前言¶
在 WorkBuddy 里连续用一段时间后，token 和 credit 往往只散落在本机日志或单次对话里，很难一眼看清：哪几天用量冲高、哪个模型占大头、思考阶段是否拖慢响应、有没有反复报错。手工翻记录或自己写脚本汇总，成本高，也不方便按日期区间对比。
下面介绍 SkillHub 上的 WorkBuddy 使用状态看板（@user_e4ef2dfb/workbuddy-usage-status，v1.6.0）。它在本机读取 WorkBuddy 使用数据，生成可视化看板，并在每次运行后导出全量 CSV 与 xlsx；全程不依赖外网，目录可搬运。
这是什么¶
WorkBuddy 使用状态看板 是社区来源（community）的 Agent Skill，分类为 data-analysis，发布坐标 @user_e4ef2dfb/workbuddy-usage-status，SkillHub 页面标注作者为 clancy-feng。标签 requires_api_key=false，不需要额外 API Key。
定位可以概括为：仅针对 WorkBuddy 本机 / 本账号 的使用状态做离线分析与展示；以 token 消耗 为主指标，credit 以逐次实测为准；不承接其他产品的用量统计，也不把任意数据做成通用看板。
核心功能¶
以下能力均来自 SkillHub 官方简介与页面说明，安装后由 Agent 在用户明确提出需求时调用 Skill 内逻辑完成。
指标与图表¶
- token：主指标，用于整体用量与趋势。
- credit：按调用逐次记录的实测值；可选参数
--credit-xlsx作为参考补充，用于补齐本地缺少逐次明细的日期（不作为默认唯一来源）。 - 思考效率：从本地数据侧观察思考相关开销与效率。
- 模型分布与成本：模型占比、费率与成本结构；支持查看 单次提问成本 偏高的记录。
- 缓存命中率：结合本地记录做命中率相关展示。
筛选与运维向视图¶
- 日期区间筛选：按时间段收窄统计范围。
- 错误监控：从本机使用数据中汇总错误相关情况。
- 用量高峰探查：便于定位用量异常抬升的时段或模式。
输出形态¶
每次运行会：
- 生成本地 使用信息看板（离线 HTML 或 Skill 约定的看板产物，纯本地打开）。
- 同步写出 全量 CSV 与 xlsx，便于二次分析或归档。
整体约束：纯本地、全程零网络、可搬运。
安装与启用¶
Skill 遵循通用 SKILL.md 格式。在已安装 SkillHub CLI 的前提下，将技能装到 当前 Agent 能识别的 skills 目录；未指定 --dir 时默认落在 ./skills/，多数客户端不会自动加载。
检查 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可按官方文档执行完整安装（示例为官方 install 脚本）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill¶
官方页面给出的坐标为 @user_e4ef2dfb/workbuddy-usage-status。安装时需把 --dir 指向对应产品的 skills 路径，例如：
在 WorkBuddy 中使用（与 WorkBuddy 数据同源，推荐）：
skillhub install user_e4ef2dfb/workbuddy-usage-status --dir ~/.workbuddy/skills/
在 Cursor 中使用：
skillhub install user_e4ef2dfb/workbuddy-usage-status --dir ~/.cursor/skills/
在 Claude Code 中使用：
skillhub install user_e4ef2dfb/workbuddy-usage-status --dir ~/.claude/skills/
在 Codex CLI 中使用（用户级或项目级二选一）：
skillhub install user_e4ef2dfb/workbuddy-usage-status --dir ~/.codex/skills/
# 或项目内：--dir <项目>/.agents/skills/
安装后按所用客户端要求刷新或重启 Agent，使新 Skill 被加载。
典型用法¶
本 Skill 的触发条件在官方说明中写得很明确：仅当用户明确表示要查看、生成或导出自己 WorkBuddy 本机 / 本账号的使用状态、使用统计或工作信息看板时 才应调用。不要用自然语言含糊带过，也不要用来统计 Cursor、Claude 等其他产品的用量。
可复现的对话意图示例（表述可略有不同，但意图需一致）：
- 「帮我生成本机 WorkBuddy 的使用状态看板，最近一周。」
- 「导出我这账号 WorkBuddy 的用量统计，要 CSV 和 xlsx。」
- 「看一下 WorkBuddy 本机 token 和模型分布，有没有用量高峰。」
若某些日期的 credit 在本地缺少逐次明细，可在 Skill 支持的前提下附带说明，让 Agent 使用可选参数 --credit-xlsx，用你提供的用量导出 xlsx 作参考补充（官方描述为填补缺明细日期，而非替代全部本地实测）。
经过上面的步骤，Agent 应在本机完成读数、生成看板并写出 CSV / xlsx，全程无需访问外网。
适用场景与注意¶
适合谁
- 长期在 WorkBuddy 本机办公、需要定期复盘 token / credit、模型选择与错误情况的开发者或团队个人账号。
- 希望留存可搬运的离线报表（看板 + 表格），而不是每次登录网页查用量的人。
限制与注意
- 产品边界：只服务 WorkBuddy 本机 / 本账号数据；不能替代其他 IDE、CLI 或云产品的计费看板。
- 触发方式：必须由用户 明确 提出看板 / 统计 / 导出需求，避免 Agent 误用为「任意数据集可视化」。
- credit 口径：默认以本地逐次实测为主；
--credit-xlsx仅作缺数据日期的补充，使用前确认导出文件来源与时间范围与本地记录一致。 - 安装路径：务必
--dir到当前 Agent 的 skills 目录（WorkBuddy 为~/.workbuddy/skills/），否则 Skill 可能已下载但不会被加载。 - 社区 Skill：版本以 SkillHub 为准（当前页面为 v1.6.0）；升级可用
skillhub按同一坐标更新到对应目录。
SkillHub 上该 Skill 分类为 data-analysis；页面展示的评分为 100000，下载约 7920 次（以 SkillHub 页面与 API 元数据为准，会随时间变化）。
结尾¶
WorkBuddy 使用状态看板把本机用量从「分散日志」收成「可筛选、可导出、可离线打开」的一套视图，主看 token，credit 跟逐次记录，并覆盖模型成本、缓存、错误与高峰等维度。若你只在 WorkBuddy 上需要自己的使用状态看板，可按官方坐标安装并在对话里明确说出查看或导出意图。
- SkillHub 页面：https://www.skillhub.cn/skills/user_e4ef2dfb/workbuddy-usage-status
- 官方 API / 元数据：https://api.skillhub.cn/user_e4ef2dfb/workbuddy-usage-status
