AI Skills 管理

# 1. 安装 clawhub
npm install -g clawhub

# 2. 登录 TCR
# tcr-prod.tencentcloudcr.com 需要替换成实际的访问域名。
clawhub login --registry https://tcr-prod.tencentcloudcr.com --token $CLH_TOKEN

# 3. 搜索 Skills
clawhub search "订单" --registry https://tcr-prod.tencentcloudcr.com

# 4. 安装 Skill
clawhub install order-query-mcp --registry https://tcr-prod.tencentcloudcr.com

# 5. 或发布自己的 Skill
clawhub publish ./my-skill --registry https://tcr-prod.tencentcloudcr.com --slug my-skill --version 1.0.0

npm install -g clawhub

# 验证安装
clawhub -V
# 期望输出: ClawHub CLI v0.8.0

yarn global add clawhub

# 验证安装
clawhub -V

pnpm add -g clawhub

# 验证安装
clawhub -V

# 设置 TCR 实例地址
export CLAWHUB_REGISTRY="https://tcr-prod.tencentcloudcr.com"

# 设置 clh_token（可直接从控制台AI Skills 页面获取），也可以自己构造：以 Base64(username:password) 编码，并去掉最后的'=', 前面拼接'clh_'前缀。username 和 password 是TCR实例用于docker login的凭证信息。
# 构造 clh_token 等价的 shell 命令： echo "clh_$(printf '{username}:{password}' | base64 | tr -d '=')"
export CLH_TOKEN="您的token内容"

# 使用环境变量
clawhub login --registry $CLAWHUB_REGISTRY --token $CLH_TOKEN

# 或直接输入
clawhub login --registry https://tcr-prod.tencentcloudcr.com --token "clh_xxx"

# 期望输出
# - Verifying token
# ✔ OK. Logged in as @100012345678.

clawhub whoami --registry $CLAWHUB_REGISTRY
# 期望输出: ✔ 100012345678

clawhub logout --registry $CLAWHUB_REGISTRY
# 期望输出: Logged out.

my-skill/
├── SKILL.md           # Skill 描述文件（必需）
├── src/               # 源代码目录
│   └── index.js       # 主入口文件
├── package.json       # 依赖配置（Node.js 项目）
└── README.md          # 详细说明（可选）

---
name: my-order-skill
description: 查询订单状态、物流信息、退款进度
version: 1.0.0
skill_type: MCP Server
runtime: node18
tags:
  - order
  - business
  - production-ready
---

# My Order Skill

查询订单相关信息的 MCP Server。

## Tools

### get_order

查询订单详情。

**参数**:
- `order_id` (string, required): 订单ID

**返回**: 订单详情 JSON

### get_logistics

查询物流状态。

**参数**:
- `order_id` (string, required): 订单ID

**返回**: 物流状态 JSON

### get_return_status

查询退换货信息。

**参数**:
- `order_id` (string, required): 订单ID
- `type` (string, optional): 类型，可选值：return/exchange

**返回**: 退换货状态 JSON

# 进入 Skill 目录
cd my-skill

# 发布
clawhub publish . \\
  --registry $CLAWHUB_REGISTRY \\
  --slug my-order-skill \\
  --version 1.0.0

# 期望输出
# - Preparing my-order-skill@1.0.0
# ✔ OK. Published my-order-skill@1.0.0 (sha256:abc123...)

# 查看发布的 Skill
clawhub inspect my-order-skill --registry $CLAWHUB_REGISTRY

# 在 explore 中查看
clawhub explore --registry $CLAWHUB_REGISTRY --limit 5

# 更新 SKILL.md 中的 version 字段，然后发布
clawhub publish . \\
  --registry $CLAWHUB_REGISTRY \\
  --slug my-order-skill \\
  --version 1.1.0

#!/bin/bash
# publish-skill.sh - 发布 Skill 到 TCR 的完整脚本

# 配置
REGISTRY="https://tcr-prod.tencentcloudcr.com"
SKILL_DIR="./my-skill"
SKILL_SLUG="my-order-skill"
VERSION="1.0.0"

echo "📤 开始发布 Skill 到 TCR..."
echo "Skill: $SKILL_SLUG@$VERSION"

# 检查 SKILL.md 是否存在
if [ ! -f "$SKILL_DIR/SKILL.md" ]; then
    echo "❌ 错误: SKILL.md 文件不存在"
    exit 1
fi

# 发布
clawhub publish $SKILL_DIR \\
  --registry $REGISTRY \\
  --slug $SKILL_SLUG \\
  --version $VERSION

if [ $? -eq 0 ]; then
    echo "✅ 发布成功！"
    echo "安装命令: clawhub install $SKILL_SLUG --registry $REGISTRY"
else
    echo "❌ 发布失败"
    exit 1
fi

clawhub install order-query-mcp --registry $CLAWHUB_REGISTRY

# 期望输出
# - Fetching order-query-mcp
# ✔ OK. Installed order-query-mcp@2.1.0 to ./.clawhub/skills/order-query-mcp

clawhub install order-query-mcp --version 1.0.0 --registry $CLAWHUB_REGISTRY

