name: 发布模式 description: 拉取请求创建、CI/CD验证和发布协调模式。在创建拉取请求、运行预PR验证、检查CI状态或协调合并时使用。
发布模式技能
目的
确保一致的拉取请求创建、CI/CD验证和发布协调,遵循基于变基的工作流。
何时应用此技能
在以下情况调用此技能:
- 创建拉取请求
- 运行预PR验证(
yarn ci:validate) - 检查CI/CD状态
- 协调合并时机
- 验证变基状态
停止线条件
禁止模式
# 禁止:缺少工单引用
gh pr create --title "feat: add feature" # 缺少 [{{TICKET_PREFIX}}-XXX]
# 禁止:使用压缩/合并提交
gh pr merge --squash # 破坏线性历史
gh pr merge --merge # 创建合并提交
# 禁止:跳过CI验证
git push origin feature # 未先运行 yarn ci:validate
# 禁止:未变基就推送
git push origin feature # 当分支落后于 dev 时
正确模式
# 正确:标题中包含工单引用
gh pr create --title "feat(scope): description [{{TICKET_PREFIX}}-XXX]"
# 正确:仅使用变基合并
gh pr merge --rebase --delete-branch
# 正确:推送前进行CI验证
yarn ci:validate && git push --force-with-lease
# 正确:始终先变基
git fetch origin && git rebase origin/dev
git push --force-with-lease origin {{TICKET_PREFIX}}-XXX-description
预PR检查清单(强制)
在创建任何PR之前:
- [ ] 分支名称:
{{TICKET_PREFIX}}-{number}-{description} - [ ] 提交遵循:
type(scope): description [{{TICKET_PREFIX}}-XXX] - [ ] 基于最新dev变基:
git fetch origin && git rebase origin/dev - [ ] 本地CI通过:
yarn ci:validate - [ ] 线性历史:无合并提交(
git log --oneline --graph -10)
CI/CD验证命令
# 在任何PR前强制运行
yarn ci:validate && echo "准备PR" || echo "先修复问题"
PR创建模板
gh pr create --title "feat(scope): description [{{TICKET_PREFIX}}-XXX]" --body "$(cat <<'EOF'
## 摘要
实现[功能/修复],如Linear工单 {{TICKET_PREFIX}}-XXX 中指定。
**Linear工单**: https://linear.app/{{LINEAR_WORKSPACE}}/issue/{{TICKET_PREFIX}}-XXX
## 所做更改
- 更改1
- 更改2
## 测试
```bash
yarn ci:validate
# 所有检查通过
预合并检查清单
- [x] 基于最新dev变基
- [x] CI通过
- [x] Linear工单引用
🤖 由 Claude Code 生成 EOF )"
## 合并策略
**仅**使用变基合并:
```bash
# 正确
gh pr merge --rebase --delete-branch
# 永不
gh pr merge --squash # 丢失提交历史
gh pr merge --merge # 创建合并提交
QAS门(强制)
在合并任何PR之前,调用QAS进行独立评审:
任务工具:QAS子代理
提示:"评审PR #XXX 对于 {{TICKET_PREFIX}}-YYY。验证提交格式、CI状态、模式。"
权威引用
- PR模板:
.github/pull_request_template.md - 工作流指南:
CONTRIBUTING.md(拉取请求流程部分) - CI/CD管道:
docs/CI-CD-Pipeline-Guide.md - 代理工作流SOP:
docs/sop/AGENT_WORKFLOW_SOP.md(3阶段评审链)