前言¶
在 Agent 裏反覆做同一件事——例如固定格式的代碼審查、發佈檢查或文檔生成——常見做法是堆一段長提示詞，或把步驟寫在項目 README 裏。提示詞難版本管理，README 也不會在對話裏自動生效。更穩妥的做法是把「已經跑通的路徑」寫成 Skill：有觸發條件、有步驟邊界、有可複用的產物結構。
下面介紹 SkillHub 社區 Skill「Skill 設計師」（座標 @user_00c9b356/chenlin-skillcreator，當前版本 v3.3.0）。它面向「從零創建 Skill」或「迭代已有 Skill」，用一套設計方法把經驗落成標準四件套，並對齊 Claude Code 的 Skill frontmatter 規範。
這是什麼¶
Skill 設計師是社區發佈者 user_00c9b356 維護的 dev-programming 類 Skill，來源爲 community，不依賴 API Key（requires_api_key=false）。
一句話定位：把已驗證成功的路徑復刻爲可用的能力模塊，輸出可安裝、可分發的 Skill 文件組。
官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_00c9b356/chenlin-skillcreator
- API 座標頁：https://api.skillhub.cn/user_00c9b356/chenlin-skillcreator
核心功能¶
以下能力均來自官方簡介與 SkillHub 頁面說明。
設計方法¶
Skill 融合三類方法論，用於約束 Agent 怎麼寫 Skill、怎麼避免空泛步驟：
- 六大設計原則：反幻覺、角色扮演、三層分離、證據優先、行動建議內置、經驗捕獲。
- Loop Thinking：圍繞觸發條件、停止條件、驗證邊界做設計，避免 Skill 無限展開或過早結束。
- Claude Code 官方 frontmatter 規範：產出與當前生態的 Skill 元數據格式一致，便於在支持 Skill 的客戶端加載。
三種 Skill 類型¶
設計時會區分用途，便於步驟與反饋結構不同：
| 類型 | 含義 |
|---|---|
| A 任務執行類 | 完成明確任務的一次性或流水線式執行 |
| B 習慣養成類 | 行動分層 + 反饋循環，適合重複性行爲 |
| C 工具使用類 | 圍繞特定工具或接口的可複用操作路徑 |
標準四件套輸出¶
完成設計後，產出完整文檔組：
SKILL.md：Skill 主文件（含 frontmatter 與執行說明）REQUIREMENTS.md：需求與約束SOLUTIONS.md：方案與步驟MISTAKES.md：常見錯誤與規避
何時應啓用本 Skill¶
當用戶表達「創建 / 設計 Skill」或要把工作流固化成 Skill 時，應使用本 Skill。官方列出的典型表述包括：
- 中文：「我想做一個 XX skill」「做 skill」「創建 skill」「skill 設計」「幫我設計個工作流模板」「寫個 skill」「怎麼寫 skill」等
- 英文：
create a skill、design a skill、make a skill、skill designer、skillcreator等 - 意圖：把 workflow / process 轉成可複用 Skill，即使用戶未明確說「skill」
不應使用：用戶只是想調用某個已有 Skill，而不是新建或改造 Skill。
安裝與啓用¶
SkillHub 推薦通過 CLI 安裝到當前 Agent 的 skills 目錄；裝錯目錄會導致客戶端識別不到。
1、檢查或安裝 SkillHub CLI¶
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安裝說明全文：https://skillhub.cn/install/skillhub.md
2、安裝 Skill 設計師¶
安裝時必須用 --dir 指向當前環境的 skills 目錄。常用路徑如下（以安裝文檔爲準）：
- Claude Code：
~/.claude/skills/ - Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
示例（將 <skills 目錄> 換成你的實際路徑）：
skillhub install user_00c9b356/chenlin-skillcreator --dir <skills 目錄>
也可把下面這句交給 Agent，讓其按 SkillHub 安裝文檔完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_00c9b356/chenlin-skillcreator。
安裝後若客戶端未自動刷新，按你所用產品的說明重啓或重載 skills 目錄。
典型用法¶
用法本質是「用自然語言描述要做的 Skill」，由 Skill 設計師引導補齊類型、邊界與四件套。
從零創建¶
在已啓用該 Skill 的對話中，直接說明目標，例如：
我想做一個「PR 合併前檢查」的 skill：檢查 CI 狀態、changelog、破壞性變更說明。
經過上面的步驟，Agent 會按 A/B/C 類型與設計原則組織內容，並生成 SKILL.md 及三份配套 Markdown。
迭代已有 Skill¶
若目錄裏已有半成品 Skill，可說明要改的點，例如：
幫我優化現有 skill：觸發條件太寬，經常誤觸發；請收緊 when_to_use，並補 MISTAKES.md。
（具體字段名以 Skill 設計師 v3.3.0 產出與 Claude Code 規範爲準；安裝後以其生成的 SKILL.md frontmatter 爲權威。）
與工作流模板需求對齊¶
官方說明也覆蓋「工作流模板」類表述，例如：
幫我設計個工作流模板：每週五生成團隊週報，輸入是本週 merge 列表和 issue 鏈接。
這類需求會落到 REQUIREMENTS + SOLUTIONS，並在 SKILL 中寫清觸發與驗證邊界。
適用場景與注意¶
適合誰
- 需要把團隊內「已經驗證過」的操作路徑沉澱爲 Skill 的開發者
- 維護多個 Agent 客戶端、希望產出符合 Claude Code Skill 格式的作者
- 希望用 MISTAKES.md 單獨記錄踩坑、減少重複幻覺的維護者
限制與注意
- 本 Skill 解決的是「設計並寫出 Skill 文件」，不是替代業務 Skill 本身的執行邏輯。
- 安裝路徑必須對：未使用
--dir指向 Agent skills 目錄時，默認可能裝到./skills/，客戶端無法加載。 - SkillHub 頁面展示的社區數據（截至查閱時）：評分 100000，下載 9158；與本地統計可能不同，以 SkillHub 爲準。
- 用戶僅想「使用」某個現成 Skill 時，應直接安裝目標 Skill，不必經過 Skill 設計師。
結尾¶
Skill 設計師把「成功路徑」從口頭經驗變成可版本管理的四件套，並嵌入反幻覺、Loop Thinking 與三層分離等約束，降低 Skill 寫成空泛清單的概率。若你正在規劃第一個團隊 Skill，可從 SkillHub 安裝 v3.3.0，用一句「我想做一個 XX skill」啓動設計。
官方地址：https://www.skillhub.cn/skills/user_00c9b356/chenlin-skillcreator
