AI 编码规范初始化

解决什么问题

在多人协作的项目里，编码规范往往散落在 PR 模板、口头约定、不同人本地的 linter 配置中。真正执行时，规则要么被忽略，要么在 merge 时被 review 反复提及。更糟的是，当我们开始用 AI 辅助写代码、补测试、改 bug 时，同一个项目里可能出现两种风格：人写的代码走一套规则，AI 生成的代码走另一套。时间一长，diff 里的噪音变多，review 成本上升，新人接入也更慢。

这个技能针对的就是这一层摩擦：让「规范」从一个可读文档，变成一份 AI 和团队都能直接对照的初始化约定。

它如何工作

核心思路是以 AGENTS.md 作为单一来源。技能会引导你在项目根目录生成或更新这份文件，把项目实际使用的语言、框架、目录结构、命名约定、提交与评审要求写清楚。

关键步骤包括：

• 生成规范初稿：根据项目现有代码与团队习惯，产出一份可直接放进仓库的规范文件。
• 初始化 AGENTS.md：在项目根目录落地该文件，使团队成员和 AI 工具在同一份约定上协作。
• 生效与维护：后续改动通过 PR 评审 AGENTS.md，让规则变更和代码变更走同一条 review 路径。

这样一来，AI 在补函数、写测试、修 lint 问题时，输出会更贴近项目既有风格，而不是每次从通用习惯开始重新猜测。

适用边界与注意点

这个技能不是替你强制代码风格，也不是替代 linter 或 CI。它更适合那些已经有明确技术栈和协作习惯、但缺少一份统一 AI 编码约定的团队。

需要注意两点：一是团队需要有人对 AGENTS.md 的内容负责，规则写得不清楚，AI 和人都只会继续按各自理解执行；二是并不是所有 AI 工具都会自动读取该文件，接入前要先确认所使用工具是否支持在项目中读取项目级约定。