SuperAPI AI 工具集

spec-flow

通用与其它

查看项目

更新于 10-16 09:31

技能介绍

用途:以 action-first 方式管理长期任务的 spec 生命周期,将业务内容写入 spec.md、plan.md 与报告模板,状态更新交给工作区 runtime,避免会话中断丢失上下文。

主要能力:生命周期固定为 explore -> plan -> implement -> accept -> archive 五个 action;状态拆为 status、currentAction、runState;以 .specs/registry.json 和各 spec 的 progress.json 为唯一状态源;业务产物为 spec.md、plan.md、acceptance-report.md、archive-summary.md;slash command 是唯一用户入口,runtime 是唯一状态写入器。implement 同时适用于代码、文档、研究、流程与运营产物;accept 要求独立上下文验收,优先使用 spec-acceptance-reviewer agent,若不支持委派则在本线程模拟独立验收,遵循 findings-first;archive 先生成 archive-summary.md,仅通过 runtime archive 执行目录迁移与 registry 更新,允许延迟归档。status 与 resume 属于 runtime 查询命令,不属于生命周期 action。

使用方式:先检查工作区是否已有 .specs/bin/spec-flow.mjs,没有则执行 /spec-flow init,并将 assets/runtime/spec-flow-runtime.mjs 落地为工作区 runtime;按当前任务选择 action;需要持久化时只通过 node .specs/bin/spec-flow.mjs ... 更新状态;需要模板时使用 assets/ 下模板文件。runtime 提供 new、amend、accept、archive 等能力,由它处理 spec ID 生成、版本递增、归档迁移与原子写入。写文档前查 references/spec-schema.md,执行命令前查 references/command-contract.md,恢复中断前查 references/recovery-rules.md。模板包括 spec-template.md、plan-template.md、acceptance-report-template.md、archive-summary-template.md。

适用场景:跨会话、可恢复、可验收、可归档的长期任务,尤其需要独立验收与状态留痕的工作。

限制:不得手改 registry.json 或任何 progress.json,也不得只在 markdown 中声称状态已变化而未写 runtime;探索优先本地工作区,仅本地材料不足、涉及第三方规范或用户明确要求时才做外部研究;进入 implement 前需用户确认;无需为凑长度编造功能、价格或平台信息。