RuView 的 GitHub 集成模式体系基于 Claude-Flow 与 ruv-swarm 的 Agent 模式设计与 gh CLI 编排实践【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView本文基于仓库中 github-modes.md 展开系统讲解 RuView 项目中 Claude-Flow 框架下全部 10 种 GitHub 集成模式的定义结构、工具映射与适用场景并结合 pr-manager、sync-coordinator 等配套 Agent 定义与 github-setup.sh 脚本说明这些模式如何通过 pre/post 钩子、批处理操作与 swarm 编排真正驱动 GitHub 工作流。模式体系的定位与文档布局该文档的 Overview 明确它描述 Claude-Flow 中所有可用的 GitHub 集成模式配合 ruv-swarm 协同每个模式都针对特定 GitHub 工作流做了优化并内建批处理工具集成以最大化效率Each mode is optimized for specific GitHub workflows and includes batch tool integration for maximum efficiency。从源码结构看这套体系在仓库中有两处镜像布局.claude/agents/github/github-modes.mdAgent 定义版本带 YAML frontmatter下文详述属于 Agent 规格说明.claude/commands/github/github-modes.md命令版本正文与 Agent 版几乎一致供 Claude Code 的 slash 命令体系调用.claude/agents/github/目录下还有 12 个同族 Agent 定义如 pr-manager.md、issue-tracker.md、release-manager.md、repo-architect.md、sync-coordinator.md、workflow-automation.md 等各自携带更完整的工具清单、钩子脚本与学习协议可视为本文各模式的展开版.claude/commands/github/下另有一组命令文档issue-triage、code-review、pr-enhance、multi-repo-swarm 等入口说明见 commands/github/README.md。也就是说github-modes.md是这套 GitHub 自动化能力的总目录而具体模式的实现细节分散在同目录的兄弟 Agent 定义中。Agent 定义结构frontmatter 中的钩子与能力声明与命令版本不同Agent 版本的 frontmatter 完整声明了模式的运行契约这是理解整个体系的入口--- name: github-modes description: Comprehensive GitHub integration modes for workflow orchestration, PR management, and repository coordination with batch optimization tools: mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, Bash, TodoWrite, Read, Write color: purple type: development capabilities: - GitHub workflow orchestration - Pull request management and review - Issue tracking and coordination - Release management and deployment - Repository architecture and organization - CI/CD pipeline coordination priority: medium hooks: pre: | echo Starting github-modes... echo Initializing GitHub workflow coordination gh auth status || (echo GitHub CLI authentication required exit 1) git status /dev/null || (echo Not in a git repository exit 1) post: | echo Completed github-modes echo GitHub operations synchronized echo Workflow coordination finalized ---几个要点值得注意工具集声明了mcp__claude-flow__swarm_init、mcp__claude-flow__agent_spawn、mcp__claude-flow__task_orchestrate三个 MCP 协同工具加上Bash、TodoWrite、Read、Write四个本地工具。也就是说模式的手是 gh CLI经 Bash 执行脑是 swarm 编排三件套。pre 钩子是硬前置校验先执行gh auth status失败即提示GitHub CLI authentication required并exit 1再执行git status不在 git 仓库内同样终止。这决定了使用任何模式的前提是本地已安装并认证 gh CLI且当前目录处于一个 git 仓库中。仓库中的 github-setup.sh 做了同样的检查——command -v gh探测安装、gh auth status探测认证未通过时给出gh auth login提示——两套逻辑互为印证。post 钩子只做收尾状态播报GitHub operations synchronized / Workflow coordination finalized不承担清理职责。全部 10 种模式完整清单与适用边界原文档将模式分为三类共 10 种。以下完整保留各模式的参数、工具与用法说明。一、GitHub 工作流模式4 种gh-coordinator —— 工作流编排与协调协调模式Hierarchical层级式最大并行操作数10批处理优化是工具gh CLI 命令、TodoWrite、TodoRead、Task、Memory、Bash用法/github gh-coordinator GitHub workflow description适用复杂 GitHub 工作流、多仓库协调pr-manager —— 拉取请求管理与评审协调评审模式Automated多评审者支持冲突处理Intelligent工具gh pr create、gh pr view、gh pr review、gh pr merge、TodoWrite、Task用法/github pr-manager PR management task适用PR 评审、合并协调、冲突解决issue-tracker —— 问题管理与项目协调问题工作流Automated标签管理Smart进度跟踪Real-time工具gh issue create、gh issue edit、gh issue comment、gh issue list、TodoWrite用法/github issue-tracker issue management task适用项目管理、issue 协调、进度跟踪release-manager —— 发布协调与部署发布流水线Automated版本规范Semantic语义化版本部署Multi-stage多阶段工具gh pr create、gh pr merge、gh release create、Bash、TodoWrite用法/github release-manager release task适用发布管理、版本协调、部署流水线二、仓库管理模式3 种repo-architect —— 仓库结构与组织结构优化支持多仓库支持模板管理Advanced工具gh repo create、gh repo clone、git 命令、Write、Read、Bash用法/github repo-architect repository management task适用仓库初始化、结构优化、多仓库管理code-reviewer —— 自动化代码评审与质量保障评审深度Deep安全分析支持性能检查Automated工具gh pr view --json files、gh pr review、gh pr comment、Read、Write用法/github code-reviewer review task适用代码质量、安全评审、性能分析branch-manager —— 分支管理与工作流协调分支策略GitFlow合并策略Intelligent冲突预防Proactive工具gh api用于分支操作、git 命令、Bash用法/github branch-manager branch management task适用分支协调、合并策略、工作流管理三、集成命令3 种sync-coordinator —— 多包同步包同步Intelligent版本对齐Automatic依赖解析Advanced工具git 命令、gh pr create、Read、Write、Bash用法/github sync-coordinator sync task适用包同步、版本管理、依赖更新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 协调、测试管理、部署自动化security-guardian —— 安全与合规管理安全扫描Automated合规检查Continuous漏洞管理Proactive工具gh search code、gh issue create、gh secret list、Read、Write用法/github security-guardian security task适用安全审计、合规检查、漏洞管理深入两个代表性模式模式清单背后的真实实现模式清单给出的是路由表而每个模式对应的 Agent 定义文件展示了实际执行时的行为深度。pr-manager从 gh CLI 到自学习评审pr-manager.md 是该模式最完整的展开。其 frontmatter 将工具从清单中的 6 个扩展到 20 个左右新增了mcp__claude-flow__github_pr_manage、mcp__claude-flow__github_code_review、mcp__claude-flow__github_metrics以及mcp__agentic-flow__agentdb_pattern_store/search/stats等模式库工具priority 从总目录的 medium 提升到 high。它的 pre 钩子比总目录版多了三步实质动作通过npx agentdb-cli pattern search Manage pull request for $PR_CONTEXT --k5 --min-reward0.8检索历史相似 PR 的处理模式执行gh auth status、git status --porcelain、gh pr list --state open --limit 1完成环境与状态体检用agentdb-cli pattern store以pr-manager-$AGENT_ID-$(date %s)为 session 标记记录任务开始。post 钩子则计算REWARD/SUCCESS/TOKENS/LATENCY四类指标并回存模式库最后执行gh pr status、git branch --show-current、gh pr checks、git log --oneline -3四组收尾校验当SUCCESStrue且REWARD0.9时触发npx claude-flow neural train --pattern-type coordination --epochs 50的神经模式训练。文档正文进一步给出了三类可执行模式swarm 评审swarm_init { topology: mesh, maxAgents: 4 }后并行 spawn 质量评审、测试、协调三类 Agent、多文件并行评审gh pr view 54 --json files驱动逐文件评论、带测试验证的合并协调状态校验通过后以merge_method: squash合并并用memory_usage存储pr/54/merged状态。sync-coordinator多包版本对齐的完整工作流sync-coordinator.md 展示了集成命令类模式的实现深度它声明了mcp__github__push_files、mcp__github__create_or_update_file、mcp__github__get_file_contents等 GitHub MCP 工具以及coordination_sync、load_balance等协同工具。其用法示例包含一条真实的分支创建命令——gh api repos/:owner/:repo/git/refs \ -f refrefs/heads/sync/package-alignment \ -f sha$(gh api repos/:owner/:repo/git/refs/heads/main --jq .object.sha)即通过gh api基于 main 分支的 SHA 创建同步分支再用gh api .../contents/... --method PUT带 base64 编码内容与 sha 防冲突推送版本对齐后的package.json随后以task_orchestrate { strategy: parallel, priority: high }编排验证。文档还给出了版本对齐策略对象engines.strategy: highest_common取各包最高公共要求、文档同步模式指定 source of truth 与目标文件清单以及跨包测试矩阵构成分析—对齐—验证—报告的闭环。issue-tracker.md 的 frontmatter 也值得注意它把能力细化到 9 项智能模板建 issue、跨仓库 issue 同步、智能标签组织、里程碑协调等验证了总目录中Smart 标签管理、Real-time 进度跟踪两个参数的具体含义。用法示例直接可复制的调用方式原文档给出三个典型的 slash 命令用法任务描述以自然语言传入由模式内部映射到 gh CLI 与 swarm 操作# 协调式 PR 工作流 /github pr-manager Review and merge feature/new-integration branch with automated testing and multi-reviewer coordination # 仓库/包同步 /github sync-coordinator Synchronize claude-code-flow and ruv-swarm packages, align versions, and update cross-dependencies # 自动化 issue 跟踪 /github issue-tracker Create and manage integration issues with automated progress tracking and swarm coordination批处理操作单消息内的并行 GitHub 操作原文档强调所有 GitHub 模式都支持批处理操作并给出一个单消息BatchTool示例说明一次交互内可并行发起多条独立的 gh 命令与状态跟踪[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)设计意图是相互独立的 GitHub API 调用建 issue、开 PR合并到同一轮消息以减少往返TodoWrite 承担跨操作进度跟踪最后以git checkout main git pull收尾本地状态。pr-manager 的Complete PR Lifecycle in Parallel示例展示了同一思想在 PR 全生命周期的应用swarm 初始化、建 PR、拉取 PR 文件、提交评审、跑测试npm test / lint / build、TodoWrite 里程碑跟踪review/test/merge 三态全部并列在同一消息中。与 ruv-swarm 的集成拓扑、Agent 角色与任务编排所有模式都可叠加 ruv-swarm 协同。原文档给出的标准集成序列是// Initialize swarm for GitHub workflow 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 } // Execute GitHub workflow with coordination mcp__claude-flow__task_orchestrate { task: GitHub workflow, strategy: parallel }对照各 Agent 定义可以归纳出实际使用的拓扑与角色搭配PR 评审场景常用mesh拓扑 4 个 Agentreviewer/tester/coordinator同步场景用hierarchical 5~6 个 Agentcoordinator/analyst/coder/tester/reviewer恢复场景则用star拓扑 3 个 Agentmonitor/analyst/coder。task_orchestrate的strategy取值在文档中观察到parallel、sequential、adaptive三种分别对应并行执行、依赖顺序执行与按条件动态路由。适用前提与边界运行环境依赖 gh CLI 且已完成gh auth loginpre 钩子与 github-setup.sh 双重校验必须处于 git 仓库内依赖的外部能力mcp__claude-flow__*与mcp__agentic-flow__*系列 MCP 工具、agentdb-cli模式库检索/存储、claude-flowCLI神经模式训练这些组件来自 Claude-Flow/Agentic-Flow 生态不属于 RuView 的 WiFi 感知核心使用时需确认已在当前环境可用文档定位.claude/目录是项目的 AI 辅助开发配置区本文所述模式服务于该仓库自身的多包、多仓库协作claude-code-flow、ruv-swarm 等配套包场景与 docs/adr 所记录的 WiFi 感知功能模块相互独立继续深入的路径模式清单见 agents/github/github-modes.md命令侧对照 commands/github/github-modes.md各模式实现细节以同目录兄弟文件pr-manager、issue-tracker、sync-coordinator、workflow-automation 等为准。综合来看这份 GitHub 集成模式文档的价值在于它定义了一套模式路由 工具映射 钩子契约 swarm 编排的四层结构路由层用 10 个模式覆盖 PR、Issue、发布、仓库、CI、安全六大工作流工具层把每个模式固定到一组最小化的 gh CLI 子命令钩子层用 pre 校验gh 认证 git 仓库保证执行前提编排层则通过 batch 操作与swarm_init/agent_spawn/task_orchestrate三件套把单点操作升级为多 Agent 并行流水线。理解这四层就能在 Claude-Flow 环境中按需选取模式并推演其完整执行路径。【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考