name	finishing-a-development-branch
description	实现完成、测试通过、要决定如何合入时使用：先验证测试，再给 4 个清晰选项（本地合并 / PR / 保留 / 丢弃），然后执行并清理。

Finishing a Development Branch

概述

在开发分支完成、测试通过、需要决定怎么把工作合入时，给出清晰选项并执行选中的工作流。

核心原则： 验证测试 → 给选项 → 执行选择 → 清理。

流程

Step 1：验证测试

给选项之前必须确认测试通过：

# 按项目跑对应的测试
npm test / cargo test / pytest / go test ./...

测试失败：

Tests failing (<N> failures)。必须先修才能完成：

[展示失败]

测试过之前不能 merge / PR。

停。不要进入 Step 2。

测试通过： 进入 Step 2。

Step 2：确定基线分支

# 常见 base 分支
git merge-base HEAD main 2>/dev/null || git merge-base HEAD master 2>/dev/null

或问："本分支基于 main，对吗？"

Step 3：给出选项

严格给这 4 个：

实现完成。你想怎么做？

1. 本地合回 <base-branch>
2. Push 并创建 Pull Request
3. 保留分支（我稍后处理）
4. 丢弃这份工作

选哪个？

不要加解释 —— 选项保持简洁。

Step 4：执行选择

Option 1：本地 merge

# 切到 base branch
git checkout <base-branch>

# 拉最新
git pull

# 合入 feature branch
git merge <feature-branch>

# 在合并结果上跑测试
<test command>

# 测试通过
git branch -d <feature-branch>

然后：清理 worktree（Step 5）。

Option 2：Push 并创建 PR

# Push 分支
git push -u origin <feature-branch>

# 创建 PR
gh pr create --title "<title>" --body "$(cat <<'EOF'
## Summary
<2-3 bullets of what changed>

## Test Plan
- [ ] <verification steps>
EOF
)"

或者直接调 MCC 的 /prp-pr 命令——它会自动分析 commit 历史、起草 PR 描述、push 新分支。本 skill 里只给最小命令，复杂场景走那条命令。

然后：清理 worktree（Step 5）。

Option 3：保留原状

报告："保留分支。Worktree 保留在。"

不清理 worktree。

Option 4：丢弃

必须先确认：

这将永久删除：
- 分支 <name>
- 所有 commit：<commit-list>
- <path> 处的 worktree

输入 'discard' 确认。

等待精确的确认字。

确认后：

git checkout <base-branch>
git branch -D <feature-branch>

然后：清理 worktree（Step 5）。

Step 5：清理 worktree

对 Options 1、2、4：

检查是否在 worktree 里：

git worktree list | grep $(git branch --show-current)

是则：

git worktree remove <worktree-path>

对 Option 3： 保留 worktree。

速查

Option	Merge	Push	保留 Worktree	清理 Branch
1. 本地 merge	✓	-	-	✓
2. 建 PR	-	✓	✓	-
3. 保留	-	-	✓	-
4. 丢弃	-	-	-	✓（强制）

常见错误

跳过测试验证

问题： 合入坏代码或造出失败的 PR
修法： 给选项前永远先验证测试

开放式问话

问题： "下一步做什么？" → 含糊
修法： 精确给 4 个结构化选项

自动清理 worktree

问题： 在可能还需要的时候清掉（Option 2、3）
修法： 只对 Options 1 和 4 清理

丢弃无确认

问题： 误删工作
修法： 要求精确输入 'discard'

红旗

永远不要：

带着失败测试继续
merge 后不在合并结果上再跑一次测试
无确认就删工作
无明确请求就 force push

永远：

给选项前验证测试
精确给 4 个选项
Option 4 要求用户打 'discard'
只对 Options 1 和 4 清理 worktree

与 MCC 生态的配合

被以下场景调用：

subagent-driven-development（Step 7）—— 全部 task 完成后
实现完成后的任何收尾节点

配套使用：

