前言¶
接手同事遗留模块、读开源仓库里的核心逻辑，常见困境不是「找不到入口」，而是读半天仍说不清这段代码在干什么、哪些行真正决定行为。自己逐行加注释费时，直接问通用对话又容易漏掉边界条件和隐含假设。
下面介绍 SkillHub 上的社区 Skill「代码解释器」（@user_70c2f807/code-explainer）。它在 Agent 侧按统一 SKILL.md 规范工作，面向「理解陌生代码」这一件事：说明功能、标出关键行、提示潜在问题，且页面标注 requires_api_key=false，无需额外 API Key。
这是什么¶
代码解释器是 SkillHub 分类 dev-programming 下的社区 Skill（来源 community，发布者 user_70c2f807，当前版本 1.0.0）。
官方简介概括为：帮助用户理解陌生代码的逻辑，自动解释代码功能、标注关键行、指出潜在问题，缓解看不懂同事代码或开源项目代码的困扰。
- Skill 坐标：
@user_70c2f807/code-explainer - SkillHub 页面：https://www.skillhub.cn/skills/user_70c2f807/code-explainer
- 资源入口：https://api.skillhub.cn/user_70c2f807/code-explainer
核心功能¶
以下能力均来自 SkillHub 页面与元数据说明，不展开未在资料中出现的细则：
- 解释代码功能：用可读的方式说明片段或文件在做什么、数据如何流动。
- 标注关键行：把真正影响行为的分支、状态变更、副作用等行标出来，便于快速扫读。
- 指出潜在问题：在理解逻辑的同时提示可能的风险点（具体规则由 Skill 内指令定义，以安装后的 SKILL.md 为准）。
安装与启用¶
SkillHub 推荐通过官方安装说明完成 CLI 与技能安装。页面给出的安装提示为：根据 https://skillhub.cn/install/skillhub.md 安装 @user_70c2f807/code-explainer。
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、安装到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 识别的 skills 目录；否则默认落在 ./skills/，Agent 可能无法加载。
skillhub install @user_70c2f807/code-explainer --dir <你的 skills 目录>
常用路径示例（以你实际使用的客户端为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后按客户端要求重启或刷新 Agent，使 Skill 生效。
3、与「发给 AI 的安装提示」等效的做法¶
若不方便手动执行命令，可将 SkillHub 页面上的提示原样发给支持 Skill 安装的 Agent：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_70c2f807/code-explainer`。
Agent 读取该文档后会按其中步骤完成 CLI 检查与 skillhub install。
典型用法¶
公开资料未附带单独的命令行子工具说明，用法是在启用该 Skill 的 Agent 对话中提出「读代码、要解释」的需求。可复现的通用模式如下：
- 确认
@user_70c2f807/code-explainer已安装到当前 Agent 的 skills 目录并已加载。 - 提供待理解的代码：粘贴片段、指定仓库内文件路径，或说明「从某函数/类开始」的阅读范围。
- 明确要求与 Skill 简介一致的三类输出，例如：
请用代码解释器的方式说明这段代码的整体功能，标注关键行，并指出可能的潜在问题。
- 对大型文件可先限定范围（单个函数、单个 PR diff），再逐步扩大，避免一次上下文过长。
具体输出格式、是否分步骤讲解等细节，以安装包内 SKILL.md 为准。
适用场景与注意¶
适合谁
- 需要快速接手他人模块、做 Code Review 前预习逻辑的开发者。
- 阅读开源项目时，希望先有「带关键行标注」的导读，再决定是否深入调试的人。
使用注意
- 本 Skill 为 community 来源，解释与问题提示依赖模型与 Skill 指令，不能替代测试、静态分析或安全审计。
- 页面元数据为 requires_api_key=false；若你使用的 Agent 另有联网或模型计费，仍按各自产品规则为准。
- SkillHub 统计（截至页面抓取）：评分 100000，下载 10810 次；安装数等字段以 SkillHub 实时展示为准。
结尾¶
「代码解释器」把「讲清逻辑、标关键行、点潜在问题」收拢成一条可复用的 Agent 工作流，适合在读陌生代码时作为第一步导读。需要安装或查看说明时，请打开官方 SkillHub 页面：
https://www.skillhub.cn/skills/user_70c2f807/code-explainer
