project-brain

为AI助手设计的项目文件夹结构与协作协议,实现跨会话记忆与接力。

安装使用

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

帮我安装这个 AI Skill:project-brain。
它的用途是:为AI助手设计的项目文件夹结构与协作协议,实现跨会话记忆与接力。
完整的 Skill 内容见:https://321skill.com/skills/project-brain/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

“请为当前项目设置 project-brain。” 它会引导你创建标准的 `brain/` 文件夹结构,并初始化核心文件如 `MAP.md`。 在新会话中,你可以说:“resume this project”,AI会自动读取 `brain/` 下的状态文件,快速理解项目进展并继续工作。

介绍

project-brain 旨在解决一个常见痛点:当你在不同会话、窗口或与不同协作者使用AI编程助手(如Claude Code、Cursor)时,每次都需要重新向AI解释项目背景和当前进度,导致效率低下和Token浪费。

它通过引入一个标准化的 brain/ 文件夹结构(包含项目地图、当前状态、决策日志等核心文件)和一套简单的协作协议来工作。AI助手只需读取其中2-3个关键文件,就能快速理解项目全貌,无缝接续之前的工作。

这个工具非常适合需要长期、多会话协作开发项目的团队或个人开发者,尤其是那些项目包含多个并行工作流(如开发、运维、市场)的场景。

建议在项目初期就引入此结构,并养成定期更新 STATUS.md 等文件的习惯。它不替代版本控制系统,而是作为AI可读的“项目记忆层”与其协同工作。

核心特点

与单纯依赖大上下文窗口的解决方案不同,project-brain 通过强制性的结构化信息组织,确保AI能精准定位关键信息,而非在海量上下文中盲目搜索。其核心是定义了AI与项目状态交互的协议,而不仅仅是一个文件模板。

注意事项

不适合极其简单或一次性脚本项目,引入结构本身会带来一定的初始维护成本。

常见问题

project-brain 和 Git 有什么区别?

Git管理代码变更历史,project-brain管理AI可读的项目状态、决策和上下文,两者互补。

必须使用 Claude Code 吗?

不是必须,其核心是文件夹协议,任何能读取文件的AI助手都可受益,但Claude Code插件提供了最佳集成体验。

给 AI 助手的安装指引

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

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