📦 中文技能发布工作流程

> 将中文 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：[步骤名称]

[命令]

### 步骤 2：[步骤名称]

[命令]

## 4. 示例

### 示例 1：[名称]

[命令]

[输出/说明]

## 5. 约束

| 约束 | 描述 |
|------|------|
| [约束1] | [描述] |
| [约束2] | [描述] |

## 6. 错误处理

### 常见错误

| 错误 | 原因 | 解决方案 |
|------|------|----------|
| [错误1] | [原因] | [方案] |

### 安全问题

| 问题 | 严重性 | 行动 |
|------|--------|------|
| [问题] | 高/中/低 | [行动] |

## 7. 边缘情况

| 情况 | 处理方法 |
|------|----------|
| [情况1] | [方法] |
| [情况2] | [方法] |

## 8. 评估命令

Axioma 5维评估

python3 /evaluator.py --verbose --improve

ISO 25010 检查

python3 /eval-skill.py --verbose

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

## 9. 发布命令

登录 ClawHub

clawhub login --token --no-browser

检查 slug 可用性

clawhub inspect chinese- 2>&1

发布

clawhub publish \

--slug chinese- \

--name "<中文名称>" \

--version 1.0.0 \

--changelog "<更新内容>"

验证

clawhub inspect chinese-

### ClawHub Token 获取

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

---

## 4. slug 生成规则

| 原 slug | 中文 slug | 说明 |
|---------|-----------|------|
| merlin-vdv | chinese-merlin-vdv | VDV 真相视觉中文版 |
| core-files-management | chinese-core-files-management | 核心文件管理中文版 |
| clawhub-publish-workflow | chinese-clawhub-publish-workflow | 发布工作流程中文版 |
| axioma-skill-evaluator | chinese-axioma-skill-evaluator | 技能评估系统中文版 |
| axiomata-deploy | chinese-axiomata-deploy | 网站部署中文版 |

---

## 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+）

| 维度 | 目标 | 说明 |
|------|------|------|
| Structure | 16+/20 | 结构完整，frontmatter 正确 |
| Clarity | 16+/20 | 描述清晰，示例充分 |
| Completeness | 16+/20 | 包含所有必需部分 |
| Consistency | 14+/20 | 风格一致，命名统一 |
| Functionality | 14+/20 | 命令正确，结果准确 |

### 6.2 ISO 25010（目标 90%+）

| 检查项 | 要求 |
|--------|------|
| SKILL.md 存在 | ✅ 必须 |
| Frontmatter 有效 | ✅ name + description |
| Description 长度 | ✅ 50+ 字 |
| 触发词 | ✅ 包含 "Use when..." 或类似 |
| 技能名称匹配目录 | ✅ |
| 资源目录非空 | ✅ |

---

## 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 /evaluator.py \

--verbose

python3 /eval-skill.py \

--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. 相关技能

| 技能 | 描述 |
|------|------|
| clawhub-publish-workflow | 英文版发布工作流程 |
| axioma-skill-evaluator | 技能评估系统 |

---

_In Altum Per Partage._
📦 中文技能发布工作流程 v1.0
## 9. 必需工具清单

### OpenClaw 工具

| 工具 | 用途 | 必需 | 模式 |
|------|------|------|------|
| `read` | 读取技能文件 | 是 | Required |
| `write` | 创建/修改文件 | 是 | Required |
| `edit` | 精确编辑 | 可选 | Optional |
| `exec` | 执行命令 | 是 | Required |

### 外部命令

| 命令 | 用途 | 安装方式 |
|------|------|----------|
| `clawhub` | ClawHub CLI | npm install -g clawhub |
| `python3` | 运行评估脚本 | 系统自带 |

### 验证命令

验证 clawhub 已安装

clawhub --version

验证 python3 可用

python3 --version

验证 evaluator.py 可用

python3 /evaluator.py --help

---

## 10. 使用示例

### 示例：发布新的中文技能

Step 1: 创建技能目录

mkdir -p /chinese-my-skill

Step 2: 编写 SKILL.md（中文）

cat > /chinese-my-skill/SKILL.md << 'SKILLEOF'

name: chinese-my-skill

description: "我的中文技能描述。触发词：my-skill、中文技能。使用此技能时，首先运行 evaluator.py 进行5维评估。"

我的中文技能

> 技能描述

1. 目的和范围

2. 工具

3. 使用流程

SKILLEOF

Step 3: 评估

python3 /evaluator.py /chinese-my-skill --verbose --improve

Step 4: 发布

clawhub publish /chinese-my-skill \

--slug chinese-my-skill \

--name "我的中文技能" \

--version 1.0.0

Step 5: 验证

clawhub inspect chinese-my-skill

---

## 11. 发布后检查清单

□ slug 正确（chinese-）

