决策流程 · 完整视图

Spec Coding 完整流程图

从需求到达到上线交付，展示不同复杂度需求在 Spec Coding 体系中的完整决策路径与执行流程

站点首页 → 协作方案
完整决策树

需求流转全景图

从新需求到达开始，经过复杂度评估后进入不同级别通道。阶段一（探索期）采用 Spec-PRD → 实施 Spec 两步流程；阶段二（成熟期）知识库完善后可一步生成完整 Spec。

新需求到达
系统
requirement-router
评估需求复杂度 + 代码影响范围，确定需求级别
需求复杂度分级
L1 绿区
L2 黄区
L3 / L4
L1 绿区
简单需求通道
新独立页面 / 内部工具 / 配置后台
产品
spec-prd-writer
PRD → 结构化 Spec-PRD
spec-prd-reviewer
质量 ≥ B?
系统
AI 生成代码
基于 Spec 端到端生成
研发
ai-code-reviewer
快速审查生成代码质量
QA
testcase-generator
生成测试用例并执行
QA
QA 测试
探索性测试 + 验收
上线
L2 黄区
中等需求通道
涉及存量代码 / C端新功能
涉及存量代码?
研发
legacy-code-analyzer
分析存量代码影响范围
产品
spec-prd-writer
PRD → 结构化 Spec-PRD
spec-prd-reviewer
质量 ≥ B?
研发
spec-writer
Spec-PRD → 实施 Spec（补充技术设计）
spec-reviewer
质量 ≥ B?
系统
AI 生成代码
基于技术方案生成代码
研发
ai-code-reviewer
严格审查代码质量
系统
implementation-spec-diff
实现与规格一致性检查
QA
testcase-generator
生成测试用例
QA
QA 测试
全面测试 + 验收
上线
L3 / L4
复杂需求通道
跨服务联动 / 核心链路 / 多团队协作
产品
project-decomposer
将大需求拆解为独立模块
研发
定义全局契约
明确模块间接口与数据规范
各模块并行执行
涉及存量代码?
研发
legacy-code-analyzer
分析存量代码
产品
spec-prd-writer
编写模块 Spec-PRD
研发
spec-writer
补充技术 → 实施 Spec
spec-reviewer
质量 ≥ B?
研发
cross-module-reviewer
跨模块一致性检查
各模块并行
tech-plan → AI代码 → review
技术方案、代码生成、审查
系统
implementation-spec-diff
实现与规格一致性
QA
契约测试 → 集成测试
模块间契约验证 + 全链路
灰度上线

图例说明

角色标识
产品（PM）
研发（Dev）
测试（QA）
系统自动
通道级别
L1 绿区 — 简单
L2 黄区 — 中等
L3/L4 — 复杂
节点类型
执行节点
决策判断
开始 / 结束
并行执行块
质量关卡
质量 ≥ B
每个质量关卡不达标时，将循环改进重试（最多 3-5 轮）
全流程贯穿机制

三大保障机制

这三项机制贯穿所有级别的流程通道，确保质量持续达标、风险可控、能力不断提升。

循环达标机制

每个关键步骤都设有质量关卡。不达标时自动触发改进循环，而非放行通过。

  • Spec 评审不达标 → 反馈修改 → 重新评审
  • 代码审查不通过 → 定位问题 → 重新生成
  • 一致性检查偏差 → 溯源修正 → 二次验证
  • 每个关卡最多 3-5 轮循环，超限人工介入

赛马机制

高风险模块允许多方案并行探索，通过竞争择优选出最佳实现路径。

  • 高风险模块可同时生成 2-3 个技术方案
  • 根据代码质量、性能指标、可维护性评分
  • 择优录用，淘汰方案保留为备选参考
  • 降低单一路径依赖，提高成功概率

复盘闭环

每次交付后自动收集过程数据，形成能力评估与流程优化的闭环反馈。

  • spec-iteration-tracker 追踪迭代轮次与修改量
  • skill-evaluator 评估各技能点的表现分数
  • 沉淀为最佳实践，优化后续流程参数
  • 数据驱动，持续改善 Spec 编写质量