Skill Manager All In One | 一站式技能管理器

模式 | Mode

读取本 SKILL.md 后，先确认当前任务属于哪种模式，再跳转对应章节执行。

核心原则 | Core Rules

1. Local first, network second — 先检查本地已安装技能，再搜索网络。
2. Be concrete — 汇报时写清楚准确路径、准确命令、准确版本变化。
3. One by one, confirm one by one — 涉及多个文件/版本/技能时，必须逐个处理、逐个确认。禁止批量操作。
4. Publish like a product — 发布文本应像正式发布说明，而非聊天记录。
5. For AI and humans — 技能正文应兼顾 agent 与人类可读性。
6. Learn from release evidence — 发布流程规则来自真实发布证据；新增检查项前先确认它能防止具体失误，而不是堆砌流程。

技能制作流程 | Phase 1: Create / Modify

按顺序执行，边做边对照第 6 章「统一检查清单」的【通用质量基线】。

步骤 1：明确需求

确定以下四项，作为后续所有操作的依据：

• 目标平台：ClawHub / GitHub / 其他
• 版本号：首次发布为 1.0.0

⚠️ Display name 和 Skill slug 是 ClawHub 专属概念，若目标平台为 ClawHub，请在 Phase 2 步骤 1 确认。

步骤 2：创建目录结构

参考第 7 章「技能目录体系」，在正式技能目录创建技能文件夹。

~/.openclaw/workspace/skills/<slug>/

步骤 3：编写 SKILL.md

按本技能的主模板编写 SKILL.md（参考 Phase 1 步骤 1 确认的平台需求）。

步骤 4：边做边查——对照清单

每完成一个文件或代码块，立即对照第 6 章【通用质量基线】逐项打勾。

目标平台已确定时，附加对应平台专项（ClawHub → CH01CH09，GitHub → GH01GH06）。

如 Phase 1 已逐项打勾通用基线，Phase 2 只需复核 + 补充平台专项，不必重复全量检查。

技能发布验证流程 | Phase 2: Publish

必须完成 Phase 1 后才能执行本阶段。

步骤 1：确认基本信息 & 复查清单

ClawHub 目标时，先确认以下两项：

• Display name：EN Title | CN Title 双语格式（对应 CH01）
• Skill slug：小写字母 + 连字符，如 speech-synthesizer

然后复查清单：

• 对照第 6 章【通用质量基线】全部项（G01~G06）
• 根据目标平台，额外核对【平台专项】（ClawHub → CH01CH09，GitHub → GH01GH06）
• 逐项标注 ✅ / ⚠️，有问题的立即修复

步骤 2：⚠️ 两步验证（强制，必须执行）

无论改动多小、无论第几次修改，两步验证不可跳过。

第一步（AI 内部执行，不输出给用户）

• 核对清单（G01~G06 + 对应平台专项）
• 检查文件大小（>50MB 需报告）
• ClawHub 目标时检查预览简介：description 应短而清楚，中文需出现在预览可见范围内
• 拟定 Changelog

第二步（输出给用户，等待明确确认）

必须输出以下全部内容（用第 9 章汇报模板），确认前不得执行任何发布类命令：

Display name / Skill slug / 目标平台 / 当前版本 / 新版本号 / Changelog / 文件大小 / 核对清单 / 发布命令

确认标志：用户明确回复「好」「确认」「上传」「发吧」等。

⚠️ 两步验证适用于所有发布类操作：clawhub publish / git push / gh release create / 推广发帖 / 社交平台发帖等。

上两步验证前，先读对应 reference：ClawHub 上传/升版 → references/clawhub-publish.md；GitHub 上传 → references/github-publish.md。

步骤 3：执行发布

获得用户确认后，执行对应平台的发布命令。

ClawHub 上传详见 references/clawhub-publish.md；GitHub 上传详见 references/github-publish.md。

若用户拒绝发布：回到 Phase 1 修改流程，递增修订版本号（如 1.2.1 → 1.2.2-dev），不得直接重复尝试发布相同内容。

发布后维护 | Phase 3: Maintain

参考 Phase 1 修改流程 + 版本号递增 → 回到 Phase 2 两步验证。

• 升版/更新：ClawHub → references/clawhub-publish.md；GitHub → references/github-publish.md
• 宣传/推广：读 references/promotion.md（Moltbook 格式、AI心理学、去标识化）
• 查看详情：ClawHub → clawhub inspect <slug> + references/clawhub-inspect.md（Details ▾ 确认 Assessment）
• GitHub：git log 验证
• 回滚：clawhub → clawhub delete <slug> --yes（软删除）；GitHub → git revert
• 隐藏/恢复/删除：执行前报告 + 执行后验证

