📦 中文技能发布工作流程

将中文 OpenClaw 技能发布到 ClawHub

1. 目的和范围

目标

将中文 OpenClaw 技能发布到 ClawHub，让中国社区的代理可以使用。

使用时机

适用场景

1. 你有一个英文技能，想发布中文版
2. 你创建了一个新的中文技能
3. 你需要批量发布多个中文技能
4. 你想更新已发布的中文技能版本

2. 工作流程总览

╔═══════════════════════════════════════════════════════════╗
║            中文技能发布流程                              ║
╠═══════════════════════════════════════════════════════════╣
║                                                           ║
║  Step 1: 准备中文 SKILL.md                               ║
║  ├─ 创建或翻译技能内容（中文）                          ║
║  ├─ 确保 frontmatter 完整                                 ║
║  └─ 遵循 SKILL.md 写作规范                               ║
║                                                           ║
║  Step 2: 评估                                             ║
║  ├─ Axioma 5维评估（目标 70+）                           ║
║  └─ ISO 25010 检查（目标 90%+）                          ║
║                                                           ║
║  Step 3: 生成 slug                                        ║
║  └─ 使用 chinese-<original-slug> 格式                    ║
║                                                           ║
║  Step 4: 发布到 ClawHub                                   ║
║  ├─ 登录 ClawHub                                         ║
║  └─ 使用 clawhub publish 命令                            ║
║                                                           ║
║  Step 5: 验证                                             ║
║  └─ 使用 clawhub inspect 确认发布成功                     ║
║                                                           ║
╚═══════════════════════════════════════════════════════════╝

3. 创建中文 SKILL.md

3.1 Frontmatter（必需）

---
name: chinese-<skill-name>
description: "中文技能描述。使用此技能来：[具体用途]。触发词：[触发词1]、[触发词2]、[触发词3]。提供 [功能列表]。使用此技能时，首先运行 evaluator.py 进行5维评估。"
---

重要：

• name 必须以 chinese- 开头
• description 必须包含中文描述和使用时机
• description 至少 50 字以满足 ISO 25010 检查

3.2 Body 结构（标准）

# 技能名称（中文）

> 技能简述

| 信息 | 值 |
|------|-----|
| 版本 | 1.0.0 |
| 状态 | 运行中 |

## 1. 目的和范围

### 目标
[技能的具体目标]

### 使用时机
| 触发器 | 行动 |
|--------|------|
| [触发词1] | [行动1] |
| [触发词2] | [行动2] |

## 2. 工具和资源

### 必需工具
| 工具 | 用途 | 必需 |
|------|------|------|
| [工具名] | [用途] | 是/否 |

### 捆绑资源
| 资源 | 路径 | 用途 |
|------|------|------|
| [资源名] | [路径] | [用途] |

## 3. 使用流程

