📦 ClawHub 发布工作流程

> 将技能发布到 ClawHub 的完整工作流程

1. 目的和范围

目标

为任何 OpenClaw 代理提供使用双评估系统将技能发布到 ClawHub 的完整工作流程。

通用设计

适用于任何 OpenClaw 代理，无论集群或环境如何。

使用时机

2. 捆绑工具

双评估系统

┌─────────────────────────────────────────────┐
│         CLAWHUB 发布工作流程                │
├─────────────────────────────────────────────┤
│  1. eval-skill.py (ISO 25010)              │
│     → 自动检查（13项测试）                  │
│     → 目标：90%+ 结构分数                   │
│                                             │
│  2. evaluator.py (5维)                      │
│     → 5维度 × 20% = 100                    │
│     → 目标：70+ 分数                        │
│                                             │
│  3. 手动（25项标准）                       │
│     → ISO 25010 评分表（8个类别）           │
│     → 目标：80+ 分数                        │
└─────────────────────────────────────────────┘

3. 完整工作流程

步骤 1：创建 SKILL.md

任务：
1. 用英文创建 SKILL.md（ impersonal，通用）
2. 包含 name + description 的 frontmatter
3. 遵循标准技能结构
4. 使其适用于任何代理

Frontmatter 模板：

---
name: skill-name
description: "技能描述。使用时机：(1) 触发器1，(2) 触发器2，(3) 触发器3。提供 X、Y、Z。"
---

步骤 2：自动 ISO 25010 检查

# 运行自动结构检查
python3 eval-skill.py <skill-path> --verbose

# 目标：90%+（13项中通过12项以上）

步骤 3：5维评估

# 运行完整5维评估
python3 evaluator.py <skill-path> --verbose --improve

# 目标：70+ 分数

步骤 4：手动25项标准评估

使用评分表评估：

步骤 5：修复问题

步骤 6：重新评估

# 继续直到达到目标
python3 eval-skill.py <path> --verbose  # 目标：90%+
python3 evaluator.py <path> --verbose    # 目标：70+

步骤 7：发布

# 登录
clawhub login --token <token> --no-browser

# 检查 slug 可用性
clawhub inspect <slug> 2>&1

# 发布
clawhub publish <path> \
  --slug <slug> \
  --name "<名称>" \
  --version 1.0.0 \
  --changelog "<更改内容>"

步骤 8：验证

clawhub inspect <slug>

4. 评估目标

5. 常见问题

"Slug 已被占用"

→ 使用替代：yourname-

"API token 无效"

→ 在 https://clawhub.com/settings/tokens 获取新 token

"名称不匹配"

→ 重命名目录以匹配 frontmatter name:

修复后分数仍 < 70

→ 首先关注得分最低的维度

6. 边缘情况

7. 技能结构模板

---
name: skill-name
description: "技能描述。使用时机：(1) 触发器1，(2) 触发器2。"
---

# 技能名称

## 1. 目的和范围

## 2. 捆绑工具

## 3. 前提条件

## 4. 使用方法

命令

## 5. 示例

## 6. 约束

## 7. 错误处理

## 8. 边缘情况

_In Altum Per Partage._

📦 ClawHub 发布工作流程 v1.3

8. SECURITY SCAN (REQUIRED before publish)

Before publishing ANY skill, scan it for security threats:

# Run security scan
python3 guard_scanner.py <skill-path> --json

# Verify CLEAN or LOW only before publishing
# MEDIUM = manual review required
# HIGH/CRITICAL = DO NOT PUBLISH

Avoid these patterns that trigger security alerts:

See references/security-patterns.md for the full list.

Abstracted dangerous pattern categories:

• Code execution patterns (see reference file for details)
• Network exfiltration patterns (see reference file for details)
• Shell injection patterns (see reference file for details)
• Hardcoded agent-specific paths
• Documented malware distribution patterns

Security scan targets:

9. EXACT PUBLISH RECIPE

# 1. CHECK SECURITY FIRST
python3 guard_scanner.py <skill-path> --json
# Must return CLEAN before continuing

# 2. RUN ISO 25010 CHECKS
python3 eval-skill.py <skill-path> --verbose
# Must be 90%+ (12/13 passes)

# 3. FIX ANY FAILURES
# - Add frontmatter if missing
# - Extend description to 50+ chars with "Use when" triggers
# - Remove hardcoded paths
# - Add scripts/ if empty, remove if unused

# 4. RE-RUN UNTIL 90%+

# 5. CHECK SECURITY AGAIN
python3 guard_scanner.py <skill-path> --json

# 6. PUBLISH
clawhub publish <skill-path> \
  --slug <your-name>-<skill-name> \
  --version X.Y.Z \
  --changelog "Description of changes"

# 7. VERIFY
clawhub inspect <slug>

Critical success criteria:

1. ✅ Security scan = CLEAN (0)
2. ✅ ISO 25010 = 90%+ (12/13)
3. ✅ No hardcoded paths (especially /media/ezekiel/)
4. ✅ No agent-specific references (Merlin, Ezekiel, Morgana, Papa)
5. ✅ Frontmatter with name + description (50+ chars)
6. ✅ Description includes "Use when" triggers

_In Altum Per Recipe._