
关于
编排从代码审查到 PR 创建的全面 Git 工作流,利用专业代理进行质量保证、测试和部署就绪检查。实现现代 Git 工作流最佳实践。
name: git-pr-workflows-git-workflow description: "Orchestrate a comprehensive git workflow from code review through PR creation, leveraging specialized agents for quality assurance, testing, and deployment readiness. This workflow implements modern g" risk: critical source: community date_added: "2026-02-27"
完整的 Git 工作流与多智能体编排
编排从代码审查到 PR 创建的完整 git 工作流,利用专门的智能体进行质量保证、测试和部署就绪性检查。此工作流实现了现代 git 最佳实践,包括 Conventional Commits、自动化测试和结构化 PR 创建。
[Extended thinking: This workflow coordinates multiple specialized agents to ensure code quality before commits are made. The code-reviewer agent performs initial quality checks, test-automator ensures all tests pass, and deployment-engineer verifies production readiness. By orchestrating these agents sequentially with context passing, we prevent broken code from entering the repository while maintaining high velocity. The workflow supports both trunk-based and feature-branch strategies with configurable options for different team needs.]
适用场景
- 处理完整 git 工作流与多智能体编排相关的任务或工作流
- 需要完整 git 工作流与多智能体编排的指导、最佳实践或检查清单
不适用场景
- 任务与完整 git 工作流与多智能体编排无关
- 需要此范围之外的其他领域或工具
指令
- 明确目标、约束条件和所需输入。
- 应用相关最佳实践并验证结果。
- 提供可操作的步骤和验证方法。
- 如需详细示例,请打开
resources/implementation-playbook.md。
配置
目标分支:$ARGUMENTS(如未指定则默认为 'main')
支持的标志:
--skip-tests:跳过自动化测试执行(谨慎使用)--draft-pr:将 PR 创建为草稿,用于进行中的工作--no-push:执行所有检查但不推送到远程--squash:推送前压缩提交--conventional:严格执行 Conventional Commits 格式--trunk-based:使用主干开发工作流--feature-branch:使用功能分支工作流(默认)
阶段 1:提交前审查与分析
1. 代码质量评估
- 使用 Task 工具,subagent_type="code-reviewer"
- 提示:"审查所有未提交的变更,检查代码质量问题。检查:1) 代码风格违规,2) 安全漏洞,3) 性能问题,4) 缺失的错误处理,5) 不完整的实现。生成带有严重级别(critical/high/medium/low)的详细报告,并提供具体的逐行反馈。输出格式:JSON,包含 {issues: [], summary: {critical: 0, high: 0, medium: 0, low: 0}, recommendations: []}"
- 预期输出:供下一阶段使用的结构化代码审查报告
2. 依赖与破坏性变更分析
- 使用 Task 工具,subagent_type="code-reviewer"
- 提示:"分析变更中的:1) 新依赖或版本变更,2) 破坏性 API 变更,3) 数据库 schema 修改,4) 配置变更,5) 向后兼容性问题。来自上次审查的上下文:[插入问题摘要]。识别任何需要迁移脚本或文档更新的变更。"
- 来自上一步的上下文:可能指示破坏性变更的代码质量问题
- 预期输出:破坏性变更评估和迁移需求
阶段 2:测试与验证
1. 测试执行与覆盖率
- 使用 Task 工具,subagent_type="unit-testing::test-automator"
- 提示:"对修改的代码执行所有测试套件。运行:1) 单元测试,2) 集成测试,3) 端到端测试(如适用)。生成覆盖率报告并识别任何未测试的代码路径。基于审查问题:[插入 critical/high 问题],确保测试覆盖问题区域。以以下格式提供测试结果:{passed: [], failed: [], skipped: [], coverage: {statements: %, branches: %, functions: %, lines: %}, untested_critical_paths: []}"
- 来自上一步的上下文:需要测试覆盖的关键代码审查问题
- 预期输出:完整的测试结果和覆盖率指标
2. 测试建议与差距分析
- 使用 Task 工具,subagent_type="unit-testing::test-automator"
- 提示:"基于测试结果 [插入摘要] 和代码变更,识别:1) 缺失的测试场景,2) 未覆盖的边界情况,3) 需要验证的集成点,4) 需要的性能基准。生成按风险优先排序的测试实现建议。考虑已识别的破坏性变更:[插入破坏性变更]。"
- 来自上一步的上下文:测试结果、破坏性变更、未测试路径
- 预期输出:需要的额外测试的优先级列表