前言¶
修 Bug 时常见两种极端:要么只靠模型「猜」改法,要么堆一堆静态检查规则却跟不上业务代码。重复出现的同类问题,每次还要从零解释上下文。下面介绍 SkillHub 上的社区 Skill「一个会学习的代码医生」(坐标 @user_00c9b356/bug-fixer-ultimate),它将 bug-fixer 系列三版合并,在 mini-swe-agent 的极简执行方式上叠加 Reflexion 反思闭环与自进化记忆,用四级置信度区分「能自动改」和「只该建议」。
这是什么¶
一句话定位:面向日常排错与项目扫描的 Agent Skill,模型优先、规则兜底,工具面只依赖 Bash。
- 维护方:社区发布者
user_00c9b356,来源标注为 community。 - 当前版本:1.0.4(以 SkillHub 页面为准)。
- 分类:dev-programming。
- 解决的问题:在用户说出修 Bug、贴报错或要求扫描项目时,按统一流程执行→评估→反思→改进,并把历史修复模式记下来,便于识别复现问题;同时保留确定性规则做快速扫描(如日期排序、嵌套列表等典型模式)。
官方 API 地址:https://api.skillhub.cn/user_00c9b356/bug-fixer-ultimate
SkillHub 展示页:https://www.skillhub.cn/skills/user_00c9b356/bug-fixer-ultimate
合并来源与能力边界¶
2026-04-08 起,该 Skill 将三条产品线合为一条:
| 来源 | 侧重 |
|---|---|
| bug-fixer | 确定性规则快速扫描 |
| bug-fixer-pro | 自进化记忆、P0–P3 置信度、多语言 |
| bug-fixer-ultimate | Reflexion 反思闭环、线性历史 |
说明:页面未单独列出各语言的规则清单或内置脚本路径,正文只写官方简介中已声明的能力,不展开未公开的实现细节。
核心功能¶
触发方式¶
Agent 加载该 Skill 后,下列表述可作为启用信号(摘自官方简介):
- 「修 bug」「修复 bug」「帮我看看这个代码」
- 「代码有问题」、粘贴错误信息
- 「扫描项目」「自动修复」
设计理念¶
官方归纳的执行原则如下:
- 模型优先,规则兜底:先让模型理解上下文,再用确定性规则补漏。
- 极简工具:不引入复杂工具链,动作通过 Bash 完成。
- 完全线性历史:对话与操作按时间线展开,每个动作彼此独立,便于复盘。
- 反思闭环:执行 → 评估 → 反思 → 改进,避免「改完就算」。
- 自进化记忆:记录历史修复模式,用于识别复现 Bug。
- 四级置信度:
- P0:自动修复
- P1:给出建议
- P2:交由 AI 深入分析
- P3:忽略 - 多语言:官方写明支持 Python、JavaScript、Go、Java 等。
依赖与标签¶
SkillHub 标记 requires_api_key=true,使用前需按你所用 Agent 与 Skill 内说明配置 API Key;未在公开页写明具体环境变量名时,以安装后 SKILL.md 为准。
安装与启用¶
安装 SkillHub CLI(若尚未安装)¶
先检查是否已有 CLI:
command -v skillhub && skillhub --version
未安装时,可用官方一键脚本(完整安装含默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装说明全文:https://skillhub.cn/install/skillhub.md
安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/,Agent 可能识别不到。
skillhub install @user_00c9b356/bug-fixer-ultimate --dir <你的 skills 目录>
常见 Client 的 skills 路径(摘自 SkillHub 安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
也可将下面提示交给已接入 SkillHub 的 AI,由其按安装文档完成安装:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_00c9b356/bug-fixer-ultimate。
安装后按所用 Client 要求重启或刷新 Skill 列表。Cursor、Codex CLI、Claude Code 的差异主要体现在 skills 目录位置;Skill 本体为通用 SKILL.md 格式,行为以仓库内说明为准。
典型用法¶
官方未提供独立「教程仓库」或固定 CLI 子命令,用法即:在已启用该 Skill 的对话里,用触发语发起任务。
示例 1:针对报错
- 在对话中粘贴完整 traceback 或编译错误。
- 说明「修复 bug」或「代码有问题」。
- Agent 按 Skill 流程分析;高置信(P0)问题可能直接改文件,低置信会落在 P1/P2 建议或分析。
示例 2:扫描项目
- 打开目标仓库的工作区。
- 发送「扫描项目」或「自动修复」(若你只希望报告、不希望改文件,应在同一句里说明「只扫描、不要自动改」——Skill 简介中 P0 对应自动修复,需自行约束意图)。
- 结合规则扫描与模型阅读,按 P0–P3 分级输出。
以上步骤描述的是触发语义与置信度设计,不代表固定输出格式;具体回复形态取决于当时模型与 Skill 内 SKILL.md 指令。
适用场景与注意¶
更适合
- 日常小 Bug、重复模式问题(依赖自进化记忆与规则扫描)。
- 多语言混合仓库中,需要统一「先反思再改」节奏的团队个人工作流。
需要注意
- 社区来源(community),升级与行为变更需自行关注 SkillHub 版本(当前 1.0.4)。
requires_api_key=true:未配置 Key 时可能无法完成需要外部调用的步骤。- P0 会自动改代码:生产分支或关键路径上建议先备份或用版本控制,再允许自动修复。
- 公开页未承诺与某一固定 Linter 或 CI 打通;复杂架构问题可能落在 P2 分析而非一键修复。
- SkillHub 统计(截至页面展示):评分 100000,下载 1098,安装 9——仅作热度参考,不代表你的环境效果。
结尾¶
「一个会学习的代码医生」把规则扫描、反思闭环和分级置信度收进一个 Skill,适合用自然语言触发修 Bug 与项目扫描,又希望少堆专用工具、多用 Bash 与线性历史的开发者。安装与坐标以 SkillHub 为准:
- 展示页:https://www.skillhub.cn/skills/user_00c9b356/bug-fixer-ultimate
- API:https://api.skillhub.cn/user_00c9b356/bug-fixer-ultimate