前言¶
日常改 Python 时，一类问题是语法和惯用写法上的「低级错误」——改起来快，但靠肉眼扫大文件或整仓很费时间。另一类是逻辑、边界或安全相关的问题，需要读上下文和报错栈，单靠静态规则很难一次判准。
如果每次都把整段代码交给大模型，成本和延迟都会上去；如果只跑 linter，复杂缺陷又常常只能标出来、不能给出可执行的修复路径。下面介绍的 Bug修复助手（SkillHub 坐标 @user_00c9b356/buddy-bug-fixer）把路径拆成两段：能用确定性规则处理的先本地毫秒级扫描并可自动修；其余再交给 AI 做深度分析，并在报告里区分「可直接应用」与「需人工复核」。
这是什么¶
Bug修复助手 是 SkillHub 上分类为 dev-programming 的社区 Skill，当前版本 1.1.0，发布者为 user_00c9b356。官方简介将其定位为 AI Bug 修复助手，设计参考 mini-swe-agent 思路：规则与提示词分工，减少样板代码，把推理留给模型。
它面向在 Agent 对话里修代码、扫项目的开发者：通过自然语言触发后，先走无需 API 的快速规则扫描，再在需要时启用需配置 API Key 的 AI 分析能力。
核心功能¶
以下能力均来自 SkillHub 页面与抓取元数据，可按条目核对。
-
确定性规则快速扫描
毫秒级完成，不调用 AI。适合常见、模式固定的缺陷。 -
自动修复简单 Bug
对规则覆盖范围内的问题尝试直接改代码；扩展方式上，官方说明auto_fix按规则名分发，便于后续加规则。 -
AI 深度分析
用于复杂逻辑、安全类问题等规则难以覆盖的场景。Skill 标签为requires_api_key=true，使用前需在对应 Agent 环境中配置 API Key。 -
问题分级报告
输出区分 AUTO-FIX（可自动修复）与 NEEDS-REVIEW（建议人工过目后再合入）。 -
对话触发
官方列出的触发信号包括：「修bug」「修复bug」「帮我看看这个代码」；「代码有问题」或粘贴报错；「扫描项目」「自动修复」等表述。
设计理念上，官方强调：确定性规则硬编码，复杂模式交给 AI；信任模型能力，避免过度工程化。
安装与启用¶
SkillHub 提供两种常见安装方式：用 CLI 装到当前 Agent 的 skills 目录，或把安装提示词发给 AI 按文档执行。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 skillhub 命令：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 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
2、安装 Bug修复助手¶
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/，Agent 可能读不到。
skillhub install @user_00c9b356/buddy-bug-fixer --dir <你的 skills 目录>
常用客户端 skills 路径示例（以 SkillHub 安装文档为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在对话中让 AI 按官方说明安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_00c9b356/buddy-bug-fixer`。
3、API Key¶
深度分析依赖模型 API。请在你使用的 Agent 或 Skill 配置里按 requires_api_key=true 的要求填写 Key；仅做规则扫描与 AUTO-FIX 路径时，官方说明快速扫描阶段无需 AI。
安装或更新 skills 后，若 Agent 未立即加载新 Skill，按你所用客户端的惯例重启或重载会话。
典型用法¶
Skill 通过自然语言介入，没有单独列出 CLI 子命令。可按官方触发信号复现下面几类对话（示例表述可替换同义说法）：
-
单文件或片段排查
粘贴代码或指出文件，并说「帮我看看这个代码」或「代码有问题」，并附上 traceback。Agent 加载本 Skill 后应先规则扫描，再视情况调用 AI。 -
项目级扫描
使用「扫描项目」类表述，让 Agent 在目录范围内做检查；简单项可走 AUTO-FIX，其余进入 NEEDS-REVIEW。 -
明确要自动改
在确认备份或版本管理的前提下，使用「修bug」「修复bug」「自动修复」等，便于走自动修复与分级报告流程。
处理完成后，留意报告中的 AUTO-FIX / NEEDS-REVIEW 标记，对 NEEDS-REVIEW 项在合并前做一次人工 diff 与测试。
适用场景与注意¶
适合谁
- 主要在 Python 项目里排错、希望「先快扫再深析」的开发者。
- 已在 Cursor、Claude Code、Codex 等支持 SkillHub skills 的 Agent 上工作，并愿意配置 API Key 以启用深度分析。
限制与注意
- 来源为 community，评分与下载量以 SkillHub 公示为准（抓取时约为评分 100000、下载 769、安装 5）；选用前可自行查看页面说明与更新记录。
- 自动修复只应作用于你信任的范围；NEEDS-REVIEW 项不要跳过 review。
- 官方页面未在此列出每一条确定性规则名称；若你需要确认某类模式是否被规则覆盖，以安装后的 Skill 文档或对话中 Agent 的行为为准。
- 不同 Agent 的 skills 目录不同，安装时
--dir务必配对，避免「已安装但未加载」。
结尾¶
Bug修复助手把 毫秒级规则扫描 + 可选 AI 深度分析 + AUTO-FIX / NEEDS-REVIEW 分级 串成一条修 Bug 路径，适合嵌进日常 Agent 对话，而不是单独再开一套工具链。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_00c9b356/buddy-bug-fixer
- API 资源地址：https://api.skillhub.cn/user_00c9b356/buddy-bug-fixer
安装坐标：@user_00c9b356/buddy-bug-fixer，版本 1.1.0。
