" --body "$(cat <<'EOF' ## 摘要 <2-3 点变更内容> ## 验证计划 - [ ] <验证步骤> EOF )" ``` 然后：清理工作树（步骤 5） #### 选项 3: 保持原样报告：“保留分支 <name>。工作树保留在 <path>。” **不要清理工作树。** #### 选项 4: 丢弃 **首先确认：** ``` 这将永久删除： - 分支 <name> - 所有提交：<commit-list> - 位于 <path> 的工作树输入 'discard' 以确认。 ``` 等待确切的确认。如果已确认： ```bash git checkout <base-branch> git branch -D <feature-branch> ``` 然后：清理工作树（步骤 5） ### 步骤 5: 清理工作树 **对于选项 1, 2, 4:** 检查是否在工作树中： ```bash git worktree list | grep $(git branch --show-current) ``` 如果是： ```bash git worktree remove <worktree-path> ``` **对于选项 3:** 保留工作树。 ## 快速参考 | 选项 | 合并 | 推送 | 保留工作树 | 清理分支 | |--------|-------|------|---------------|----------------| | 1. 本地合并 | ✓ | - | - | ✓ | | 2. 创建 PR | - | ✓ | ✓ | - | | 3. 保持原样 | - | - | ✓ | - | | 4. 丢弃 | - | - | - | ✓ (强制) | ## 常见错误 **跳过逻辑验证** - **问题：** 合并有缺陷的草稿，创建失败的 PR - **修复：** 在提供选项之前始终验证 **开放式问题** - **问题：** “我接下来该做什么？” → 模棱两可 - **修复：** 展示确切的 4 个结构化选项 **自动清理工作树** - **问题：** 移除可能还需要的工作树（选项 2, 3） - **修复：** 仅对选项 1 和 4 清理 **丢弃无确认** - **问题：** 意外删除工作 - **修复：** 要求输入 "discard" 确认 ## 危险信号 **绝不：** - 在验证失败时继续 - 未在结果上验证就合并 - 未经确认删除工作 - 未经明确请求强制推送 **始终：** - 在提供选项前验证 - 展示确切的 4 个选项 - 获得选项 4 的打字确认 - 仅为选项 1 & 4 清理工作树 ## 集成 **调用者：** - **drafting** (步骤 7) - 所有任务完成后 - **execution** (步骤 5) - 所有批次完成后 **配对：** - **isolation**

--- name: sa-finalization description: 当撰写完成，所有逻辑检查通过，你需要决定如何整合工作时使用——通过展示清晰的合并、提交审阅或清理选项来指导完成开发工作 --- # 完成草稿分支 (Finishing a Draft Branch) ## 概述通过展示清晰的选项并处理所选工作流来指导完成撰写工作。 **核心原则：** 验证逻辑 → 展示选项 → 执行选择 → 清理。 **开始时声明：** “我正在使用 finalization 技能来完成这项工作。” ## 流程 ### 步骤 1: 验证逻辑 **在展示选项之前，验证逻辑检查通过：** ```bash # 运行项目的验证套件 make verify / ./scripts/check_logic.sh ``` **如果验证失败：** ``` 验证失败（个问题）。必须在完成前修复： [展示失败] 在验证通过之前无法进行合并/提交审阅。 ``` 停止。不要进行到步骤 2。 **如果验证通过：** 继续步骤 2。 ### 步骤 2: 确定基础分支 ```bash # 尝试常见基础分支 git merge-base HEAD main 2>/dev/null || git merge-base HEAD master 2>/dev/null ``` 或者问：“此草稿是从 main 分离出来的——这正确吗？” ### 步骤 3: 展示选项展示确切的这 4 个选项： ``` 撰写完成。你想做什么？ 1. 本地合并回 2. 推送并创建审阅请求 (Pull Request) 3. 保持分支原样 (我稍后处理) 4. 丢弃此草稿哪个选项？ ``` **不要添加解释** - 保持选项简洁。 ### 步骤 4: 执行选择 #### 选项 1: 本地合并 ```bash # 切换到基础分支 git checkout # 拉取最新 git pull # 合并草稿分支 git merge # 在合并结果上验证逻辑 # 如果验证通过 git branch -d ``` 然后：清理工作树（步骤 5） #### 选项 2: 推送并创建审阅请求 (PR) ```bash # 推送分支 git push -u origin # 创建 PR gh pr create --title "" --body "$(cat <<'EOF' ## 摘要 <2-3 点变更内容> ## 验证计划 - [ ] <验证步骤> EOF )" ``` 然后：清理工作树（步骤 5） #### 选项 3: 保持原样报告：“保留分支 <name>。工作树保留在 <path>。” **不要清理工作树。** #### 选项 4: 丢弃 **首先确认：** ``` 这将永久删除： - 分支 <name> - 所有提交：<commit-list> - 位于 <path> 的工作树输入 'discard' 以确认。 ``` 等待确切的确认。如果已确认： ```bash git checkout <base-branch> git branch -D <feature-branch> ``` 然后：清理工作树（步骤 5） ### 步骤 5: 清理工作树 **对于选项 1, 2, 4:** 检查是否在工作树中： ```bash git worktree list | grep $(git branch --show-current) ``` 如果是： ```bash git worktree remove <worktree-path> ``` **对于选项 3:** 保留工作树。 ## 快速参考 | 选项 | 合并 | 推送 | 保留工作树 | 清理分支 | |--------|-------|------|---------------|----------------| | 1. 本地合并 | ✓ | - | - | ✓ | | 2. 创建 PR | - | ✓ | ✓ | - | | 3. 保持原样 | - | - | ✓ | - | | 4. 丢弃 | - | - | - | ✓ (强制) | ## 常见错误 **跳过逻辑验证** - **问题：** 合并有缺陷的草稿，创建失败的 PR - **修复：** 在提供选项之前始终验证 **开放式问题** - **问题：** “我接下来该做什么？” → 模棱两可 - **修复：** 展示确切的 4 个结构化选项 **自动清理工作树** - **问题：** 移除可能还需要的工作树（选项 2, 3） - **修复：** 仅对选项 1 和 4 清理 **丢弃无确认** - **问题：** 意外删除工作 - **修复：** 要求输入 "discard" 确认 ## 危险信号 **绝不：** - 在验证失败时继续 - 未在结果上验证就合并 - 未经确认删除工作 - 未经明确请求强制推送 **始终：** - 在提供选项前验证 - 展示确切的 4 个选项 - 获得选项 4 的打字确认 - 仅为选项 1 & 4 清理工作树 ## 集成 **调用者：** - **drafting** (步骤 7) - 所有任务完成后 - **execution** (步骤 5) - 所有批次完成后 **配对：** - **isolation** - 清理由该技能创建的工作树 </article></body></html>

sa-finalization

Scan your own AI components