goldfish

为AI编码会话提供持久的意图记录与上下文管理工具。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:goldfish。
它的用途是:为AI编码会话提供持久的意图记录与上下文管理工具。
完整的 Skill 内容见:https://321skill.com/skills/goldfish/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'/recall',它会自动加载最近的工作检查点和当前的战略简报,让你无缝接续上次的编码会话。当完成一个关键功能模块时,

对AI说:'/checkpoint 实现了用户登录模块,采用JWT方案以支持后续的微服务拆分',它会将此次变更及原因记录下来。在项目方向明确后,

对AI说:'/brief 本项目目标是构建一个高并发的实时数据看板,优先保证图表渲染性能,使用WebSocket推送数据',这将创建一个持久的战略指导文件。

介绍

Goldfish 解决了AI辅助编码时,不同会话间决策意图和战略方向容易丢失的问题。现有的AI编码工具擅长规划和总结,但缺乏一种持久、可跨会话和工具读取的“为什么”记录机制。

它通过三个核心MCP工具(checkpoint, recall, brief)和六个技能命令来工作。您可以在重要里程碑使用 /checkpoint 记录变更及原因;使用 /brief 保存长期战略方向;在新会话开始时使用 /recall 恢复上下文。所有记录都以Markdown文件形式保存在代码仓库中,随代码一起版本控制。

该工具非常适合需要长期、多会话协作开发复杂项目的开发者,尤其是全栈开发、智能体开发者和项目经理,他们需要确保项目的战略意图和决策历史不被遗忘。

使用建议:初次使用建议从Claude Code客户端开始,体验最完整。安装插件后,新会话会自动加载使用指引。注意,在Cursor等客户端中,首次使用时需先执行一次记录操作(如checkpoint)以帮助工具识别当前项目路径。

核心特点

与同类工具相比,Goldfish的核心区别在于它是“意图的Git”——将项目决策、里程碑和战略方向以源码可控、Markdown为源的独立账本形式保存,完全独立于任何特定的AI编码工具(如Claude Code、Cursor),实现了上下文和意图的持久化与可移植性。

注意事项

不适合仅进行一次性、短平快代码片段生成或无需保留决策历史的简单编码任务。

常见问题

Goldfish记录的数据存储在哪里?

所有记录(checkpoint、brief)都以Markdown文件形式保存在您代码仓库的 `.agents/skills` 目录下,随代码一起提交到Git,便于版本控制和团队协作。

它支持哪些AI编码客户端?

主要支持Claude Code(功能最完整)和Cursor,也可通过MCP服务器供VS Code with GitHub Copilot等支持MCP协议的工具使用。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/goldfish/raw/index.md 读取 goldfish 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。