AIDocxWorkFlow: Skill for Claude Code

AIDocxWorkFlow S7 — 用例审查

独立阶段：可单独调用。上游材料（S6 test_cases.json + coverage/omission 账本）审查合格后开始，失败写失败报告。

⚠️ 模块定义见 .cursor/MODULES.md（项目级唯一真相源）。 本文件不重写模块表。所有"模块"字段取值集合见 MODULES.md §1 总表，{Module} 占位符 实际取值集合 = 8 模块之一（CONFIG / UI / BIZ / UTIL / LINK / LOG / SPECIAL / HINT）。

HINT vs UI 边界判定（误标高发区）见 MODULES.md §4.11.2。

---

阶段入口

触发：/aidocx-s7-review 或粘贴 S6 test_cases.json

前置材料：S6 test_cases.json + S5 test_points.json + S4 business_flow.md + coverage_ledger.json + omission_ledger.json。详见 §1.4。

材料缺失时：生成失败报告，停止 S7。

---

§1.4 必读材料与违规认定

⚠️ 违反本节禁令 → 产出不合格，必须补读后重新生成。

违规认定（满足任一 → 产出不合格）

• ❌ 未读取本节材料，直接凭印象生成
• ❌ 跳过标注"强制"的材料，用其他来源替代
• ❌ 产出的 module / s4_reference 与材料内容明显不符
• ❌ 用"业务常识"替代必须读取的材料

必读材料清单

审查前，必须先 Read 以下材料。

#	材料	路径	必读原因
①	8 模块总表	.cursor/MODULES.md（§1 总表）	覆盖率按模块统计；审查员 B 的 module_coverage 以 8 模块为分母
②	模块边界区分	.cursor/MODULES.md（§4 各模块 O_boundary.md）	判断 TP 模块归属是否正确；HINT vs UI 是最高误标区
③	S6 test_cases（强制）	workflow_assets/<req_name>/<version>/「S6 测试用例生成」/test_cases.json	审查对象；未读取 → 无法审查
④	S5 test_points（强制）	workflow_assets/<req_name>/<version>/「S5 测试点生成」/test_points.json	S4 风险点覆盖率对比基准
⑤	S4 business_flow（强制）	workflow_assets/<req_name>/<version>/「S4 流程图导出」/business_flow.md	S7 覆盖率指标 = S4 风险点全量覆盖（100%）是硬约束

---

§1.6 强制写文件（不可跳过，禁止询问）

S7 审查的产出是文件，不是对话窗口内的文字。

执行顺序（强制）：

步骤 1：调用 auto_reviewer.snapshot() 获取事实数字（不可跳过）
  ↓
步骤 2：LLM 读取 snap 输出，做语义审查
  ↓
步骤 3：调用 save_review_report() 写入文件（强制，不可跳过）

步骤 1：调用 auto_reviewer（必须先执行）

from ai_workflow.auto_reviewer import snapshot, save_review_report
from pathlib import Path

req_dir = Path("workflow_assets/<req_name>")
snap = snapshot(
    test_cases_path=req_dir / "<version>/「S6 测试用例生成」/test_cases.json",
    backlog_path=req_dir / "<version>/「S2 需求拆解」/backlog.json",
    test_points_path=req_dir / "<version>/「S5 测试点生成」/test_points.json",
)

# 输出事实数字供 LLM 使用（禁止跳过此步骤）
print(snap.ai_input_summary)
print(f"[S7] TC 填写率: {snap.structure.fill_rate:.1%}")
print(f"[S7] S5 TP 填写率: {snap.s5_structure.fill_rate:.1%}" if snap.s5_structure else "")