名称: 安全工作流程 描述: SAFe开发工作流程指导,包括分支命名约定、提交消息格式、rebase优先工作流程和CI验证。适用于开始处理Linear工单、准备提交、创建分支、编写PR描述或询问贡献指南时。
SAFe工作流程技能
模板: 此技能使用
{{TICKET_PREFIX}}作为占位符。替换为您项目的工单前缀(例如WOR、PROJ、FEAT)。
目的
通过标准化的分支命名、提交消息格式和rebase优先合并策略,强制执行符合SAFe的git工作流程。
适用场景
- 开始处理工单时
- 创建提交或分支时
- 询问PR工作流程或贡献指南时
- 询问“我应该如何提交这个?”时
分支命名约定
格式: {{TICKET_PREFIX}}-{number}-{short-description}
# 好例子
{{TICKET_PREFIX}}-447-create-safe-workflow-skill
{{TICKET_PREFIX}}-123-fix-login-redirect
# 坏例子
feature/add-dark-mode (缺少工单号)
john-new-feature (个人命名)
提交消息格式
格式: type(scope): description [{{TICKET_PREFIX}}-XXX]
| 类型 | 使用场景 |
|---|---|
| feat | 新功能 |
| fix | 错误修复 |
| docs | 仅文档 |
| refactor | 代码重构 |
| test | 添加或更新测试 |
| chore | 维护、依赖项 |
feat(harness): create safe-workflow skill [{{TICKET_PREFIX}}-447]
fix(auth): resolve login redirect [{{TICKET_PREFIX}}-57]
Rebase优先工作流程
# 1. 从最新的main开始
git checkout {{MAIN_BRANCH}} && git pull origin {{MAIN_BRANCH}}
# 2. 创建功能分支
git checkout -b {{TICKET_PREFIX}}-{number}-{description}
# 3. 提交更改
git commit -m "type(scope): description [{{TICKET_PREFIX}}-XXX]"
# 4. 推送前 - rebase
git fetch origin && git rebase origin/{{MAIN_BRANCH}}
# 5. 使用force-with-lease推送
git push --force-with-lease
提交PR前检查清单
- 分支名称遵循约定
- 所有提交都有工单引用
- 已基于最新的main进行rebase
- CI通过:
{{CI_VALIDATE_COMMAND}}
参考
- CONTRIBUTING.md - 完整的贡献者指南
- GEMINI.md - 开发命令