name	finishing-a-development-branch
description	当实现已完成、测试已通过，需要决定如何集成这次工作时使用：通过结构化选项引导 merge/PR/保留/丢弃，并在选择后完成收尾与清理。

Finishing a Development Branch

Overview

通过给出清晰选项并执行所选 workflow，完成一次开发分支的收尾。

核心原则： Verify tests → 给选项 → 执行选择 → 清理。

开始时宣告： “我正在使用 finishing-a-development-branch skill 来完成这次工作收尾。”

The Process

Step 1：验证测试

在给选项之前，必须先验证测试通过：

# 运行项目的测试套件
npm test / cargo test / pytest / go test ./...

如果测试失败：

测试失败（<N> 个 failure）。必须先修复后才能收尾：

[展示失败信息]

在测试通过前，不能继续 merge/PR。

停止，不要进入 Step 2。

如果测试通过： 继续 Step 2。

Step 2：确定 base branch

# 尝试常见 base branch
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：执行选择

选项 1：本地合并

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

# 拉取最新
git pull

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

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

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

然后进入：清理 worktree（Step 5）

选项 2：Push 并创建 PR

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

# 创建 PR
gh pr create --title "<title>" --body "$(cat <<'EOF'
## 概述
<2-3 条变更摘要>

## 测试计划
- [ ] <验证步骤>
EOF
)"

默认保留分支与 worktree，便于后续跟进 PR（除非用户明确要求清理）。

选项 3：保留原样

汇报：“保留分支。worktree 保留在。”

不要清理 worktree。

选项 4：丢弃

必须先确认：

这会永久删除：
- 分支 <name>
- 所有 commits：<commit-list>
- worktree：<path>

输入 'discard' 以确认。

等待用户输入精确的 discard。

确认后：

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

然后进入：清理 worktree（Step 5）

Step 5：清理 worktree

对选项 1、4：

检查是否在 worktree 中：

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

如果是：

git worktree remove <worktree-path>

对选项 2、3： 保留 worktree。

Quick Reference

选项	Merge	Push	保留 Worktree	清理 Branch
1. 本地合并	✓	-	-	✓
2. 创建 PR	-	✓	✓	-
3. 保留原样	-	-	✓	-
4. 丢弃	-	-	-	✓（force）

Common Mistakes

跳过测试验证

问题： 合并坏代码 / 创建会失败的 PR
修正： 给选项前永远先验证测试

开放式问题

问题： “接下来该怎么做？”→ 语义模糊
修正： 只给 4 个结构化选项

自动清理 worktree

问题： 在仍可能需要 worktree 时把它删了（选项 2、3）
修正： 只在选项 1、4（以及按需的 2）做清理

丢弃不确认

问题： 误删工作
修正： 必须要求用户输入 discard

Red Flags

Never：

测试失败还继续
merge 后不在结果上验证测试
未确认就删除工作
未经明确请求就 force-push

Always：

给选项前验证测试
只给 4 个选项
选项 4 必须 typed confirmation
仅在需要时清理 worktree

Integration

会被调用自：

subagent-driven-development（Step 7）：全部任务完成后
executing-plans（Step 5）：全部 batch 完成后

常与其配合：

using-git-worktrees：清理该 skill 创建的 worktree

Más de este repositorio

mismo repositorio

skill-creator

lyfe2025/lyfes-coding-skills

初始化新 skill 目录（运行 init_skill.py）、打包 skill（运行 package_skill.py）、或需要了解 skill 结构规范时使用。

2026-01-254

writing-skills

lyfe2025/lyfes-coding-skills

在编写 skill 内容、验证 skill 是否有效、或需要用 TDD 方法测试 skill 能否被正确遵守时使用。

2026-01-254

frontend-master

lyfe2025/lyfes-coding-skills

Frontend Master - 大师级前端页面开发。智能分析项目技术栈，生成独特设计美感的 UI，避免'AI审美'。自动持久化设计规范，保持项目一致性。整合 Frontend-Design 设计哲学 + UI-UX Pro Max 设计数据库。触发词: 前端、页面、组件、UI、登录页、落地页、dashboard、表单、卡片、导航栏。

