finishing-a-development-branch

用途：在功能开发完成时规范收尾流程，核心顺序为验证测试 → 检测环境 → 展示选项 → 执行选择 → 清理。开始时声明正在使用该技能。\n\n主要流程：先运行项目完整测试套件（如 npm test / cargo test / pytest / go test ./...），失败则报告并停止，通过后检测 Git 环境。通过 GIT_DIR 与 GIT_COMMON 对比判断普通仓库、命名分支工作树或 detached HEAD，分别给出 3 个或 2 个选项。确认分叉的 base 分支后再合并。\n\n选项：普通仓库和命名分支工作树提供三种——本地合并回 base、推送并创建 PR、保持现状；detached HEAD 只提供后两种。本地合并需切到主仓库、git pull、git merge 并在合并结果上重跑测试，通过后清理工作树并 git branch -d 删除分支。创建 PR 用 git push -u origin <feature-branch>，detached HEAD 下用 git push origin HEAD:refs/heads/<new-branch>，保留工作树供迭代。丢弃工作需明确请求并输入 discard 确认，才执行 git branch -D。\n\n清理仅针对 .worktrees/ 或 worktrees/ 下的工作树，用 git worktree remove 与 git worktree prune；拒绝移除时展示未提交文件并询问，不得擅自 --force。\n\n跨客户端：可用于 GitHub Copilot、Claude Code 和 Codex，Codex 需同步到 $CODEX_HOME/skills/finishing-a-development-branch 并重启。无需 MCP，回退时依靠本地指令、资源、shell 或编辑器工具与直接验证。\n\n限制：不处理非明确任务边界；合并失败会停止并调查；推送被拒不得擅自 force-push；不得在无证据时宣称成功。相关技能包括 verification-before-completion 与 documentation-verification。