Project Brain – AI编程的持久记忆索引

Project Brain 是一个针对 Claude Code 的创新技能，旨在解决 AI 编程助手在多个项目中工作时的记忆问题。许多开发者每天都要花费大量时间向 Claude 解释项目架构、部署方式、技术栈和历史，但每次新会话都要重新来过。更糟糕的是，长时间工作后，模型可能会混淆不同项目的细节，导致错误决策和重复劳动。

Project Brain 通过一个简单的约定来解决这个问题：在项目根目录下创建一个 .project-brain/ 文件夹，包含一个轻量级索引文件（index.md）和按需加载的主题文件。索引文件仅包含项目列表、主题及其状态和指针，而详细内容则存储在单独的文件中，仅在需要时读取。这样，Claude 不会一次性加载所有知识，而是根据问题精准获取相关信息。

该技能的核心优势在于其状态追踪功能。每个主题不仅标记为“已完成”，还区分了“已验证成功”、“尝试失败”和“进行中”。例如，当 Claude 查询某个问题解决方案时，如果地图显示该方案三天前已验证通过，它会主动告知用户并询问是否重复。这种设计有效减少了幻觉，防止模型凭空捏造部署细节或混淆不同项目栈。

此外，Project Brain 支持版本管理。当某个方法被替换时，旧版本会被保留为“已替代”笔记，完整记录尝试历程和变更原因。这种非覆盖式的历史记录为团队协作和长期项目维护提供了宝贵上下文。

安装过程非常简单：通过 git 克隆仓库，运行 install.sh 脚本即可将技能复制到 ~/.claude/skills/ 目录。注意，技能是每台机器安装一次，而记忆数据（.project-brain/）则存在于每个工作区中。首次使用时，只需在工作区内执行 /project-brain init 命令，它会自动检测项目（基于 package.json、pyproject.toml 或 git）并创建索引。初始化过程非常轻量，不会读取源代码。

对于已有大量代码库的项目，用户可以选择进行“深度回填”，让 Claude 读取现有代码和文档并生成摘要。这需要一次性令牌投入，但之后每次会话都会更便宜、更精准。技能还会在执行深度回填前给出警告，以避免意外消耗。

Project Brain 的设计注重隐私和灵活性。.project-brain/ 文件夹中的内容可能包含基础设施细节（如数据库名称、端口、服务器路径），用户可以根据需要决定是否将其纳入版本控制。项目自带 .gitignore 默认忽略该文件夹，以防意外泄露。

该技能的背景来自作者运行多个独立 SaaS 产品的实际经验，包括 Sentinel AI、24ad.info 等。当每个项目都承载着数千行上下文时，AI 遗忘或混淆的代价是真实的。Project Brain 提供了一种实用的工作记忆，帮助保持项目清晰。

总而言之，Project Brain 不仅是一个工具，更是一种让 AI 助手持续了解项目状态的方法。它通过智能索引、状态追踪和版本历史，显著减少了令牌消耗和幻觉，支持跨月记忆，是提升 AI 编码效率的有力补充。

该技能基于 MIT 许可证开源，欢迎开发者试用和改进。