using-git-worktrees —— 清理由该 skill 建出来的 worktree
/prp-pr —— 选 Option 2 时的首选命令，自动处理 PR 分析、push、创建
/prp-commit —— 合并前还有未提交工作时用

Más de este repositorio

mismo repositorio

codex-audit

18811184907/mcc

Claude 用 codex CLI 做差异化对抗审查 + Layer 2 二审 + auto-fix 全链路。**v2.8.0 起流式 streaming**：codex 思考过程实时事件流（onEvent 回调每个 thread.started / item.completed / turn.completed），idle-timeout（90s 没新事件才算卡死）替代固定 totalTimeout。runCodexAudit 是 async，要 await。三层架构：Layer 1 codex (OpenAI) 流式产 finding → Layer 2 finding-validator subagent (Claude fresh) 独立复现 → Layer 3 通过自动 Edit 修不询问用户。触发：/plan 完成 / /implement 大改动 / /review 3 路并行 / /pr 4 路 PR 预检。codex 是不同模型 = 不同盲区，跟 Claude 互补不替代。**全自动 — 用户从不需要手动管 codex**。

2026-04-304

user-vault

18811184907/mcc

Claude 自动接管用户级跨项目敏感配置（personal API key / 个人 PAT / git 全局身份 / 跨项目 SSH host）。触发：用户提到跨项目通用 secret、或 project-vault 检测到条目应提升到用户级、或用户问'跨项目共用 secret 放哪'。写 ~/.claude/USER_VAULT.md，hook 自动 sync 到 .user-env.{sh,ps1} + git --global + ~/.ssh/config。与 project-vault 分工：本 skill 跨项目，project-vault 单项目。

2026-04-294

claudemd-sync

18811184907/mcc

Claude 主动沉淀用户跨项目偏好到 ~/.claude/CLAUDE.md，post-hook 自动 commit+push 到 dotfiles repo 跨设备同步。触发：用户说'记下这个偏好 / 沉淀到 CLAUDE.md / 把这个习惯加进去'、用户连续多次重复同样反馈（'又忘了'）、或做了跨项目通用决策（'以后所有项目都用 zod'）。仅追加不覆盖。与 continuous-learning-v2 分工：本 skill 主动显式沉淀偏好，learning-v2 被动观察行为。

2026-04-294

database-schema-doc

18811184907/mcc

Claude 自动维护 docs/SCHEMA.md。触发：用户提到表结构（'加 users 表，字段 email/password'）、写改 ORM 模型（Prisma/SQLAlchemy/TypeORM）、写改 migration SQL、或问'数据库表结构在哪'。不存在自动建（从 ORM 抽骨架），存在直接 Edit 加表/字段；业务含义缺失填 '_TODO_' 占位。与 architecture-decision-records 分工：本 skill 记结构现状，ADR 记选型决策（如选 Postgres）。

2026-04-294

dev-changelog

18811184907/mcc

Claude 自动维护开发实时流水日志 docs/CHANGELOG-DEV.md，记**正在发生**的需求/进度/坑/下一步。触发：用户讲新需求或改主意（◇）、Claude 完成 ≥30 行或跨文件改动（✓）、遇 blocker（⚠）、决定下一步（→）。与 git log（已落盘代码）/ ADR（终态决策）/ SCHEMA（结构）/ mistakes（bug 根因）分工——本 skill 记进行中状态。每条 ≤5 行倒序。

2026-04-294

project-vault

18811184907/mcc

Claude 自动接管项目级敏感配置（API key / DB 密码 / 部署 IP / SSH / token）。触发：用户在对话里说出任何 secret 或 IP、或代码里硬编 secret、或问 '.env 怎么放 / token 存哪'。写 .claude/PROJECT_VAULT.md，hook 自动 sync 到 .env.local + .env.example + ~/.ssh/config + SECRETS-INDEX.md，强制 .gitignore。与 user-vault 分工：本 skill 单项目，跨项目用 user-vault。

2026-04-294

name	finishing-a-development-branch
description	实现完成、测试通过、要决定如何合入时使用：先验证测试，再给 4 个清晰选项（本地合并 / PR / 保留 / 丢弃），然后执行并清理。

