用途:在包含 openspec/ 目录的项目中完成开发分支收尾,替代 superpowers:finishing-a-development-branch。核心原则为验证测试→提供选项→执行选择→清理→归档规格。开始时需说明“I'm using openspec-finishing-branch to complete this work.”
流程:第一步运行项目测试套件,测试不通过即停止。第二步用 git merge-base HEAD main 2>/dev/null || git merge-base HEAD master 2>/dev/null 确定基分支。第三步给出四个选项:1 本地合并回基分支;2 推送并创建 Pull Request;3 保持分支原样;4 丢弃该工作。第四步按选择执行:本地合并用 git checkout、git pull、git merge,并在合并结果上验证测试后 git branch -d;提 PR 用 git push -u origin <feature-branch> 与 gh pr create;保留则报告并保存;丢弃需确认后删除分支。第五步清理工作树,选项 1、2、4 移除,选项 3 保留。
第六步为相对标准流程的新增步骤:归档 OpenSpec 变更。选项 1、2 先执行 openspec validate <name> --json,再执行 openspec archive <name> --yes,把增量规格合并进项目主规格基线,保留在 openspec/specs/ 中;选项 3 不归档,变更留在 openspec/changes/;选项 4 用 rm -rf openspec/changes/<name> 移除且不合并规格。归档失败时报告错误但不阻塞 git 操作,归档为建议性步骤。
限制与前提:需要项目含 openspec/ 目录并安装 OpenSpec 与 gh;测试必须先通过;选项 4 需输入确认。其他收费、平台支持等信息暂未提供。