前言¶
合併前或交付前,人工掃一遍目錄往往耗時長,還容易漏掉規範細節、潛在缺陷和可讀性問題。團隊若有 Java 規範要求,還要對照文檔逐項打分,更難在對話裏一次性說清。
下面介紹 SkillHub 上的「代碼審查」Skill(座標 @user_6cc7d052/code-reviewer)。它在 Agent 側按 SKILL 約定工作:對指定文件夾內的代碼做結構化審查,並可在需要時產出審查報告,適合把「看代碼質量、找問題、對規範」交給模型按固定維度執行。
這是什麼¶
「代碼審查」是社區來源(community)、由發佈者 user_6cc7d052 維護的 dev-programming 類 Skill,當前版本 1.0.1。SkillHub 頁面標註 requires_api_key=false,安裝後一般無需額外配置 API Key。
一句話定位:對指定文件夾內的代碼做全面審查,覆蓋規範性檢查、Bug 檢測、性能優化建議、可讀性評估,以及基於華爲 Java 編程規範的質量評分;當需要審查代碼質量、發現潛在問題、評估規範符合度或生成代碼審查報告時使用。
核心功能¶
以下能力均來自 SkillHub 官方簡介,未在資料中出現的細節不作延伸:
- 規範性檢查:對照約定與常見規範,指出不符合項。
- Bug 檢測:在靜態閱讀範圍內提示可能的邏輯或實現風險。
- 性能優化建議:給出可討論的改進方向(非替代 profiling 工具)。
- 可讀性評估:從結構、命名、複雜度等角度評價可維護性。
- 質量評分:結合華爲 Java 編程規範給出評分維度,便於 Java 項目對齊企業規範。
- 審查報告:在對話中彙總上述結果,便於歸檔或跟進。
安裝與啓用¶
SkillHub 推薦通過 CLI 安裝,並必須用 --dir 指向當前 Agent 識別的 skills 目錄;默認裝到 ./skills/ 時,部分客戶端不會自動加載。
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、安裝「代碼審查」Skill¶
將 @user_6cc7d052/code-reviewer 安裝到當前環境對應的 skills 目錄。常見路徑如下(以 SkillHub 安裝文檔爲準):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下的.agents/skills/
示例(請把 <skills 目錄> 換成實際路徑):
skillhub install @user_6cc7d052/code-reviewer --dir <skills 目錄>
SkillHub 技能頁也提供等價的自然語言安裝提示,核心是引用同一座標與安裝說明文檔 https://skillhub.cn/install/skillhub.md:
請根據 https://skillhub.cn/install/skillhub.md,安裝 `@user_6cc7d052/code-reviewer`。
安裝完成後,按所用客戶端要求重啓或刷新 Agent,使新 Skill 生效。
典型用法¶
公開資料未附帶單獨的 SKILL.md 全文或固定 CLI 子命令;用法與簡介一致:指定目錄 + 說明審查目標。在已啓用該 Skill 的對話中,可明確文件夾路徑與期望輸出,例如:
- 說明要審查的目錄(相對或絕對路徑均可,以 Agent 能訪問爲準)。
- 說明關注點:規範、Bug、性能、可讀性,或需要完整報告。
- 若爲 Java 代碼且需對齊華爲規範,可明確要求「按華爲 Java 編程規範評分」。
示例表述(可按項目改寫路徑與語言棧):
請使用代碼審查 Skill,對 ./src/main/java 目錄做全面審查,輸出規範性問題和潛在 Bug,並給出基於華爲 Java 編程規範的質量評分與改進建議;最後整理成一份審查報告。
經過上面的步驟,Agent 會按 Skill 內定義的流程組織輸出;具體檢查項以安裝包中的 SKILL 說明爲準。
適用場景與注意¶
適合誰
- 需要在合併或發佈前快速過一遍目錄質量的個人或小團隊。
- 希望把 Java 規範檢查與評分寫進對話流程、減少手工對照文檔的場景。
- 需要結構化審查報告以便跟蹤整改項時。
限制與注意
- 審查對象是 Agent 能讀到的文件夾內源碼,不能替代專用靜態分析器、測試或生產環境 profiling。
- 「華爲 Java 編程規範」相關評分主要服務於 Java;其他語言仍可受益於通用維度的 Bug、性能與可讀性建議,但評分基準以 Skill 設計爲準。
- SkillHub 列表數據(截至頁面抓取):評分 100000,下載 28410,安裝 13;社區 Skill 的維護節奏與規則更新需自行關注版本 1.0.1 的後續升級。
結尾¶
「代碼審查」把目錄級審查、多維度建議和 Java 規範向評分收斂到一條 Skill 工作流裏,適合在 IDE Agent 中按需觸發,而不是另開一套獨立審查服務。
官方入口:
- SkillHub 頁面:https://www.skillhub.cn/skills/user_6cc7d052/code-reviewer
- API 座標頁:https://api.skillhub.cn/user_6cc7d052/code-reviewer