st-diagnose

name	st-diagnose
description	Token 占用诊断。当用户想了解 CodeBuddy Token 占用情况、诊断环境配置、查看 MCP/Skill/Plugin/Rules/CODEBUDDY.md 的 Token 消耗时使用。
allowed-tools	Read, Write, Bash, AskUserQuestion

st-diagnose: Token 占用诊断

调用 st diagnose CLI 命令诊断当前 CodeBuddy 环境的 Token 占用情况，向用户呈现结构化的诊断报告。

工作流

步骤 1: 检测 st 命令

执行以下命令检测 st 是否已安装：

which st || echo "NOT_FOUND"

如果输出 NOT_FOUND：向用户报告：

st CLI 工具未安��。请执行以下命令安装：

  npm install -g save-token

安装后重新运行诊断。或访问 https://github.com/studyzy/save-token 获取更多信息。

停止执行。

步骤 2: 执行诊断

执行诊断命令，使用 JSON 格式输出以便解析：

st diagnose --format json

参数说明:

• --format json: 输出结构化 JSON，供后续解析
• 如需跳过 headless 探针（仅文件扫描），追加 --no-headless

步骤 3: 解析诊断结果

解析 JSON 输出。关键字段：

• dataSource: 数据来源（proxy 最精确, headless 次之, fs-only 保底）
• scanTimestamp: 采集时间戳
• contextOverview.totalEstimatedTokens: 总 Token 估算
• contextOverview.breakdown[]: Token 分布明细（按类别）
• : MCP 工具列表及 Token 估算