1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | bug-hunt-swarm-dimillian-skills |
| 作者/维护者 | Thomas Ricouard(GitHub: Dimillian,OpenAI Codex 开发者体验团队成员,4,306 关注者) |
| 来源链接 | https://github.com/Dimillian/Skills/tree/main/bug-hunt-swarm |
| 许可证 | MIT(GitHub API 核实) |
| GitHub Stars/Forks | 3,879★ / 202 forks(GitHub API,2026-08-04;数字属整个 Dimillian/Skills 合集仓库,不代表本技能自身热度) |
| 最新版本 | 无独立版本号;本技能目录最近一次实质性提交 2026-03-29(GitHub API) |
| 安装方式 | 复制技能目录到 agent 的 skills 目录,或通过第三方 CLI 一键安装,见第 10 章 |
2. 功能介绍与亮点
bug-hunt-swarm 面对一个 bug、回归或间歇性失败,先把症状与复现线索整理成排查简报,再并行派出四个只读子 agent 分别调查:复现边界、代码路径与失败节点、近期变更与回归线索、验证方案与可观测证据。主 agent 汇总四路结果、剔除弱证据,产出按置信度排序的根因假设、最快验证步骤与推荐修复路径。SKILL.md 反复强调子 agent 只读——不得编辑文件、apply_patch、暂存或提交,诊断与实施动作被严格分开。仓库另提供 agents/openai.yaml,给出 Codex 原生调用入口。
亮点:该合集仓库收到过外部工程团队用自动化审查工具提出的改进建议 Pull Request;该技能已被 claudemarketplaces.com、terminalskills.io 等第三方 Skill 目录站点收录并给出独立安装页面;仓库本身也被“Awesome Codex CLI”资源列表收录。
3. 适用场景
所属分类:工程效率与代码质量
面向使用 AI 编码 agent 排查疑难 bug 的初中级开发者:复现路径不明确、影响面模糊、或怀疑是近期改动引入回归时,用它一次性从多个角度并行收集证据,避免单线索排查越走越窄,尤其适合生产环境异常、间歇性失败等定位比动手改代码更费时的场景。诊断优先、不碰代码的设计也适合需要先对齐根因再决定怎么修的协作流程。
4. 跨 Agent 兼容性
- Codex:原生支持——仓库本身即 Codex Skills 合集,自带
agents/openai.yaml元数据,安装路径为$CODEX_HOME/skills - Claude Code:需适配——SKILL.md 格式通用,可手动复制到
.claude/skills/;第三方站点 claudemarketplaces.com 另提供了一键安装命令,依赖第三方 CLI,见第 11 章 - OpenClaw:未验证——已抓取材料中未提及
- Hermes Agent:未验证——已抓取材料中未提及
5. 推荐理由
它把“疑难 bug 排查”这件依赖经验直觉的事,拆成四条并行、边界清晰的只读调查线,再综合成带置信度、带最快验证步骤的根因清单,比单线程排查更不易漏线索。诊断与修复动作彻底分离,适合放心用在不希望 agent 擅自改代码的生产场合。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 所属合集仓库 3,879★,该数字属整个合集仓库,不代表本技能自身热度;作者为公开可查的 OpenAI Codex 开发者体验团队成员,技能被多家第三方 Skill 目录站点收录并给出独立安装页面,但未检索到围绕该技能本身的活跃社区讨论 |
| 可用性 | 8 | SKILL.md 结构清晰,四个子 agent 的角色与检查项写得具体可执行;无需 API key 或付费依赖;最近一次提交 2026-03-29,仍在 6 个月维护窗口内;Claude Code 用户需额外一步手动复制或依赖第三方安装器,并非单条命令直接可用 |
| 安全性 | 8 | 安装单元仅含 SKILL.md 与一份 yaml 元数据,无脚本、无可执行代码;引导子 agent 使用的均为只读命令(rg、git diff/log/show),并反复明令禁止编辑文件、提交或其他状态变更;License 明确、作者身份可核实 |
| 综合 | 7.3 | 三项均值 |
安全检查清单:①仅引导只读 shell 命令(rg、git diff/log/show),SKILL.md 反复明令四个子 agent 不得编辑文件、apply_patch、暂存或提交 ②技能自身无网络请求;若选择第三方 CLI 一键安装(而非手动复制),所依赖的安装器另有两条未解决的“未经同意上传使用数据”类投诉,详见第 11 章 ③不涉及 API key 或凭据 ④通读 SKILL.md 全文未发现可疑指令或混淆内容 ⑤作者身份可核实、无刷星迹象 ⑥License 为 MIT,明确 ⑦最近一次提交距今约 4 个月,在 6 个月维护窗口内
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与本技能的差异 |
|---|---|---|
| diagnosing-bugs-mattpocock-skills | 单 agent 系统化排查方法论:先搭建可复现的紧凑反馈回路,再对候选假设排序、逐一验证 | 是单线程、按顺序验证假设的流程;本技能用四个只读子 agent 并行从不同角度同时收集证据,再统一综合排序,覆盖面更快更广 |
| codexstar69/bug-hunter | 多 agent 流水线查找安全漏洞、逻辑错误与运行时 bug,并在安全分支上自动实施修复 | 定位是“查完就修”的自动化流水线;本技能刻意只做诊断、不碰代码,更适合需要先对齐根因、由人决定怎么修的场景 |
| Dimillian/Skills 下的 review-swarm | 同一合集的姊妹技能,用四个只读子 agent 并行审查一份 git diff,找行为回归、安全隐患、性能问题与测试覆盖缺口 | 审查对象是“已提交的改动”,回答“这次改动有没有问题”;本技能面对的是“一个已发生的 bug”,回答“它为什么会发生”,两者可在开发流程的不同阶段搭配使用 |
8. 用户评价
该技能目前在第三方平台尚无独立具名用户评价。
9. 其他补充
Dimillian/Skills 合集仓库同期还收录 review-swarm(并行审查 diff)、review-and-simplify-changes、orchestrate-batch-refactor 等风格一致但场景不同的技能,供有相邻需求的用户参考。
10. 安装使用方式
Codex(原生)
git clone https://github.com/Dimillian/Skills.git
cp -r Skills/bug-hunt-swarm "$CODEX_HOME/skills/"
安装后可在遇到疑难 bug 时用仓库自带的默认提示语触发,或直接向 agent 描述“用 bug hunt swarm 排查这个问题”。
Claude Code(手动复制)
git clone https://github.com/Dimillian/Skills.git
cp -r Skills/bug-hunt-swarm ~/.claude/skills/
复制后开启新对话即可加载,SKILL.md 的 description 字段会让 agent 按任务自动匹配调用。
Claude Code(第三方 CLI,可选)
npx -y skills add dimillian/skills --skill bug-hunt-swarm --agent claude-code
该命令来自第三方安装工具而非本仓库官方渠道,使用前请先阅读第 11 章的注意事项。
以上方式均无需 API key 或付费配置。
11. 注意事项
- README 面向 Codex 用户,Claude Code / OpenClaw / Hermes Agent 均需手动复制或依赖第三方工具,无官方内置支持
- 若选择第三方
npx skills add一键安装:其 CLI(vercel-labs/skills)当前有两条未解决的公开投诉——一条称未经同意上传使用数据,另一条称审计上报不受禁用开关约束——2026-08-04 复查时仍处开放状态;如有顾虑可改用手动复制,不经过该 CLI - 四个子 agent 并行调查会消耗更多 token/请求配额,面对一目了然的小 bug 直接本地排查可能更快,SKILL.md 本身也建议此时跳过并行调查
- 该技能只产出诊断与建议,不会自动实施修复,后续修复仍需人工或另行触发其他技能完成