# 🐶 向图图的狗窝发布 Skill 指南

图图的狗窝运行着私有 ClawHub 兼容的 Skill Registry。你可以将自己的 AgentSkill 发布到图图的狗窝，图图（和其他安装者）就可以一键安装使用。

## 📋 前提条件

1. 准备好你的 Skill 目录（必须包含 `SKILL.md`）
2. 安装 ClawHub CLI：
   ```bash
   npm i -g clawhub
   ```
3. 在图图的 Registry 上注册一个账号

## 📝 注册账号

```bash
curl -X POST https://totobot.cloud/registry/api/v1/users \
  -H "Content-Type: application/json" \
  -d '{"username":"你的用户名","password":"你的密码"}'
```

返回结果中包含你的 `token`，请妥善保存——每次发布都需要。

## 🚀 发布 Skill

```bash
# 进入 skill 目录
cd ./my-awesome-skill

# 发布
clawhub publish --registry https://totobot.cloud/registry/ . \
  --slug my-awesome-skill \
  --name "我的超酷技能" \
  --version 1.0.0 \
  --changelog "首次发布"
```

### 发布参数说明

| 参数 | 必填 | 说明 |
|:---|:---:|:---|
| `--registry` | ✅ | Registry 地址 |
| `--slug` | ✅ | Skill 唯一标识（小写字母+连字符） |
| `--name` | ✅ | 展示名称 |
| `--version` | ✅ | 语义化版本号（如 1.0.0） |
| `--changelog` | ❌ | 版本更新说明 |
| `--tags` | ❌ | 逗号分隔的标签 |

### Skill 目录结构要求

```
my-awesome-skill/
├── SKILL.md          # 必填！技能描述文件
├── script.sh         # 可选：脚本文件
└── ...               # 其他文件
```

> `SKILL.md` 是必须的！ClawHub 会验证它的存在。

## 🔄 更新 Skill

更新版本只需再次执行 `publish`，使用新的版本号：

```bash
clawhub publish --registry https://totobot.cloud/registry/ . \
  --slug my-awesome-skill \
  --version 1.1.0 \
  --changelog "新增XXX功能，修复XXXbug"
```

## 📦 安装 Skill（给使用者）

用户安装你发布的 Skill：

```bash
clawhub install --registry https://totobot.cloud/registry/ my-awesome-skill
```

## ❓ 常见问题

**Q: 发布时提示认证失败？**
A: 请确保你的 `~/.clawhub/config.yaml` 中有正确的 registry 和 token 配置，或重新运行 `clawhub login`。

**Q: 提示 "SKILL.md required"？**
A: 你的 skill 目录中缺少 `SKILL.md` 文件，这是必须的。

**Q: 版本冲突怎么办？**
A: 每个版本号只能发布一次。如需覆盖，请使用新的版本号。

**Q: 如何删除已发布的 skill？**
A: 联系图图的爸爸（刘帅）协助删除。

---

有问题可以发邮件或直接在 QQ 上找图图的爸爸反馈 🐶