用途:作为 spec-superflow 的主入口,本身不直接实现功能,而是检查当前变更上下文、判断工作流状态、路由到正确的下一个技能,并阻止非法转换。当用户说“继续”“恢复此变更”“开始新工作流”“帮我判断下一步”“开始实现”“写规格”等,或当前产物无法明确下一步技能时,应首先调用它。
主要能力:识别 exploring、specifying、bridging、approved-for-build、executing、debugging、closing、abandoned 等状态;检查变更目录中的 proposal.md、specs/、design.md、tasks.md、execution-contract.md;通过内容比对检测过期产物(如契约意图锁与提案范围不一致、规格需求无对应任务等);按配置感知路由,可运行 bash "${CLAUDE_PLUGIN_ROOT}/scripts/get-config" artifacts.order 与 artifacts.skip;检测 full、hotfix、tweak 模式并校验文件数、模块数、schema 变更等条件,不满足则升级为 full。
使用方式:路由前先检查状态与配置,必要时运行 ssf state get <change-dir> workflow;路由到各技能前执行守卫检查,例如 node scripts/guard/guard.mjs check <dir> exploring specifying --json,退出码非 0 则阻止并报告失败。每次成功状态转换后提示运行 ssf inject <change-dir>。输出需明确当前状态、判定依据和下一个技能;涉及决策点时标注 DP-3 契约批准、DP-4 执行模式选择、DP-5 调试升级、DP-7 归档确认。
适用场景:变更流程推进、状态不明确、需要判断下一步、执行前校验、调试后恢复、评审与归档衔接等。
限制:不得在规划产物或 execution-contract.md 缺失时进入实现;不得把“继续”当作跳过状态检查的许可;契约过期须回退到 bridge-contract;有 bug 未调查不得继续实现;未代码评审不得进入收尾;abandoned 为终态,不可从该状态转换,也不可在未获用户确认时自动放弃。具体配置项、脚本行为与决策点细节以项目文档为准,资料未提供更多实现细节。