# 技能指南

TokST 技能檔案（`skill.md`）是一個自包含文件，AI 智能體讀取後即可安裝並使用 TokST 記憶。本頁說明如何使用。

## 什麼是 skill.md？

`skill.md` 是一個託管在 `https://tokst.com/skill.md` 的 Markdown 文件。它包含 AI 智能體所需的操作規則：

1. 安裝 TokST CLI
2. 完成瀏覽器授權，或為自動化使用 API 金鑰
3. 在支援 Skills 的用戶端中放入對應目錄
4. 讀取、檢索、寫入和治理長期記憶
5. 使用雲端或本機工作階段，並完成工作區內的智能體交接

智能體可以通過 URL fetch 讀取，使用者也可以直接將其內容貼上到對話框中。

## 一鍵設定

將此連結分享給任何 AI 智能體，它可讀取目前的安裝與使用規則：

```
https://tokst.com/skill.md
```

### 如何使用

複製以下訊息，貼上到智能體的對話框中：

```
Read https://tokst.com/skill.md. Install TokST, configure the matching MCP mode, and follow the Session memory workflow.
```

安裝程式會開啟瀏覽器授權，並在升級時保留本機連線。WorkBuddy、ZCode、Qoder、Kimi 與其他支援 Skills 或 MCP 的用戶端可使用同一份 `skill.md`。

## 版本檢查

技能檔案包含版本標記（`<!-- skill-version: 0.8.3 -->`）。智能體可以對比本機安裝版本和遠端版本以檢測更新：

```bash
# 已安裝版本
grep "^version:" ~/.claude/skills/tokst-memory/SKILL.md

# 最新版本
curl -fsSL https://tokst.com/skill.md | grep "skill-version:"
```

## 支援的智能體

將 `skill.md` 以 `SKILL.md` 的名稱放入目標用戶端使用的目錄：

| 智能體 | 技能目錄 |
|--------|---------|
| Claude Code | `~/.claude/skills/tokst-memory/` |
| ZCode | `~/.zcode/skills/tokst-memory/` |
| Cursor / Windsurf | `~/.cursor/skills/tokst-memory/` |
| Codex CLI | `~/.codex/skills/tokst-memory/` |
| Pi | `~/.pi/skills/tokst-memory/` |
| WorkBuddy | `~/.workbuddy/skills/tokst-memory/` |
| Qoder | `~/.qoder/skills/tokst-memory/` |
| Kimi Code | `~/.kimi-code/skills/tokst-memory/` |
| 通用 MCP | `~/.agents/skills/tokst-memory/` |

## 連線方式

支援瀏覽器 OAuth 的 MCP 用戶端可連接 `https://api.tokst.com/mcp` 並在 TokST 中批准授權。靜態 MCP 用戶端使用 `Authorization` 請求標頭中的專用 API 金鑰。本機 MCP 在 `tokst setup --local` 後透過 `tokst local mcp` 執行，資料保存在裝置 SQLite 設定中。

TokST 雲端 MCP 提供 51 個工具，涵蓋記憶、工作區、檔案、工作階段、自動記憶、可信 Agent 身分和訊息。公開 Skill 包含 PATH 衝突、瀏覽器授權、靜態 MCP 驗證、額度、Local SQLite 修復、自動記憶診斷與 Agent 監聽重連的簡潔恢復路徑。

## 儀表板整合

在[儀表板](https://tokst.com/dashboard/api-keys)建立自動化 API 金鑰時，建立彈窗會提供：
- 可直接複製的 **SKILL.md**（內嵌你的金鑰）
- **快速安裝腳本**（終端機貼上）
- **MCP 設定** JSON
- 每個金鑰旁的 **Copy for Agent** 按鈕

瀏覽器登入和遠端 MCP 授權不會建立 API 金鑰。透過[智能體](/dashboard/agents)頁面檢視可信 `agt_...` 身分與工作區交接訊息。

WorkBuddy、ZCode、Qoder、Kimi Code 也可在各自的 Skills 或 Agent Skills 設定中匯入 `https://tokst.com/skill.md`。

## 相關

- [智能體設定](/docs/agent-setup) — 完整設定指南
- [CLI 參考](/docs/cli) — 完整指令文件
- [MCP 伺服器](/docs/mcp) — MCP 設定詳情