github-swarm-issue

用途

GitHub Swarm Issue 技能的核心目的是把 GitHub Issue 转化为智能体集群任务，从而支持自动化的任务分解、智能体协调与全面的进度跟踪。它提供 Issue 到集群（issue-to-swarm）的转换、自动化分诊，以及生命周期管理。

适合用于以下场景：

复杂 Issue：需要分解的多步骤任务
缺陷调查：需要系统性调试的 Issue
功能请求：需要架构与实现的新功能
技术债：包含多个组件的重构任务
Epic 管理：协调父 Issue 下的子 Issue

主要能力

Issue 到集群的转换，并自动进行任务分解
通过 Issue 评论命令控制集群
自动化分诊与打标签
任务拆解并创建子任务
带可视化更新的进度跟踪
重复检测与关联

使用方式

快速开始

技能给出的命令示例包括：获取 Issue 详情用于集群初始化、列出可进行集群处理的 Issue、添加 swarm 标签以触发处理、发布集群状态评论。

# Get issue details for swarm initialization
gh issue view 456 --json title,body,labels,assignees,comments

# List issues ready for swarm processing
gh issue list --label "swarm-ready"

# Add swarm label to trigger processing
gh issue edit 456 --add-label "swarm-ready"

# Post swarm status comment
gh issue comment 456 --body "Swarm initialized for this issue"

Issue 到集群的转换

通过 gh issue view 获取完整 Issue 上下文（标题、正文、标签、指派人、评论、projectItems），随后根据复杂度选择集群拓扑（topology）并设置最大智能体数。示例逻辑为：当标签数大于 3 或正文长度超过 1000 时使用 hierarchical 拓扑、最多 8 个智能体；当正文匹配到复选框或步骤类文本时使用 mesh 拓扑、最多 5 个智能体；否则使用 ring 拓扑、最多 3 个智能体。最后通过 gh issue comment 发布初始化评论。

任务分解

从 Issue 正文中提取 Markdown 清单项（形如 - [ ] 的任务），生成结构化子任务清单并更新 Issue 正文，并可为主要子任务创建相关联的 Issue。示例中创建子任务的命令使用 gh issue create，并在正文中以「Part of #456」关联父 Issue，同时列出验收标准。

进度跟踪

技能提供了一个 track_progress 函数，通过统计 Issue 正文中已完成（- [x]）与全部任务项数量来计算完成百分比，生成可视化进度条，并通过 gh issue comment 发布进度更新评论。

Issue 评论命令

可在 Issue 评论中使用以下命令：

/swarm analyze：分析 Issue 并建议方案
/swarm decompose 5：分解为子任务
/swarm assign @coder：指派特定智能体类型
/swarm estimate：估算工作量
/swarm start：启动集群处理
/swarm progress：检查进度
/swarm complete：完成并总结

自动化分诊

技能提供了 triage_issues 示例函数：获取无标签 Issue，根据标题与正文内容自动识别并添加标签（如 bug、enhancement、performance、security），通过 gh issue edit --add-label 应用标签。

陈旧 Issue 管理

技能提供了 manage_stale_issues 示例函数：查询 30 天未更新的开放 Issue；若尚未标记 stale 则添加 stale 标签并评论提示 7 天后关闭；若已标记 stale 则再次检查是否超过 7 天未更新并关闭。

Issue 模板

技能给出 .github/ISSUE_TEMPLATE/swarm-task.yml 模板，包含集群拓扑下拉选项（mesh、hierarchical、ring、star）、所需智能体输入、任务描述与子任务字段。

MCP 工具集成

技能展示了多智能体 Issue 处理示例，包括将 Issue 上下文存入集群记忆（issue/456/context，包含 issue_number、title、labels、complexity、agents_assigned），以及以自适应策略编排 Issue 解决。还给出了 GitHub 集成工具示例：跟踪 Issue（action: triage）、分析仓库（analysis_type: code_quality）、获取指标。

GitHub Actions 集成

技能给出 .github/workflows/issue-swarm.yml 工作流示例，触发条件包括 issues 的 opened、labeled 以及 issue_comment 的 created。任务包括：对新 Issue 自动分诊并根据内容添加标签；处理 swarm-ready 标签后发布集群处理开始评论；处理以 /swarm 开头的评论命令。

Issue 类型与策略

缺陷报告：技能给出 handle_bug 示例，分配调试、分析、测试、编码等角色，流程为复现、隔离、定位根因、修复、添加回归测试、验证修复。
功能请求：技能给出 handle_feature 示例，分配架构、编码、测试、评审等角色，阶段为设计评审、实现、测试、文档、演示/评审。

最佳实践

技能列出以下要点：

Issue 模板：包含集群配置选项、结构化任务拆解、清晰验收标准、复杂度估算
标签策略：使用一致的集群相关标签（swarm-ready、swarm-processing），把标签映射到智能体类型，包含优先级指示，用标签跟踪状态
评论规范：清晰的命令语法（/swarm command）、在讨论串中更新进度、用总结评论记录决策、链接到相关 PR
进度跟踪：定期状态更新、可视化进度指示、ETA 估算、阻塞项识别

指标与分析

技能提供了一个 generate_metrics 示例函数，统计最近 30 天已关闭 Issue 的总数、平均解决天数（按标签分组统计）。

限制与说明

资料未提供该技能对具体 GitHub 版本、权限范围、配额或收费的说明；相关资料中给出的命令、脚本与工作流均为示例，使用前需结合自身仓库环境验证。版本记录显示 1.0.0（2026-01-02）为初始技能转换版本。

技能介绍

用途