2026-01-254

brainstorming

lyfe2025/lyfes-coding-skills

你必须在任何创意工作之前使用：新功能、组件搭建、添加能力或修改行为。先通过对话澄清用户意图、需求与设计，再进入实现。

2026-01-254

dispatching-parallel-agents

lyfe2025/lyfes-coding-skills

当你面对 2 个以上彼此独立的任务（无共享状态、无顺序依赖）时使用：为每个独立问题域派发一个 agent 并行推进。

2026-01-254

executing-plans

lyfe2025/lyfes-coding-skills

当你已经有一份书面的 implementation plan，需要在独立 session 中按批执行并在批次间做 review checkpoint 时使用。

2026-01-254

name	finishing-a-development-branch
description	当实现已完成、测试已通过，需要决定如何集成这次工作时使用：通过结构化选项引导 merge/PR/保留/丢弃，并在选择后完成收尾与清理。

Finishing a Development Branch

Overview

通过给出清晰选项并执行所选 workflow，完成一次开发分支的收尾。

核心原则： Verify tests → 给选项 → 执行选择 → 清理。

开始时宣告： “我正在使用 finishing-a-development-branch skill 来完成这次工作收尾。”

The Process

Step 1：验证测试

在给选项之前，必须先验证测试通过：

# 运行项目的测试套件
npm test / cargo test / pytest / go test ./...

如果测试失败：

测试失败（<N> 个 failure）。必须先修复后才能收尾：

[展示失败信息]

在测试通过前，不能继续 merge/PR。

停止，不要进入 Step 2。

如果测试通过： 继续 Step 2。

Step 2：确定 base branch

# 尝试常见 base branch
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：执行选择

选项 1：本地合并

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

# 拉取最新
git pull

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

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

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

然后进入：清理 worktree（Step 5）

选项 2：Push 并创建 PR

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

# 创建 PR
gh pr create --title "<title>" --body "$(cat <<'EOF'
## 概述
<2-3 条变更摘要>

## 测试计划
- [ ] <验证步骤>
EOF
)"

默认保留分支与 worktree，便于后续跟进 PR（除非用户明确要求清理）。

选项 3：保留原样

汇报：“保留分支。worktree 保留在。”

不要清理 worktree。

选项 4：丢弃

必须先确认：

这会永久删除：
- 分支 <name>
- 所有 commits：<commit-list>
- worktree：<path>

输入 'discard' 以确认。

等待用户输入精确的 discard。

确认后：

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

然后进入：清理 worktree（Step 5）

Step 5：清理 worktree

对选项 1、4：

检查是否在 worktree 中：

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

如果是：

git worktree remove <worktree-path>

对选项 2、3： 保留 worktree。

Quick Reference

选项	Merge	Push	保留 Worktree	清理 Branch
1. 本地合并	✓	-	-	✓
2. 创建 PR	-	✓	✓	-
3. 保留原样	-	-	✓	-
4. 丢弃	-	-	-	✓（force）

Common Mistakes

跳过测试验证

问题： 合并坏代码 / 创建会失败的 PR
修正： 给选项前永远先验证测试

开放式问题

问题： “接下来该怎么做？”→ 语义模糊
修正： 只给 4 个结构化选项

自动清理 worktree

问题： 在仍可能需要 worktree 时把它删了（选项 2、3）
修正： 只在选项 1、4（以及按需的 2）做清理

丢弃不确认

问题： 误删工作
修正： 必须要求用户输入 discard

Red Flags

Never：

测试失败还继续
merge 后不在结果上验证测试
未确认就删除工作
未经明确请求就 force-push

Always：

给选项前验证测试
只给 4 个选项
选项 4 必须 typed confirmation
仅在需要时清理 worktree

Integration

会被调用自：

subagent-driven-development（Step 7）：全部任务完成后
executing-plans（Step 5）：全部 batch 完成后

常与其配合：

using-git-worktrees：清理该 skill 创建的 worktree