质量门禁

AI 提高 产出速度，也提高 错误放大速度。质量门禁用 自动化 + 人审 把风险拦在 merge 之前。本课衔接 ai-coding-essentials 的工具链与 testing-essentials 的验收标准。

学习目标

• 设计 AI 时代最小可行门禁（测试、lint、CI、Review）
• 理解「绿 CI」对 AI 生成代码的特殊意义
• 知道 CodeRoadMap 仓库里门禁如何覆盖代码与内容

门禁四层

本地：format / unit test 绿
  ↓
PR：  lint + CI pipeline
  ↓
人审： diff + 测试计划 + AI usage 披露
  ↓
主干： protected branch，仅 CI 绿 + Approve 可 merge

层	抓什么	AI 相关注意
单元测试	逻辑、回归	AI 常漏边界断言
静态分析	空指针、风格	不抓业务幻觉
CI	集成、构建	Agent 改 pom 要盯
Review	设计、安全	AI 初筛，人终审

与 testing-essentials 衔接

• test-intro：测试是需求的可执行版
• AI 起草测试后，人必须问：「失败时能说明什么 bug？」
• 参考 ai-test 的审查清单

规则：无 CI 绿的 AI 大 PR 默认不 merge。

与 git-essentials 衔接

• git-workflow：小 PR 更易 Review
• git-merge：冲突解决不能全丢给 AI
• 每个门禁点都应有 可回滚的 commit 粒度

AI 特有门禁建议

建议	原因
PR 必填 Test plan	防「AI 说测过了」
大 diff 拆 PR	Agent 一次改太多
禁止跳过 hook	--no-verify 对 AI 改动更危险
敏感目录 CODEOWNERS	鉴权、支付双人审

内容仓库门禁

CodeRoadMap content/ 变更：

• 链接 slug 与 outline.yaml 一致
• 无 secrets、无整段未授权转载
• PR 描述可注 content draft, AI-assisted