Skill Curator：當你的 Agent 有 125 個技能但只活了 64 個 | Agentic Research

命題： 你給你的 Agent 裝了 125 個技能。你覺得它很強大。實際上，它只能正確調用其中 64 個。另外 61 個——6 個永遠無法觸發、55 個對中文用戶基本無效。
方案： Skill Curator——一個六階段自動策展引擎。掃描 → 診斷 → 調適 → 場景 → 報告 → 執行。
結果： 125 個技能從 51% 健康度提升至 99.2%。6 致命 → 1（幽靈技能），55 警告 → 0，64 健康 → 124。

🎭 第一章：圖書館悖論

想像你走進一個圖書館。書架上堆滿了書——125 本。但：

60% 的書沒有中文目錄——你用中文搜不到
6 本書連封面都沒有——根本不知道裡面是什麼
15 本書內容完全重疊——但你不知道該扔掉哪本
沒有人告訴你每本書的用法——你站在門口，不知所措

這就是每個 AI Agent 面臨的現實。

我們把這個現象命名為「圖書館悖論」： 技能越多 ≠ 能力越強。沒有策展，技能數量與可用性成反比。

問題的根源

Agent 生態系統有三個結構性問題：

技能是下載來的，不是調適來的。 開源技能的 description 欄位 95% 是純英文。中文用戶說「幫我做網站」→ description 中只有 "frontend design"、"UI engineering" → 關鍵詞匹配失敗 → 技能形同虛設。
格式錯誤是天生的。 社區技能抄來抄去，frontmatter YAML 錯位、缺少必填欄位、編碼問題——一個空白的 description 能讓技能永遠無法觸發。
沒有人會主動維護技能。 用戶的下載行為是一次性的，維護行為是零次的。你需要一個自動化的「技能管家」。

🔬 第二章：審計——125 個技能的血檢報告

2026 年 5 月，我們對 UltraClaw 的 125 個技能進行了首次全面健康掃描。以下是血檢結果：

健康度分布

🔴 致命

無 description 或格式損壞，永久無法被觸發。相當於「這本書沒有封面」。

🟡 警告

缺中文關鍵詞，description 純英文。中文用戶觸發成功率低於 20%。

🟢 健康

格式完整 + 中英雙語關鍵詞。但仍有功能重疊和未測試的隱患。

核心發現

指標	數據	嚴重性
整體健康率	51.2%	一半技能處於亞健康或死亡狀態
非英語觸發成功率	~20%	每 5 次中文指令只有 1 次能找到對的技能
描述語言覆蓋率	1.2 種語言/技能	95% 的技能只有英文 description
功能重疊技能組	7 組（15 技能）	同一功能有 2-3 個重疊技能互相干擾

結論： 你以為你的 Agent 很強。實際上，每兩個技能就有一個在摸魚。

🧬 第三章：六階段生命週期

Skill Curator 的核心設計理念是全生命週期管理。不是一次性修復，而是持續性的健康維護。

{["1️⃣ 掃描 Scan", "2️⃣ 診斷 Diagnose", "3️⃣ 調適 Adapt", "4️⃣ 場景 Scenarios", "5️⃣ 報告 Report", "6️⃣ 執行 Execute"].map((phase, i) => (

{phase}

))}

Phase 1：掃描 Scan —— 全量健康盤點

掃描器遍歷 skills/ 目錄下的所有 SKILL.md 文件，提取：

Frontmatter 完整性： name、description 必填欄位是否存在
語言覆蓋率： description 中包含了多少種語言
關鍵詞矩陣： 每個語言下有哪些觸發詞
檔案元數據： 大小、修改時間、授權類型

# 掃描報告示例片段
{
  "skill": "frontend-design",
  "health": "🟡 warning",
  "issues": [
    "description 僅含英文 (1/6 language)",
    "缺失關鍵詞: 網站, 前端, 建站, 網頁"
  ],
  "recommended_action": "inject_keywords"
}

掃描結果自動生成 JSON 報告，供後續階段消費。

Phase 2：診斷 Diagnose —— 三層分類

這是 Skill Curator 最有價值的設計：不是所有問題都同等重要。

🔴 致命級 Critical

技能完全無法被觸發。需要立即修復。

description 欄位缺失或為空
Frontmatter YAML 語法錯誤導致解析失敗
SKILL.md 檔案損壞或為空

首次掃描發現 6 個致命技能。其中 4 個是因為 community skills 的 frontmatter 格式異常（縮排錯誤、使用了非標準欄位導致解析器跳過必填欄位）。

🟡 警告級 Warning

技能存在但效率極低。對非英語用戶幾乎不可用。

description 僅包含英文（觸發詞覆蓋 1/6 語言）
缺少繁體中文、簡體中文、日文、韓文、阿拉伯文關鍵詞
Frontmatter 完整但 description 過短（< 50 字符）

