# OpenClaw Skill Collection

自定義 Skill 集合，適用於多種 AI Coding Agent 平台。

## 相容平台

| 平台 | 支援狀態 | 說明 |
|------|---------|------|
| [OpenClaw](https://github.com/nicepkg/openclaw) | ✅ 原生支援 | 依照 SKILL.md + handler.ts 規範開發 |
| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | ✅ 相容 | 可作為 slash command / custom skill 使用 |
| [Codex CLI](https://github.com/openai/codex) | ✅ 相容 | 透過 workspace instructions 整合 |
| [OpenCode](https://github.com/opencode-ai/opencode) | ✅ 相容 | 支援自定義工具規範 |

> 每個 Skill 由 `SKILL.md`（宣告觸發條件與描述）+ `handler.ts`（執行邏輯）組成，符合 OpenClaw Skill 標準格式。其他平台可直接參考 SKILL.md 的 prompt 與 handler 邏輯來整合。

## Skills 列表

| Skill | 功能 | 類別 |
|-------|------|------|
| `assign-task` | 分析任務內容，判斷分派到 VPS-A 或 VPS-B | 行動任務 |
| `dispatch-webhook` | 底層 Webhook 發送（含重試、認證） | 行動任務 |
| `daily-briefing` | 每日早安簡報（天氣 + 行程 + 待辦） | 生活安排 |
| `task-capture` | Telegram 快速記錄待辦（自動優先級 + 截止日） | 生活安排 |
| `qmd-brain` | 知識庫搜尋（BM25 + pgvector 向量檢索） | 知識庫 |
| `tts-voice` | 文字轉語音（LuxTTS 聲音克隆） | 多媒體 |
| `skill-review` | Agent 自動審查 skills 並提交 Gitea PR | DevOps |

## 目錄結構

```
openclaw-skill/
├── README.md
├── 技術手冊.md              # 完整安裝、設定、維運指南
├── create-skill.md          # Skill 開發教學
├── skills/
│   ├── assign-task/         # 行動任務：分派任務到 VPS
│   ├── dispatch-webhook/    # 底層 Webhook 發送工具
│   ├── daily-briefing/      # 每日簡報
│   ├── task-capture/        # 快速記錄待辦
│   ├── qmd-brain/           # 知識庫搜尋
│   ├── tts-voice/           # 文字轉語音
│   └── skill-review/        # Agent PR 審查工作流
├── chapters/                # 技術手冊分章
└── openclaw-knowhow-skill/  # OpenClaw 官方文件與範本
```

## 安裝方式

### OpenClaw

```bash
# 複製 skill 到 workspace（注意：必須用 cp -r，不能用 symlink）
cp -r skills/daily-briefing ~/.openclaw/workspace/skills/
cp -r skills/task-capture ~/.openclaw/workspace/skills/

# 重啟 Gateway
systemctl --user restart openclaw-gateway
```

### Claude Code

將 SKILL.md 的內容作為 custom slash command 或加入專案的 CLAUDE.md 指引中。

### Codex CLI / OpenCode

參考各 skill 的 SKILL.md 描述，整合至對應平台的 workspace instructions 或工具定義。

## 詳細說明

請參閱 **技術手冊.md** 取得完整安裝、設定、維運指南。

## License

MIT