前言¶
自己寫的 Agent Skill 能跑起來，和「別人一裝就能用、觸發穩定、文檔經得起 review」之間，往往差在 SKILL.md 的結構、觸發詞和失敗分支。手工通讀改稿費時，也很難用同一套標準給多個技能打分對比。
下面介紹 SkillHub 上的 魯班.skill（luban-skill-pro，當前公開頁標註 v1.0.6）。它把 Skill 評分、質量檢查、自動優化和 review 收進一套可複用的工作流，適合在發佈或內部分發前系統打磨 SKILL.md。
這是什麼¶
魯班.Skill（luban Skill） 在 SkillHub 上的定位是：工業級智能體技能優化器。技能本體遵循通用 SKILL.md 格式，安裝後由 Agent 按文檔中的流程執行，而不是單獨起一個常駐服務。
維護與分發渠道爲 SkillHub（社區分類 ai-agent；頁面側欄可見 SkillHub 評分約 25994、累計下載約 127702 次，數據以 SkillHub 展示爲準）。官方入口：
https://api.skillhub.cn/user_741dc82b/luban-skill-pro
與同名的開源「魯班打磨工坊」類項目不同，本條目對應的是 luban-skill-pro 優化器套件（含 Quick/Full 雙模、十維 Rubric 等，見安裝後的 SKILL.md 與 REFERENCE.md）。
核心功能¶
結合 SkillHub 簡介與公開的 SKILL.md 摘要（來源標註爲 skillhub.cn），已覈實的能力包括：
- 觸發式接入：用戶提到優化、評分、質量檢查、review 等意圖時，Agent 應加載本 Skill 並按其流程執行。
- Skill 評分（Rubric）：按約十個維度（如 Frontmatter、工作流清晰度、失敗模式、檢查點、可執行具體性、實測表現、安全門控等）加權計分，總分 100，用於基線評估與對比改進效果。
- Quick / Full 雙模：
- Quick（默認）：輕量 Self-Refine，最多約 3 輪，可用.bak回退；偏結構評分與 dry_run 推演。
- Full：完整循環（最多約 5 輪）、多評委、git 分支（如auto-optimize/YYYYMMDD-HHMM）、更嚴的審查與元認知沉澱（如meta_learnings.md）。
- 模式由前置規則選擇，例如用戶明確要求「完整/深度/全面/工業/生產」、基線分偏低、或歷史存在 revert 等情形會傾向 Full。 - 自動優化循環：在「不改變技能核心功能、不隨意加依賴」等約束下，分輪只改一個維度，編輯幅度有預算（如單輪字符變化約 ≤10%），改進需經獨立評分或測試驗證，未提升則回滾並記錄。
- 人在迴路：關鍵檢查點（文檔中的 🔴 CHECKPOINT / 🛑 STOP）會暫停等待確認，避免靜默大改。
- 配套腳本與數據文件：優化過程會在被優化 Skill 目錄下寫入
results.tsv、diagnostics.tsv、test-prompts.json等；魯班工作區目錄下維護optimization-registry.tsv、luban-profile.json等（路徑約定見SKILL.md）。
安裝與啓用¶
安裝方式以 SkillHub 官方說明爲準：先閱讀 SkillHub 安裝與優先源配置，再安裝本包。頁面對本條目的提示爲安裝 @user_741dc82b/luban-skill-pro（SkillHub 上另有鏡像標識 @indiv-ebandao/luban-skill-pro，以你使用的入口爲準）。
1、檢查或安裝 SkillHub CLI
command -v skillhub && skillhub --version
未安裝時可按官方文檔執行（完整安裝示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安裝魯班.skill 到當前 Agent 的 skills 目錄
SkillHub 要求安裝時必須用 --dir 指向 Agent 實際識別的 skills 目錄，否則可能裝到 ./skills/ 而不會被加載。
skillhub install user_741dc82b/luban-skill-pro --dir <你的 skills 目錄>
常見路徑（摘自 skillhub.cn 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝後按你所用客戶端的要求重啓或刷新 Agent，使新 Skill 生效。也可將「請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_741dc82b/luban-skill-pro」發給支持 Skill 安裝的 AI，由其代爲執行上述步驟。
典型用法¶
1、用自然語言觸發
在已啓用本 Skill 的會話中，直接說明意圖即可，例如：
- 「幫我 skill 評分，目錄在
~/my-agent/skills/foo-skill/」 - 「優化 skill，重點改觸發詞和工作流步驟」
- 「做一次 skill 質量檢查 / skill review」
- 「自動優化這個 SKILL.md，需要 完整/深度 流程」（傾向 Full 模式）
官方列出的觸發關鍵詞還包括：優化skill、skill評分、auto optimize、skill質量檢查、小魯班、luban、優化技能、幫我改skill、skill怎麼樣、提升skill質量、skill打分 等。
2、準備被優化的 Skill 目錄
- 確認目標目錄中存在
SKILL.md。 - 建議在 git 倉庫中操作，便於 Full 模式分支與
git checkout回滾；非 git 環境時 Skill 文檔會引導使用git init或文件備份。 - 首次優化會創建或更新
test-prompts.json（典型與歧義場景各若干條），用於實測維度評分。
3、跟隨檢查點
流程中會在 Phase 0.5、基線評估、每輪優化後等節點要求確認。按提示選擇繼續、加輪或收工，避免跳過測試用例設計或靜默 revert。
適用場景與注意¶
適合誰
- 維護多個 Agent Skill 的團隊，需要統一 Rubric 做發佈前門禁。
- 單作者 Skill 已能運行，但觸發不穩、步驟含糊、缺少失敗分支或檢查點。
- SkillHub 或內部技能庫運營，需要對來稿做結構化 review 與可追蹤的改進記錄。
使用注意
- 優化器強調「只改寫法、不改技能要做什麼」，並限制新增 scripts/references；若你希望改業務邏輯，應人工改需求而非指望全自動擴 scope。
- Full 模式依賴 git 與子 Agent 獨立評分；環境不支持子 Agent 時會走文檔中的降級路徑，效果可能與 Full 設計有差距。
- 魯班工作區（
luban-workspace）在文檔中約定爲本 Skill 所在目錄且建議爲 git 倉庫；與被優化 Skill 的數據文件目錄不同，避免混放。 - 第三方鏡像站會全文轉載
SKILL.md，細節以你安裝包內文件爲準；SkillHub 騰訊雲鏡像頁若顯示「Skill 未找到」，可改用 skillhub.cn 技能頁 或上述官方 API 入口獲取安裝提示。
結尾¶
魯班.skill 把 Skill 文檔的質量問題從「憑感覺改」變成可評分、可回滾、可審計的優化流程，適合在發佈前做最後一輪工業化打磨。安裝與更新請以 SkillHub 爲準。
官方地址：https://api.skillhub.cn/user_741dc82b/luban-skill-pro
