Git PR 多智能体工作流
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/git-pr-workflows-git-workflow。
技能介绍
问题背景
从本地改完代码到 PR 可合并,中间往往散落着风格与安全审查、破坏性变更梳理、测试与覆盖率、Conventional Commits 文案、分支策略以及 PR 描述与元数据配置。若全靠人工串这些步骤,容易漏检、上下文在工具之间断裂,或在未就绪时就把变更推上远程。
技能如何工作
本技能把上述链路编排成 五个阶段,各阶段通过 Task 调用不同 subagent_type,并把上一阶段的结构化输出写入下一阶段提示词。
- 提交前审查与分析:
code-reviewer对未提交变更做质量评估(JSON 报告含严重级别);再次用审查智能体做依赖与破坏性变更分析。 - 测试与验证:
unit-testing::test-automator跑单元/集成/E2E(视情况),产出覆盖率与失败清单;随后做测试差距与补充场景建议。 - 提交信息生成:审查智能体按 Conventional Commits 做变更分类与是否拆提交的建议;
llm-application-dev::prompt-engineer生成符合规范的 subject/body/BREAKING CHANGE。 - 分支策略与推送准备:
cicd-automation::deployment-engineer按--trunk-based或默认--feature-branch准备分支与冲突检查,并做推送前终检(敏感信息、分支保护、审查项是否闭环)。 - Pull Request 创建:
documentation-generation::docs-architect写 GitHub 风格 PR 描述;部署工程师智能体配置 reviewer、标签、关联 issue、合并策略与--draft-pr等。
可配置项包括目标分支(默认 main)、--skip-tests、--no-push、--squash、--conventional 等。文档中还定义了 成功标准(关键/高严重问题已处理、测试通过、覆盖率目标、无冲突、PR 完整等)以及合并后的 回滚流程(git revert、功能开关、热修复分支等)。
适用边界
- 任务必须与「多智能体编排的完整 Git 工作流」相关;纯领域问题或无关工具不在范围内。
--skip-tests仅应在明确知情下使用;工作流假设运行环境已具备对应 Task/subagent 能力。- 更细的示例与 playbook 见技能内
resources/implementation-playbook.md,本介绍不替代逐步执行说明。
使用场景
- 本地有一批未提交改动,需要先跑结构化 code-reviewer 报告再决定是否继续推送
- 合并前要跑单元/集成测试并核对覆盖率,同时把审查里的 critical/high 问题对应到测试覆盖
- 团队强制 Conventional Commits,需要按变更类型拆提交并生成带 BREAKING CHANGE 的说明
- 功能分支开发完成,要生成完整 PR 描述并配置 reviewer、标签与 `--draft-pr` 等元数据
适合人员
- 负责主干/功能分支策略、要在推送前做 deployment-engineer 终检的 CI 维护者
- 每次发 PR 前必须串起审查、测试与 Conventional Commit 文案的后端/feature 工程师
- 需要按 CODEOWNERS 自动指派 reviewer 并填写测试与破坏性变更章节的 Tech Lead
- 合并后出问题需按技能内回滚流程(revert、功能开关、hotfix)处理的 on-call 工程师