agents-md
一份文件让所有编码代理表现如资深工程师
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：agents-md。 它的用途是：一份文件让所有编码代理表现如资深工程师 完整的 Skill 内容见：https://321skill.com/skills/agents-md-ferroxlabs/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'安装AGENTS.md到本项目。' 它会自动下载文件、创建符号链接，并读取代码库后填写Section 10的项目上下文。之后当你要求它'修复这个Bug'时，它会先写单元测试验证，再输出最小化diff，并主动询问模糊需求，而不是直接改代码。
介绍
这个Skill解决了AI编码代理行为不一致、不遵守规则、过度修改代码的问题。在实际开发中，团队成员使用不同AI代理（如Claude Code、Codex、Cursor、Gemini CLI等），每个代理的默认行为差异很大，经常出现无谓的代码重构、忽略原有约定、输出冗长代码等情况，导致代码审查成本激增。
使用方式很简单，你只需要在项目根目录执行安装命令，将AGENTS.md放入项目，然后为Claude Code和Gemini CLI创建符号链接。之后所有支持的AI代理都会自动读取这个文件，按照“资深工程师”的行为准则工作：拒绝不合理请求、输出最小化差异、先写验证再报告、主动澄清歧义。你只需在Section 10中填写一次项目上下文（构建命令、目录布局等），Section 11会由代理自动记录每次纠正的内容，形成持续改进的学习循环。
它非常适合需要统一团队AI协作规范的开发团队或个人。尤其是那些已经使用多个AI编码代理、希望降低代码审查负担、提升代码质量的团队。项目经理和全栈开发者可以通过这个文件快速让所有代理对齐团队编码规范，避免因为代理行为差异导致的返工。
建议在项目初始化时统一使用此文件，并确保团队所有成员都使用相同版本的AGENTS.md。需要注意的是，它主要依赖项目根目录的AGENTS.md文件，对于大型多模块项目可能需要每个子模块单独放置；同时，Section 10需要人工填写，无法自动理解注释中的隐含规则。
常见问题
安装这个文件会覆盖我已有的CLAUDE.md吗？
不会。安装过程中如果CLAUDE.md或GEMINI.md已存在且包含内容，脚本不会覆盖，而是将@AGENTS.md作为第一行插入，保留原有内容。
如何更新AGENTS.md到最新版本？
重新运行curl下载命令覆盖旧文件即可，然后重新启动AI代理会话。注意Section 10和11的内容需要手动备份合并。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agents-md-ferroxlabs/raw/index.md 读取 agents-md 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agents-md-ferroxlabs/raw/index.md（查看排版版本）