用途:在 Grove 工作区中,当实现完成且所有测试通过后,用该技能规范化收尾流程。适用前提是当前确实处于 Grove 工作区。
主要能力:检测工作区、验证测试、读取元数据、给出结构化收尾选项并按选择执行清理或保留。
使用方式:
- 检测工作区,运行 test -f "$(git rev-parse --show-toplevel)/.grove/workspace.json";若未找到该文件,说明不在 Grove 工作区,应改用 superpowers:finishing-a-development-branch。
- 依据标记文件自动识别测试命令:go.mod 用 go test ./...,package.json 用 npm test,Cargo.toml 用 cargo test,build.gradle 或 build.gradle.kts 用 ./gradlew test,pyproject.toml 或 requirements.txt 用 pytest,Makefile 用 make test。测试失败则停止,不展示完成选项。
- 运行 cat .grove/workspace.json,提取 id、golden_copy 与 branch。
- 只给出四个选项:推送分支并创建 PR;推送分支并销毁工作区;保持工作区不变;丢弃工作并销毁工作区。
- 执行选择:选项一先 git push -u origin <branch>,再 gh pr create --title "<title>" --body "<body>",随后 grove destroy <workspace-id>,最后 cd <golden-copy-path>;选项二只执行 git push -u origin <branch> 与 grove destroy <workspace-id> 后 cd;选项三仅报告保持;选项四必须先要求用户输入 discard,再 grove destroy <workspace-id> 并 cd。
适用场景:Grove 工作区实现完成、测试通过后的统一收尾;可由 superpowers:subagent-driven-development(第 7 步)与 superpowers:executing-plans(第 5 步)调用,与 grove:using-grove 搭配,并替代 superpowers:finishing-a-development-branch。
限制与注意事项:不要跳过测试验证;不要用开放式提问,应始终给出固定四选项;选项三不得擅自运行 grove destroy;选项四销毁未提交工作,必须要求用户输入 discard。若 .grove/workspace.json 缺失但存在 .grove/config.json,说明在 golden copy 上而非工作区,应改走 superpowers:finishing-a-development-branch。若 grove destroy 失败,工作区 ID 可能已失效,可先运行 grove list 确认后再重试。