AGENTS.md
全局编码代理指令，规范行为与验证
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：AGENTS.md。 它的用途是：全局编码代理指令，规范行为与验证 完整的 Skill 内容见：https://321skill.com/skills/agents-md-anbeeld/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请按照AGENTS.md中的规则，先探索项目结构，收集所有相关证据，再实施修改，最后验证不引入副作用。' 它会依次执行：扫描项目文件、确认任务范围、列出需要修改的代码块、实施最小改动、运行测试并报告结果。
介绍
这个Skill解决了AI编码代理普遍存在的三大问题：未经证据收集就动手编码、任务范围不受控地扩展、未经验证就提交变更。在实际开发中，开发者经常遇到代理跳过调研直接实现、悄悄重构现有代码、或输出未通过测试的修改，导致返工和错误。本文件通过一套全局指令，强制代理在每一步都遵循“探索→收集证据→扫描技能→实施→验证”的固定顺序，并用硬性规则约束行为边界。
使用方式很简单，你只需要将仓库中的AGENTS.md文件复制到你的AI代理配置目录（如Claude Code的CLAUDE.md位置），即可立即生效。如果你使用多个代理，项目提供了sync.sh和sync.ps1脚本，可以一键将同一份指令同步到各大工具（Claude Code、Codex、OpenCode、Cursor等）的配置位置。此外，对于支持@导入的代理（如Claude Code），你还可以在CLAUDE.md中写入@AGENTS.md直接引用，无需复制。
它非常适合需要频繁使用AI编码代理进行代码生成、重构、调试的团队或个人。尤其是那些已经遭遇过代理“编造代码”、“擅自扩大修改范围”、“依赖未经验证”等问题的开发者。对同时管理多个AI代理（如Claude、Gemini、Codex）的用户，本文件能统一所有代理的行为规范，减少人工审查成本。
建议在团队内统一使用此文件，并鼓励成员根据项目特点在本地CLAUDE.md中添加覆盖规则。需要注意的是，它主要面向编码代理场景，如果你的工作流不涉及AI辅助编程，则无需使用。另外，文件中的规则对“无证据即执行”的行为约束较强，部分代理模型可能因此降低响应速度，但能显著提升输出质量。
常见问题
这个文件与项目自带的CLAUDE.md冲突怎么办？
AGENTS.md明确说明：本地项目指令优先级高于本文件，因此你在项目级CLAUDE.md中写的规则会覆盖全局指令。建议将AGENTS.md作为基础规范，在项目级按需添加补充或覆盖。
支持哪些AI代理或工具？
支持所有读取AGENTS.md或CLAUDE.md的编码代理，包括Claude Code、Codex、OpenCode、Gemini、GLM、Kimi、MiniMax等。脚本可同步至Claude Code、Codex、OpenCode、Cursor、Windsurf等主流工具。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agents-md-anbeeld/raw/index.md 读取 AGENTS.md 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agents-md-anbeeld/raw/index.md（查看排版版本）