SuperAPI AI 工具集

speckit-proc

通用与其它

查看项目

更新于 10-15 21:41

技能介绍

用途:speckit-proc 用于实现需要改代码的 GitHub Issue,也适用于任何经由 speckit 流程分派的开发任务;资料称其是经 Pylot crews 分派的所有代码任务的强制流程。

主要能力:把 Issue 到 PR 的过程拆成 7 个阶段——01-preflight(预检)、02-specify、03-plan、04-tasks、05-implement、06-test、07-deliver。每个阶段在各自的 CONTEXT.md 中有明确契约(Inputs/Process/Outputs),按契约读入、执行、写出;阶段间以交接文件传递,输出写入 .procedure-output/speckit-proc/ 对应子目录。

使用方式:接受两个位置参数——Issue 编号与 org/repo(如 fellowship-dev/pylot)。执行前先创建输出目录:mkdir -p ".procedure-output/speckit-proc",再读取 CONTEXT.md 获取阶段链与 worker 会话信息,然后逐阶段顺序执行:读取 stages/0N-<name>/CONTEXT.md、按 Inputs 表加载输入、严格照 Process 步骤执行、运行 Audit 检查直到全部通过、在检查点按需暂停、最后写出 handoff 并输出结果标记 [pylot] outcome="speckit-proc complete: <summary>" status=success。支持 --stage N 从第 N 阶段恢复(跳过前面阶段并读取其 handoff,缺失则 status=failed),以及 --review 在含 Checkpoints 的阶段完成后暂停并 status=review。

前置条件:需要 gh CLI 且 GH_TOKEN 有效,以及 worker 调度脚本(支持 --resume 的 spawn-worker.sh、wait-for-worker.sh)。可用 gh issue view $0 --repo $1 --json state --jq '.state' 检查问题可访问性。

关键限制:必须遵守阶段契约,只加载 Inputs 表指定的内容,输出前须通过 Audit;参考文件而非先前 handoff 才是权威;一次只处理一个阶段、不得提前阅读后续阶段;01 预检不可跳过;只创建一个 worker 会话,02 创建、03-07 复用它。官方页面未提供定价、平台支持与效果数据。