流水线总览：6 个步骤 × 3 道闸门 × 1 个统一日志
每一步都留下完整审计日志，出问题 1 分钟追溯到根因；不会出现「AI 生成时到底发生了什么？」的黑盒。
01
需求与产品
标准化输入 · AI补全边界02
接口与契约
OpenAPI 3.0 自动生成03
TDD 测试先行
覆盖率 ≥ 85% 红线04
受控编码实现
规约 · 沙箱 · 本地跑测05
智能审查门禁
5 维度评分 ≥ 90 准入06
集成与部署
PR 自动生成 · 人工合入| 步骤 | 🤖 AI 自动动作 | 👤 HITL 人类卡点 | 🛡️ 质量防线（硬红线） |
|---|---|---|---|
| 01 需求与产品 | PRD 边界/异常流补全；复用建议；UML 初稿 | 架构师确认 PRD 完整性 | Checklist 完整度 ≥ 95%；可测性验证通过 |
| 02 接口与契约 | 自动生成 OpenAPI 3.0；Mock 数据；前端 TS 类型 | 前后端负责人对齐契约 | 错误码 ≥ 12 类、分页/鉴权必须覆盖 |
| 03 TDD 测试先行 | 高覆盖率 JUnit/Vitest；Mock 接口；用例分类 | 主管确认关键验收用例 | 分支覆盖率 ≥ 85%（不达标无法进入编码） |
| 04 受控编码实现 | 按规约生成业务代码；沙箱自动本地跑测 | 研发自测后签字 + 说明 | 本地 100% 通过、Lint 零 Error |
| 05 门禁 Gatekeeper | 5 维度自动打分 + 修复建议 Diff | 主管对 80~89 分进行人工复核 | 综合评分 ≥ 90 准入（＜80 自动打回） |
| 06 集成与部署 | 自动生成 Changelog + PR；关联 Issue | 1 人最终合入确认 | 自动回归套件 + 生产灰度发布 |
5 维度门禁 Gatekeeper：90 分准入公式全公开
我们不做「黑盒打分」。5 项维度 + 权重分配 + 建议阈值，所有公式在文档中完全透明，你可以根据团队特点自定义权重。
35%🛡️ 安全审计 · OWASP Top 10
25%🧹 代码异味 · SonarQube 规则集
15%🔁 重复代码 · 3% 阈值
15%📐 圈复杂度 · 8 阈值
10%🏷️ 命名规范 · 团队规约对齐
≥ 90 分🎯 综合准入标准
📐 打分公式（建议版，支持自定义）
SCORE = 安全×35% + 异味×25% + 重复×15% + 圈复杂度×15% + 命名×10%
≥ 90 分：✓ PASS → 自动放行 & 推送 PR 评论
80~89 分：⚠ NEED HUMAN → 主管人工复核
＜ 80 分：✗ BLOCK → 自动打回 + 给出 AI 自动修复 Diff
常见门禁打回场景 & 修复 Diff 示例
示例 1：OrderService 圈复杂度 17.4（超标 8）
💡 AI 自动修复建议：将超长 if-else 提取为 3 个策略类 + 工厂方法，拆分后平均圈复杂度 ≤ 5；附带完整重构 Diff 一键 Apply。
示例 2：发现 SQL 拼接漏洞（SEV-HIGH）
💡 AI 自动修复建议：替换为 MyBatis Parameterized Query；并在 Rules Center 新增 2 条「禁止拼接 SQL」规约，以后相同问题生成阶段就会被拦截。