前言¶
编译失败、测试红灯、运行时堆栈、依赖解析冲突，往往只占排查时间的一小部分；更多精力花在对照日志猜根因、在文档和 Issue 里翻同类问题。若对话里已启用合适的 Agent Skill，可以把「贴日志 → 定位 → 解释 → 改代码」收成一条固定流程，而不是每次从零提示模型。
下面介绍 SkillHub 社区 Skill code-error-fixer（坐标 @user_01798a01/code-fix）：在用户报告错误、异常或异常行为时触发，按 SKILL 约定做系统化诊断与修复建议。
这是什么¶
code-error-fixer 是 SkillHub 上的 dev-programming 类社区 Skill，版本 1.0.0，发布者为 user_01798a01。官方页面将其定位为「全能代码报错极速修复工具」：支持 C++、Java、Python、前端、Linux 等场景下的编译报错与运行报错；用户粘贴报错日志或错误代码后，Skill 引导 Agent 定位错误根源、解释底层原因、输出可复制运行的修复代码，并给出避坑方案。
英文简介中将其概括为 Systematic code error diagnosis and fix skill，覆盖编译错误、运行时异常、类型错误、逻辑缺陷、崩溃分析、依赖冲突与意外行为等。页面标签标明 requires_api_key=false，无需额外 API Key 即可按 Skill 说明使用。
SkillHub 展示数据（以页面与抓取资料为准）：评分 100000，下载 15525 次；分类 dev-programming，来源 community。
核心功能¶
以下能力均来自官方简介与 Skill 元数据说明，不展开未在资料中出现的工具链或私有配置。
错误类型覆盖¶
- 编译错误、构建与测试失败
- 运行时异常、崩溃与堆栈跟踪
- 类型错误、逻辑问题、非预期行为
- 依赖解析或版本冲突
工作方式（Skill 约定）¶
- 接收用户提供的报错日志、异常信息或相关代码片段。
- 系统化诊断：区分表象与根因，必要时结合语言与运行环境说明。
- 给出可执行的修复思路与代码，并补充避免同类问题的注意点。
何时应触发 / 不应触发¶
应在下列情况触发 Skill（摘自 Skill 英文说明）：
- 用户报告 error、exception、bug、crash
- 构建或测试失败
- 代码出现非预期行为
- 类型错误、运行时堆栈、依赖解析失败
- 用户询问「为什么不行」「修这个错」「帮我 debug」等
不应在下列情况单独依赖本 Skill（同样摘自官方说明）：
- 无报错语境的 code review
- 纯架构或方案讨论
- 无错误背景的功能需求
- 「如何实现 X」类开发问题（应选用其他 dev 类 Skill）
安装与启用¶
安装方式以 SkillHub 官方页面与 SkillHub 安装文档 为准。页面提示：按该文档安装 @user_01798a01/code-fix。
1、安装 SkillHub CLI（若尚未安装）¶
先检查本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可使用文档中的完整安装命令（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、安装 code-error-fixer 到当前 Agent 的 skills 目录¶
文档要求安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认装到 ./skills/ 可能无法被加载。
在 Cursor 中，常用路径为 ~/.cursor/skills/：
skillhub install @user_01798a01/code-fix --dir ~/.cursor/skills/
其他客户端路径以安装文档列举为准，例如 Claude Code 为 ~/.claude/skills/，Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/。装好后按你所用客户端的惯例重启或刷新 Agent，使 Skill 生效。
也可在 SkillHub 搜索坐标核对版本与说明：
skillhub search code-error-fixer
典型用法¶
官方资料未提供独立的长示例仓库；用法与简介一致，可概括为可复现的操作步骤：
- 在已启用该 Skill 的 Agent 对话中，直接粘贴完整报错日志或最小可复现代码 + 错误信息（编译器、测试框架、运行时堆栈均可）。
- 用自然语言说明环境要点（语言版本、操作系统、相关依赖名），便于 Skill 按「编译 / 运行 / 依赖」分支处理。
- 根据 Agent 输出：先阅读根因说明，再应用建议的修复代码，并按「避坑方案」调整配置或写法。
触发语可与 Skill 说明对齐，例如：「构建失败，日志如下，请 fix this error」或「这段 Python 运行报类型错误，帮我 debug」。
适用场景与注意¶
适合谁
- 日常开发中频繁遇到编译、测试、运行时错误，希望对话里有一套固定诊断流程的开发者。
- 需要在 C++、Java、Python、前端或 Linux 相关报错上快速对齐根因与修复方向的场景。
限制与注意
- 本 Skill 面向有错误上下文的问题；无报错的评审、架构讨论或纯功能设计，应换用其他 Skill，避免误触发。
- 修复建议仍需你在本地构建、测试验证；Skill 不能替代 CI 或生产环境检查。
- 安装路径必须与当前 Agent 的 skills 目录一致，否则可能出现「已安装但未加载」的情况。
- 社区来源（community）Skill，使用前可在 SkillHub 页面查看版本 1.0.0 与更新说明。
结尾¶
code-error-fixer 把报错与异常场景下的诊断、解释、修复与避坑收敛为一条 Skill 驱动的流程，并与明确的触发 / 非触发条件对齐，减少在通用对话里重复写排查提示。
- SkillHub 页面：https://www.skillhub.cn/skills/user_01798a01/code-fix
- API / 资源地址：https://api.skillhub.cn/user_01798a01/code-fix
- 安装说明：https://skillhub.cn/install/skillhub.md
