| name | loom-finishing-a-development-branch |
| description | Clean up a feature branch after verification: merge, create PR, keep, or discard. Follows conventional commits. Use when: a development branch has passed verification and needs merge, PR, keep, or discard handling.
|
| when_to_use | Finish a verified development branch by choosing merge, PR, keep, or discard handling. |
| argument-hint | <branch or spec_dir> |
| user-invocable | true |
开发分支收尾
触发条件
loom-verification-before-completion 验证通过
loom-index-update 索引已更新
- 用户确认所有开发工作已完成
完成条件与下一步
- 分支已合并到主分支 / PR 已创建 / 分支已保留
- 功能开发流程结束
公告
开始时宣布:"我正在使用 loom-finishing-a-development-branch skill 来完成这项工作。"
执行流程
Step 1:确认开发完成
- 所有 task 已完成
- 所有测试通过
- 图后端状态已确认(不可用时已注明跳过)
- 无 BLOCKER
- 测试报告已生成(来自 test-reporter)
Step 2:检查分支状态
git status
git diff --stat
Step 3:运行最终验证
构建/检查/测试命令
读取 .loom/rules/constitution.md 中的 BUILD_CMD/VET_CMD/TEST_CMD 并执行验证。
Step 4:展示选项
向用户展示以下选项:
## 分支完成选项
**1. Merge(合并)** - 直接合并到主分支
**2. Pull Request** - 创建 PR 供审查
**3. Keep(保留)** - 保持分支,稍后继续
**4. Discard(丢弃)** - 丢弃所有变更
请选择?
Step 5:提交变更(如有未提交的变更)
如果分支上还有未提交的变更,先提交:
git add <specific-files>
git commit -m "$(cat <<'EOF'
feat: <功能描述>
- 变更 1
- 变更 2
Co-Authored-By: AI Assistant
EOF
)"
Step 6:执行用户选择
- Merge:
git checkout <branch> && git merge --no-ff feature/<date>-<name> && git push origin <branch>
- Pull Request:
git push -u origin feature/<date>-<name> → gh pr create --title "feat: <描述>" --body "..."
- Keep: 保持分支状态,提醒用户稍后继续
- Discard:
git checkout <branch> && git branch -D feature/<date>-<name>
提交信息规范
Conventional Commits 格式
提交信息必须遵循 Conventional Commits 格式:<type>(<scope>): <subject>
- feat: 新功能
- fix: Bug 修复
- refactor: 重构(不改变行为)
- docs: 文档
- test: 测试
- chore: 构建/工具变更
约束
- 提交前必须运行完整验证
- 提交信息必须清晰描述变更内容
- 禁止提交敏感信息(密钥、密码等)
禁止在主分支实现
没有明确用户同意,永远不要在 main/master 分支上开始实现。