Finishing a Development Branch

概述

在开发分支完成、测试通过、需要决定怎么把工作合入时，给出清晰选项并执行选中的工作流。

核心原则： 验证测试 → 给选项 → 执行选择 → 清理。

流程

Step 1：验证测试

给选项之前必须确认测试通过：

# 按项目跑对应的测试
npm test / cargo test / pytest / go test ./...

测试失败：

Tests failing (<N> failures)。必须先修才能完成：

[展示失败]

测试过之前不能 merge / PR。

停。不要进入 Step 2。

测试通过： 进入 Step 2。

Step 2：确定基线分支

# 常见 base 分支
git merge-base HEAD main 2>/dev/null || git merge-base HEAD master 2>/dev/null

或问："本分支基于 main，对吗？"

Step 3：给出选项

严格给这 4 个：

实现完成。你想怎么做？

1. 本地合回 <base-branch>
2. Push 并创建 Pull Request
3. 保留分支（我稍后处理）
4. 丢弃这份工作

选哪个？

不要加解释 —— 选项保持简洁。

Step 4：执行选择

Option 1：本地 merge

# 切到 base branch
git checkout <base-branch>

# 拉最新
git pull

# 合入 feature branch
git merge <feature-branch>

# 在合并结果上跑测试
<test command>

# 测试通过
git branch -d <feature-branch>

然后：清理 worktree（Step 5）。

Option 2：Push 并创建 PR

# Push 分支
git push -u origin <feature-branch>

# 创建 PR
gh pr create --title "<title>" --body "$(cat <<'EOF'
## Summary
<2-3 bullets of what changed>

## Test Plan
- [ ] <verification steps>
EOF
)"

或者直接调 MCC 的 /prp-pr 命令——它会自动分析 commit 历史、起草 PR 描述、push 新分支。本 skill 里只给最小命令，复杂场景走那条命令。

然后：清理 worktree（Step 5）。

Option 3：保留原状

报告："保留分支。Worktree 保留在。"

不清理 worktree。

Option 4：丢弃

必须先确认：

这将永久删除：
- 分支 <name>
- 所有 commit：<commit-list>
- <path> 处的 worktree

输入 'discard' 确认。

等待精确的确认字。

确认后：

git checkout <base-branch>
git branch -D <feature-branch>

然后：清理 worktree（Step 5）。

Step 5：清理 worktree

对 Options 1、2、4：

检查是否在 worktree 里：

git worktree list | grep $(git branch --show-current)

是则：

git worktree remove <worktree-path>

对 Option 3： 保留 worktree。

速查

Option	Merge	Push	保留 Worktree	清理 Branch
1. 本地 merge	✓	-	-	✓
2. 建 PR	-	✓	✓	-
3. 保留	-	-	✓	-
4. 丢弃	-	-	-	✓（强制）

常见错误

跳过测试验证

问题： 合入坏代码或造出失败的 PR
修法： 给选项前永远先验证测试

开放式问话

问题： "下一步做什么？" → 含糊
修法： 精确给 4 个结构化选项

自动清理 worktree

问题： 在可能还需要的时候清掉（Option 2、3）
修法： 只对 Options 1 和 4 清理

丢弃无确认

问题： 误删工作
修法： 要求精确输入 'discard'

红旗

永远不要：

带着失败测试继续
merge 后不在合并结果上再跑一次测试
无确认就删工作
无明确请求就 force push

永远：

给选项前验证测试
精确给 4 个选项
Option 4 要求用户打 'discard'
只对 Options 1 和 4 清理 worktree

与 MCC 生态的配合

被以下场景调用：

subagent-driven-development（Step 7）—— 全部 task 完成后
实现完成后的任何收尾节点

配套使用：

using-git-worktrees —— 清理由该 skill 建出来的 worktree
/prp-pr —— 选 Option 2 时的首选命令，自动处理 PR 分析、push、创建
/prp-commit —— 合并前还有未提交工作时用