CLI Reference

CLI 速查

npx spec-superflow list

命令	说明
ssf list	列出 changes 与状态。
ssf validate <dir>	验证 proposal、specs 等工件。
ssf doctor	检查版本、hooks、skills 与文档一致性。
ssf state <sub> <dir>	管理 .spec-superflow.yaml。
ssf workflow recommend/select/show	推荐、确认和显示工作流路径。
ssf execution recommend/plan/show/revise/review	管理 full/hotfix 的执行模式、waves 和评审收据。
ssf checkpoint save/list/show	保存或查看任务级恢复点。
ssf resume [change]	返回只读恢复摘要；唯一 active change 时自动选择。
ssf switch <change>	返回指定 change 的只读恢复上下文。
ssf handoff create/list/finish/resolve	管理显式的 research、prototype、experiment handoff。
ssf inject <dir>	生成指定平台的 phase guard。
ssf audit <dir>	生成决策点审计报告。
ssf version <semver>	同步 manifest 中的版本号。

执行计划示例

ssf execution recommend changes/my-change \
  --wave foundation:parallel:1.1,1.2 \
  --wave integration:serial:2.1:foundation --json

ssf execution plan changes/my-change --mode sdd --confirm \
  --reason "independent work" \
  --wave foundation:parallel:1.1,1.2 \
  --wave integration:serial:2.1:foundation

选择不同于推荐结果的模式时，必须额外使用 --acknowledge-recommendation，将已知风险写入审计记录。Batch Inline 始终是串行执行，不能作为并行 SDD 的替代品。