🏛️ SpecFlow 架构定位：Harness Engineering 与 Loop Engineering 的深度结合

在评估 SpecFlow AI 工程化平台时，研发团队常有一个核心疑问：“SpecFlow 究竟只是一个简单的 CLI 工具引擎，还是属于 Harness Engineering 或 Loop Engineering？”

答案是：SpecFlow 是 Harness Engineering（装配体工程）与 Loop Engineering（闭环工程）在 SDD（规范驱动开发）理念下的深度结合体。 SpecFlow CLI 与 AI Skill 仅是调配这两者协同运行的工程化载体。

---

📌 一、 Harness Engineering (装配体工程) 在 SpecFlow 中的物理体现

Harness Engineering（装配体工程） 的核心在于为 AI 提供受控、隔离、可预测的物理约束环境与审查物理设施。在 SpecFlow 中体现在以下维度：

1. 双仓 Sibling 物理隔离 Harness：
   • 强约束 .specify/ 契约规范物理隔离保存在物理 -spec 规范仓下（如 reimburse-pc-cli-spec），而业务仓（如 reimburse-pc-cli）保持绝对纯净。
   • 防止 AI 臆造工程结构：底层脚手架精准扫描目标业务仓物理结构，前端 Vue 工程强约束只生成前端组件（src/views/），绝对禁止在纯前端项目物理强插 Java 代码！
2. 5 大部门规制与 14 条静态审查 Harness：
   • 将 58 财务部门的金额 BigDecimal 规则、硬编码密钥检测、空 catch 块等装配为静态 Rule 规则库，物理阻断违法代码进入 master。
3. iGit API 物理单据与贴图 Harness：
   • 自动在 iGit / GitLab 平台物理创建 Merge Request，并将双表格审查结论贴回至 Discussion Thread。

---

⚙️ 二、 Loop Engineering (闭环工程) 在 SpecFlow 中的物理体现

Loop Engineering（闭环工程） 的核心在于解决大语言模型 (LLM) 输出的概率性与非确定性，建立“生成 $\rightarrow$ 校验 $\rightarrow$ 捕获扣分/Error $\rightarrow$ 反馈 Prompt $\rightarrow$ 自愈重构”的闭环回路：

1. P1/P2 契约完备性 Loop：缺失金额 BigDecimal 标记或 AC 场景为空时，Harness 阻断向 P3 推进，重新提示 Agent 补齐规格；
2. P3 AST/语法自检 Loop：AI 代码产生后，静态 AST 语法树自检行号与上下文，如有语法错误或硬编码，反馈回 AI 进行针对性重构；
3. P4 单测覆盖率自愈 Loop：单测覆盖率 $<85%$ 时，Testcase-Harness 捕获未覆盖分支列表并回溯驱动 AI 生成补充单测；
4. P5 双表审查 0 Error Loop：审查得分 $<85$分 或存在致命 Error 时，将扣分项反馈给 AI 修正，直至达标。

---

💡 三、 架构全景融合关系

---

归档路径：knowledge-base/site/specflow/harness-and-loop-engineering.md