Skill: kofna3369/clawhub-chinese-publish (version 2.0.0)

--- name: clawhub-chinese-publish description: "中文技能发布工作流程 — 将中文 OpenClaw 技能发布到 ClawHub。使用此技能来：(1) 创建新的中文技能，(2) 将现有技能翻译为中文并发布，(3) 批量发布多个中文技能，(4) 更新中文技能版本。适用于想与中国社区分享技能的 OpenClaw 代理。触发词：发布中文技能、翻译技能到中文、批量发布中文技能、中文版本发布。使用此技能时，首先运行 evaluator.py 进行5维评估，然后运行 eval-skill.py 进行ISO 25010检查，确保达到目标分数后再发布。" --- # 📦 中文技能发布工作流程 > 将中文 OpenClaw 技能发布到 ClawHub | 信息 | 值 | |------|-----| | **版本** | 1.0.0 — 2026-05-07 | | **状态** | 运行中 ✅ | | **语言** | 中文 (Chinese) | | **目标分数** | Axioma 5维 70+，ISO 25010 90%+ | --- ## 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（必需） ```yaml --- name: chinese-<skill-name> description: "中文技能描述。使用此技能来：[具体用途]。触发词：[触发词1]、[触发词2]、[触发词3]。提供 [功能列表]。使用此技能时，首先运行 evaluator.py 进行5维评估。" --- ``` **重要：** - `name` 必须以 `chinese-` 开头 - `description` 必须包含中文描述和使用时机 - description 至少 50 字以满足 ISO 25010 检查 ### 3.2 Body 结构（标准） ```markdown # 技能名称（中文） > 技能简述 | 信息 | 值 | |------|-----| | 版本 | 1.0.0 | | 状态 | 运行中 | ## 1. 目的和范围 ### 目标 [技能的具体目标] ### 使用时机 | 触发器 | 行动 | |--------|------| | [触发词1] | [行动1] | | [触发词2] | [行动2] | ## 2. 工具和资源 ### 必需工具 | 工具 | 用途 | 必需 | |------|------|------| | [工具名] | [用途] | 是/否 | ### 捆绑资源 | 资源 | 路径 | 用途 | |------|------|------| | [资源名] | [路径] | [用途] | ## 3. 使用流程 ### 步骤 1：[步骤名称] ```bash [命令] ``` ### 步骤 2：[步骤名称] ```bash [命令] ``` ## 4. 示例 ### 示例 1：[名称] ```bash [命令] ``` [输出/说明] ## 5. 约束 | 约束 | 描述 | |------|------| | [约束1] | [描述] | | [约束2] | [描述] | ## 6. 错误处理 ### 常见错误 | 错误 | 原因 | 解决方案 | |------|------|----------| | [错误1] | [原因] | [方案] | ### 安全问题 | 问题 | 严重性 | 行动 | |------|--------|------| | [问题] | 高/中/低 | [行动] | ## 7. 边缘情况 | 情况 | 处理方法 | |------|----------| | [情况1] | [方法] | | [情况2] | [方法] | ## 8. 评估命令 ```bash # 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. 发布命令 ```bash # 登录 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 生成规则 | 原 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 批量发布脚本 ```bash #!/bin/bash # 批量发布中文技能 SKILLS_DIR=/media/ezekiel/Merlin/.openclaw/workspace/skills [REDACTED_SECRET] # 技能列表 SKILLS=( "merlin-vdv:中文 VDV 真相视觉" "core-files-management:中文 核心文件管理" "clawhub-publish-workflow:中文 发布工作流程" ) for item in "${SKILLS[@]}"; do IFS=':' read -r skill cn_name <<< "$item" echo [REDACTED_SECRET] 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 单独发布命令 ```bash # 发布单个中文技能 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 中文版 ```bash # 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. 相关技能 | 技能 | 描述 | |------|------| | 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` | 运行评估脚本 | 系统自带 | ### 验证命令 ```bash # 验证 clawhub 已安装 clawhub --version # 验证 python3 可用 python3 --version # 验证 evaluator.py 可用 python3 <axioma-skill-evaluator-path>/evaluator.py --help ``` --- ## 10. 使用示例 ### 示例：发布新的中文技能 ```bash # 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. 故障排除 | 问题 | 原因 | 解决方案 | |------|------|----------| | "Slug 已存在" | 已被占用 | 添加版本号或用户名 | | "Token 无效" | token 过期 | 获取新 token | | 评估失败 | 路径错误 | 检查技能目录是否存在 | | ISO 检查失败 | frontmatter 缺失 | 添加完整的 YAML frontmatter | | 无法触发 | description 太短 | 扩展 description 到 50+ 字 | --- _In Altum Per Partage._ 📦 中文技能发布工作流程 v1.0 --- ## 13. 命令语法标准 ### 标准命令格式 ```bash # 评估命令 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>" ``` ### 参数说明 | 参数 | 说明 | 示例 | |------|------|------| | `<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. 验证工具可用性 ↓ 2. 运行 Axioma 5维评估 ↓ 3. 检查分数（≥70?） ↓ 是 → 继续 ↓ 否 → 修复问题，重新评估 ↓ 4. 运行 ISO 25010 检查 ↓ 5. 检查分数（≥90%?） ↓ 是 → 继续 ↓ 否 → 修复问题，重新检查 ↓ 6. 发布到 ClawHub ↓ 7. 验证发布成功 ``` --- _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 字 | 中 | | 触发词 | 必须包含明确的触发词 | 中 | ### 约束检查命令 ```bash # 检查 frontmatter head -5 <skill-path>/SKILL.md # 检查 description 长度 wc -c < <skill-path>/SKILL.md # 检查 slug 唯一性 clawhub inspect <slug> 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


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)