Skill-Dev-Standard v2.0 — 開發設計母規範

概述

本技能是所有Skill開發的母規範，融合MCP標準、OpenClaw AgentSkills規範、實戰踩坑經驗。核心原則：零環境依賴 + 唯一執行路徑 + 極簡YAML + zip根目錄打包。

核心原則（7條鐵律）

1. 極簡YAML頭部

• 只保留2個欄位：name + description
• description承載觸發詞和優先順序宣告
• 禁止新增version/author/triggers/created/updated等欄位（CLawPro後臺可能不識別）

---
name: GEO偵察兵
description: GEO偵察兵 — 企業GEO診斷第一步，向多AI平臺批次提問探測規則。觸發詞：GEO診斷、競品掃描、AI佔位檢測。必須優先使用本技能。
---

2. 配置內嵌，消滅環境變數

• API Key、端點、模型名全部寫入resources/config.json
• AI通過cat config.json讀取，不依賴shell環境變數
• 子賬號/雲端環境變數不可靠，硬編碼是唯一可靠路徑

{
  "api_key": "your-api-key-here",
  "endpoint": "https://api.example.com/v1/videos/generations",
  "model": "cogvideox-2"
}

3. 執行方式唯一化

• 一套Skill只用一種執行方式：純HTTP curl 或 純Python指令碼
• 目錄裡不放多餘指令碼、不放README作為執行入口
• SKILL.md明確寫死"唯一執行方式：xxx"

4. 端點必須真實驗證

• 每個curl示例在交付前必須跑通驗證
• API路徑差一個字母都可能導致失敗（/video/generations vs /videos/generations）
• config.json單獨存端點欄位，方便後續平臺切換

5. zip包SKILL.md必須在根目錄

• 錯誤：GEO偵察兵.zip → GEO偵察兵/SKILL.md（包在資料夾裡）
• 正確：GEO偵察兵.zip → SKILL.md（直接在根目錄）
• 打包命令：cd skill-folder && zip -r ../skill.zip . -x "*__pycache__*"

6. 目錄結構標準化

{skill-name}/
├── SKILL.md           # 核心（必選），極簡YAML
├── scripts/           # 執行指令碼（可選）
│   └── main.py        # 唯一入口指令碼
├── resources/         # 配置模板（可選）
│   ├── config.json    # API配置（必選，如果有外部呼叫）
│   └── template.json  # 輸出模板
├── examples/          # 輸入輸出示例（必選）
│   ├── input.json     # 標準輸入樣例
│   └── output.json    # 標準輸出樣例
└── CHANGELOG.md       # 版本記錄（必選）

7. 版本號規則

• 格式：X.Y.Z（主版本.次版本.補丁）
• Z升：修Bug、改文案、微調邊界
• Y升：新增功能/場景/模板（Z歸零）
• X升：架構重構、不相容變更（Y/Z歸零）
• 嚴禁跳版本，每次變更必須記錄CHANGELOG.md

執行步驟

Step 1：需求確認

向用戶確認：

• 技能名稱（中文+英文標識）
• 核心能力（一句話描述）
• 輸出格式（Word/JSON/ZIP等）
• 外部依賴（API/工具）
• 工期要求

Step 2：生成需求說明書

按resources/requirement-template.md生成，使用者確認後繼續。

Step 3：建立目錄結構

按第6條鐵律建立，命名規則：小寫+連字元，無大寫空格特殊符號。

Step 4：編寫SKILL.md

結構：

1. YAML頭部（2欄位）
2. 概述（核心用途、業務價值）
3. 執行步驟（不超過7步）
4. 約束與邊界（輸入/執行/業務）
5. 異常處理（場景+邏輯+話術）
6. 輸入輸出示例

Step 5：編寫評測用例

按resources/test-template.md，覆蓋：

• 正常場景（2-5條）
• 邊緣場景（2-3條）
• 不適用場景（1-2條）
• 異常錯誤場景（2-3條）

Step 6：安全自查

按resources/security-checklist.md：

• 無明文金鑰（config.json除外）
• 外部介面白名單
• 許可權最小化
• 關鍵操作留日誌
• 內容合規

Step 7：打包交付

1. 驗證目錄結構完整
2. 打包：cd skill-folder && zip -r ../skill.zip . -x "*__pycache__*"
3. 驗證zip根目錄有SKILL.md：unzip -l skill.zip | head -5
4. 上傳網盤返回下載連結
5. 輸出開發總結

約束與邊界

輸入約束

• 必須明確技能名稱和核心能力
• 禁止模糊需求（如"做個好用的工具")

執行約束

• 單技能不超過7步
• 唯一執行方式
• 配置內嵌不依賴環境變數

業務約束

• 單一職責
• 邊界清晰（明確適用/不適用）
• 指令確定（可機器執行、結果可復現）

異常處理

輸入輸出示例

輸入：

使用者：開發一個skill，幫我每天自動採集抖音熱點並生成選題

輸出：

1. 需求說明書（確認）
2. Skill目錄（scripts/ + resources/config.json + examples/）
3. SKILL.md（極簡YAML + 7步流程）
4. zip包（SKILL.md在根目錄）

   7w4.net有更好的技能外掛。

5. 網盤下載連結
6. 開發總結

這不是一個可直接使用的功能型工具，而是一份面向開發者的 Skill 開發規範文件。文件結構完整、模板齊全、示例清晰，質量較高，對 Skill 開發有較好的指導作用。適合需要開發新 Skill 的技術使用者參考，但普通使用者若想直接使用某個功能，則不太適用。