S27-A03 · AI 开发规范（团队级）

适用读者：要给团队定"AI 怎么用"的人。
前置：S24-A01（权限）、S24-A03（度量）。
覆盖旧文：556（后端项目 AI 开发规范，966 点）。
扩展点：E-S27-009（规范即约束）。
上一篇：S27-A02 · 多模态生成：视频与素材流水线
下一篇：S27-X01 · 教程卡与杂项登记。

1. 一句话结论

规范要写成"AI 能执行的约束"，而不是"给人看的倡议"：能落到规则文件、钩子、权限里的，才算生效。

规范层级	形式	执行力
倡议（文档里写）	README	弱
规则文件	`CLAUDE.md` 类	中（模型尽量遵守）
钩子/门禁	提交前 lint/测试	强（强制）
权限	沙箱/审批	强

2. 规范的四块内容（E-S27-009）

块	内容	落点
允许/禁止	能改哪些目录、不能碰什么	权限 + 规则
必须执行	提交前跑测试/lint	钩子
风格	命名/分层/异常处理	规则文件
交付标准	什么算完成	验收命令

判据："这条规范，违反了会被自动挡住吗？" 不会 → 它还只是倡议。

3. 团队落地三步

① 先写"禁止清单"（最小、最硬）：不能碰的目录/命令
② 再加"必须执行"（钩子）：提交前测试
③ 最后写风格与交付标准（规则文件）

"为什么从禁止清单开始"：它收益最高、争议最小——挡住一次越界改动，胜过十条风格建议（S24-B03）。

4. 与代码评审的关系

环节	AI 角色	人角色
生成	写代码	定方向
自检	跑测试/lint	设定判据
评审	辅助（提意见）	最终判断
合并	❌ 不应自动	✅ 人

"为什么合并必须由人做"：它是 L3 不可逆操作（S24-A01）。

5. 五个误区

误区	真相
"写了规范就会遵守"	要落到钩子/权限
"规范越长越全"	太长会被忽略
"风格规范最重要"	禁止清单收益更高
"AI 可以自动合并"	L3 需人审批
"规范一次写完就够"	随工具演进要更新

6. 自检（架构师版）

四个规范层级的执行力？
四块内容各落到哪？
为什么从禁止清单开始？
AI 与人在评审中的分工？
为什么规范要随工具更新？

7. 下一篇

S27-X01 · 教程卡与杂项登记

最后一篇是附录（19,002 点），随后进入 S25（求职，最大系列）。

本篇属于系列《S27 · 杂项归档与工具实测》。旧文来源：A-556；扩展点 E-S27-009。