ClawHub Publish Workflow — ClawHub 发布工作流程

CLAWHUB 发布工作流 📦 完成的工作流程，用于将技能发布到 ClawHub 信息值 版本 1.3.0 — 2026-05-07 状态 OPERATIONAL

• 目的和范围

目标 为任何 OpenClaw 代理提供一个完整的工作流程，以使用双重评估系统将技能发布到 ClawHub。 通用设计 适用于任何 OpenClaw 代理，无论集群或环境如何。 何时使用 触发操作 创建一个新技能以发布 请遵循此工作流程 需要评估和改进 使用捆绑的双评估器 发布到 ClawHub 请遵循所有步骤 修复失败的评估 运行评估 + 修复

• 捆绑工具

文件系统 目的 evaluator.py 5 维彩色 5 维评估 eval-skill.py ISO 25010 自动结构检查（13 项测试） references/tools.md — 完整工具参考 双评估系统 ┌─────────────────────────────────────────────┐ │ CLAWHUB 发布工作流 │ ├─────────────────────────────────────────────┤ │ 1. eval-skill.py (ISO 25010) │ │ → 自动检查（13 项测试） │ │ → 目标：90%+ 结构评分 │ │ │ │ 2. evaluator.py (5 维) │ │ → 5 维 × 20% = 100 │ │ → 目标：70+ 评分 │ │ │ │ 3. 手动（25 项标准） │ │ → ISO 25010 评分标准（8 类别） │ │ → 目标：80+ 评分 │ └─────────────────────────────────────────────┘

• 完整工作流程

步骤 1：创建 SKILL.md 任务：

• 创建 SKILL.md（英文，非个人，通用）
• 包括前置内容，包括名称 + 描述
• 遵循标准技能结构
• 使其可供任何代理访问

前置内容模板： --- name: skill-name description: "技能描述。使用时：（1）触发器 1，（2）触发器 2，（3）触发器 3。提供 X，Y，Z。" ---

步骤 2：自动 ISO 25010 检查 # 运行自动结构检查 python3 eval-skill.py <技能路径> --verbose # 目标：90%+（12+/13 项检查通过）

步骤 3：5 维评估 # 运行完整的 5 维评估 python3 evaluator.py <技能路径> --verbose --improve # 目标：70+ 评分

步骤 4：手动 25 项标准评估 评分使用评分标准： 类别 最高评分 功能适用性 /12 可靠性 /12 性能 /8 人工智能可用性 /12 人类可用性 /8 安全性 /12 可维护性 /12 代理特定 /24 总计 /100

步骤 5：修复问题 低评分区域 修复 结构 <15 添加缺失部分，格式 清晰度 <15 添加示例，命令，约束 完整性 <15 添加工具，先决条件，错误 一致性 <15 添加样式标记，命名一致性 功能性 <15 修复命令语法

步骤 6：重新评估 # 继续直到达到目标 python3 eval-skill.py <路径> --verbose # 目标：90%+ python3 evaluator.py <路径> --verbose # 目标：70+

步骤 7：发布 # 登录 clawhub login --token --no-browser # 检查 slug 可用性 clawhub inspect 2>&1 # 发布 clawhub publish <路径> \ --slug \ --name "<名称>" \ --version 1.0.0 \ --changelog "<更改日志>"

步骤 8：验证 clawhub inspect

• 评估目标

系统 指标 目标 命令 ISO 25010 结构 90%+ eval-skill.py --verbose 5 维评分 70+ evaluator.py --verbose 手动 25 项标准 80+ 评分标准评分

• 常见问题

"Slug 已被占用" → 使用替代：yourname-<技能名称> "API 令牌无效" → 获取新令牌 https://clawhub.com/settings/tokens "名称不匹配" → 重命名目录以匹配前置内容名称： 评分 < 70 后修复 → 首先关注评分最低的维度

• 边缘情况

情况 解决方案 没有前置内容 添加 --- 在开始处，包括名称 + 描述 缺失工具部分 文档所有必需工具 没有示例 添加至少 2 个具体示例 SKILL.md 过长 将其分割到 references/ 中 空脚本目录 删除空目录

• 技能结构模板

--- name: skill-name description: "技能描述。使用时：（1）触发器 1，（2）触发器 2。" --- # 技能名称

1. 目的和范围

2. 捆绑工具

3. 先决条件

4. 使用

```bash # 命令在此

• 示例
• 约束
• 错误处理
• 边缘情况

--- _In Altum Per Partage._ 📦 ClawHub 发布工作流 v1.3