clawhub install order-query-mcp \\
  --registry $CLAWHUB_REGISTRY \\
  --output ./my-project/skills

# 查看当前目录下安装的 Skills
ls .clawhub/skills/

# 查看 Skill 详情
cat .clawhub/skills/order-query-mcp/SKILL.md

clawhub update order-query-mcp --registry $CLAWHUB_REGISTRY

clawhub uninstall order-query-mcp

#!/bin/bash
# install-skill.sh - 从 TCR 安装 Skill 的完整脚本

# 配置
REGISTRY="https://tcr-prod.tencentcloudcr.com"
SKILL_NAME="order-query-mcp"
OUTPUT_DIR="./.clawhub/skills"

echo "📥 开始安装 Skill..."
echo "Skill: $SKILL_NAME"

# 安装
clawhub install $SKILL_NAME \\
  --registry $REGISTRY \\
  --output $OUTPUT_DIR

if [ $? -eq 0 ]; then
    echo "✅ 安装成功！"
    echo "Skill 目录: $OUTPUT_DIR/$SKILL_NAME"
    ls -la "$OUTPUT_DIR/$SKILL_NAME"
else
    echo "❌ 安装失败"
    exit 1
fi

clawhub explore --registry $CLAWHUB_REGISTRY --limit 10

# 输出示例
# - Fetching latest skills
# my-order-skill  v1.1.0  1h ago  查询订单状态、物流信息、退款进度
# wecom-notifier  v1.3.0  2h ago  企业微信消息通知工具
# mysql-query-tool v1.0.0 3h ago  安全的 MySQL 数据库查询工具

# 按关键词搜索
clawhub search "订单" --registry $CLAWHUB_REGISTRY

# 输出示例
# - Searching
# my-order-skill v1.1.0  my-order-skill  (1.000)
# order-tracker v1.0.0  order-tracker  (0.850)

# 搜索特定类型
clawhub search "kubernetes" --registry $CLAWHUB_REGISTRY

clawhub inspect order-query-mcp --registry $CLAWHUB_REGISTRY

# 输出示例
# Name: order-query-mcp
# Version: 2.1.0
# Type: MCP Server
# Description: 查询订单详情、物流状态和退换货信息
# Tags: order, business, production-ready
# Tools: get_order, get_logistics, get_return_status

clawhub versions order-query-mcp --registry $CLAWHUB_REGISTRY

# 输出示例
# v2.1.0  2026-03-15  Latest
# v2.0.0  2026-03-10
# v1.1.0  2026-02-20
# v1.0.0  2026-02-01

---
# YAML Frontmatter（必需字段）
name: skill-name
description: Skill 的简短描述
version: 1.0.0
skill_type: MCP Server
runtime: node18
tags:
  - tag1
  - tag2
---

# Skill 标题

详细说明（Markdown 格式）

## Tools

工具列表和说明

---
name: wecom-notifier
description: 企业微信消息通知工具，支持文本、Markdown、图片和文件消息
version: 1.3.0
skill_type: MCP Server
runtime: node18
tags:
  - notification
  - wecom
  - production-ready
author: dev-team
license: MIT
repository: https://github.com/example/wecom-notifier
---

# 企业微信通知 Skill

向企业微信群聊或个人发送消息通知。

## 前置条件

1. 创建企业微信机器人
2. 获取 Webhook URL
3. 配置环境变量 `WECOM_WEBHOOK_URL`

## Tools

### send_text

发送文本消息。

**参数**:
- `content` (string, required): 消息内容
- `mentioned_list` (array, optional): @成员列表

**示例**:
```json
{
  "content": "部署完成",
  "mentioned_list": ["@all"]
}

{
  "content": "## 部署通知\\n- 环境: prod\\n- 状态: **成功**"
}

// 在 AI Agent 中使用
const result = await mcp.call('send_text', {
  content: '任务执行完成',
  mentioned_list: ['user1', 'user2']
});

# 检查 token 格式
echo $CLH_TOKEN | head -c 4
# 应该输出: clh_

# 检查 registry 地址
echo $CLAWHUB_REGISTRY
# 应该是 https:// 开头的完整 URL

# 重新登录
clawhub logout --registry $CLAWHUB_REGISTRY
clawhub login --registry $CLAWHUB_REGISTRY --token $CLH_TOKEN

# 检查文件是否存在
ls -la SKILL.md

# 如果不存在，创建一个
cat > SKILL.md << 'EOF'
---
name: my-skill
description: My skill description
version: 1.0.0
skill_type: MCP Server
runtime: node18
tags:
  - example
---

# My Skill

Description here.
EOF

ls -la .clawhub/skills/
# order-query-mcp/
# wecom-notifier/

{
  "mcpServers": {
    "order-query": {
      "command": "node",
      "args": ["./.clawhub/skills/order-query-mcp/src/index.js"]
    }
  }
}

# 直接引用 SKILL.md 中的 prompt 内容

# 目前需要逐个更新
clawhub update skill1 --registry $CLAWHUB_REGISTRY
clawhub update skill2 --registry $CLAWHUB_REGISTRY