前言¶
用 AI 辅助改 bug 时,常见情况是模型连续给出补丁,问题却反复出现:复现步骤不完整、根因未确认就改代码、缺少回归测试。这和「有没有模型」关系不大,更多是流程缺少分诊、确认和收尾。下面介绍 SkillHub 上的「高级Bug修复技能」——它把缺陷修复收成一条结构化工作流,并在关键节点要求人工拍板,而不是让 Agent 一路自动改到底。
这是什么¶
「高级Bug修复技能」是 SkillHub 社区技能(坐标 @user_458438e1/bug-fix-farming,当前版本 2.0.1,分类 dev-programming)。发布者为 user_458438e1,标签 requires_api_key=false,不依赖额外 API Key。
定位可以概括为:代码缺陷修复闭环——AI 负责分析与提案,人在检查点上做确认与决策。官方说明中强调,它面向 VibeCoding 模式下「修 bug 流程里始终解决不了问题」的情况,把修缺陷、查回归、线上问题排查等场景统一到同一套步骤里。
核心功能¶
已核实的能力如下。
七步工作流¶
技能按固定顺序推进:
- 分诊:界定问题范围与优先级。
- 复现:把现象变成可重复验证的步骤。
- 根因定位:在证据基础上收敛原因,而不是猜测性改代码。
- 修复:在确认根因后实施改动。
- 补测试:为修复补上可回归的测试或验证手段。
- 代码审查:对改动做审查层面的检查。
- 报告:输出修复过程与结论的说明。
上述七步在官方简介中串联为:分诊→复现→根因定位→修复→补测试→代码审查→报告。
四道强制人工检查点¶
全程设有 四道强制人工检查点。含义是:Agent 可以给出分析与修改建议,但在这些节点必须有人确认后才能继续。这与「AI 分析提案、人工确认决策」的表述一致,避免未核实根因就合入补丁。
触发方式¶
在支持 Skill 的客户端里启用该技能后,可用自然语言触发,官方列出的提示词包括:
- 修复 bug
- bug 修复
- bug fix
- debug
- 改一下这个问题
安装与启用¶
安装方式以 SkillHub 页面与通用安装文档为准:先具备 skillhub CLI,再把技能装到当前 Agent 能识别的 skills 目录(装错目录会导致技能不被加载)。
检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装,可按官方安装脚本执行(完整安装或仅 CLI,以 SkillHub 安装文档 为准):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本技能¶
官方页面给出的安装目标是 @user_458438e1/bug-fix-farming,并指向上述安装文档。安装时需用 --dir 指定当前环境的 skills 目录,例如:
skillhub install @user_458438e1/bug-fix-farming --dir <skills 目录>
常见客户端的 skills 路径(摘自 SkillHub 安装文档,以你本机实际配置为准):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
SkillHub 页面还提供另一种方式:把「请根据 https://skillhub.cn/install/skillhub.md,安装 @user_458438e1/bug-fix-farming」这类提示发给 AI,由 Agent 按文档完成安装。无论 CLI 还是对话安装,核心都是同一坐标与同一 skills 目录规则。
安装后按你所用客户端的要求重启或刷新 Agent,使 SKILL.md 格式的技能被加载。
典型用法¶
下面是一种可复现的协作方式,不涉及虚构项目细节。
- 在已启用技能的会话中,用官方触发词描述问题,例如:「debug:登录接口在特定参数下返回 500,请按技能流程处理。」
- 跟随技能进入 分诊 与 复现,补充日志、版本、请求参数等 Agent 追问的信息;在第一个检查点确认「问题定义与复现步骤是否成立」。
- 在 根因定位 阶段审阅 Agent 的证据链(调用栈、相关提交、配置差异等),在检查点确认是否同意根因结论,再进入 修复。
- 补测试 与 代码审查 完成后,在后续检查点确认测试覆盖与改动范围,最后阅读 报告 并决定是否合入或发布。
全程保持「提案—确认—再推进」,而不是一次性接受大段未验证的 diff。
适用场景与注意¶
适合谁
- 需要修本地或测试环境缺陷、追查回归、处理线上问题的开发者。
- 希望 AI 参与排查,但不想跳过复现与根因确认的团队。
使用上的注意
- 技能是 工作流与约束,不能替代你对业务与环境的判断;四道检查点需要人主动参与,跳过确认会削弱设计目的。
- 安装务必指向正确的 skills 目录;SkillHub 文档明确默认
./skills/可能不会被当前 Agent 识别。 - 社区来源(community),版本与行为以 SkillHub 上 v2.0.1 页面及包内
SKILL.md为准;不同 Agent 对 Skill 的加载方式略有差异,以各自文档为准。
结尾¶
「高级Bug修复技能」把缺陷修复从「连续打补丁」拉回到 分诊、复现、根因、修复、测试、审查、报告 的闭环,并用检查点把决策权留在人手里。若你正在 SkillHub 上找可落地的修 bug 流程型技能,可从官方页面查看说明并安装:
- SkillHub 展示页:https://www.skillhub.cn/skills/user_458438e1/bug-fix-farming
- API 条目:https://api.skillhub.cn/user_458438e1/bug-fix-farming
(SkillHub 统计:评分 100000,下载 1859,安装 0——数据来自预抓取资料,以页面实时显示为准。)