SuperAPI AI 工具集

workflow-start

办公与效率

查看项目

更新于 10-16 00:03

技能介绍

用途:这是 spec-superflow 状态机工作流的主入口,只在用户明确请求 spec-superflow 或已存在活动变更时调用;普通编码不需要该工作流。

主要能力:支持恢复、启动新请求、继续执行和完成工作流。恢复时运行 SSF resume <change-dir> --json 一次,合并状态、交接、检查点和当前计划检查,返回的绝对 change.path 用于后续操作,并遵循 next_action。新请求会从请求和仓库推断范围与风险,只提供两条路径:Direct(有界证明的清晰变更)和 Planned(行为或架构不确定,或用户要求计划);有状态诊断时先诊断,不派发可用波次,关闭、放弃等状态有明确处理规则。

使用方式:执行 CLI 前必须将行首 SSF 替换为 node "<plugin-root>/scripts/spec-superflow.mjs",<plugin-root> 是本文件向上两级的绝对目录,不能字面运行 SSF 或调用 PATH 中的 ssf。Direct 路径运行 SSF workflow start <dir> --path direct --scope "<requested outcome and bounds>";Planned 路径先编写 proposal.md 和 tasks.md,再运行 SSF workflow start <dir> --path planned --confirm --reason "<existing approval>"。完成使用 SSF workflow complete <dir> --verification-command "<required check command>",用户可显式接受已知风险:workflow complete --accept-risk --confirm --reason "<decision and remaining issues>"。旧变更按其记录义务恢复,不自动转换或丢弃回执。

适用场景与限制:适用于明确请求或已有变更的受控工作流,诊断、关闭、放弃有独立规则。更新检查可选且非阻塞,网络访问不得作为恢复前提。资料未提供具体收费、平台或效果信息。