首次掃描發現 55 個警告技能。這是最大的問題集——佔總數的 44%。每個都「理論上可用」，但對使用繁體中文的老闆來說，觸發率低於 20%。

🟢 建議級 Suggestion

技能功能正常但存在優化空間。需要用戶確認後執行。

功能重疊：多個技能實現相同/類似功能（如 3 個不同的「前端設計」技能）
從未使用：技能安裝超過 30 天但零調用記錄
Token 優化：技能 SKILL.md 過大（> 20KB），每次載入消耗大量 context

首次掃描發現 7 組功能重疊（涉及 15 個技能），以及 12 個「幽靈技能」（安裝後從未被調用過）。

Phase 3：調適 Adapt —— 自動修復引擎

這是 Skill Curator 的「外科手術」環節。全自動執行，但永遠先備份。

3.1 六語言關鍵詞注入

核心算法：解析 description 的語義內容 → 為每個缺失的語言生成對應關鍵詞 → 注入到 description 欄位。

修復前：
description: "Full-stack web application development with modern frameworks"

修復後：
description: "全棧開發 網站製作 前後端 Webアプリ開発 풀스택 개발 
تطوير الويب 全栈开发 site web Full-stack web application development 
with modern frameworks"

六語言覆蓋：

🇹🇼 繁體中文
🇨🇳 簡體中文
🇯🇵 日本語
🇰🇷 한국어
🇸🇦 العربية
🇬🇧 English（原有）

3.2 Frontmatter 修復

自動修正常見的格式損壞：

YAML 縮排錯誤 → 重新格式化
缺少 description → 從技能內容中自動提取並生成
非標準欄位 → 保留但移到注釋區域
編碼問題 → 統一到 UTF-8

3.3 安全機制：永遠先備份

# 每次修復前自動執行
cp skills/frontend-design/SKILL.md skills/frontend-design/SKILL.md.bak.$(date +%s)

結果： 首次策展中，61 個技能被自動修復。零出錯。因為每次修改前都保留了原始檔案。

Phase 4：場景生成 Scenarios —— 「你應該這樣用我」

修復只是讓技能可以被發現。場景生成讓技能被正確使用。

為每個技能自動生成 3-5 個觸發場景：

## 🧪 觸發場景

| 你想做什麼 | 你應該說 | 觸發技能 |
|-----------|---------|---------|
| 建立公司網站 | 「幫我做個官網」 | Frontend Design |
| 股票調研 | 「調研一下騰訊」 | AK-HK-Stock-DD |
| 生成投資建議書 | 「寫一份投資提案」 | AK-Investment-Proposal |
| 發送日報郵件 | 「寄出今日報告」 | Email Report |
| 建立飛書文檔 | 「創建會議記錄」 | Feishu Create Doc |

場景生成的價值：

降低學習成本： 用戶不需要知道技能名稱，只需要知道「我想做什麼」
提高觸發精度： 場景中的觸發詞會被同步到 description，形成正向循環
發現隱藏功能： 用戶可能不知道 Agent 有某些技能，場景生成把它們曝光出來

Phase 5：報告 Report —— 透明度是信任的基石

策展完成後，自動生成結構化報告，推送到飛書：

## 📊 Skill Curator 策展報告 — 2026-06-10

### 健康度趨勢
- 整體健康率：51.2% → 99.2% (+48.0%)
- 致命技能：6 → 1 (-83.3%)
- 警告技能：55 → 0 (-100%)
- 健康技能：64 → 124 (+93.8%)

### 本次執行的操作
- 🔧 自動修復：61 個技能
- 🌏 關鍵詞注入：61 個技能（平均每個 +15 個關鍵詞）
- 🔨 Frontmatter 修復：4 個技能
- 📋 場景生成：125 個技能（共 487 個場景）
- ⚠️ 建議卸載：3 個重疊技能（等待審批）
- 👻 幽靈技能：1 個（無法修復，已標記）

### 語言覆蓋率提升
- 修復前：平均 1.2 語言/技能
- 修復後：平均 5.8 語言/技能

報告的設計原則：

不是給開發者看的技術日誌，是給決策者看的健康報告
每一項操作都可追溯——備份檔案路徑、修改內容、時間戳
建議類操作需要用戶明確審批，不做黑箱決策

Phase 6：執行 Execute —— 人機協作的決策邊界

這是 Skill Curator 最關鍵的設計原則：自動化的邊界。

操作類型	執行方式	原因
關鍵詞注入	🤖 全自動	無風險，可逆，有備份
Frontmatter 修復	🤖 全自動	格式修正，不改語義
場景生成	🤖 全自動	附加內容，不修改原文件
去重合併	👤 需審批	涉及功能變更
卸載技能	👤 需審批	不可逆操作
路由規則調整	👤 需審批	影響全局行為

設計理念： 能自動的就自動，不能自動的就清楚標記，等待用戶決定。Agent 不應該替人類做價值判斷。