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 恢復上下文。
• 設定檔感知：可建立專案設定檔，管理文件層級與受保護區段，實現更強的架構一致性。
• 自動維護：包含檔案整理、維基同步與自動檢查自身更新等功能。