# 技能指南

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 配置详情