技能介绍

要解决的具体问题

Vibe Usage Windows 是一款本地 Windows 桌面仪表盘，以只读模式读取 Codex JSONL 会话和 WorkBuddy SQLite 用量数据来统计 token 使用情况。但在实际开发、维护或排查时，容易遇到三类具体问题：一是仓库结构不清，直接修改文件容易遗漏关键路径；二是改动解析逻辑或数据源后出现 token 计数归零、统计错误，却找不到排查方向；三是打包发布时误将私有文件、构建产物纳入源码包，导致发布内容不规范。

技能如何工作

该技能围绕 Vibe Usage Windows 的维护、打包与排查展开，核心能力包括本地验证、安装包构建、故障排查和发布准备。关键步骤遵循明确的工作流：

先定位仓库路径，优先使用 vibe-usage-windows/app 子目录
修改文件前先读 references/project-map.md 了解项目布局
运行测试、构建或打包前，先查阅 references/commands.md 获取标准命令
改动解析逻辑或排查零用量问题时，阅读 references/data-sources.md 理解数据源行为
始终以只读模式处理源数据，修改代码前先补充或更新测试
汇报应用、解析器、安装包或发布包可用前，先运行针对性验证

适用边界与注意点

使用该技能时需遵守明确的护栏规则：

必须将 Codex 和 WorkBuddy 的源数据视为只读，禁止修改 .codex 会话文件或 WorkBuddy 数据库
不可声称 WorkBuddy credit 与 token 计数等价，两者语义不同
发布文档需保持事实性，避免无法本地验证的宣传话术
禁止将 node_modules、app/dist、app/dist-installer、app/src-tauri/target 或私有 Obsidian 索引文件作为源码发布
汇报任务完成前，必须先确认生成的 zip 和安装包路径存在