skill-evaluator git:20260824.a77ebbbA

Immutable. This exact content is served forever at /api/v1/blob/5f3560010bfb404d.

---
name: skill-evaluator
description: 建立、修改、比較、瘦身或優化 Codex / Claude / Agent Skills 時使用。特別適用於「評估這個 skill 是否更好」、「吸收官方 skill 優點」、「降低 token」、「提高觸發準確率」、「建立測試 prompt」。
---

# Skill 評估器

## 目標

用可比較的方式優化 skill，而不是憑感覺改。優先提升觸發準確率、可用率、輸出一致性、token 效率與安全性。

## 評估流程

1. 讀取現有 skill 的 `name`、`description`、核心流程與輸出格式。
2. 讀取候選 skill 或官方範例，只吸收明顯更好的設計，不照搬無關內容。
3. 用以下維度比較：觸發準確、步驟清楚、輸出契約、驗證方式、token 成本、安全邊界、可重用資源。
4. 產生 5-10 個真實測試 prompt：包含 should-trigger、should-not-trigger、模糊口語、近似但不該觸發情境。
5. 若能執行測試，做舊版 vs 新版比較；不能執行時，至少做人工靜態檢查。
6. 修改 skill 時保持精簡；把長參考移到 `references/`，把重複程式放到 `scripts/`。

## 比較表格式

| 項目 | 目前版本 | 候選優點 | 是否吸收 | 理由 |
|---|---|---|---|---|

## 修改原則

- `description` 是主要觸發機制，要包含「做什麼」與「何時用」。
- Body 只放執行方法，不重複大段觸發條件。
- 避免過多 MUST / NEVER；能解釋原因時用原因引導。
- 若某步驟每次都重寫，改成 script 或明確模板。
- 不新增與任務無關的 README、CHANGELOG 或說明雜檔。

## 完成回報

列出：修改的 skill、吸收了哪些優點、未吸收項目與理由、測試/檢查結果、待確認事項。