前言¶

很多人一上來就用 skill-creator 寫 SKILL.md，結果觸發詞含糊、步驟拆不清、和別的 skill 邊界重疊，改幾輪仍不好測。常見做法是邊寫邊補需求；更穩妥的是先有一份需求規格級的「施工藍圖」，再交給創建類 skill 落地。下面介紹 SkillHub 上的 高質量 skill 設計指南（積木化工作流，座標 @user_814dbe54/high-quality-skill-guidance，當前 v3.1.1）：在動手寫文件之前，把模糊想法收成可鏈接、可複用、可衡量、可演進的 Skill 設計。

這是什麼¶

一句話定位：創建 skill 之前的設計指南，產出技能藍圖 brief（含文件結構示意），施工與寫文件交給兄弟 skill skill-creator（本 skill 可銜接調用，但不取代它）。

• 維護與分發：SkillHub 社區 skill，分類 ai-agent，發佈者 user_814dbe54；頁面標註 requires_api_key=false。
• 解決的問題：把「高質量 Skill 設計」收成標準化流水線，避免直接從零寫 SKILL.md 卻缺少邊界、驗收與演進思路。

官方入口：

• API / 分享頁：https://api.skillhub.cn/user_4894573e/high-quality-skill-guidance
• SkillHub 詳情：https://www.skillhub.cn/skills/user_814dbe54/high-quality-skill-guidance

核心功能¶

以下能力均來自 SkillHub 公開簡介，按使用順序理解即可。

10 格積木鏈¶

用固定鏈條把念頭結構化，對應格子爲：條件 → 事實 → 觀點 → 問題 → 分析 → 決策 → 計劃 → 行動 → 結果 → 復盤。目標是讓後續 skill 的觸發條件、事實來源、決策分支和驗收結果都有落點，而不是堆一段長提示詞。

四步施工流¶

1. 意圖路由 + 10 格流水線（判斷你是新建、改進還是體檢）。
2. 概念討論：對齊要解決什麼問題、不做什麼。
3. 初步方案 → 深化設計：收斂觸發場景與能力邊界。
4. 施工藍圖：輸出可交給 skill-creator 的 brief。

趕時間可走 輕量通道（官方說明約 30 分鐘出藍圖）；表達「創建 / 改進 skill」時，通常會先給一次輕量建議，由你決定是否先出藍圖再落地。

交付物與質量閉環¶

• 技能藍圖 + 文件結構圖（提供 7 套框架範例作參考）。
• 五維就緒度打分：對當前設計做體檢（例如「給我的 skill 打個分」「這個 skill 哪裏不合格」）。
• 測試打磨閉環：藍圖定稿後再進入測試與迭代；改進已有 skill 時強調 診斷先行。

與兄弟 skill 的分工¶

用戶以中文提問時以中文引導、術語保留英文；英文提問則英文引導。

安裝與啓用¶

SkillHub 頁面給出的安裝方式是：讓 AI 按官方安裝說明操作，並安裝指定座標。

請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_814dbe54/high-quality-skill-guidance。

也可在 SkillHub 詳情頁使用「下載 Zip 包安裝」或「安裝到本地 Agent」等入口（具體步驟以頁面與 skillhub.md 爲準）。本 skill 未要求 API Key。

典型用法¶

安裝並啓用後，在對話裏用自然語言說明意圖即可，無需先懂目錄規範。下列表述會命中本 skill（摘自官方 Use when 說明）：

新建與設計

• 「幫我設計一個 skill」「skill 怎麼設計」「SKILL.md 該寫什麼」「skill 目錄怎麼搭」
• 「我想創建一個 XXX 技能」「create / build / design a skill」

改進與把關

• 正在用 skill-creator 寫改 skill，希望先做一次設計把關
• 「improve a skill with skill-creator」

體檢與演進

• 「給我的 skill 打個分」「體檢 skill」「這個 skill 哪裏不合格」

未明說「做技能」但本質相同

• 「把這件事教給 AI」「讓 AI 更會做 XX」「幫我把這個流程固化下來」

經過上面的步驟，你會得到藍圖 brief；確認後再交給 skill-creator 生成或修改 skill 文件。若從 skill-rebuild 過來做「吸收結果落庫」，本 skill 負責入庫側銜接，不負責替你做優秀 skill 的拆解提煉。

適用場景與注意¶

適合誰

• 第一次做 Agent Skill，希望先有規格再寫文件。
• 已有 skill 反覆改仍不清晰，需要診斷與五維打分。
• 團隊希望 skill 可鏈接、可複用、可衡量、可演進，而不是一次性提示詞。

不要用本 skill 的情況（官方 Do NOT use）

• 僅安裝、推薦、管理已安裝的 skill。
• 在 SkillHub 上找 skill（交給 find-skills 類）。
• 「這個 skill 很好你學一下」式拆解提煉（交給 skill-rebuild）。
• 一次性腳本、無複用價值的單點小助手。
• 只想學 Skill 設計理論、不要藍圖產出（本 skill 產藍圖，不講純理論課）。

結尾¶

高質量 skill 設計指南把設計階段收成 10 格積木鏈 + 四步施工流，先出藍圖與就緒度評估，再與 skill-creator 分工落地。若你正準備新建或改進任意 Skill，可從 SkillHub 安裝 @user_814dbe54/high-quality-skill-guidance，或直接打開官方分享頁：https://api.skillhub.cn/user_4894573e/high-quality-skill-guidance 。