在 Claude-Flow / ruflo 中使用/github命令GitHub 九大集成模式的完整实战指南【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo关联文档.claude/commands/github/github-modes.md本仓库根级命令集与 v3 命令副本ruflo即本仓库内以 Claude-Flow / ruv-swarm 体系为核心的 Agent 元控制台在.claude/commands/github/下内置了一整套 GitHub 集成命令。本指南以github-modes.md为主干系统讲解九种按工作场景划分的集成模式工作流协调、仓库管理、集成协同三大类逐一给出其能力属性、可用工具、调用语法与适用场景同时结合同目录配套命令文档与 swarm 底层源码说明如何通过批处理、MCP 工具与 ruv-swarm 协调让这些模式跑出多智能体并行作业的效果。读完你将掌握为 PR 评审、Issue 管理、发布流程、CI/CD 与安全审计选择正确的/github子命令并用 MCP 工具调用完成可落地的 GitHub 自动化工作流。一、文档定位与命令集全貌github-modes.md是一份模式选型索引它没有把九种能力拆成碎片而是按使用场景归为三类方便你在接到具体任务时快速对号入座分类模式一句话定位GitHub Workflow Modesgh-coordinator复杂工作流与多仓库编排GitHub Workflow Modespr-managerPR 管理与评审协调GitHub Workflow Modesissue-trackerIssue 管理与项目协调GitHub Workflow Modesrelease-manager发布与部署协调Repository Management Modesrepo-architect仓库结构与多仓库组织Repository Management Modescode-reviewer自动化代码评审与质量保障Repository Management Modesbranch-managerGitFlow 分支与合并策略Integration Commandssync-coordinator多包同步与版本对齐Integration Commandsci-orchestratorCI/CD 流水线协调Integration Commandssecurity-guardian安全与合规管理在 .claude/commands/github/ 目录中这九种模式既有各自独立的命令文档如 pr-manager.md、issue-tracker.md、release-manager.md、repo-architect.md、sync-coordinator.md也有配套的 swarm 聚合命令 github-swarm.md 与多仓库场景命令multi-repo-swarm.md、swarm-pr.md、swarm-issue.md、release-swarm.md、code-review-swarm.md。同一份模式索引还以 agent 定义形式存在于 .claude/agents/github/github-modes.md说明这些模式既可以作为一次性命令由你显式唤起也可以作为具备持久上下文的Agent常驻协作。说明本仓库存在多处.claude命令/Agent 镜像根级.claude与 v3/claude-flow/cli/.claude、v3/claude-flow/mcp/.claude其github-modes.md内容一致本文以根级文档为对象讲解示例同样适用于镜像副本。二、GitHub Workflow Modes四种工作流协调模式这一组的共同特征是以ghCLI 任务跟踪TodoWrite/TodoRead 协调Task为核心适合处理端到端的 GitHub 业务流。2.1 gh-coordinator —— 工作流编排中枢当任务涉及多个仓库、多步骤、跨模块协同时gh-coordinator是首选入口。协调模式Hierarchical分层协调最大并行数10批处理优化是可用工具ghCLI 命令、TodoWrite、TodoRead、Task、Memory、Bash调用语法/github gh-coordinator GitHub workflow description最佳场景复杂 GitHub 工作流、多仓库协调所谓 Hierarchical 协调是让一个协调者拆解任务并分派给多级子 Agent这与 swarm MCP 工具中swarm_init { topology: hierarchical }的拓扑语义一一对应详见第六节源码分析。同时该模式的Memory工具暗示其具备跨步骤记忆保持能力可在多轮工作流中共享仓库上下文。2.2 pr-manager —— PR 全生命周期管理评审模式Automated自动评审多评审人支持冲突解决Intelligent智能冲突解决可用工具gh pr create、gh pr view、gh pr review、gh pr merge、TodoWrite、Task调用语法/github pr-manager PR management task最佳场景PR 评审、合并协调、冲突解决配套文档 pr-manager.md 给出了更细的工具面除了 gh 命令它还能经由mcp__github__create_pull_request、get_pull_request、list_pull_requests、create_pull_request_review、merge_pull_request、get_pull_request_files、get_pull_request_status、update_pull_request_branch等 MCP 工具与 GitHub 对话并挂接 swarm 记忆与自动重试网络失败重试、合并冲突智能处理、评审瓶颈负载均衡。典型完整生命周期见该文档的批处理示例初始化评审 swarm →gh pr create→gh pr review 54 --approve→npm test npm run lint npm run build→TodoWrite跟踪三项状态。2.3 issue-tracker —— Issue 与项目进度协调Issue 工作流Automated标签管理Smart智能打标进度跟踪Real-time实时可用工具gh issue create、gh issue edit、gh issue comment、gh issue list、TodoWrite调用语法/github issue-tracker issue management task最佳场景项目管理、Issue 协调、进度跟踪配套文档 issue-tracker.md 内置了两套可直接复用的模板集成任务模板含 Dependencies / Functionality / Testing 三组验收清单与Bug 报告模板含问题描述、期望/实际行为、复现步骤、环境、排查计划、swarm 分工。它还演示了多 Issue 项目协调用search_issues检索同标签/同状态的关联 Issue 后批量更新 labels、milestone并把进度写入 swarm 记忆键issue/n/progress实现跨 Agent 的实时状态同步。2.4 release-manager —— 发布协调与部署发布流水线Automated版本化Semantic语义化版本部署Multi-stage多阶段可用工具gh pr create、gh pr merge、gh release create、Bash、TodoWrite调用语法/github release-manager release task最佳场景发布管理、版本协调、部署流水线该模式与仓库中的发布实践相互印证本仓库根目录与各插件都维护CHANGELOG.md如 CHANGELOG.md、v3/claude-flow/cli/CHANGELOG.md并存在 prepare-root-publish.mjs、prepare-publish.mjs 等发布脚本——release-manager正是把打标签、改版本、创建 release这类语义化发布动作交给 Agent 统一协调的入口。三、Repository Management Modes三种仓库管理模式这一组偏重仓库本身的结构、质量与分支治理工具面更多落在gh repo、git与文件读写上。3.1 repo-architect —— 仓库结构与多仓库组织结构优化支持多仓库支持模板管理Advanced可用工具gh repo create、gh repo clone、git命令、Write、Read、Bash调用语法/github repo-architect repository management task最佳场景仓库初始化、结构优化、多仓库管理提示仓库根级 AGENTS.md 与本仓库大量 monorepo 实践crates/、plugins/、v3/多包共存都印证了结构即约定的组织思路使用repo-architect做新仓库初始化时可结合 CONTRIBUTING.md 与各插件 README 来生成一致的目录骨架。3.2 code-reviewer —— 自动化评审与质量保障评审深度Deep安全分析支持性能检查Automated可用工具gh pr view --json files、gh pr review、gh pr comment、Read、Write调用语法/github code-reviewer review task最佳场景代码质量、安全评审、性能分析gh pr view --json files用于先取出 PR 改动文件清单再交给评审 Agent 逐文件Read/Write。这与仓库中的评审驱动实践一致根级存在 .claude/agents/reviewer.yaml 等角色定义并有独立子命令 code-review.md 与 code-review-swarm.md。仓库还专门编写了audit-*.mjs、smoke-*.mjs系列脚本如 audit-tool-descriptions.mjs、smoke-github-actions-pins.mjs可作为评审 Agent 在本地补强安全/合规维度的检测抓手。3.3 branch-manager —— 分支与合并策略治理分支策略GitFlow合并策略Intelligent冲突预防Proactive主动预防可用工具gh api用于分支操作、git命令、Bash调用语法/github branch-manager branch management task最佳场景分支协调、合并策略、工作流管理注意该模式以gh api而非gh branch之类的命令驱动分支操作——GitHub 本身没有gh branch子命令因此文档刻意用gh api直接调 REST/GraphQL 端点完成基于上游更新分支校验保护分支规则等操作。四、Integration Commands三种集成协同模式这一组是面向开发流程中需要横向打通的场景多包版本、CI/CD 状态、安全基线。4.1 sync-coordinator —— 多包同步与版本对齐包同步Intelligent版本对齐Automatic依赖解析Advanced可用工具git命令、gh pr create、Read、Write、Bash调用语法/github sync-coordinator sync task最佳场景包同步、版本管理、依赖更新原文档的示例即同步 claude-code-flow 与 ruv-swarm 两包、对齐版本并更新交叉依赖——这种场景正是 monorepo 日常。本仓库有真实参照package.json使用package-lock.json与pnpm-lock.yaml双锁文件、pnpm-workspace.yaml 声明工作区多个 crates 子包共享根级 Cargo.tomlworkspacev3/claude-flow/*又是独立 TS 包群跨包版本对齐与依赖升级正是sync-coordinator的用武之地。4.2 ci-orchestrator —— CI/CD 流水线协调流水线管理Advanced测试协调Parallel并行部署Automated可用工具gh pr checks、gh workflow list、gh run list、Bash、TodoWrite、Task调用语法/github ci-orchestrator CI/CD task最佳场景CI/CD 协调、测试管理、部署自动化它通过gh pr checks读取 PR 状态检查、gh workflow list/gh run list枚举与回放 workflow 运行把等待测试 → 定位失败 → 重跑从人工轮询变成 Agent 主动编排。仓库自身的测试基建如根级vitest、tests/下的 docker-regression 与各类smoke-*.mjs可作为并行测试任务的真实清单来源。4.3 security-guardian —— 安全与合规管理安全扫描Automated合规检查Continuous漏洞管理Proactive可用工具gh search code、gh issue create、gh secret list、Read、Write调用语法/github security-guardian security task最佳场景安全审计、合规检查、漏洞管理该模式用gh search code全局检索疑似泄露的密钥/模式、用gh secret list校验仓库 Secrets 配置、对发现项以gh issue create建档跟踪。本仓库在 SECURITY.md 与.claude/settings.json之外还沉淀了大量安全审计脚本audit-supply-chain.mjs、audit-hook-handler-prompt.mjs、smoke-github-safe-injection.mjs 等可作为security-guardian本地预检的后端命令。五、命令实战示例与批处理5.1 三条开箱即用的调用原文档给出了三个高频用法均以/github mode 自然语言任务描述形式唤起在 Claude Code / claude-flow 会话中直接输入# 1) 带自动化测试与多评审人协调的 PR 全流程 /github pr-manager Review and merge feature/new-integration branch with automated testing and multi-reviewer coordination # 2) 跨包同步与版本对齐 /github sync-coordinator Synchronize claude-code-flow and ruv-swarm packages, align versions, and update cross-dependencies # 3) 带自动化进度跟踪与 swarm 协调的 Issue 管理 /github issue-tracker Create and manage integration issues with automated progress tracking and swarm coordination5.2 批处理单条消息并行多条 GitHub 操作Batch Optimized是九种模式的共性能力。由于模式本身由 Agent 执行它可以在一条消息内并发发起多个工具调用从而把往返延迟摊平。原文档的示意JavaScript 伪代码如下[Single Message with BatchTool]: Bash(gh issue create --title Feature A --body ...) Bash(gh issue create --title Feature B --body ...) Bash(gh pr create --title PR 1 --head feature-a --base main) Bash(gh pr create --title PR 2 --head feature-b --base main) TodoWrite { todos: [todo1, todo2, todo3] } Bash(git checkout main git pull)要点同类操作如两个gh issue create、两个gh pr create并行发出提升批量创建/批量更新吞吐用TodoWrite在并行操作之前先把todo清单登记好便于随后逐项核对结果先git checkout main git pull保证本地基线最新避免批量操作基于过期快照执行。在 pr-manager.md 的完整生命周期示例中并行段还扩展了npm test/npm run lint/npm run build三个验证命令与「review/test/merge」三段式 Todo可作为更真实的模板。六、与 ruv-swarm 的深度集成6.1 让 GitHub 任务拥有多智能体协调能力原文档明确指出所有 GitHub 模式都可以叠加 ruv-swarm 协调来增强。示意如下// 初始化 GitHub 工作流 swarm mcp__claude-flow__swarm_init { topology: hierarchical, maxAgents: 5 } mcp__claude-flow__agent_spawn { type: coordinator, name: GitHub Coordinator } mcp__claude-flow__agent_spawn { type: reviewer, name: Code Reviewer } mcp__claude-flow__agent_spawn { type: tester, name: QA Agent } // 以并行策略编排 GitHub 工作流 mcp__claude-flow__task_orchestrate { task: GitHub workflow, strategy: parallel }分工含义swarm_init先声明拓扑与规模。topology: hierarchical分层适合coordinator 拆任务 → reviewer/tester 分工pr-manager.md 与 issue-tracker.md 分别示范了topology: mesh评审 Agent 平级互审与topology: star以 Issue Manager 为中心的用法agent_spawn按角色孵化子 Agent。coordinator编排、reviewer评审、tester测试是三个基础角色issue-tracker 还用到researcher需求分析、analyst进度跟踪等角色对应命令文档中按 Issue 类型指派专职 Agent的最佳实践task_orchestrate把GitHub workflow作为一个整体任务下发strategy: parallel表示并行执行priority可配high/medium等优先级。6.2 底层机制swarm MCP 工具的源码印证这些mcp__claude-flow__swarm_*工具并非占位示例在本仓库中有真实实现。从源码 swarm-tools.ts 可以看出swarm 状态以文件方式持久化到项目目录下的.claude-flow/swarm/swarm-state.json带.lock锁文件与 10s 过期机制见第 33~36 行常量定义并区分initializing / running / paused / shutting_down / terminated五种生命周期状态第 42 行SwarmState结构体中的topology、maxAgents、agents[]、tasks[]字段正是上文swarm_init/agent_spawn/task_orchestrate三类调用所写入的内容两者语义完全对齐文件操作使用O_CREAT 临时文件renameSync原子替换 statSync等方式管理并发第 8~18 行引入node:fs相关 API说明同一时刻多个 GitHub 子 Agent 写进度是有并发保护的。结合这些源码证据你可以推断/github pr-manager这类命令在会话内的执行实质上会通过同一套 MCP 工具建立 swarm 状态评审进度与合并结论可写入.claude-flow/swarm状态目录从而实现跨 Agent、跨消息的上下文延续。运行前提提示要复现上述 MCP 调用需要你的 Claude Code / claude-flow 环境已加载claude-flow的 MCP 服务器与对应工具工具命名前缀mcp__claude-flow__即 MCP 命名空间约定。.claude/mcp.json展示了此类 MCP 服务器的标准声明方式name、command、args、env 结构可参照配置你自己的服务器条目。七、模式选型建议与配套资料7.1 一张图选型任务跨多仓库 / 流程长 →gh-coordinator核心是评审并合入一个 PR →pr-manager核心是跟踪并推进一堆 Issue/里程碑 →issue-tracker核心是走一遍发版流水线 →release-manager核心是搭/理仓库结构 →repo-architect核心是给代码改动挑毛病 →code-reviewer核心是理分支/定合并策略 →branch-manager核心是对齐 monorepo 多包版本 →sync-coordinator核心是盯 CI 运行与失败重跑 →ci-orchestrator核心是扫密钥/查合规/管 Secrets →security-guardian。复杂场景无需单选——pr-manager.md 与 issue-tracker.md 都列出了模式互操作清单例如pr-manager可搭配issue-trackerIssue 关联 PR、branch-manager分支策略、ci-orchestratorCI 集成.claude/agents/github/下的独立 Agentmulti-repo-swarm、project-board-sync、release-swarm等则覆盖更垂直的专项。7.2 需要 gh CLI 的命令文档中多数模式的工具面直接以gh子命令书写gh pr *、gh issue *、gh release *、gh search *、gh workflow *、gh run *、gh secret list、gh api。运行这些模式前请确保本机已安装并认证 GitHub CLIgh auth status可验证。部分操作也可被等价的mcp__github__*MCP 工具替代见 pr-manager.md 工具清单两类通道可以混用。7.3 进一步阅读命令聚合入口.claude/commands/github/README.md 与 github-swarm.mdnpx claude-flow github swarm一键拉起含 Issue Triager / PR Reviewer / Documentation / Test / Security 五类 Agent 的仓库管理 swarm仓库结构说明AGENTS.md、SKILL.md、README.mdswarm 状态实现swarm-tools.ts评审/测试与安全脚本样例scripts/ 下的audit-*.mjs、smoke-github-*.mjs系列。【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考