SuperAPI AI 工具集

speckit-runner

编程与开发

查看项目

更新于 10-15 21:41

技能介绍

用途:针对 GitHub issue $0 在仓库 $1 中运行 speckit 流水线,由本会话充当操作员,驱动一个生产者 worker 走完 speckit 各阶段,再让独立审查 worker 复核已推送的检查点,最后才创建 PR。

主要能力:分阶段执行 speckit.preflight(预检与规格)、plan(计划与任务,并生成不变量矩阵)、implement(实现、验证与检查点),支持断点续跑(通过 issue 状态与已存在 PR/唯一分支进行对账)。内置两个校验脚本:validate-invariant-matrix.sh(模式门,校验单个 TSV 矩阵的表头、13 列、稳定 INV-NNN ID、允许的 class/state 值、provenance/evidence 完整性及 passed/failed 行)和 validate-review-output.sh(覆盖门,校验审查者对每行给出 ROW INV-NNN verdict,覆盖须完整)。

使用方式:依据环境变量运行——网关 $PYLOT_API 或 $PYLOT_GATEWAY_URL,令牌 $PYLOT_DISPATCH_TOKEN,任务 $PYLOT_JOB_ID,仓库 $1 或 $PYLOT_REPO。会话开始定义 cleanup_supervisor_checkout 并用 EXIT trap 清理 worktree。先做 Step 0 对账(issue 已 CLOSED 或已有打开 PR 则输出对应 marker 后终止),再 Step 1 通过 curl 调用 worker API 生成 worker。每阶段排队提示后用打包的 poll-worker.sh 轮询:bash ~/.claude/skills/speckit-runner/poll-worker.sh "$WID" "$TURN_SEQ",在 POLL_RESULT=running 时重复运行;约 30 分钟出现 POLL_RESULT=block_elapsed 时依据心跳与输出变更决定是否再给一个 block;ceiling_timeout 则失败。终止前必须运行 Step C 清理并保留推送的 Git 检查点。

限制与注意:Step P 必须同步执行,不得设置长超时、不得后台化、不得等待通知,也不得在 worker turn 进行中结束回合——后台化轮询会导致任务失败。心跳新鲜(<约5分钟)应继续,陈旧(>约10分钟)才判定卡死。审查者失败时只停止审查者并记录 review 不可用,继续用生产者检查点。以上为资料所述机制;其余细节(如具体计费、支持平台)暂未提供。