现在给 coding agent 写项目规则,常见入口已经不止一个:AGENTS.md、CLAUDE.md、Cursor rules、skills、hooks 都能影响行为。真正的决策不是选一个最流行的文件,而是先判断这条规则属于共享仓库上下文、某个工具的行为、可复用工作流,还是必须强制执行的安全边界。
共享仓库规则放 AGENTS.md
如果规则应该同时帮助 Codex、Cursor、Claude 或其他 coding agent,就优先放 AGENTS.md。适合写安装命令、测试命令、目录结构、代码风格、review gate 和本地安全约定。
- 适合:命令、约定、项目地图、PR 前检查。
- 不适合:密钥、个人沙箱 URL、临时账号。
- 如果规则需要脚本、参考资料或验证器,考虑升级成 skill。
Claude 专属记忆放 Claude 文件
CLAUDE.md 更适合 Claude Code 专属上下文,比如项目架构、常用命令、团队反复纠正过的习惯和工作流偏好。只影响部分路径的规则可以放到 .claude/rules/。但 memory 只是上下文,不是强制配置;真正要禁止的动作要用 hook 或权限控制。
Cursor 行为放 Cursor rules
当你需要 Cursor 的 metadata、文件范围匹配、Team Rules 或 User Rules 时,用 Cursor rules。Cursor 也支持项目根目录和子目录里的 AGENTS.md,所以更稳的分工是:AGENTS.md 做通用底座,Cursor rules 处理 Cursor 专属路由和团队策略。
重复工作流再升级成 Skill
Instruction file 适合写上下文和工作约定。Skill 适合那些需要 progressive disclosure、参考资料、脚本、素材或可检查产物的重复任务。如果只是一句项目规则,留在 AGENTS.md 或工具专属规则里通常更好维护。
来源
- OpenAI·官方资料·核心来源OpenAI Codex AGENTS.md guide
- Anthropic·官方资料·核心来源Claude Code memory documentation
- Cursor·官方资料·核心来源Cursor rules documentation
- AGENTS.md·第三方资料·社区观察AGENTS.md project site
