用途：在 GitHub 上管理项目，结合 AI 群体协调完成智能 issue 管理、项目看板自动同步与冲刺规划。适用于问题分类整理、将看板接入群体、把 issue 拆解为子任务、规划或跟踪冲刺，以及协调发布与路线图。
前提条件：已安装并认证 gh（GitHub CLI）；可用 ruv-swarm 或 claude-flow（npx ruv-swarm ...）；对目标仓库或组织有编辑 issue 与项目的权限。
主要能力：
- issue 管理与分类：启动小型协调群体，创建结构化 issue 并编排跟踪；自动为未打标签的 issue 分类，将大型 issue 拆解为子任务清单。
- 看板自动化：将群体连接到 GitHub Project，随工作进展移动卡片，支持自动分配与元数据更新。
- 冲刺规划与分析：管理冲刺、自动填充、跟踪速度，跟踪里程碑并预测完成时间。
- 高级协调：多看板与跨组织同步、issue 依赖、史诗编排、跨仓库协调与团队协作自动化。
使用方式（命令保持原样）： gh issue create --title "Feature: Advanced Authentication" --body "Implement OAuth2 with social login..." --label "enhancement,swarm-ready" npx claude-flow@alpha hooks pre-task --description "Feature implementation" PROJECT_ID=$(gh project list --owner @me --format json | jq -r '.projects[0].id') npx ruv-swarm github board-init --project-id "$PROJECT_ID" --sync-mode "bidirectional" npx ruv-swarm github board-sync --auto-move-cards --update-metadata npx ruv-swarm github board-auto-assign --strategy "load-balanced" --update-cards npx ruv-swarm github sprint-manage --sprint "Sprint 23" --auto-populate --track-velocity npx ruv-swarm github milestone-track --milestone "v2.0 Release" --predict-completion
核心工作流还包含通过 MCP 工具（如 swarm_init、agent_spawn、create_issue、task_orchestrate）进行群体初始化与任务编排。详细命令目录、分类规则、issue 转群体、拆解、自动进度评论、陈旧 issue 处理、状态映射、自定义字段、看板同步配置（.github/board-sync.yml）及 issue 模板见 references/ 目录，按需加载。
最佳实践：复杂 issue 先初始化群体；按 issue 类型分配专用智能体；定期发布自动进度更新；跨仓库统一列与标签命名；定期梳理看板；验证双向同步并定义冲突解决策略，保留审计记录与项目数据备份；采用一致的优先级标签并将智能体类型映射到标签。
安全与权限：执行 issue 命令前校验用户权限；限流防止滥用；记录所有群体操作；遵守私有仓库设置；为实时更新保护 webhook 端点。
集成：可与 github-release-management 协调发布 issue 与里程碑，与 github-multi-repo 协调多仓库 issue。
限制：资料未提供具体收费、价格、平台支持范围与效果数据，暂未提供。