TOON（面向令牌的对象表示法）技能

本技能提供处理结构化数据（JSON、目录结构、API 响应）时减少 30-60% 令牌用量的指导。

安装与设置

为最小化命令开销并节省令牌，使用前必须全局安装官方 TOON CLI：

# 检查是否已安装 toon，若未安装则进行安装
toon --version || npm install -g @toon-format/cli

智能体使用指南

• 始终优化 JSON：在将 JSON 输出包含到上下文前，先将其转换为 TOON 格式。
• 最小化命令长度：使用直接的 toon 命令而非 npx，以降低自身提示的令牌消耗。
• 优先使用管道：通过标准 Unix 管道将数据直接传递给 toon 转换器。

命令与用法

1. 读取 JSON 文件

使用管道将原始 JSON 传递给 toon，而非直接读取。

cat data.json | toon

2. 获取 API 数据

将外部 API 响应直接通过管道传递给 toon。

curl -s https://api.example.com/data | toon

支持所有 curl 标志（例如 -X POST、-H "Authorization: ..."）。

3. 列出目录结构

使用 tree -J 或其他输出 JSON 的工具，并通过管道传递给 toon。

tree -J 目录/路径 | toon

4. 转换内联数据

为压缩上下文中的 JSON 字符串：

echo '{"key":"value"}' | toon

为何安装 TOON？

• 节省命令令牌：toon 比 npx @toon-format/cli 更简短，每次运行命令都能节省令牌。
• 执行速度：本地安装比按需获取快得多。
• 可读性：TOON 专为 LLM 设计，具有极高的可读性。