前言¶
自己寫 Skill 時，常見問題不是「能不能跑」，而是寫完就交差：觸發條件含糊、步驟和約束沒對齊、改了一版卻沒人按同一套標準複查。團隊裏若各自憑感覺驗收，質量會漂移，也不利於在 SkillHub 上長期維護。
下面介紹社區 Skill「Skill TRACE 質量評測流程」。它在每次創建或重大修改 Skill 之後，用 TRACE 五維度做自檢，並要求全部子項達到 5.0 滿分後才視爲任務完成，把「寫完」和「達標」拆開。
這是什麼¶
Skill TRACE 質量評測流程（座標 @user_fcba917f/skill-trace-checker，版本 1.0.0）是 SkillHub 社區來源（community）、分類爲 dev-programming 的評測型 Skill。發佈者爲 user_fcba917f，SkillHub 頁面標註作者爲周博遠（EFU）。標籤 requires_api_key=false，不依賴額外 API Key。
它解決的是：Skill 創建或改版之後，缺少統一、可重複的驗收口徑。與「只跑一遍 happy path」不同，本 Skill 把 TRACE 體系固化爲必須執行的檢查流程。
TRACE 五維度¶
官方簡介中的 TRACE 覆蓋以下五個維度（英文縮寫與中文名稱一併保留）：
| 維度 | 含義 |
|---|---|
| Trust | 可信任度 |
| Reliability | 可靠性 |
| Adaptability | 適用性 |
| Convention | 規範性 |
| Effectiveness | 有效性 |
完成標準：各維度下的全部子項均需達到 5.0 滿分；未達標則任務不算完成。具體子項清單與打分細則在 Skill 本體（SKILL.md）中定義，安裝後由 Agent 按該 Skill 的指令執行，本文不展開未公開的內容。
觸發條件¶
官方說明的觸發場景很明確：
- 每次完成 Skill 創建之後；
- 每次對 Skill 進行重大修改之後。
在上述節點應自動執行本檢查流程，而不是可選的「有空再看一眼」。
核心功能（已覈實）¶
結合 SkillHub 頁面與抓取元數據，可確認的能力邊界如下：
- 五維 TRACE 自檢：按 Trust、Reliability、Adaptability、Convention、Effectiveness 組織檢查項。
- 滿分門檻：全部子項 5.0 才視爲任務完成。
- 與 Skill 生命週期綁定：創建或重大修改後觸發，適合作爲交付前的固定步驟。
- 無 API Key 要求：
requires_api_key=false，降低接入成本。
SkillHub 統計（以頁面與抓取數據爲準，會隨時間變化）：評分 100000，下載約 910 次；安裝數在抓取時爲 0，以 SkillHub 實時頁面爲準。
安裝與啓用¶
SkillHub 推薦兩種方式：用 CLI 安裝，或把提示詞交給當前 AI 客戶端由其按安裝文檔操作。
1. 檢查 SkillHub CLI¶
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
若未安裝，可按 SkillHub 安裝文檔 執行完整安裝或僅安裝 CLI（文檔中的 curl 安裝腳本）。限網環境需在允許聯網的權限下執行。
2. 安裝本 Skill¶
安裝時必須用 --dir 指向當前 Agent 實際使用的 skills 目錄，否則默認落到 ./skills/ 可能不會被識別。
skillhub install @user_fcba917f/skill-trace-checker --dir <你的 skills 目錄>
常用客戶端的 skills 路徑（摘自官方安裝文檔，按你當前環境選用）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
也可直接向 Agent 發送 SkillHub 頁面給出的安裝提示，核心是讓其閱讀並執行：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_fcba917f/skill-trace-checker`。
安裝完成後，按你所用客戶端的要求刷新或重啓 Agent，使新 Skill 進入可用列表。
典型用法¶
本 Skill 基於通用 SKILL.md 格式。公開頁面未提供獨立示例倉庫，可復現的工作流如下：
- 完成某個 Skill 的新建或重大修改（含
SKILL.md及附屬說明、腳本等）。 - 在同一 Agent 會話中啓用或引用
@user_fcba917f/skill-trace-checker，對目標 Skill 執行 TRACE 自檢。 - 對照 TRACE 五維度及 Skill 內定義的子項，逐項覈對是否達到 5.0；若有未達標項，回到 Skill 文稿修改後再次執行檢查。
- 僅在全部子項滿分後，將「創建/修改 Skill」相關任務標記爲完成。
若你同時維護「被測 Skill」與「本評測 Skill」，建議把第 2 步寫進自己的團隊規範或母 Skill 的交付清單，避免改版後跳過複檢。
適用場景與注意¶
適合誰
- 經常在 Cursor、Claude Code、Codex 等環境裏編寫或迭代 Agent Skill 的開發者。
- 希望交付前有一致驗收標準、而不是口頭約定的個人或小團隊。
限制與注意
- 評測深度取決於 Skill 本體中的子項定義；未安裝或未加載時，Agent 無法自動套用 TRACE 流程。
- 「重大修改」的邊界需結合你自己的版本管理習慣界定；官方僅給出觸發語義，不替代你的變更評審。
- SkillHub 上的評分、下載量爲動態數據，引用時以 SkillHub 詳情頁 爲準。
- API 地址
https://api.skillhub.cn/user_fcba917f/skill-trace-checker用於 Skill 元數據與分發；瀏覽器直接訪問可能返回 HTTP 405，安裝仍以 CLI 或安裝文檔爲準。
結尾¶
Skill TRACE 質量評測流程把「創建/改版 Skill」之後的驗收，收斂爲 TRACE 五維、子項 5.0 滿分的可重複步驟，適合作爲 Skill 工程化裏固定的一環。
官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_fcba917f/skill-trace-checker
- 元數據 API：https://api.skillhub.cn/user_fcba917f/skill-trace-checker
- 安裝說明：https://skillhub.cn/install/skillhub.md
