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在根目录）

> 5. 网盘下载链接

> 6. 开发总结