前言¶
讀陌生模塊時，往往要在多個函數和分支之間來回跳轉，腦子裏很難一直維持完整的執行路徑。註釋和文檔能說明「做什麼」，卻不總能一眼看出「先走哪條分支、何時返回」。若能把當前關注的代碼片段整理成一張樹狀流程圖，對照閱讀會省不少時間。下面介紹 SkillHub 上的「代碼流程圖生成 skill」，它面向這類需求：把複雜代碼邏輯用樹狀圖直觀呈現運行路徑。
這是什麼¶
「代碼流程圖生成 skill」（座標 @user_76770c14/hyy，版本 1.0.0）是 SkillHub 社區來源（community）的 Agent Skill，分類爲 dev-programming，由發佈者 user_76770c14 維護。
官方簡介概括爲：讓複雜的代碼邏輯在一張樹狀流程圖中直觀顯示其運行邏輯。Skill 標籤標明 requires_api_key=false，安裝後無需額外配置 API Key。
核心功能¶
依據 SkillHub 頁面說明，當前可覈實的能力如下：
- 樹狀流程圖呈現：將代碼中的控制流與調用關係組織爲樹狀結構，便於從上到下或按分支理解執行順序。
- 運行邏輯可視化：側重「怎麼跑」而非單純羅列符號，適合在 Code Review、接手遺留代碼或梳理算法分支時使用。
- 無 API Key 依賴：不依賴外部付費接口即可完成 Skill 側的基礎能力（具體生成效果仍取決於你所用的 AI Agent 與上下文中的代碼質量）。
頁面未單獨列出更多子功能或輸出格式（如 Mermaid、PNG 等）；若安裝後 SKILL.md 中有更細的輸出約定，以本地技能包說明爲準。
安裝與啓用¶
SkillHub 提供兩種常見安裝方式：用 CLI 安裝到當前 Agent 的 skills 目錄，或把安裝提示詞交給 AI 按官方文檔執行。
方式一：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
安裝本 Skill 時，必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認會裝到 ./skills/，Agent 可能無法識別：
skillhub install user_76770c14/hyy --dir <你的 skills 目錄>
常用客戶端 skills 目錄（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝或更新技能後，按你所用客戶端的要求重啓或刷新 Agent，使新 Skill 生效。
方式二：交給 AI 按文檔安裝¶
SkillHub 技能頁給出的提示詞爲：請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_76770c14/hyy。在已聯網、且 Agent 能讀取該文檔的環境下，可將上述句子發給 AI，由它按文檔完成 CLI 與 --dir 配置。
典型用法¶
公開頁面未附帶逐步截圖或固定 prompt 模板。結合 Skill 定位，可復現的用法流程是：
- 在 Cursor、Claude Code 等已啓用該 Skill 的會話中，選中或粘貼需要理解的代碼片段（函數、類方法或一段帶分支的邏輯）。
- 明確要求生成「樹狀流程圖」或「運行邏輯流程圖」，並說明希望覆蓋的範圍（例如：從入口函數到所有
return/throw分支）。 - 根據 Agent 返回的圖示或結構化描述對照源碼閱讀；若分支不全，可補充「遺漏的 else / 異常路徑」讓 Agent 補全。
具體節點命名、是否導出爲 Mermaid 等細節，以安裝後技能目錄內的 SKILL.md 爲準；本文不臆造未在官方頁面出現的示例輸出。
適用場景與注意¶
適合誰
- 需要快速建立代碼執行心智模型的開發者。
- 做評審或文檔化時，希望用一張圖串起多分支邏輯的團隊。
限制與注意
- 輸出質量依賴上下文長度與模型對代碼的理解；過長文件宜先縮小範圍再生成圖。
- SkillHub 統計（截至頁面信息）：評分 100000，下載 5557，安裝 26；社區 Skill 的維護節奏以發佈者爲準，升級前可在 SkillHub 查看版本是否仍爲 1.0.0。
- 流程圖是理解輔助，不能替代單測與真實運行驗證；邊界條件仍以代碼與測試爲準。
結尾¶
「代碼流程圖生成 skill」把「複雜代碼 → 樹狀運行邏輯圖」這件事封裝成 Agent Skill，且無需 API Key。若你經常在分支密集的代碼裏迷路，可以按上文方式裝到當前環境的 skills 目錄試用。
- SkillHub 技能頁：https://www.skillhub.cn/skills/user_76770c14/hyy
- 座標與 API 入口：https://api.skillhub.cn/user_76770c14/hyy
- 安裝說明：https://skillhub.cn/install/skillhub.md
