前言¶
寫 Agent Skill 的常見路徑是先搜「SKILL.md 怎麼寫」，再翻平臺文檔找部署方式，接着在測試和優化階段繼續查資料。知識分散在 Anthropic 規範、OpenClaw 部署文檔、ClawHub 商店說明裏，版本和術語還不一致。這個 Skill 把這些內容按流程組織成一套可跟隨的說明，減少來回檢索。
這是什麼¶
「智能體技能配置指南」是一個知識型 Skill，座標 @user_148deca1/agentskills-complete-guide，由社區發佈者 user_148deca1 維護，版本 1.0.1，分類 ai-agent。它定位是 AI Agent Skills 的全棧指南：從概念原理、Anthropic 開發規範，到 OpenClaw 部署架構，覆蓋技能從創建到發佈的完整鏈路。它不替代各平臺官方文檔，也不負責具體編碼。
觸發方式與覆蓋範圍¶
按官方說明，它在用戶提到以下話題時觸發：創建技能、Skill 開發、Agent Skills、SKILL.md、觸發器、Hook、漸進式披露、500 行規則、技能部署、ClawHub、OpenClaw 配置、技能測試、技能優化、技能商店、MCP、護欄技能、領域技能、執行級別、會話跟蹤、技能加載、技能發佈、技能註冊表、skill-rules、技能調試。
明確不適用於三類情況：非技能開發領域的通用編程問題；商業產品級技能的全權代勞；各平臺官方文檔的完整替代。
核心內容¶
按官方描述，指南的主線是：
- 概念與原理：解釋技能是什麼、執行級別、會話跟蹤、技能加載、漸進式披露、觸發器、Hook。
- 開發規範：SKILL.md 的寫法、500 行規則、skill-rules、護欄技能與領域技能的區分。
- 測試與優化：技能調試、技能測試、技能優化的通用流程。
- 部署與發佈：技能部署、OpenClaw 配置、技能註冊表、技能商店、ClawHub、MCP 接入。
它屬於知識庫型 Skill，實際產出是結構化的說明與檢查清單，而不是可運行代碼。
安裝與啓用¶
已抓取資料只給出了 SkillHub 座標和標籤 requires_api_key=false，沒有提供標準安裝命令或目錄約定。因此這裏不寫未經覈實的 curl 或 npm 命令。可用入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_148deca1/agentskills-complete-guide
- 官方地址：https://api.skillhub.cn/user_148deca1/agentskills-complete-guide
- 來源歸屬：community（社區），
ai-agent分類，發佈者user_148deca1
在支持該註冊表的客戶端裏按座標安裝即可。是否需要 API Key 的字段在資料中標記爲 requires_api_key=false。Cursor、Codex CLI、Claude Code 的安裝差異，資料中沒有給出，這裏不做區分說明。
典型用法¶
資料裏沒有提供可復現的命令行示例或代碼片段，以下爲按官方描述推導的使用方式，不是官方原文。
按創建技能的流程，可以這樣使用：
1. 讓 Skill 給出 SKILL.md 的字段結構與 500 行規則的判定標準
2. 讓它給出觸發器與 Hook 的配置要點
3. 按 OpenClaw 部署架構準備目錄與註冊表項
4. 用它的測試與優化清單逐項覈對
5. 按技能商店 / ClawHub 的要求準備發佈材料
在提問時把問題限定在技能開發範圍內，例如「漸進式披露在 SKILL.md 裏怎麼體現」「技能調試的檢查順序是什麼」，得到的說明會更貼合指南範圍。
適用場景與注意¶
適合這幾類人：第一次寫 Agent Skill、需要把規範和部署一次問全的開發者；接手他人技能、要做優化和調試的維護者；要在 OpenClaw / ClawHub 生態裏發佈技能的人。
需要注意的限制：
- 它是知識指南，不生成或修改你的技能代碼，商業產品級技能仍需自行實現和評審。
- 各平臺官方文檔持續更新，指南內容以發佈時的版本爲準，遇到不一致以平臺文檔爲準。
- 觸發詞覆蓋面廣，通用編程問題也會被相關詞命中，這類請求應明確轉回普通開發流程。
- 資料中標註的評分與下載數隨時間變化，以 SkillHub 頁面實時數據爲準。
結尾¶
這個 Skill 的價值在於把分散在規範、部署文檔和商店說明裏的知識按技能生命週期組織起來，讓開發者按同一順序獲取信息。倉庫地址：https://api.skillhub.cn/user_148deca1/agentskills-complete-guide
