一个我自己写的小工具,专治「AI 技能包装着装着就成了一团麻」
完全免费开源。macOS / Windows / Linux 都支持。欢迎提优化意见,觉得好用可以star支持一下~
先问你一个扎心的问题
你给 Claude Code、Codex、Cursor 这些 AI 编程工具装过「技能包」(skill)吗?
就是那种网上一搜一大把、复制一行命令就能装上的小玩意儿。装个 git-push 让它帮你提交代码,装个 obsidian-markdown 让它懂你的笔记格式。
装的时候是真爽。一行命令,三秒到位。
问题是三个月之后。
我前几天心血来潮,数了数自己的电脑:
看见顶上那排数字了吗?43 个技能包,26 个是重复的,12 个在绕远路(这个稍后细说,最坑),还有 1 个压根找不到了,指向一个早就被删掉的文件夹。
一半以上有毛病。而这一切,我在装的时候完全没有察觉。
为什么会乱成这样
这事儿真不怪你。
你想想,现在谁还只用一个 AI 工具?Claude Code 写代码,Codex 跑批量任务,Cursor 里顺手补个函数,opencode 开个终端。我这台电脑上装了七个。
而这七个家伙,各自把技能包放在自己家里,谁也不知道隔壁住了谁。
于是就有了这些场景。你在 A 工具里装了个 prototype,两个月后在 B 工具里又装了一遍,现在磁盘上躺着两份,改哪份生效?看命。你手滑删了某个技能包的文件夹,但指向它的那些「快捷方式」还在原地,AI 每次启动都去敲那扇门,门后面什么都没有。
最绝的是「绕远路」:快捷方式 A 指向快捷方式 B,B 才指向真东西。平时能用,直到某天 B 被删了,A 跟着一起死,而你根本想不起来 B 是谁。
我做这个功能的起点很简单。我想先看见,才谈得上收拾。
一、先让你看见
打开工具管理页(侧栏底部那个扳手图标),第一眼就是一张体检报告。
顶上那排彩色标签就是病历本,重复 26、绕远路 12、找不到 1。每一个都能点,点下去列表立刻只剩这一类。
右边是选中那个技能包的详细档案。「启用于」那排小图标告诉你哪几个 AI 能看见它,亮着的就是能用的;「内容」是真东西存在哪儿,注意这里可能不止一条,有好几条就说明你装重复了;「引用」列出所有指向它的快捷方式,以及中间拐了几道弯。
最下面还有一栏「风险点」,这个值得多说一句。
技能包本质上是一段文本指令,AI 会照着做。也就是说,你从网上装的技能包,理论上可以让 AI 去删你的文件。所以我扫了一遍,把可疑的命令都标出来了,还分了等级。这里有个小心思:说明文档里举例用的 rm -rf 和真要执行的脚本里的 rm -rf,危险程度差着十万八千里,前者会自动降级。不然满屏飘红,等于没标。
二、搬家:把散落的技能包收进一个窝
看见问题之后,第一件事是统一门户。
选一个主文件夹(我用的是 ~/.agents/skills),点「搬进主 store」:
图里这个 git-push 就是典型病例。同一份东西在我电脑上躺了三处,一处在 ~/.skills-manager,另外两处在项目目录里,我自己完全没印象什么时候装了三遍。
注意看弹出来的这个框。它没有二话不说就开搞,而是把要干的事一条条摊开:三处各搬一次到主文件夹,搬完在原地各留一个快捷方式指过去。
原地留快捷方式这一步很关键,是为了让原来能用的东西继续能用。你不用担心搬完之后哪个 AI 突然找不到它了。
看明白了点「执行 6 步」,觉得不对就点「取消」。在你点之前,磁盘上一个字节都没动。
嫌一个个搬麻烦?右上角有个「全部搬进主 store」,一次性收编。
三、拉直:把绕远路的快捷方式掰正
这个是我最想吐槽的毛病。
先解释下什么叫绕远路。正常情况应该是这样:
Claude 的文件夹 ──────────────→ 真东西
但实际上我电脑里长这样:
Claude 的文件夹 ──→ 另一个快捷方式 ──→ 真东西
中间莫名其妙多了一跳。平时完全看不出来,因为它能用。
直到某天你清理磁盘,把中间那个删了。然后 AI 就说技能包找不到,而你对着 Claude 的文件夹左看右看:快捷方式明明还在啊!
这种问题排查起来,是真的想砸键盘。
点「修链接」:
它干的事非常直白,把中间商踢掉。原来 ~/.claude/skills/three 要先经过 .skills-manager 才能到 .cc-switch,修完之后直达。
同样,动手前把两步摊给你看。
四、删除:死链是怎么来的
重点来了。你以为的删除,和实际发生的删除,可能不是一回事。
绝大多数工具的「删除技能包」,就是把那个文件夹 rm -rf 掉。干脆利落。
然后呢?指向它的那七八个快捷方式,全留在原地变成了死链。
我前面说的那「1 个找不到」,就是这么来的。这不是我编的假设,是我自己电脑上真实发生过的事。
所以这里的删除是反过来做的:
先把指向它的快捷方式一条条摘掉,然后才删真东西。
顺序不能反。反过来的话,快捷方式瞬间全变死链,而这时候你已经没有任何信息知道该去哪些文件夹清理了。那些死链会在你硬盘上躺一年,直到某天你翻出来,一脸茫然。
还有个细节,看到「删除 2」了吗?这个技能包在我电脑上同时存在两个地方。只删一个的话,另一个还会继续生效,你会以为没删干净。事实上你确实没删干净。
底下那行红字写得明明白白:「删除不可撤销,上面列的会全部消失。」看完再点。
补充一个场景:同一个技能包,全局装了一份、某个项目里也装了一份,你只想删全局那份。列表里每一条「内容」后面都有一个单独的删除按钮,想删哪份删哪份,互不干涉。
顺手还管了这些
技能包是主角。但既然打开了工具管理页,就顺手把其他几摊也收了。
MCP:你的上下文被谁吃了
MCP 是给 AI 外挂能力的插件,能读网页、能操作浏览器那种。它有个隐藏成本:每个插件都要先把自己的说明书塞给 AI 看,而 AI 的记忆是有限的。
看顶上那条「上下文预算」。我这儿装了五个,还没开始说话就吃掉了约 5726 个 token,全是图里那个 chrome-devtools 一个人干的,它带了 29 个工具。装十来个插件的人,可能一开口就已经烧掉十几万上下文,然后纳闷「AI 怎么老是忘事」。
这个面板的目的不是让你装更多插件,是让你看清楚哪个该关掉。
还有个更隐蔽的。同一个插件你可能在好几个文件里都写过,真正生效的只有优先级最高的那份。图里最下面那栏「被覆盖的定义」列的就是白写的那些。你改了,存了,然后一点效果都没有,对着文件发呆半小时。
发现 skills:装之前先看清楚
可以直接搜社区的技能包,数据来自 skills.sh。
搜只是顺带的,重点是装之前能看见里面有什么:说明、文件清单、来自哪个版本。别人写的、AI 会当指令执行的东西,闭着眼装进去是真的有点刺激。
点「复制并安装」之后,会在旁边开一个看得见的终端,命令一行行跑给你看,觉得不对随时 Ctrl-C。它会停下来问你要装到哪几个 AI,这一步得你自己选。
说个丢人的。这个「停下来等你选」是被血教训出来的。开发过程中有一次,因为一个环境变量的问题,那个命令误以为「有程序在自动操作我」,于是一句话不问,直接把东西装进了 7 个工具的文件夹。当场吓出一身汗,连夜修的。现在它老老实实停在那儿等人点。
全局配置:AI 到底在读哪份指令
CLAUDE.md、AGENTS.md 这些文件,是你给 AI 定的规矩。
坑在于它们会互相串门。opencode 自己没有这个文件的话,会去读 Claude 的,图里那个「回退」标签说的就是这个。也就是说你改 Claude 的规矩,opencode 也跟着变了,而你完全不知情。
这个面板就是把这张关系网画出来。谁有、谁没有、谁在读谁的、哪两份内容已经不一样了。
哦对了,它本职是个会话浏览器
说了半天工具管理,其实这是个附加功能。
这个 App 的本职,是把 Claude Code、Codex、Grok、Kimi、Pi、Antigravity、opencode 这七个 AI 散落在硬盘各处的聊天记录,整合到一个界面里浏览。
- 完整还原思考过程、工具调用、代码 diff、贴过的图
- 全局搜索,
⌘⇧F跨项目找,直接跳到那条消息 - 一键在终端里接着聊
- 算 token 和花了多少钱
- 导出成 Markdown / HTML
- 删掉的会话进回收站,能捞回来
- 支持自定义背景设置(支持mp4)
- 软件支持分配操作
图里能看到每个会话的消息数、体积、token 数。顺便一提,最上面那条 6823 条消息、177.5 MB 的,就是我写这篇文章的这个会话。
两条我一步没让的底线
这工具会动你的配置文件,所以有两件事我想说清楚。
第一,不确认就不写盘。你在上面看到的每一个弹框,意思都是「我打算这么干,你看行不行」。点取消,磁盘上什么都没发生。
第二,不碰你自己写的东西。改配置文件时只重写这个 App 认识的那几个键,你手写的注释、你自己加的配置,原样保留。改之前在旁边留一份备份;如果发现文件在读进来之后被别的程序动过,这次写入会直接拒绝,而不是盖掉你的改动。
说白了就一句话。这是你的电脑,我只负责帮你看清楚,动手之前得你点头。
怎么用
完全免费开源,macOS / Windows / Linux 都有。欢迎提优化意见,觉得好用可以star支持一下~
下载:https://github.com/jerrywu001/cc-sessions-viewer/releases
源码:https://github.com/jerrywu001/cc-sessions-viewer
打开之后点侧栏最下面那个扳手图标(或者按 ⌘K),就是本文说的工具管理页。
第一次打开建议什么都别急着点,先看看那排数字。
我赌你那台电脑上的「重复」也不会是 0。

