前言¶
接手別人的 uni-app 或 Vue 倉庫時，結構是否清晰、技術債是否可控，往往要靠人工翻目錄、掃依賴、看規範執行情況纔能有個印象。這類工作重複且容易漏項。下面介紹 SkillHub 上的 Uni-app 項目分析器，它把「項目結構梳理、代碼質量與隱患、技術債務量化、分析報告生成」交給 Agent 按 Skill 約定執行，適合在 Cursor、Claude Code 等支持 Skills 的環境裏使用。
這是什麼¶
Uni-app 項目分析器（座標 @user_1cf5565c/uniapp-analyzer，版本 1.0.0）是 SkillHub 社區來源（community）的編程類 Skill，發佈者爲 user_1cf5565c，分類爲 dev-programming。官方頁面標註 requires_api_key=false，安裝後無需額外 API Key。
一句話定位：面向 Vue 2/3 與 uni-app 技術棧，智能分析項目並輸出可讀的評估與報告；不適用於 React、Angular、Svelte、Python、Java、原生小程序或其他非 Vue 技術棧項目。
核心功能¶
依據 SkillHub 簡介，已覈實的能力包括：
- 項目結構分析：針對 Vue 2/3、uni-app 倉庫做結構層面的梳理與理解。
- 代碼質量與隱患：在分析過程中發現潛在代碼風險與質量問題（具體檢查項由 Skill 內指令定義，使用時以安裝後的 SKILL 內容爲準）。
- 技術債務量化：對技術債做量化評估，便於排期與重構決策。
- 分析報告生成：自動生成項目分析報告，可用於內部分享或文檔沉澱。
適用觸發場景（官方描述）：需要分析 uni-app / Vue 項目結構、檢查代碼質量、評估技術債務、生成項目文檔時，可啓用該 Skill。
安裝與啓用¶
SkillHub 推薦通過 CLI 將技能安裝到當前 Agent 的 skills 目錄；未指定 --dir 時默認裝到 ./skills/，Agent 可能無法識別。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
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、安裝本 Skill¶
將 @user_1cf5565c/uniapp-analyzer 安裝到對應客戶端的 skills 目錄，例如：
# Cursor
skillhub install user_1cf5565c/uniapp-analyzer --dir ~/.cursor/skills/
# Claude Code
skillhub install user_1cf5565c/uniapp-analyzer --dir ~/.claude/skills/
# Codex（用戶級或項目級二選一）
skillhub install user_1cf5565c/uniapp-analyzer --dir ~/.codex/skills/
SkillHub 頁面亦提供自然語言安裝方式：讓 Agent 根據 SkillHub 安裝說明 安裝 @user_1cf5565c/uniapp-analyzer。安裝後按所用客戶端要求重啓或刷新 Agent，使 Skill 生效。
典型用法¶
本 Skill 遵循通用 SKILL.md 格式，無單獨 REST 接口；用法是在已打開目標 Vue / uni-app 項目的工作區中，向 Agent 提出與分析相關的任務，由 Skill 引導分析流程。可復現的表述示例（與官方簡介一致，不承諾額外能力）：
- 打開待分析的 uni-app 或 Vue 2/3 項目根目錄。
- 在對話中說明需求，例如：「請用項目分析能力梳理目錄結構、評估技術債務，並生成一份項目分析報告。」
- 根據 Agent 輸出覈對報告中的結構說明、風險點與技術債結論，再決定重構或文檔歸檔。
不要在 React、Angular 等非 Vue 棧倉庫上期望該 Skill 生效；官方已明確排除這些場景。
適用場景與注意¶
適合誰
- 維護或接手 uni-app、Vue 2/3 單體或多端項目的開發者。
- 需要在評審、交接或立項前快速產出結構化分析結論的團隊。
限制與注意
- 技術棧邊界清晰：僅 Vue / uni-app；其他框架應選用對應領域的 Skill。
- 分析深度取決於倉庫規模與 Agent 上下文；超大單體倉庫可能需要分模塊多次分析。
- SkillHub 頁面統計（截至資料抓取）：評分 100000，下載 2868 次，安裝 108 次；選用時可結合社區反饋與自身試點結果判斷。
結尾¶
Uni-app 項目分析器把 Vue / uni-app 項目的結構梳理、質量與隱患關注、技術債量化以及報告生成收斂到一條 Agent 工作流裏，適合在支持 Skills 的 IDE 或 CLI 中作爲固定能力安裝。官方 Skill 頁與 API 入口：
- https://www.skillhub.cn/skills/user_1cf5565c/uniapp-analyzer
- https://api.skillhub.cn/user_1cf5565c/uniapp-analyzer
