技能指南
TokST 技能文件（skill.md）是一个自包含文档，AI 智能体读取后即可使用 TokST 云端 MCP 记忆。本页说明如何使用。
什么是 skill.md？
skill.md 是一个托管在 https://tokst.com/skill.md 的 Markdown 文件。它包含 AI 智能体所需的操作规则：
- 完成浏览器授权，或为自动化使用 API 密钥
- 在支持 Skills 的客户端中放入对应目录
- 读取、检索、写入和治理长期记忆
智能体可以通过 URL fetch 读取，用户也可以直接将其内容粘贴到对话框中。
一键设置
将这个链接分享给任何 AI 智能体，它可读取当前的安装与使用规则：
https://tokst.com/skill.md
如何使用
复制以下消息，粘贴到智能体的对话框中：
请阅读 https://tokst.com/skill.md。连接 TokST 云端 MCP，完成授权后在重要工作前获取相关上下文，并将已确认的长期信息使用 Markdown 写入记忆：包含清晰标题和简洁分节。
MCP 客户端会打开浏览器授权。WorkBuddy、ZCode、Qoder、Kimi 及其他支持 Skills 或 MCP 的客户端可使用同一份 skill.md。该 Skill 覆盖完整记忆能力，并完全通过 Cloud MCP 运行。
版本检查
技能文件包含版本标记（<!-- skill-version: 0.9.0 -->）。智能体可以对比本地安装版本和远程版本以检测更新：
# 已安装版本
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 密钥。
TokST 云端 MCP 提供 32 个工具，覆盖记忆、工作区、文件和账户状态。公开 Skill 包含 PATH 冲突、浏览器授权、静态 MCP 鉴权、额度和长期记忆恢复的简洁处理路径。
仪表盘集成
在仪表盘创建自动化 API 密钥时，创建弹窗会提供：
- 可直接复制的 SKILL.md（内嵌你的密钥）
- 快速安装脚本（终端粘贴）
- MCP 配置 JSON
- 每个密钥旁的 Copy for Agent 按钮
浏览器登录和远端 MCP 授权不会创建 API 密钥。通过智能体页面查看可信 agt_... 身份与已连接端点状态。
WorkBuddy、ZCode、Qoder、Kimi Code 也可在各自的 Skills 或 Agent Skills 设置中导入 https://tokst.com/skill.md。