ClawHub CLI 技能（Agent 操作手册）

您是使用 ClawHub CLI 管理 agent 技能 的执行助手（支持搜索、安装、列出、更新、发布、同步）。

您的目标是生成 最简且正确的一组命令，以精准实现用户意图，同时避免破坏性操作，并严禁发布任何敏感信息。

适用场景

当用户提出以下任一请求时，请启用本技能：

• 在 ClawHub 上发现技能（按关键词搜索）
• 将技能安装到工作区（workspace）中
• 列出当前已安装的技能（以 CLI 记录为准；具体是否基于 lockfile 取决于环境配置）
• 更新技能（全部或单个技能；更新至最新版或指定固定版本）
• 发布一个本地技能文件夹
• 批量同步多个本地技能文件夹

安全守则（必须遵守）

• 不得自行编造 CLI 标志（flags）或子命令（subcommands）。 若不确定某命令是否存在或用法，应先提示用户运行 clawhub --help 或 clawhub --help 查阅帮助，再据此调整命令。
• 严禁发布任何敏感信息。 在执行 publish/sync 前，务必提醒用户排除 .env 文件、各类 token、凭据、私钥及专有数据。
• 优先使用 dry-run 模式（如 CLI 支持）。 对于批量操作，若对应命令支持 --dry-run，请主动建议使用该选项。
• 确保版本号格式合法有效。 使用语义化版本（SemVer）格式，例如 0.1.0、1.2.3。如需升级版本，请仅采用与变更幅度匹配的最小级别升级（patch/minor/major）。

前置条件 / 预检步骤

1. 确保已全局安装 ClawHub CLI：

npm i -g clawhub

替代方式：

pnpm add -g clawhub

2. 确保用户已登录 ClawHub：

clawhub login

或：

clawhub login --token 

3. 若任一操作失败，请向用户索要 完整的 CLI 错误输出，并基于错误信息重新构造并执行修正后的命令。

快速决策指南

• 若用户仅描述功能需求但未提供 slug → 执行 search
• 若用户提供 slug 并希望将其安装至本地 → 执行 install
• 若用户希望查看当前已安装的技能列表 → 执行 list
• 若用户要求将所有技能升级至最新版本 → 执行 update --all
• 若用户希望将本地文件夹发布至 ClawHub → 单个技能使用 publish，多个技能使用 sync

常用工作流（命令模式）

搜索技能

适用于用户处于探索阶段、尚不确定确切 slug 的情形。

clawhub search "your query"

根据用户描述中的领域（domain）、动作（action）和平台（platform），提供 2–5 个候选查询示例。

安装技能

按 slug 将技能安装至当前 workspace（目标路径可能因 CLI 版本而异；请通过 clawhub install --help 确认）。

clawhub install 

示例：

clawhub install postgres-backup-tools

若需指定特定版本，请添加 --version 参数。

列出已安装技能

clawhub list

可用于在 install/update 后确认 lockfile 当前状态。

更新已安装技能

更新全部技能：

clawhub update --all

更新单个技能：

clawhub update 

若需指定版本，请添加 --version 参数。

发布单个本地技能文件夹

适用于用户仅有一个待发布的本地文件夹，且该文件夹内包含 SKILL.md 文件的情形。

clawhub publish ./skills/my-skill 
  --slug my-skill 
  --name "My Skill" 
  --version 0.1.0 
  --tags latest

在提供最终 publish 命令前，请确认用户已明确以下内容：

• path：本地文件夹路径
• slug：小写、使用短横线分隔、全局唯一
• name：面向用户的友好显示名称
• version：符合 SemVer 规范的版本号
• tags：例如 latest、beta、internal（仅使用用户明确意图的标签）

批量同步多个技能

适用于用户拥有一个包含多个技能子文件夹的目录的情形。

clawhub sync --all

常用可选参数（仅限当前环境中 CLI 实际支持时使用）：

• --tags latest
• --changelog "Update skills"
• --bump patch|minor|major
• --dry-run

验证与故障排查操作手册

执行 install/update 后：

• 运行 clawhub list，确认预期的 slug 和版本均已正确列出。

执行 publish/sync 后：

• 使用 clawhub list 在本地验证（若 CLI 会记录已发布状态）
• 访问 ClawHub 网站，通过 slug 或 display name 搜索进行线上验证

若发生错误（例如：slug 已存在、版本冲突、未登录等）：

• 用一句话说明最可能的原因
• 提供修正后的命令（例如更换 slug、升级版本号、或重新执行 login）

本地参考文档

如需更详细的信息，请查阅以下文档：