用途:在 GitHub 上用 AI 集群(swarm)协同管理项目,把议题(issue)、项目看板与冲刺规划串成自动化流程,覆盖从议题创建、分诊、拆解到看板同步、进度追踪的环节。
主要能力:一、议题管理与分诊,支持单个或批量创建议题、按内容自动打标签、合并重复议题、把议题拆成子任务、自动更新清单与进度评论、处理长期停滞议题。二、项目看板自动化,包括看板初始化与双向同步、状态到列与代理到标签的映射配置、议题转为看板卡片、自动分配、按规则智能移动卡片与批量操作。三、冲刺规划与追踪,含冲刺管理、里程碑跟踪、敏捷与看板(WIP 限制)建板、看板分析与绩效报告、KPI 与团队指标、发布协调。四、高级协同,支持跨看板与跨组织同步、议题依赖解析、史诗级协同、多仓库议题管理与工作分配、站会报告与评审协调。
使用方式:以 GitHub CLI(gh)加 npx ruv-swarm 与 claude-flow 钩子为主。示例:gh issue create --title "..." --body "..." --label "enhancement,swarm-ready";npx claude-flow@alpha hooks pre-task --description "Feature implementation";通过 gh project list 获取 PROJECT_ID 后执行 npx ruv-swarm github board-init --project-id "$PROJECT_ID" --sync-mode "bidirectional"。也可在议题评论中用 $swarm analyze、$swarm decompose 5、$swarm assign @agent-coder、$swarm start 等指令触发操作。配置采用 .github 下的 board-sync.yml 或 swarm-labels.json 定义状态、代理与优先级映射。
适用场景:需要把议题分诊、看板流转与冲刺指标自动化的 GitHub 团队项目,尤其是多代理协同、跨仓库或跨组织、需要频繁同步与报告的场景。
限制:资料未提供所需权限、令牌配置、定价、速率限制、失败回退与依赖版本要求;命令涉及 npx 与 gh,实际可用性取决于本地环境与仓库权限;部分示例含占位变量(如 $GITHUB_REPOSITORY)需按实际情况替换。