WorkBuddy技能管理助手
你的 WorkBuddy 技能是不是越装越多，真正用的越来越少？
装了几百个技能，真正常用的可能不到十个。哪个在角落积灰、哪些功能重复了、哪个版本过时了、哪些组合才是你的真实工作流——WorkBuddy技能管理助手一键扫描你的技能库，生成一张可视化全景报告，从"装了多少"到"该怎么管"，一步到位。
数秒出报告，双击就能看。
你会看到什么
报告采用三视图设计，从全局到细节逐层深入：
🗺 技能地图（全局视角）
力导向网络图呈现你的完整技能生态。每个节点代表一个技能，节点大小反映调用热度，颜色区分 SkillHub 官方 12 大分类（办公效率/内容创作/开发编程/数据分析/设计多媒体/AI Agent/知识管理/商业运营/教育学习/行业专业/运维安全/生活服务），节点间的连线揭示隐藏的技能搭档——哪些技能总在同一任务中被一起调用。
点击任意节点，右侧滑出详情面板，展示该技能的完整档案：分类、来源（SkillHub/ClawHub/自建/本地/项目级）、版本号、调用次数、可调用指令（支持一键复制）、SKILL.md 全文预览、SkillHub 平台安全报告（keen+sanbu 双扫描结果）、生命周期时间线（安装日期→最后使用日期→当前状态）、常连带调用的技能组合。
📊 使用分析（趋势视角）
四张图表从不同维度还原你的使用习惯：
| 图表 | 回答的问题 |
|---|---|
| 热度排行榜 | 哪些技能最常用？TOP 20 排名一目了然 |
| 调用趋势 | 使用频率在涨还是在跌？7/30/60 天三条趋势线对比 |
| 星期×小时热力图 | 你什么时候最活跃？7×24 网格精确到小时 |
| 技能组合 | 哪些技能是你的真实工作流？高频共现组合 TOP 5 |
💡 管理建议（行动视角）
基于数据分析生成可行动的管理建议，按严重级别排序：
| 建议类型 | 说明 |
|---|---|
| 吃灰预警 | 60 天零调用的技能清单，附安全评分辅助断舍离决策 |
| 版本更新 | 与 SkillHub 最新版本比对，过时的技能标红提醒 |
| 功能重叠 | Jaccard 相似度 ≥35% 的技能对，建议保留更常用的那个 |
| 安全提示 | 信任分较低的技能预警，附评分明细表说明原因 |
| SkillHub 热门推荐 | 按你最活跃的 Top 3 分类推荐平台热门技能，卡片式展示可直接跳转下载 |
安全评分体系
每个技能都有一个 0-100 的信任评分，采用信任+能力模型——含脚本、声明联网、声明写文件是技能的正常能力，不因"有能力"扣分，只关注"是否可信"：
| 维度 | 分值范围 | 说明 |
|---|---|---|
| 基础分 | +60 | 中性起点，不预设可疑 |
| 来源信任 | 0 ~ +30 | SkillHub 官方 +30 / 自建 +20 / ClawHub +15 / 项目级 +10 / 本地 +5 |
| 维护信号 | 0 ~ +13 | 版本号 +5 / 脚本+版本组合 +3 / 安装记录 +5 |
| 元数据完整性 | 0 ~ +8 | 描述完整 +5 / 使用说明 +3 |
| 体量合理性 | -8 ~ 0 | >1MB 扣 8 / >500KB 扣 3 |
详情面板中每个技能的评分下方都附有评分明细表，逐行展示每个维度的加减分和原因——评分不再是黑盒。
SkillHub 来源的技能额外显示平台安全报告（腾讯安全 keen + sanbu 双扫描），非 SkillHub 技能显示来源标签（自建/本地/项目级/ClawHub）。
快速开始
python scripts/run_report.py
控制台打印报告路径，双击打开（不自动弹浏览器）。
也可以在 WorkBuddy 对话中直接说：
> 「生成我的技能分析报告」
> 「看看我装了哪些 skill」
> 「哪些技能在吃灰」
输出说明
skill-insight-report/
├── skill-map-20260804-072610-145.html # 报告（毫秒时间戳，永不覆盖历史）
└── last-run.json # 运行记录（状态/警告/耗时/成本）
- 重复运行自动追加新文件，历史报告天然成为时间线对比基线
- 降级容错：无技能 → 纯统计模式；无调用记录 → 纯清单模式；目录不可写 → 自动转存临时目录
> 📌 隐私提示：报告仅生成本机，包含工作区目录名与技能 SKILL.md 全文等本地信息，不外发；分享前请自行检查内容。
示例输出
以 3 个技能（文档助手 / 代码生成 / 翻译）为例，报告三视图呈现示意（实际为可交互 HTML，节点可点击）：
| 视图 | 呈现内容示意 |
|---|---|
| 技能地图 | 节点大小 = 调用热度：文档助手（大）、代码生成（中）、翻译（小）；节点颜色 = 分类；连线 = 常一起被调用的搭档关系 |
| 使用统计 | 热度榜：文档助手 42 次 > 代码生成 18 次 > 翻译 5 次；7/30/60 天调用趋势：12/58/65；热力图显示调用集中在工作日上午 |
| 沉默洞察 | 翻译 60 天零调用 → 吃灰（建议断舍离）；代码生成 近 7 天 8 次、前 7 天 2 次 → 崛起；文档助手 稳定高频 → 无信号 |
> 以上为示意数据，仅用于说明报告形态；实际数字以本机扫描结果为准。
最佳实践
| 实践 | 说明 |
|---|---|
| 定期生成 | 建议每周生成一次报告；时间戳命名的历史文件天然构成时间线，可直接对比技能使用习惯的变化 |
| 监控扫描规模 | 观察 last-run.json 的 cost 字段（total_duration_ms / jsonl_files / jsonl_lines）：数值异常增长说明 projects/ 转录膨胀，可及时治理 |
| 归档旧报告 | 定期把 skill-insight-report/ 下的旧报告移入归档目录（如 archive/），保持输出目录聚焦近期时间线 |
适用边界
| 维度 | 说明 |
|---|---|
| 能做什么 | 扫描本机技能安装与调用记录，生成单文件 HTML 报告：安装清单、分类分布、调用热度、7/30/60 趋势、沉默洞察、共现图；联网时额外提供 SkillHub 安全报告（keen+sanbu 双扫描）、版本核对、热门推荐、功能重叠检测 |
| 不能做什么 | 创建/编辑/卸载技能；多用户/团队视图；自动打开浏览器 |
| 数据来源 | 本地：<WORKBUDDY_HOME>/skills（已安装技能）与 <WORKBUDDY_HOME>/projects/**/*.jsonl（调用记录）；在线：SkillHub API（安全报告/版本/推荐，需联网） |
| 分类体系 | 固定 SkillHub 官方 12 分类 + other，不开放自定义；口径见 references/taxonomy.md |
进阶配置
零硬编码，全部环境变量驱动：
| 环境变量 | 作用 | 默认 |
|---|---|---|
WORKBUDDY_HOME |
WorkBuddy 用户目录 | ~/.workbuddy |
SKILL_INSIGHT_SELF_ROOTS |
自建技能源根目录（用于「自建」来源判定） | 空 |
WB_PROJECTS_ROOT |
会话转录扫描根目录 | <WORKBUDDY_HOME>/projects |
| CLI 参数 | 作用 | 默认 |
|---|---|---|
--out <dir> |
输出目录 | <cwd>/skill-insight-report/ |
技术架构
┌─────────────────────────────────────────────┐
│ 数据源 │
│ ├── ~/.workbuddy/skills/*/SKILL.md │ 已安装技能
│ ├── ~/.workbuddy/skills/*/_skillhub_meta.json│ 来源/版本元数据
│ ├── ~/.workbuddy/projects/**/*.jsonl │ 会话调用记录
│ └── api.skillhub.cn │ SkillHub 平台（可选）
└──────────────────┬──────────────────────────┘
▼
┌─────────────────────────────────────────────┐
│ build_skill_map_data.py │
│ ├── 扫描已安装技能 + 元数据扩展 │
│ ├── 解析会话转录（60 天调用记录） │
│ ├── 分类归一化（taxonomy 映射 → 关键词兜底） │
│ ├── 洞察计算（吃灰/崛起/退烧/新宠） │
│ ├── 安全信任评分（信任+能力模型） │
│ ├── 功能重叠检测（Jaccard 相似度 ≥35%） │
│ ├── 管理建议生成（5 类可行动建议） │
│ └── SkillHub API 集成（安全报告/版本/推荐） │
└──────────────────┬──────────────────────────┘
▼
┌─────────────────────────────────────────────┐
│ inject_data.py + assets/skill_map.html │
│ ├── 单文件 HTML（ECharts + DATA 全内嵌） │
│ ├── 三视图：🗺 地图 / 📊 分析 / 💡 建议 │
│ ├── 详情面板（评分明细 + 生命周期 + 连带） │
│ └── 毫秒时间戳命名，永不覆盖历史 │
└─────────────────────────────────────────────┘
- 纯 Python 标准库，零第三方依赖，只读扫描不修改任何文件
- 降级容错：SkillHub API 超时 10s 自动降级为纯本地模式；无技能/无调用记录/目录不可写均有降级方案
- 数据一致性：快照 JSON 与源数据 100% 一致，可复现
排障
异常码（E001-E006）与警告（W002-W008）处理指引：references/troubleshooting.md
分类口径与降级链：references/taxonomy.md
纯 Python 标准库 · 零第三方依赖 · 只读扫描不修改任何文件 · 数据与快照 100% 一致
