JamesShi96/project-butler

解决的问题

AI 编程助手在不同会话之间常常出现‘遗忘’问题，用户需要反复解释项目架构、命名规范和之前的决策。project-butler 提供了一个持久化记忆层，将项目文件夹变成一个共享的真相源，使不同的 AI 工具（如 Claude Code、Cursor 和 Codex）能够准确地从上一次会话结束的地方继续工作。

工作原理

该工具使用直接存储在项目根目录中的普通 Markdown 文件和 JSON 配置，实现一个由 7 个组件构成的内存栈。该栈按信息的稳定性进行组织：

• 稳定规则：由人工审核的原则存储在 CLAUDE.md 中。
• 当前状态：项目维基（PROJECT.md）、文件组织规则（STRUCTURE.md）和里程碑变更日志（UPDATE_LOG.md）。
• 原始事实：会话日志和 TODO.md 检查清单。
• 交接信息：session-handoff.md 文件明确告知下一个助手如何恢复工作。

它作为 Claude Code 的原生技能集成，并为其他助手生成兼容文件（如 .cursor/rules/project-system.mdc 或 AGENTS.md），确保它们遵循相同的记忆协议。

适用人群

使用 AI 编程助手并希望避免重复设置上下文的开发者，尤其是那些在不同 AI 工具之间切换或长期维护复杂架构项目的人。

主要亮点

• 跨工具兼容性：通过基于文件的记忆系统，可在 Claude Code、Cursor 和 Codex 中使用。
• 代码化交接：使用特定触发词如 end session 保存进度，continue 恢复上下文。
• 配置文件感知：可创建项目配置文件，管理文档层级和受保护区域，实现更强的架构一致性。
• 自动维护：包含文件整理、维基同步和自动检查自身更新等功能。