SuperAPI AI 工具集

spec-driven-ship

通用与其它

查看项目

更新于 10-16 09:58

技能介绍

用途:在规格驱动工作流的各道关卡均已通过后,将已归档的变更交付(ship)。该技能只做提交与推送,是可选且需用户主动进入的步骤。

主要能力与前置条件:项目根目录须存在 .spec-driven/ 目录,可用 ls .spec-driven/ 验证;若不存在,需先运行 /spec-driven-init。

执行流程:选择要交付的已归档变更(若未给出名称,检查 .spec-driven/changes/archive/ 并询问用户);仅存在于 .spec-driven/changes/<name>/ 的未归档变更会被拒绝交付。随后从 .spec-driven/changes/archive/YYYY-MM-DD-<name>/ 读取 proposal.md、design.md、tasks.md、questions.md 及 specs/ 差异文件,并确认任务已完成。若存在 .spec-driven/roadmap/,运行 node {{SKILL_DIR}}/scripts/spec-driven.js roadmap-status,若报告错误或声明值与推导值不匹配则停止。接着运行 git status -sb 检查文件与分支上游状态,向用户展示候选文件列表;若工作区存在无法归属该变更的无关或歧义改动则停止询问。之后暂存目标文件并用基于变更名的简洁信息(如 feat: add basic ship step)提交。最后用 git branch --show-current 确认当前分支,确保只推送本次新建提交;若分支在提交前已领先上游或没有上游,需先询问用户,再运行 git push,并如实报告失败。

限制:不削弱或绕过 apply、verify、review、archive、路线图核对等关卡;不交付未归档的活跃变更;不创建 PR、不部署、不发布 release、不跑 canary、不发布包、不协调多仓库交付;不新增或依赖 TypeScript ship 子命令。