stk-diagnose

# SKILL: stk-diagnose 本 SKILL 指导 AI Agent 执行 `/stk-diagnose` 命令的逻辑。 ## 目标 获取当前会话各部分的 Token 占用基线数据。 ## 执行流程 1. 检查 `stk` 命令是否已安装（如 `which stk` 或 `stk --version`）。**如未安装，先停点询问用户**，不得擅自执行全局安装——全局 npm 安装是最重的系统级修改，必须由用户显式确认： 用 `AskUserQuestion` 询问「stk 未安装，是否现在安装？」： - 选「现在安装」→ 执行： ```bash npm install -g @studyzy/save-token-kit # 或 pnpm add -g @studyzy/save-token-kit ``` - 选「暂不安装」/ Other → 给出手动安装指引（上述命令），**终止本次流程**，不继续后续步骤。 安装失败（如无权限）时不要反复重试，如实报告错误并附上手动安装指引。 2. 检测当前 AI Agent 运行环境，选择对应的 `--agent` 参数。一台机器可能同时安装多个 Agent，且 `CODEBUDDY_BASE_URL` 这类**配置类**环境变量可能被用户全局设置（如指向自定义 API 或本工具代理），在任意 Agent 会话里都存在——因此只能以**当前会话注入的会话级环境变量**判定，不能用"是否安装了某个 Agent"或配置类变量判断： ```bash # WorkBuddy 桌面会话注入 WORKBUDDY_* 变量（须在 CodeBuddy 判定之前，因两者同内核可能同时设置 CODEBUDDY_SESSION_ID） if [ -n "$WORKBUDDY_CONFIG_DIR" ] || [ -n "$WORKBUDDY_APP_NAME" ]; then AGENT=workbuddy # CodeBuddy 会话注入的会话级变量（不是配置类变量 CODEBUDDY_BASE_URL） elif [ -n "$CODEBUDDY_SESSION_ID" ]; then AGENT=codebuddy # Claude Code 会话会注入 CLAUDE_CODE_SESSION_ID / CLAUDE_PID 环境变量 elif [ -n "$CLAUDE_CODE_SESSION_ID" ] || [ -n "$CLAUDE_PID" ]; then AGENT=claude # CodeX 会话会注入 CODEX_HOME（指向其配置目录，如 ~/.codex） elif [ -n "$CODEX_HOME" ]; then AGENT=codex else # 无法判定（如普通终端直接运行、或当前版本未注入上述变量）：不要猜测 AGENT= fi ``` 若 `AGENT` 为空，先用 `AskUserQuestion` 询问用户当前运行在哪个 Agent 中，确认后再执行： ```bash stk diagnose --agent "$AGENT" --report-path=./save-token/diagnosis-report.md ``` > **⚠️ WorkBuddy 必须先告知用户操作方法（不可省略）**：WorkBuddy 无法自动触发探测，需要用户手动切模型发消息才能捕获请求。该命令在 WorkBuddy 中执行时会等待捕获（最长数分钟），而**命令输出会被折叠、用户默认看不到**，因此你必须在**调用命令之前**，先在对话中用自然语言完整告知用户操作步骤，再执行命令： ``` 执行诊断采集。请点击左侧「新建任务」，然后在模型列表中选择 「stk-diagnose (token check)」，发送消息「Hi」。 ``` 命令开始等待后（通常表现为长时间无返回），可再简短提醒一次"正在等待捕获，请按上述步骤操作"。 > 说明：CodeBuddy 为了兼容也会设置 `CLAUDE_SESSION_ID` / `CLAUDE_PROJECT_DIR` 等变量， > 因此不能以这些变量判定为 Claude Code；请以 `CLAUDE_CODE_SESSION_ID` / `CLAUDE_PID`（Claude Code 官方注入）为准。 > 同理，`CODEBUDDY_BASE_URL` 是配置 API 端点/代理的变量（可能被全局设置），不能作为"当前运行在 CodeBuddy"的依据，故仅用 `CODEBUDDY_SESSION_ID` 判定。 3. 读取 `./save-token/diagnosis-report.md`，在对话中展示诊断报告。 4. **使用次数统计**：`.md` 报告不含 Tools / Skill / MCP / SubAgent 的调用次数；这些数据在 `./save-token/diagnosis-report.json` 的 `usageStats` 字段（`mcpServerUsage` / `skillUsage` / `subagentUsage`，含 `last30Days.ranking`）。展示时需从 JSON 补充各维度"最近 30 天调用排名"一并呈现；若 `usageStats` 缺失或 `filesScanned === 0`，如实说明"无会话历史数据"，不得当作 0 次调用。 5. 提醒用户下一步运行 `/stk-analyze`，基于本次诊断数据给出节省 Token 的优化建议。 ## 注意 如实展示`diagnosis-report.md`的内容即可，无需点评或者给出建议。