القائمة
实现完成、所有测试通过且需要决定如何集成工作时使用 - 指导完成开发工作
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
何时使用需要为编程项目、monorepo 或多级目录创建/更新 AGENTS.md、CLAUDE.md 软链接、项目级 agent 操作手册、子目录局部规则、验证命令和 Coding Agent 上下文边界时使用。
分析代码库结构并生成中文 token-lean 架构文档。
用于构建或维护个人 LLM 驱动的知识库。触发词：将资料导入 wiki、查询 wiki 知识、检查 wiki 质量、'添加到 wiki'、'我了解什么关于'，或任何提到 'LLM wiki' 的场景。
当有书面实施计划要在单独会话中执行并带审查检查点时使用
用户明确要求隔离工作区、并行分支验证或临时试验时使用 - 创建隔离的 git worktree
开始开发编程相关对话时使用 - 建立如何查找和使用 skills，在做出任何响应前要求先检查适用的 skill
| name | dev-finishing-branch |
| description | 实现完成、所有测试通过且需要决定如何集成工作时使用 - 指导完成开发工作 |
通过展示清晰选项和处理选定工作流来指导开发工作的完成。
核心原则： 验证测试 → 展示选项 → 执行选择 → 清理。
开始时宣布： "我正在使用完成开发分支 skill 来完成此工作。"
展示选项前，验证测试通过：
# 运行项目测试套件
npm test / cargo test / pytest / go test ./...
如果测试失败：
测试失败（<N> 失败）。必须先修复：
[显示失败]
测试通过前无法继续合并/PR。
停止。不要继续步骤 2。
如果测试通过： 继续步骤 2。
# 尝试常见基础分支
git merge-base HEAD main 2>/dev/null || git merge-base HEAD master 2>/dev/null
或问："此分支从 main 分离 - 正确吗？"
精确展示这 4 个选项：
实现完成。你想做什么？
1. 本地合并回 <base-branch>
2. 推送并创建 Pull Request
3. 保持分支原样（我稍后处理）
4. 丢弃此工作
选择哪个选项？
不要添加解释 - 保持选项简洁。
# 切换到基础分支
git checkout <base-branch>
# 拉取最新
git pull
# 合并功能分支
git merge <feature-branch>
# 验证合并结果上的测试
<test command>
# 如果测试通过
git branch -d <feature-branch>
然后：清理 worktree（步骤 5）
# 推送分支
git push -u origin <feature-branch>
# 创建 PR
gh pr create --title "<标题>" --body "$(cat <<'EOF'
## 总结
<2-3 点变更内容>
## 测试计划
- [ ] <验证步骤>
EOF
)"
然后：清理 worktree（步骤 5）
报告："保持分支 <名称>。Worktree 保留在 <路径>。"
不要清理 worktree。
先确认：
这将永久删除：
- 分支 <名称>
- 所有提交：<提交列表>
- <路径> 的 worktree
输入 'discard' 确认。
等待确切确认。
如果确认：
git checkout <base-branch>
git branch -D <feature-branch>
然后：清理 worktree（步骤 5）
对于选项 1、2、4：
检查是否在 worktree 中：
git worktree list | grep $(git branch --show-current)
如果是：
git worktree remove <worktree-path>
对于选项 3： 保持 worktree。
| 选项 | 合并 | 推送 | 保持 Worktree | 清理分支 |
|---|---|---|---|---|
| 1. 本地合并 | ✓ | - | - | ✓ |
| 2. 创建 PR | - | ✓ | ✓ | - |
| 3. 保持原样 | - | - | ✓ | - |
| 4. 丢弃 | - | - | - | ✓（强制） |
跳过测试验证
开放式问题
自动 worktree 清理
丢弃无确认
绝不：
总是：
被以下调用：
配对：