统一检查清单 | Checklist（制作与发布共享）

Phase 1 边做边查，Phase 2 发布前复查。 制作时查【通用质量基线】，发布时查【通用 + 平台专项】。

通用质量基线（所有技能必查）

上游参考技能保护：不要直接修改上游/参考技能，尤其是 skill-creator。它会随 OpenClaw 或上游版本更新而变化；本技能只能把本地经验沉淀到 skill-manager-all-in-one 自己的 SKILL.md / references 中。若确实需要修改上游技能，必须先向用户说明原因、影响和恢复方案，等待明确授权。

ClawHub 专项（附加于通用基线之后）

GitHub 专项（附加于通用基线之后）

⚠️ 必须先通过通用质量基线 G01~G06。

技能目录体系 | Directory System

命名规范 | Naming Convention

⚠️ 重要：项目目录和模型缓存必须与技能名（slug）保持一致。

示例（speech-transcriber 技能）：

~/.openclaw/workspace/skills/speech-transcriber/     # 技能本身
~/.openclaw/workspace/projects/speech-transcriber/   # 项目数据（转写结果等）
~/.cache/huggingface/modules/speech-transcriber/   # 模型缓存（见 CH05）
└── small/                                          # small 模型（464MB）

汇报模板 | Report Template

汇报时必须包含以下全部内容（ID + 文字说明）：

display_name: "Skill Name | 中文名"
slug: "skill-name"
platform: "clawhub" | "github"
current_version: "1.0.0"
new_version: "1.0.1"
file_size: "48KB"
changelog:
  - "EN description. 中文描述。"

checklist:
  # 通用质量基线
  G01 去标识化: ✅     # 无个人信息、内部路径、私有凭证
  G02 安全性: ✅        # 无注入风险、无过度权限、无数据外传
  G03 逻辑科学性: ✅    # 结构清晰、路径准确、模块化、同名规范
  G04 AI可读性: ✅     # agent可理解、上下文连贯、无歧义指令
  G05 易维护性: ✅      # 代码整洁、注释到位、变量命名清晰
  G06 依赖声明: ✅      # 外部包/工具/密钥已声明，无硬编码

  # ClawHub 专项
  CH01 name字段: ✅    # Display Name：EN Title | CN Title格式；name:字段填此处
  CH02 slug: ✅        # 小写字母+连字符，如speech-synthesizer
  CH03 坏符号链接: ✅  # 无失效符号链接
  CH04 运行时产物: ✅   # 无.pyc/.pyo/__pycache__/.log
  CH05 文件≤50MB: ✅  # 大型模型放模型缓存，有引用说明
  CH06 Embedding500: ✅ # 文档过长时有降级方案
  CH07 目录隔离: ✅    # 无.git/.DS_Store等无关文件
  CH08 版本号一致: ✅  # _meta.json/changelog/命令三处一致
  CH09 Changelog: ✅   # 英文在前，面向用户，双语列表
  CH10 预览简介: ✅  # description短且双语可见，中文不会被卡片截断

  # 或（有问题时）
  G03 逻辑科学性: ⚠️    # 路径引用待修复
  CH05 文件≤50MB: ⚠️  # 模型已移至缓存，需补充引用说明

汇报示例：

display_name: "PDF 解析器 | PDF Parser"
slug: "pdf-parser"
platform: "clawhub"
current_version: "1.2.0"
new_version: "1.2.1"
file_size: "12.3 MB"
changelog:
  - "Fixed: OCR timeout on large files. 修复：大文件 OCR 超时问题。"

checklist:
  G01 去标识化: ✅
  G02 安全性: ✅
  G03 逻辑科学性: ✅
  G04 AI可读性: ✅
  G05 易维护性: ✅
  G06 依赖声明: ✅
  CH01 name字段: ✅
  CH02 slug: ✅
  CH03 坏符号链接: ✅
  CH04 运行时产物: ✅
  CH05 文件≤50MB: ✅
  CH06 Embedding500: ✅
  CH07 目录隔离: ✅
  CH08 版本号一致: ✅
  CH09 Changelog: ✅

publish_command: "clawhub publish ~/.openclaw/workspace/skills/pdf-parser --version 1.2.1 --changelog '...'"

实用说明 | Practical Notes

执行提示

• 执行敏感操作前，用 clawhub --help 核对当前 CLI 行为
• skill-creator 是底层规则权威来源