Agent 指令文件：哪些内容放哪里

现在给 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 或工具专属规则里通常更好维护。