质量门禁
CI、测试、lint;ai-coding 与 testing 衔接。
30 分钟
质量门禁
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