□ 名称是中文

□ 描述是中文且50+字

□ Axioma 5维分数 70+

□ ISO 25010 90%+

□ clawhub inspect 显示正确信息

□ 可以被其他代理触发

---

## 12. 故障排除

| 问题 | 原因 | 解决方案 |
|------|------|----------|
| "Slug 已存在" | 已被占用 | 添加版本号或用户名 |
| "Token 无效" | token 过期 | 获取新 token |
| 评估失败 | 路径错误 | 检查技能目录是否存在 |
| ISO 检查失败 | frontmatter 缺失 | 添加完整的 YAML frontmatter |
| 无法触发 | description 太短 | 扩展 description 到 50+ 字 |

---

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

---

## 13. 命令语法标准

### 标准命令格式

评估命令

python3 /evaluator.py --verbose --improve

ISO 检查命令

python3 /eval-skill.py --verbose

发布命令

clawhub publish --slug --name "<名称>" --version --changelog ""

### 参数说明

| 参数 | 说明 | 示例 |
|------|------|------|
| `<evaluator-path>` | evaluator.py 所在目录路径 | /path/to/axioma-skill-evaluator |
| `<skill-path>` | 要评估的技能目录路径 | /path/to/skills/chinese-merlin-vdv |
| `<slug>` | 技能 slug（唯一标识符） | chinese-merlin-vdv |
| `<名称>` | 中文显示名称 | 中文 VDV 真相视觉 |
| `<ver>` | 版本号 | 1.0.0 |
| `<log>` | 更新日志 | 中文版本首次发布 |

### 命令执行流程

1. 验证工具可用性

↓

1. 运行 Axioma 5维评估

↓

1. 检查分数（≥70?）

↓ 是 → 继续

↓ 否 → 修复问题，重新评估

↓

1. 运行 ISO 25010 检查

↓

1. 检查分数（≥90%?）

↓ 是 → 继续

↓ 否 → 修复问题，重新检查

↓

1. 发布到 ClawHub

↓

1. 验证发布成功

---

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

---

## 14. 约束

| 约束类型 | 描述 | 优先级 |
|----------|------|--------|
| Token 有效性 | ClawHub token 必须有效且未过期 | 高 |
| slug 唯一性 | slug 必须在 ClawHub 上唯一 | 高 |
| 语言一致性 | 所有描述和内容必须使用中文 | 高 |
| frontmatter 格式 | 必须包含完整的 YAML frontmatter | 高 |
| 评估通过 | 发布前必须通过 Axioma 5维 (70+) 和 ISO 25010 (90%+) | 高 |
| 目录结构 | 技能目录必须包含 SKILL.md | 高 |
| description 长度 | description 必须至少 50 字 | 中 |
| 触发词 | 必须包含明确的触发词 | 中 |

### 约束检查命令

检查 frontmatter

head -5 /SKILL.md

检查 description 长度

wc -c < /SKILL.md

检查 slug 唯一性

clawhub inspect 2>&1

---

## 15. 错误处理

### 常见错误及解决方案

| 错误代码 | 错误描述 | 原因 | 解决方案 |
|----------|----------|------|----------|
| E001 | Slug 已存在 | 已被其他技能占用 | 添加用户名前缀，如 `kofna-chinese-merlin-vdv` |
| E002 | Token 无效 | token 过期或错误 | 在 https://clawhub.com/settings/tokens 获取新 token |
| E003 | 评估失败 | 路径错误或文件损坏 | 检查技能目录结构，确保 SKILL.md 存在 |
| E004 | ISO 检查失败 | frontmatter 缺失或格式错误 | 添加标准 YAML frontmatter，确保 name 和 description 字段 |
| E005 | 触发失败 | description 太短 | 扩展 description 到 50+ 字，包含触发词 |
| E006 | 发布失败 | 权限不足 | 检查 token 权限，确保有发布权限 |
| E007 | 验证失败 | slug 不存在 | 使用 `clawhub inspect <slug>` 确认发布成功 |
| E008 | 批量发布部分失败 | 单个技能问题 | 单独检查失败的技能，重新发布 |

### 错误诊断流程

检测到错误

↓

识别错误代码（E001-E008）

↓

查阅上表找到原因

↓

应用解决方案

↓

重新执行操作

↓

验证问题已解决

### 紧急错误处理

| 错误类型 | 紧急程度 | 立即行动 |
|----------|----------|----------|
| Token 泄露 | 高 | 立即吊销 token，在 ClawHub 生成新 token |
| 批量发布全部失败 | 中 | 检查网络连接，单独重试每个技能 |
| 评估脚本损坏 | 中 | 从备份恢复或重新下载 evaluator.py |
| ClawHub 服务不可用 | 低 | 等待服务恢复，定期重试 |

---

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