前言¶
PR 越堆越大、diff 裏混着功能、重構和依賴升級時,人工 review 很容易漏掉安全或性能問題;只讓模型「看一眼代碼」又往往只停留在風格層面。下面介紹一個在合併前按固定維度走一遍的 Agent Skill,把正確性、架構、安全等檢查收斂成可重複的流程。
這是什麼¶
多軸代碼評審(SkillHub 座標 @org-b6kzcl68/code-review-and-quality,版本 1.0.0)是 SkillHub 上分類爲 dev-programming 的企業來源 Skill,由重慶途光網絡傳媒有限責任公司發佈。頁面標註 requires_api_key=false,安裝與使用不依賴額外 API Key。
它面向「任何變更進入主分支之前」:對自己、同事或 AI 生成的代碼做多維度質量評估,而不是單次對話裏的隨意點評。SkillHub 簡介將其定位爲合併前必做的多軸評審,並寫明適用時機爲合併 PR 或變更之前、功能實現完成之後、需要評估多方代碼質量時。
官方入口:
- SkillHub 頁面:https://www.skillhub.cn/skills/org-b6kzcl68/code-review-and-quality
- API 資料頁:https://api.skillhub.cn/user_e40a4360/code-review-and-quality
核心功能¶
依據 SkillHub 已公開的簡介,該 Skill 的能力可歸納爲以下幾塊(均以官方描述爲準):
- 五維評估:對每一處變更從正確性、可讀性、架構、安全、性能五個維度審查。
- 變更拆分策略:在評審流程中納入如何拆分變更的建議(與「大 PR 難 review」的場景對應)。
- 評審清單:提供結構化清單,便於 Agent 按項檢查而非自由發揮。
- 死代碼清理:評審時覆蓋無用代碼的識別與清理紀律。
- 依賴升級紀律:在涉及依賴變更時,按 Skill 內規則做升級相關評審。
觸發語境(官方 Triggers 列舉):代碼評審、review diff、review PR、代碼質量檢查、合併前評審、重構評估、依賴升級評審、死代碼清理。在 Cursor 等支持 Skills 的客戶端裏,用上述自然語言描述任務即可讓 Agent 加載該 Skill 的 SKILL.md 並按其中步驟執行。
安裝與啓用¶
SkillHub 推薦兩種方式:用 CLI 安裝,或把安裝提示詞發給當前 Agent。
1、安裝 SkillHub CLI(若尚未安裝)¶
先檢查是否已有 CLI:
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
說明見:https://skillhub.cn/install/skillhub.md
2、安裝本 Skill 到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄,否則默認會裝到 ./skills/,客戶端可能識別不到。
skillhub install @org-b6kzcl68/code-review-and-quality --dir <你的 skills 目錄>
常用路徑(來自 SkillHub 安裝文檔):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下的.agents/skills/
也可直接向 Agent 發送 SkillHub 頁面上的安裝提示詞:
請根據 https://skillhub.cn/install/skillhub.md,安裝 `@org-b6kzcl68/code-review-and-quality`。
安裝完成後,按你所用客戶端的要求重啓或刷新 Agent,使新 Skill 生效。
典型用法¶
本 Skill 遵循通用 SKILL.md 格式:啓用後由 Agent 讀取技能說明,再結合你提供的上下文(diff、分支、PR 描述等)執行評審。下面是可以直接復現的對話入口,均來自官方 Triggers 與 Use when 描述。
-
合併前看 diff
在已安裝 Skill 的項目或全局 skills 下,對 Agent 說:「對當前git diff做合併前評審,按正確性、可讀性、架構、安全、性能五個維度檢查。」 -
Review PR
「review PR:列出必須修復項與建議項,並說明變更是否應拆分。」 -
重構或依賴變更
「這是一次重構評估 / 依賴升級評審,請按 Skill 裏的依賴升級紀律和死代碼清理要求審查變更。」 -
AI 生成代碼自檢
功能實現完成後:「評估剛提交的代碼質量,準備合併到主分支前。」
經過上面的步驟,Agent 會按 Skill 內清單與五維框架輸出結論;具體條目以安裝包中的 SKILL.md 爲準,本文不展開未在公開簡介中出現的工作流細節。
適用場景與注意¶
適合誰
- 需要在合併 PR 前統一評審標準的小團隊或個人開發者。
- 經常處理 AI 輔助生成代碼、希望 review 不只盯語法和命名的場景。
- 變更裏常夾雜重構、依賴升級,需要單獨紀律檢查的情況。
限制與注意
- SkillHub 頁面當前顯示版本爲 v1.0.0;評分、下載量等會隨商店更新變化,以頁面爲準(資料抓取時評分爲 100000,下載 23 次)。
- 該 Skill 是評審流程與清單,不替代 CI 裏的自動化測試、靜態分析或安全掃描;五維中的「正確性」「安全」仍應與你倉庫裏的工具鏈配合。
- 安裝路徑錯誤是常見坑:務必
--dir指向 Cursor 等客戶端的 skills 目錄。 - 官方簡介末尾帶有「淘寶搜索 AI靈匣」等發佈方信息,與技能能力無直接關係,安裝時以 SkillHub 座標與安裝文檔爲準即可。
結尾¶
多軸代碼評審把合併前的代碼質量檢查固定爲五個維度,並附帶變更拆分、清單、死代碼與依賴升級等紀律,適合在 PR 合併前、功能完成後或 review AI 生成代碼時啓用。安裝與詳情見 SkillHub:https://www.skillhub.cn/skills/org-b6kzcl68/code-review-and-quality