SDD MVCP 生成器模板版：执行流程（可复用）

输入

python3 scripts/sdd_mvcp_generator.py \
  --project-name "${PROJECT_NAME}" \
  --version "${VERSION}" \
  --owner "${OWNER}" \
  --prd-root "${PRD_ROOT}" \
  --out "${OUT_DIR}" \
  [--requirements-json "${REQ_JSON}"] \
  [--manifest "/path/to/custom_manifest.json"] \
  [--agent-pool "agent-1,agent-2,agent-3"] \
  [--graph-parallel-threshold 3] \
  [--graph-loop-round 2] \
  [--disable-graph]

参数含义：

• project-name：项目英文名（写入 meta.project）
• version：SDD 版本号（如 v1.0.0）
• owner：约束包 owner
• prd-root：PRD 源目录（至少包含功能/流程/界面章节）
• out：SDD 结果输出目录
• requirements-json：可选，JSON 数组或对象（{"requirements":[...]}）
• manifest：可选，自定义执行图 manifest；不传则按 PRD 文本语义推导默认规则
• agent-pool：可选，agent 可并发池（英文逗号分隔）
• graph-parallel-threshold：可选，需求数到达阈值且无高风险阻断时 M/V 可并行（默认 3）
• graph-loop-round：可选，质量门禁回灌最大轮次（默认 2）
• disable-graph：可选，关闭执行图自动生成（默认会自动生成）
• manifest 优先级：显式 manifest > 语义推导默认规则

生成物

1. 00-SDD-生成记录.md：生成上下文
2. 01-M-模型设计.md
3. 02-V-界面与交互.md
4. 03-C-控制与接口.md
5. 04-P-流程与状态流转.md
6. 05-实施约束与依赖.md
7. 06-验收与测试锚点.md
8. sdd-mvcp-contract.json
9. sdd_exec_graph_manifest.json（默认自动生成，--disable-graph 不输出）
10. sdd-graph.mmd（--disable-graph 不输出）
11. sdd-graph.runbook.json（--disable-graph 不输出）
12. unit_matrix.json（--disable-graph 不输出）
13. handoff_bundle.md（--disable-graph 不输出）

下一步（必须做）

• 按 sdd_mvcp_contract_schema.json 校验 json 可解析性
• 按 sdd-mvcp-checklist.md 逐项填写
• 对 PRD 每条需求生成 acceptance_matrix 覆盖项
• 若有字段/接口仍有空白，不能进入 coding
• 读取 sdd-graph.runbook.json 作为 wave/agent 分配依据并并发执行

一键自检（快速验收）

# 建议先设置到可复现环境
export PRD_ROOT="/tmp/sdd_100_a"
export PROJECT_NAME="DemoProj"
export VERSION="v1.0.0"
export OWNER="ops"

# 一键跑闭环：py_compile + 4 场景重放 + schema/产物可验证
bash scripts/sdd_selfcheck.sh ./SDD/selfcheck

仅检查已生成目录（不重放）：

bash scripts/sdd_selfcheck.sh check ./SDD/selfcheck/default_graph