AI Coding 落地检查清单

用法：上线前、运行中、故障时各过一遍。每条是一个动作或判断，不做就勾不上；阈值没有出处的标“经验值”，按团队基线调整。

上线前

• [ ] 任务已选范式：改一行/写样板用补全；单模块、验收清晰用 Agent；跨模块、高风险、需审计用 SDD。不要用同一种自主性覆盖所有任务。
• [ ] 规格有可测试 AC：每条 AC 能直接翻译成断言或基准；AC 有稳定编号，并已映射到任务和测试。
• [ ] 测试先红后绿：新功能先写测试并确认失败；Bug 修复先写复现测试。测试没红过，不算验证。
• [ ] 项目约定已落盘：AGENTS.md / CLAUDE.md 写清技术栈、构建/测试命令、禁止项、完成定义；先不写，按重复失败追加，常见 20–50 行（经验值），超过 200 行拆分。
• [ ] 权限最小化：Agent 只读写必要目录；MCP 工具按阶段授权；删数据、发布、改权限、动生产配置必须人工确认。
• [ ] 执行有隔离且有上限：Agent 跑在容器或独立 worktree；不挂生产凭证，限制网络出口，任务结束销毁环境；设置模型/工具调用次数、token 预算、单步超时，超限转人工或降级，不允许无限循环。
• [ ] CI 门禁可执行：测试、lint、构建、SAST/SCA、覆盖率全部是命令返回码；不通过不能合并，禁止 skip 或 --no-verify 绕过。

运行中

• [ ] 变更可追溯：Spec/AC 编号、任务、提交、测试、CR 记录能互相对上；代码改了但 Spec 没改的 PR 要拦下。
• [ ] 影响面已确认：调用方、数据表、消息主题、定时任务、配置中心、外部消费方逐项检查，AI 穷举、人补历史约束。
• [ ] 人工卡点未被跳过：规格评审、任务拆解、最终验收由人签字；AI 不能自批，也不能用“已完成”替代验收。
• [ ] 测试质量有抽查：AI 生成的测试至少抽查 30%（经验值），核心路径逐个审；用突变测试或“改坏实现”验证不是假测试。

故障时

• [ ] Agent 跑偏/循环：连续修复 3 次仍失败立即停会话转人工（经验值）；保留 checkpoint 和工具调用日志，不要让它继续烧 token。
• [ ] 测试或构建失败 / 模型工具不可用：先复现并确认失败原因，再改代码；禁止跳过失败用例或降低门禁换合并；模型或工具不可用时切备用并降级人工，记录原因，不要静默失败后继续执行。
• [ ] 误改/越权：先回滚分支或 commit，再吊销相关凭证；查工具调用审计，补一条回归测试，最后复盘权限边界。
• [ ] 疑似提示注入/数据泄露：立即隔离会话，清空上下文，检查 MCP 工具返回内容，轮换密钥；确认影响范围后再恢复。

故障分诊流程

先定性再动手：六条路径的第一动作没有一个包含"改代码重试"——AI Coding 的故障多数是验证与权限问题伪装成模型问题。

一句话

这份清单只保底，不保赢：它保证 AI 的产出可验证、可回滚、可追责；真正的效率来自把规格、测试和上下文做扎实，而不是把门禁调松。