jbarbier/CLAUDE.md

解決的問題

本專案為 Claude Code、Cursor、Gemini CLI 等程式碼代理提供一組全面且具主觀立場的指示（「合約」）。透過建立一組持續生效的規則，規定代理應如何思考、撰寫程式碼以及進行溝通，防止其預設採取平庸行為——例如跳過測試、自行發明函式庫、或對本應獨立處理的任務請求許可。

如何運作

本專案由單一檔案 CLAUDE.md 組成，該檔案在每次會話開始時載入至模型的上下文中。此檔案作為系統提示或持續性合約，覆蓋代理的預設行為。為確保在不同工具間的相容性，作者建議使用符號連結（例如將 CLAUDE.md 連結至 AGENTS.md 或 GEMINI.md），以確保多個 AI 程式碼工具共享同一份權威來源。

適用對象

使用 AI 程式碼代理，並希望透過提供嚴格的操作指南，獲得更優質、更可預測輸出的開發者。

主要亮點

• 跨工具相容性：透過標準化命名與符號連結，支援 Claude Code、OpenAI Codex CLI、Cursor 和 Gemini CLI。
• 程式化分支規則：包含經過驗證的 shell 命令，用於管理 git worktrees，確保多個代理會話不會在同一個倉儲中發生衝突。
• 多代理工作流程：整合「分發 + 嚴苛批評」循環以實現高品質輸出，並引入自我評分規則以支援迭代改進。
• 模組化設計：指示按類別（如任務拆分、安全性、完成狀態）組織，使用者可根據特定專案需求與技術堆疊選擇保留或刪除部分。
• 已驗證命令：倉儲包含測試套件，確保指示中提供的 shell 命令在功能上正確無誤。