### 步骤 1：[步骤名称]
```bash
[命令]

步骤 2：[步骤名称]

[命令]

4. 示例

示例 1：[名称]

[命令]

[输出/说明]

5. 约束

6. 错误处理

常见错误

安全问题

7. 边缘情况

8. 评估命令

# Axioma 5维评估
python3 <axioma-skill-evaluator-path>/evaluator.py <skill-path> --verbose --improve

# ISO 25010 检查
python3 <axioma-skill-evaluator-path>/eval-skill.py <skill-path> --verbose

说明： 将 <axioma-skill-evaluator-path> 替换为你的 axioma-skill-evaluator 实际路径。

9. 发布命令

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

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

# 发布
clawhub publish <path> \
  --slug chinese-<original-slug> \
  --name "<中文名称>" \
  --version 1.0.0 \
  --changelog "<更新内容>"

# 验证
clawhub inspect chinese-<original-slug>

ClawHub Token 获取

1. 访问 https://clawhub.com/settings/tokens
2. 创建新 token
3. 使用 token 登录

4. slug 生成规则

5. 批量发布模板

5.1 批量发布脚本

#!/bin/bash
# 批量发布中文技能

SKILLS_DIR=/media/ezekiel/Merlin/.openclaw/workspace/skills
TOKEN=clh_D_1J2_rsQs0XZbt_2Gf3LoRdyiUivZebillnWFdql1U

# 技能列表
SKILLS=(
  "merlin-vdv:中文 VDV 真相视觉"
  "core-files-management:中文 核心文件管理"
  "clawhub-publish-workflow:中文 发布工作流程"
)

for item in "${SKILLS[@]}"; do
  IFS=':' read -r skill cn_name <<< "$item"

  echo "=========================================="
  echo "发布: $skill → chinese-$skill"
  echo "名称: $cn_name"

  # 评估
  echo "评估中..."
  python3 $SKILLS_DIR/axioma-skill-evaluator/evaluator.py $SKILLS_DIR/$skill --verbose 2>&1 | grep -E "Score|STATUS"

  # 发布
  clawhub publish $SKILLS_DIR/$skill \
    --slug chinese-$skill \
    --name "$cn_name" \
    --version 1.0.0 \
    --changelog "中文版本发布" \
    --token $TOKEN

  echo ""
done

echo "批量发布完成!"

5.2 单独发布命令

# 发布单个中文技能
SKILL_PATH=/media/ezekiel/Merlin/.openclaw/workspace/skills/merlin-vdv
SLUG=chinese-merlin-vdv
NAME="中文 VDV 真相视觉"

clawhub publish $SKILL_PATH \
  --slug $SLUG \
  --name "$NAME" \
  --version 1.0.0 \
  --changelog "中文版本发布"

6. 评估标准

6.1 Axioma 5维（目标 70+）

6.2 ISO 25010（目标 90%+）

7. 完整示例流程

发布 merlin-vdv 中文版

# Step 1: 创建中文版本目录
mkdir -p /media/ezekiel/Merlin/.openclaw/workspace/skills/chinese-merlin-vdv

# Step 2: 创建 SKILL.md（使用本工作流程结构）
cat > /media/ezekiel/Merlin/.openclaw/workspace/skills/chinese-merlin-vdv/SKILL.md << 'EOF'
---
name: chinese-merlin-vdv
description: "中文 VDV — 真相视觉技能。使用此技能来分析复杂系统、寻找无法进一步压缩的刚性点、应用5维框架进行现实三角测量。触发词：VDV、真相分析、需要确切路径。使用此技能时，首先运行 evaluator.py 进行5维评估。"
---

# 🧙‍♂️ VDV — 真相视觉（中文版）

> 真理 = 永不偏离的主权轴线

[详细内容...]
EOF

# Step 3: 评估
python3 <axioma-skill-evaluator-path>/evaluator.py \
  <skill-path> --verbose

python3 <axioma-skill-evaluator-path>/eval-skill.py \
  <skill-path> --verbose

# Step 4: 发布
clawhub publish /media/ezekiel/Merlin/.openclaw/workspace/skills/chinese-merlin-vdv \
  --slug chinese-merlin-vdv \
  --name "中文 VDV 真相视觉" \
  --version 1.0.0 \
  --changelog "中文版本首次发布"

# Step 5: 验证
clawhub inspect chinese-merlin-vdv

8. 相关技能

In Altum Per Partage. 📦 中文技能发布工作流程 v1.0

9. 必需工具清单

OpenClaw 工具

外部命令

验证命令

# 验证 clawhub 已安装
clawhub --version

# 验证 python3 可用
python3 --version

# 验证 evaluator.py 可用
python3 <axioma-skill-evaluator-path>/evaluator.py --help

10. 使用示例

示例：发布新的中文技能

# Step 1: 创建技能目录
mkdir -p <skills-directory>/chinese-my-skill

# Step 2: 编写 SKILL.md（中文）
cat > <skills-directory>/chinese-my-skill/SKILL.md << 'SKILLEOF'
---
name: chinese-my-skill
description: "我的中文技能描述。触发词：my-skill、中文技能。使用此技能时，首先运行 evaluator.py 进行5维评估。"
---

# 我的中文技能

> 技能描述

## 1. 目的和范围

## 2. 工具

## 3. 使用流程
SKILLEOF

# Step 3: 评估
python3 <evaluator-path>/evaluator.py <skills-directory>/chinese-my-skill --verbose --improve

# Step 4: 发布
clawhub publish <skills-directory>/chinese-my-skill \
  --slug chinese-my-skill \
  --name "我的中文技能" \
  --version 1.0.0

# Step 5: 验证
clawhub inspect chinese-my-skill

11. 发布后检查清单

□ slug 正确（chinese-<original>）
□ 名称是中文
□ 描述是中文且50+字
□ Axioma 5维分数 70+
□ ISO 25010 90%+
□ clawhub inspect 显示正确信息
□ 可以被其他代理触发

12. 故障排除

In Altum Per Partage. 📦 中文技能发布工作流程 v1.0

13. 命令语法标准

标准命令格式

# 评估命令
python3 <evaluator-path>/evaluator.py <skill-path> --verbose --improve

# ISO 检查命令
python3 <evaluator-path>/eval-skill.py <skill-path> --verbose

# 发布命令
clawhub publish <path> --slug <slug> --name "<名称>" --version <ver> --changelog "<log>"

参数说明

命令执行流程

1. 验证工具可用性
   ↓
2. 运行 Axioma 5维评估
   ↓
3. 检查分数（≥70?）
   ↓ 是 → 继续
   ↓ 否 → 修复问题，重新评估
   ↓
4. 运行 ISO 25010 检查
   ↓
5. 检查分数（≥90%?）
   ↓ 是 → 继续
   ↓ 否 → 修复问题，重新检查
   ↓
6. 发布到 ClawHub
   ↓
7. 验证发布成功

In Altum Per Commands. 📦 中文技能发布工作流程 v1.0

14. 约束

约束检查命令

# 检查 frontmatter
head -5 <skill-path>/SKILL.md

# 检查 description 长度
wc -c < <skill-path>/SKILL.md

# 检查 slug 唯一性
clawhub inspect <slug> 2>&1

15. 错误处理

常见错误及解决方案

错误诊断流程

检测到错误
    ↓
识别错误代码（E001-E008）
    ↓
查阅上表找到原因
    ↓
应用解决方案
    ↓
重新执行操作
    ↓
验证问题已解决

紧急错误处理

In Altum Per Quality. 📦 中文技能发布工作流程 v1.0 — FULLY OPTIMIZED