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

## 输入

```bash
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` 分配依据并并发执行

### 一键自检（快速验收）

```bash
# 建议先设置到可复现环境
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
bash scripts/sdd_selfcheck.sh check ./SDD/selfcheck/default_graph
```