从Tech Tree到Galaxy 3D:pm-claude-skills的Web Playground与技能可视化设计解析
从Tech Tree到Galaxy 3D:pm-claude-skills的Web Playground与技能可视化设计解析
如果你想在浏览器里快速试用上千个 Agent Skills,pm-claude-skills 的 Web Playground 就是最佳入口。这个项目收录了 1255+ 个专业技能(PRD、周报、裁员谈判、医疗账单解读……全部是纯 Markdown 文件)。但真正让人眼前一亮的,是它把整个技能库做成了一套可视化体系:Tech Tree 技能科技树、2D 星图、Galaxy 3D 三维星空。这篇文章带你拆解这几种技能可视化设计是怎么做出来的,以及为什么普通用户会觉得它"好玩又好用"。
先认识主角:零后端的 Web Playground
Web Playground 是项目自带的在线试用台:选一个技能 → 它自动变成一个表单 → 填完点运行,结构化结果就在浏览器里流式输出。
对新手来说它有三个关键特性(详见 web/README.md):
| 特性 | 说明 |
|---|---|
| 🔑 密钥只留在浏览器 | API key 存于 localStorage,直连模型提供商,不经过任何服务器 |
| 🏷️ 成熟度分层 | 每个技能标注 🟢 Production-Ready / 🔵 Stable / 🟡 Experimental,一眼看清可信度 |
| 📋 一键复制到其他工具 | 任意技能可复制为 ChatGPT、Gemini 可用的提示词,粘贴即用 |
底层数据源是 web/skills.json,由构建脚本扫描 skills/ 目录自动生成——界面、目录、星图、科技树全部读同一份数据,这就是"技能可视化"能保持一致的基础。
Tech Tree:把技能库当成"科技树"来点
打开 site/tech-tree/index.html(源码见 site/tech-tree/),你会看到一棵横跨 150+ 个分支的大树:每个分支是一类技能包(autopilot、analytics、banking……),每个节点是一个技能。
它的设计亮点在于节点有三种状态,用颜色区分:
- 🟢 Researched(已研究):已发布的正式技能
- 🩷 In research(研究中):社区投票最多的需求,正在开发
- 🔵 Proposed(提议中):虚线框,等待社区投票
这个"研究队列"机制让技能库本身变成了产品:你的投票真的会被写进 site/tech-tree/votes.json,再由构建脚本同步进 site/tech-tree/data.json(该文件注释明确写着"由脚本生成,请勿手改",保证数据链路干净)。
交互细节也很克制:
- 点任意节点 → 右侧滑出详情面板,给出 CLI 安装命令(
npx pm-claude-skills add ...)和 Claude Code 插件命令,一键复制 - 顶部搜索框实时匹配,命中的节点会高亮描边
- 每个节点还能"生成分享海报"——带二维码的 1080×1350 图片,扫码即读技能
- 支持中英文切换,深色/浅色跟随系统
对新手而言,Tech Tree 回答的是最实际的问题:"我该装哪个?怎么装?"
Galaxy 3D:钻进 1285 颗星星组成的星空
如果说 Tech Tree 是"说明书",那 Galaxy 3D(源码 web/galaxy3d.html)就是"游乐场"。它用 WebGL(three.js)把整个技能库渲染成一个可以飞行的真实星场。
读一下源码(web/galaxy3d.html)会发现几个非常讲究的设计决策:
- 黄金分割配色:每个技能包(bundle)的颜色按
i * 0.618034 % 1取色相,相邻分支永远不会撞色,152 个星团各自发光却互不混淆; - 三螺旋星臂:技能包中心点沿三臂螺旋分布,
production级技能的星星更大更亮,成熟度直接"可视化"; - 飞行搜索:在搜索框输入关键词,镜头会"飞"到对应星星的位置并自动弹出面板——搜索不再是列表,而是空间导航;
- 超空间跳跃(Warp):点 Warp 按钮,相机随机跳向一颗星,同时 FOV 拉伸 + Bloom 光晕激增,复刻"超空间飞行"的手感;
- "你的星星更亮":你在 Playground 里真正运行过的技能,星星会燃烧得更亮(数据来自
localStorage的运行记录)——技能库第一次有了"个人痕迹"。
它还有 2D 版本 web/galaxy.html:技能按职业聚类成星座,亮度对应评测得分,Guided Journeys 被画成星轨,相关技能之间还画了连线。
设计解析:为什么可视化能降低门槛
把 Tech Tree、2D 星图和 Galaxy 3D 放在一起看,能总结出三条技能可视化设计原则,对做类似项目的人很有参考价值:
- 同一份数据,多种叙事:列表回答"有什么",Tech Tree 回答"怎么选",星图回答"怎么逛"。三层界面共用
skills.json,维护成本不随界面数量上升; - 游戏化不喧宾夺主:Warp、星星变亮、投票队列都是"调味",核心动作(搜索、查看说明、复制安装命令)始终一步可达;
- 全客户端、零服务器:所有可视化都跑在浏览器里,密钥不落地到服务器,隐私故事本身就成了产品卖点。
快速上手:3 步本地体验
如果想在自己的机器上跑起来,仓库地址是 https://gitcode.com/gh_mirrors/pm/pm-claude-skills:
- 克隆仓库:
git clone https://gitcode.com/gh_mirrors/pm/pm-claude-skills - 本地起一个静态服务(Playground 必须走 HTTP,不能直接
file://打开):cd web && python3 -m http.server 8000 - 打开
http://localhost:8000,粘贴你的模型 API key,开始运行技能
不想装任何东西?项目文档 site/README.md 还介绍了目录站点的部署方式,site/ 与 web/ 两个静态站分离部署,前者是目录与 Tech Tree,后者是 Playground 本体。
小结
pm-claude-skills 的聪明之处,在于它没有把 1255 个 Markdown 文件堆给你,而是用 Web Playground + Tech Tree + Galaxy 3D 三种互补的技能可视化,把"庞大"翻译成了"可探索":想装技能看科技树,想随便逛就飞进星空。对一个以纯 Markdown 为核心资产的项目来说,这种"数据一次生成、多形态消费"的设计,值得任何技能库或文档型项目借鉴。




