ClawHub 发布流程

前置条件

• 已安装 clawhub CLI：npm i -g clawhub
• 已完成登录：clawhub whoami（若未登录，则执行 clawhub login，通过 PTY + 浏览器完成认证）
• 目标 Skill 文件夹已存在于 C:MAIBOTskills 路径下

工作流

1. 发布前检查清单

每次发布前均需对每个 Skill 执行该检查。完整校验标准详见 references/checklist.md。

快速预览：

Get-Content "C:MAIBOTskillsSKILL.md" -Encoding UTF8 | Select-Object -First 40

必须确认以下各项：

• description: 字段使用英文（这是 ClawHub 用户首先看到的内容）
• SKILL.md 正文中不含韩文内容
• 不含个人路径（如 C:Usersjini9、JINI_SYNC 等）
• 不含内部账号名或凭证信息
• 凡出现个人配置的位置，均已替换为通用占位符

2. 语言与敏感信息清理

若发现韩文内容或个人信息，请按以下步骤处理：

1. 将 SKILL.md 全文重写为英文
2. 将个人路径替换为通用占位符（例如 $VAULT_PATH、~/vault、your-username）
3. 同步将所有 references/*.md 中的内容翻译为英文
4. 确保以 UTF-8 编码保存文件：[System.IO.File]::WriteAllText($path, $content, [System.Text.Encoding]::UTF8)

3. 版本号确定

4. 执行发布

cd C:MAIBOT
clawhub publish ./skills/ `
  --slug  `
  --name "" `
  --version  `
  --changelog ""

Slug 命名规则：

• 仅允许小写字母和短横线（-）
• 必须在 ClawHub 全局唯一
• 若 Slug 已被占用，请追加 -mai 后缀（例如：obsidian-daily-mai）

5. 验证发布结果

clawhub whoami   # 确认仍处于登录状态
# 然后访问：https://clawhub.ai/u/jini92 查看发布效果

6. 更新相关记录

成功发布后，请同步更新以下两处文档：

• C:MAIBOTmemorymarketplace-strategy.md — 在 ClawHub 表格中新增一行记录
• Obsidian 中的 _DASHBOARD.md — 将该 Skill 添加至“当前冲刺（Current Sprint）”下的“已完成（Done）”列表中

批量发布

如需一次性发布多个 Skill，请依次对每个 Skill 执行步骤 1 至 4。 每次执行前，请查阅 references/checklist.md 确保满足全部质量要求。

常见错误