Super Skill Helper - 超级 skill 助手
一站式技能管理解决方案，整合发现、创建、审查、发布四大核心能力。
🔄 四大阶段概览
| 阶段 | 核心功能 | 主要工具 |
|---|---|---|
| 发现 | 多平台搜索、安全验证 | skills.sh, Cocoloop, GitHub |
| 创建 | 开发、测试、评估、优化 | init_skill.py, package_skill.py |
| 审查 | 安全审计、权限分析 | vetting checklist |
| 发布 | 打包、分发、版本管理 | package_skill.py |
🔍 第一阶段：发现（Discovery）
支持的平台
| 平台 | 命令/方式 | 特点 | 优先级 |
|---|---|---|---|
| Skillhub | skillhub CLI |
国内加速，加速+合规，API稳定 | ⭐⭐⭐ |
| skills.sh | npx skills |
官方生态，最大规模 | ⭐⭐⭐ |
| Cocoloop | 浏览器访问 | 国内加速，安全审计 | ⭐⭐ |
| GitHub | gh CLI |
开源社区，直接可控 | ⭐⭐ |
| SkillsMP | 浏览器 + API | 中文界面 | ⭐⭐ |
| ClawHub | clawhub CLI |
有 API 速率限制，经常失败 | ⭐（备选） |
搜索优先级（重要）：
1. skillhub search - 首选，国内网络最优
2. npx skills find - 备选
3. clawhub search - 最后备选，常有速率限制失败
搜索技能
# 方法一：Skillhub（国内推荐，首选）
skillhub.bat search "关键词"
# 方法二：skills.sh（备选）
npx skills find "关键词"
# 方法三：Cocoloop（国内推荐）
# 浏览器访问 https://hub.cocoloop.cn/search?q=关键词
# 方法四：GitHub 搜索
gh search repos "openclaw skill 关键词" --limit 10
安装前安全检查清单
在安装任何技能前，必须进行基础检查：
- 来源可信度：知名组织 > 认证作者 > 个人开发者
- 代码审查：检查 SKILL.md 内容，确认没有可疑代码
- 安装确认：❌ 不要使用
-y跳过确认 - 权限范围：检查需要的外部 API keys
🛠️ 第二阶段：创建（Creation）
技能分类（4 类型）
| 类型 | 定义 | 特征 | 示例 |
|---|---|---|---|
| Tool | 执行特定技术操作 | 明确输入/输出，低自由度 | pdf-processor |
| Workflow | 多步骤流程指导 | 顺序执行，中自由度 | app-deployment |
| Capability | 专业领域增强 | 领域知识，高自由度 | finance-advisor |
| Scenario | 场景定制行为 | 角色扮演，高自由度 | customer-service |
创建流程
需求分析 → 初始化 → 编辑 → 测试 → 评估 → 优化 → 打包
快速命令
# 初始化新技能
python scripts/init_skill.py <skill-name> --path <output-path> --resources scripts,references,assets
# 打包技能
python scripts/package_skill.py <skill-path>
# 描述优化
python scripts/run_loop.py --eval-set <eval.json> --skill-path <skill-path>
核心设计原则
- 简洁至上：上下文窗口是公共资源，只添加必要信息
- 渐进式披露：SKILL.md < 500行，详细信息放 references/
- 解释为什么：不要用死板的指令，让 AI 理解背后的原因
目录结构
skill-name/
├── SKILL.md (必需)
│ ├── YAML frontmatter (name + description)
│ └── Markdown 指令
└── 捆绑资源 (可选)
├── scripts/ - 可执行代码
├── references/ - 按需加载文档
└── assets/ - 输出使用文件
🔐 第三阶段：审查（Vetting）
审查协议
Step 1: 元数据检查
name匹配预期名称（无 typosquatting）version符合 semverdescription清晰且匹配功能author可识别（非匿名）
Step 2: 权限范围分析
| 权限 | 风险等级 | 需要解释 |
|---|---|---|
fileRead |
低 | 几乎总是合法 |
fileWrite |
中 | 必须解释写入什么文件 |
network |
高 | 必须解释哪个端点和原因 |
shell |
严重 | 必须解释确切命令 |
⚠️ 红旗：network + shell 组合可能数据泄露
Step 3: 内容分析
关键红旗（立即阻止）：
- 引用 ~/.ssh, ~/.aws, ~/.env 凭证文件
- curl, wget, nc, bash -i 命令
- Base64 编码或混淆内容
- 禁用安全设置的指令
警告红旗（标记审查）：
- 过宽文件访问（/**/*, /etc/）
- 修改系统文件指令
- sudo 或提权请求
- 提示注入模式
Step 4: Typosquat 检测
检查名称是否仿冒知名技能：
- 单字符增删改
- 同形字替换（l vs 1, O vs 0）
- 多余连字符或下划线
- 常见拼写错误
审查报告格式
SKILL VETTING REPORT
====================
Skill: <name>
Author: <author>
Version: <version>
VERDICT: SAFE / WARNING / DANGER / BLOCK
PERMISSIONS:
fileRead: [GRANTED/DENIED] — <justification>
fileWrite: [GRANTED/DENIED] — <justification>
network: [GRANTED/DENIED] — <justification>
shell: [GRANTED/DENIED] — <justification>
RED FLAGS: <count>
<list of findings>
RECOMMENDATION: <install / review further / do not install>
信任层级
- Official OpenClaw skills（最高信任）
- UseClawPro 验证技能
- 知名作者公开仓库
- 社区高下载多评论
- 新作者未知来源（最低信任 → 全审查）
📦 第四阶段：发布（Publishing）
打包流程
# 1. 确保技能目录完整
ls <skill-path>/
# 应包含: SKILL.md, scripts/, references/, assets/
# 2. 运行打包脚本
python scripts/package_skill.py <skill-path>
# 3. 验证生成的 .skill 文件
# 文件位置: <skill-path>.skill
版本管理
更新 SKILL.md frontmatter：
metadata:
version: "1.0.0" # semver 格式
updated: "2026-03-28"
🔄 完整工作流程
快速模式（发现 → 安装）
用户询问技能 → 多平台搜索 → 快速安全检查 → 安装指导
创作模式（创建 → 发布）
需求分析 → 初始化 → 编辑 → 测试用例 →
评估查看器 → 用户反馈 → 优化迭代 → 打包发布
完整模式（全生命周期）
发现 → 基础审查 → 创建/优化 →
深度审查 → 打包 → 分发 → 安装验证
📋 常用技能推荐
搜索与研究
| 技能 | 说明 |
|---|---|
| tavily-search-pro | AI 搜索平台 |
| summarize | 多模态内容摘要 |
开发工具
| 技能 | 说明 |
|---|---|
| agent-browser | 浏览器自动化 |
| docker-sandbox | 安全沙箱执行 |
办公自动化
| 技能 | 说明 |
|---|---|
| gog | Google Workspace CLI |
| wacli | WhatsApp 管理 |
🔗 快速链接
- skills.sh: https://skills.sh
- Cocoloop: https://hub.cocoloop.cn
- SkillsMP: https://skillsmp.com/zh
📚 参考文件
详细文档位于 references/ 目录：
references/schemas.md— JSON 结构定义references/skill-classification.md— 4类型分类详情references/progressive-disclosure.md— 渐进式披露原则references/workflows.md— 多步骤流程指南references/output-patterns.md— 输出模式最佳实践
子代理说明位于 agents/ 目录：
agents/grader.md— 评分代理agents/comparator.md— 比较代理agents/analyzer.md— 分析代理
更新日志
- 2026-03-28: 创建融合版，整合 find-skills + skill-creator-enhanced + skill-vetter
