前言¶
接手同事遺留模塊、讀開源倉庫裏的核心邏輯，常見困境不是「找不到入口」，而是讀半天仍說不清這段代碼在幹什麼、哪些行真正決定行爲。自己逐行加註釋費時，直接問通用對話又容易漏掉邊界條件和隱含假設。
下面介紹 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
