Coding Agent ：对比理解 AGENT.md、SPEC.md、SKILL.md
以 Claude Code 为典型 coding agent，统一讲解三类文档的定位、痛点、业界实践与整合之道。 一、三类文件分别在做什么？ 快速对比 维度 AGENT.md / CLAUDE.md SPEC.md / spec.md SKILL.md 角色 项目级「写给 AI 的 README」 功能/迭代级「可执行规范」 可插拔的「技能包」 生命周期 长期稳定，随项目演进 每个功能/迭代一份 按需激活，持久存在 作用域 整个仓库 / 子目录 单个功能或任务 单个工作流或能力 核心问题 我们怎么干活？ 这次要干什么？什么算完成？ 具体怎么做这一步？ 加载时机 每次对话自动加载 任务启动时读取 匹配到场景时按需加载 1. AGENT.md / CLAUDE.md —— 给「代理人格」和「项目」定规矩 「把它当成给 AI coding agents 的 README」—— 是专门写给智能体看的项目说明书，而不是写给人的 README。 以 Claude Code 为例，其官方使用 CLAUDE.md。AGENTS.md 是一个更通用的开放规范，两者本质作用类似。 典型内容 AGENT.md 内容结构 ** 项目/仓库级信息** 依赖安装: pnpm install 构建命令: npm run build 测试命令: pytest, pnpm typecheck ** 代码风格/规范** 单引号 vs 双引号 类型注解要求 Linter / Formatter 选型 ** 工作流与约定** 分支命名、Commit / PR 格式 是否先写测试再写实现 ** 特殊注意事项** 常见坑、脚本套路 安全/隐私约束 核心意义 对 AI：稳定、可缓存的「行为准则 + 项目简介」，可被多种工具一致读取（Claude Code、Copilot、Cursor、Gemini CLI 等都支持 AGENTS.md） 对团队：把「平时口头说的套路」固化为 repo 内的真实文档，开发者和 agent 共用同一套规则 类比理解 ...