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 命令在功能上正确无误。