workflow-start

工作流起始

捆绑运行时

执行下方 CLI 命令前，请将开头的 SSF 替换为 node "<plugin-root>/scripts/spec-superflow.mjs"；<plugin-root> 是本文件上两级目录的绝对路径。切勿按字面运行 SSF，也不要调用 PATH 中的 ssf。

仅在明确请求 spec-superflow 或存在现有变更时使用。普通编码不需要 spec 工作流。

恢复

运行一次 SSF resume <change-dir> --json。该命令会综合检查状态、交接、检查点和当前计划。后续所有操作均使用返回的绝对路径 change.path：恢复过程可能会将过时的源副本重定向到记录的 worktree。遵循 next_action；除非要诊断该结果，否则不要重复运行所有组件命令。被阻止的继续操作不代表应重试；再次运行前，先解决其指出的原因。只读取与下一步操作相关的工件。

• debugging：先诊断，即使计划已过时也一样。诊断期间绝不分派符合条件的波次。
• closing：逻辑上已完成。如果记录的隔离仍有待完成的实际收尾工作，应在现有合并授权允许的前提下，将剩余操作交给 release-archivist。否则停止。
• abandoned：停止。
• 就绪的交接需要通过 SSF handoff resolve 审核；进行中的交接不会阻塞。过时的检查点仅属历史记录，不是当前依据。
• 缺失或过时的 Full 计划会阻止实施，但不会阻止调查。有效的短路径和 Tweak 不需要计划。

更新检查为可选项（SSF runtime check-update），结果会缓存且不会阻塞。恢复操作绝不能以访问网络为前提。

新请求

根据请求和仓库推断范围与风险；不要把 CLI 字段变成问卷。将变更名称验证为 changes/ 下单个安全的相对路径段，并且只创建该目录。重用已给出的授权。绝不能仅凭工件存在就推断已获批准。

仅提供以下两种路径，不要询问用户选择模式：

• 直接：请求的变更明确，且证明范围有限。在同一轮中运行 SSF workflow start <dir> --path direct --scope "<requested outcome and bounds>"。无需规划包、建议回执或执行计划。使用受影响的测试或检查；相关时可用 --verification 记录 tdd/new-test/bounded。任务数和文件数仅供参考，并非硬性限制。
• 计划式：行为或架构不确定，或用户要求制定计划。共同起草 proposal.md（范围、验收标准、风险）和 tasks.md（有序任务及证明）。仅在确有需要时添加 specs/design。根据实际代码检查一次共享接口。提交一份具体计划供批准，并重用已涵盖该计划的现有批准。然后运行 SSF workflow start <dir> --path planned --confirm --reason "<existing approval>"。CLI 会生成执行计划并进入 executing；无需 contract-builder、手写 contract、DP-0..DP-4 流程或 execution recommend。默认采用 native + final；仅在明确委托时添加 --mode sdd。

无需再次提问，继续交给 build-executor。普通调试仍处于 executing 阶段。范围变更时更新受影响的规划章节，并在实际重新批准后再次运行 planned start；不要经过中间状态。非语义性修正可使用 execution resync 并记录原因，同时保留审核历史。

通过 SSF workflow complete <dir> --verification-command "<required check command>" 完成工作。该命令会运行一次检查并保留失败结果。计划式工作还需要当前审核和已完成的任务；现有 delta specs 需要同步。用户可以通过 workflow complete --accept-risk --confirm --reason "<decision and remaining issues>" 明确接受已知风险；这会记录为 accepted-risk，而非 pass，且不会授权集成。

遗留变更

不要自动转换正在进行的遗留变更或丢弃其凭据。继续履行已记录的义务：Full/legacy Hotfix 可能仍需经过 contract-builder 和旧版审批/评审关卡；旧版 Quick/Tweak/Lightweight/direct Hotfix 使用其现有凭据。仅针对适用的旧版决策阅读 docs/decision-points.md，不要为每项任务都阅读。只有在遗留转换不明确时，才使用 SSF runtime asset read docs/state-machine.md。遗留 SSF state init 必须先于 SSF workflow recommend；选择非推荐方案时必须予以确认。遗留 Quick/direct Hotfix 在关闭前使用 workflow accept --verification 并持久化 test_result: pass；使用 SSF state set <change-dir> dp_0_timestamp now 设置可移植时间戳。

未经逐阶段交接询问，继续执行已授权的内部工作。对于所有路径，只读取当前任务的源和证据。进度更新使用一段简短文字；仅在需要作出新的重大决策时提问，不要针对已授权的工作询问“继续吗？”。