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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/project-brain/raw/index.md(查看排版版本)