Appearance
🛡️ SpecFlow P1~P7 企业级 AI 开发全流程闭环与 3 维范式能力对标矩阵
版本标识：SpecFlow
v0.13.85
核心意义：在企业级与金融级软件研发中，通用 AI 提示词或简单开源 CLI 常存在“凭空幻觉需求”、“改动脱节组件”、“伪单测套用”及“缺乏质量卡点”等痛点。SpecFlow 通过 P1~P7 阶段刚性治理体系，构建了完全物理闭环的 AI 规范驱动开发 (SDD) 范式。
📌 一、 SpecFlow P1~P7 全生命周期闭环总览
$$\begin{array}{rcc} \mathbf{P1\ Specify} & \longrightarrow & \text{CodeGraph 图谱探查 + 问询卡片确认目标组件 (拒绝脱节)} \ \mathbf{P2\ Plan} & \longrightarrow & \text{物理绑定宿主组件拓扑 + 架构宪法门禁落盘} \ \mathbf{P3\ Task} & \longrightarrow & \text{基于精准文件锚点物理编码 (0 假 Demo 页面)} \ \mathbf{P4\ Testcase} & \longrightarrow & \text{\mathbf{Terminal\ 物理单测合成 + StackTrace\ TDD\ 自愈修复}} \ \mathbf{P5\ Review} & \longrightarrow & \text{\mathbf{SpecFlow\ 独创\ 5D\ 契约双向对齐 + Node\ 逆向回溯}} \ \mathbf{P6\ Report} & \longrightarrow & \text{\mathbf{P1\sim P5\ 质量审计物理双表格归档 + specflow-report\ 部门大盘}} \ \mathbf{P7\ MR} & \longrightarrow & \text{\mathbf{90分前置硬阻断 + 100%\ 物理双报告贴回强对齐 (!800)}} \end{array}$$
📊 二、 3 维范式能力对比矩阵 (SpecFlow vs OpenSpec/SpecKit vs 传统CLI)
| SDD 阶段 | 核心任务 | SpecFlow 企业级闭环设计 | GitHub spec-kit / OpenSpec 范式 | 传统 CLI / 人工提示词模式 | SpecFlow 独创设计优势 |
|---|---|---|---|---|---|
| P1 Specify | 需求规格定义 | • CodeGraph 图谱探查物理工程拓扑• ask_question 卡片交互式问询多候选组件，用户物理确认• Spec 文本零假设/零幻觉 | • 基于简单对话生成 .spec.md• 缺少本地物理 CodeGraph 绑定 • 容易挑选脱节的 View/Component | • 散落在聊天框，无落盘 .spec.md• 完全由 AI 幻觉猜测工程路径 | 【独创门禁】物理 CodeGraph 扫描 + 问询卡片硬锁定目标 View 组件，杜绝跑偏与假 View |
| P2 Plan | 架构设计与 Task 拆解 | • 物理绑定用户确认宿主组件 (如 reimburse/index.vue)• 落盘 research.md / data-model.md• 精细化 Task 拆解与宪法门禁自检 | • 生成简单 plan.md• 文件粒度粗糙 • 无强锁定的架构宪法限制 | • 无 Plan 方案落盘，直接堆代码 • 缺乏边界与模块解耦规划 | 【独创门禁】物理架构宪法门禁 + Data Model 序列图与组件粒度硬性绑定 |
| P3 Task | 物理代码落地与修改 | • 基于物理解耦算法（如纯函数 interceptor.js）+ Vue 视图前置插桩• 零破坏已有逻辑 • 零通用假 Demo 页面 | • Agent 修改或新建代码文件 • 缺乏对已有重名/多视图组件的防护 | • 手工/简单 AI 替换代码 • 容易引入破坏性修改或语法错误 | 【独创门禁】非破坏性切面植入，强约束物理作用于已有宿主代码，0 Dummy 污染 |
| P4 Testcase & Testgen | 物理单测与 TDD 修复闭环 | • 基于 Given-When-Then AC 真实合成单测 • 调起 Terminal 运行 node --test• StackTrace 报错捕获 + Agent 源码自愈修复循环 | • 生成单元测试框架文件 • 依赖开发者在终端中手动调起 • 测试失败无自动 Backtracking 自愈 | • 不写单测，或仅手工点测 • 易吞噬异常，无法保证代码可靠性 | 【独创门禁】100% 真实 Terminal 单测运行 + 物理 StackTrace 报错源码自愈修复循环 |
| P5 Review | 静态审计与 5D 契约双向对齐 | • SpecFlow 独创阶段 • git diff 14 条静态规则 + 5D 契约双向对齐校验 (AC词匹配/层级防御/空安全)• 得分 $< 90$ 分硬阻断，逆向回溯自愈 | ❌ 开源范式无此独立阶段 (依赖异步 GitHub Actions 或 PR 人工看代码) | ❌ 无审查阶段 (代码质量完全取决于开发个人素养) | 【独创切面】提 Push/MR 前本地刚性 Review 门禁 (≥90分达标) + 5D 契约双向对齐 |
| P6 Report | P1~P5 质量归档与大盘推送 | • 物理汇总 P1~P5 审计成果 • 生成 metrics.json + AUDIT_REPORT.md• 自动 Git Push 至 specflow-report.git 大盘 | ❌ 开源范式无此独立阶段 (无部门集中质量归档大盘) | ❌ 无数据归档 (团队管理者无法感知 AI 编码质量) | 【独创切面】P1~P5 物理双表格大盘集中归档与美事在线文档强同步 |
| P7 MR | 一键 Merge Request | • 提 MR 前置刚性得分校验 (≥90分) • 物理读取 AUDIT_REPORT.md 贴发 Discussion Thread• MR 评论与部门大盘 100% 字节级强一致 | • 通过 GitHub PR CLI 或 GitLab Web 手动创建 • 评论为通用占位符或空白 | • 人工手动在 GitLab UI 上复制粘贴开 MR | 【独创门禁】得分低于 90分 硬拦截 + MR Discussion 评论与大盘报告 100% 强对齐 |
💡 三、 SpecFlow 企业级独创设计的四大核心优势
- 零幻觉与目标组件刚性对齐： 通过
CodeGraph.json图谱与ask_question问询卡片，在 P1 阶段强制用户与 AI 达成目标 View/Component 物理一致性，从源头杜绝新建脱节假页面的问题。 - 终端 Terminal 真实 TDD 报错自愈闭环： 摒弃纸上谈兵式的假单测，Agent 直接调起物理 Shell 执行
node --test，解析 TAP 协议日志，失败时捕获 StackTrace 自动回溯修正源码。 - P5 独创 5D 契约双向静态审查： 在开 MR 之前建立 $\ge 90$ 分金融严格级防线，对比
git diff物理切面与.spec.md中的 AC 关键词及组件层级职责。 - P6/P7 物理双表格归档与 100% MR 讨论强一致： P6 汇总 P1~P5 审计指标，生成物理双表格（高层汇总表 + 分类细分表）；P7 创建 MR 时物理读取
AUDIT_REPORT.md正文帖回，做到 MR 评论与部门大盘 100% 字节级强一致。