vft-kit 总览
这是什么
vft-kit 是一个 Claude Code 插件，装进 Claude Code 之后，会往你的会话里注入一组 skill（技能） 和 hook（钩子）。
做它的起因很实际：Claude Code 用久了，配置、插件、登录态会散落在本机各处，换电脑或者插件坏掉时没人救你；官方文档在这块写得很薄，社区踩的坑倒是不少。vft-kit 里的这些工具，就是踩坑之后沉淀下来的。
它分两大块：
- Claude Code 自身运维——给 CC 这套工具链做体检、备份恢复、插件刷新、用量告警；常驻菜单栏助手 cc-helper（用量+通知）；
- 通用开发工具——前端真实浏览器验证 + 性能体检、信息图生成、绕过 hooks 提交、巨型 Vue 组件拆分。
安装
# 添加 marketplace（本仓库路径或 git 地址）
claude plugin marketplace add <本仓库路径或 git 地址>
# 安装插件
claude plugin install vft-kit@vft-kit
装完重启一次 Claude Code 会话，skill 和 hook 才会加载进来。之后在对话里用自然语言描述需求即可触发对应 skill，不用记命令。
装了之后新 skill 没出现、或改了插件不生效？看 plugin-refresh 插件刷新 一页——这是 CC 插件机制最常见的坑。
全量速查表
CC 运维类（3 个 skill）
| skill | 干什么 | 详情 |
|---|---|---|
cc-baseline | 核对本机 CC 是否符合「装配基线」（CLI / npm / MCP / 插件 / 权限），缺什么给修复命令。纯只读 | → |
cc-backup-restore | 备份 / 恢复配置与数据（CLAUDE.md、settings.json、插件、memory、hooks、skills），换号 / 重装 / 换机用 | → |
plugin-refresh | 刷新插件 cache——改了本地插件源却不生效时用它 | → |
通用工具类（5 个 skill）
| skill | 干什么 | 详情 |
|---|---|---|
fe-auto-test | Playwright 真实浏览器验证前端页面 + Lighthouse 全维度体检（依赖自动补装） | → |
co-infographic-generator | 结构化文字 → 信息图（HTML+CSS 排版，puppeteer 截图成 PNG） | → |
git-auto-push | 绕过 git hooks 提交（husky / lint-staged 卡住时的逃生通道） | → |
vue-sfc-split | 把体量过大的 Vue 单文件组件拆成「平铺入口 + 专属目录」 | → |
cc-helper-setup | 构建并安装 cc-helper.app——常驻菜单栏的 CC 助手（实时用量 + 重置倒计时 + 可选刘海显示 + 事件通知横幅 + 图形设置面板） | → |
hook 类（1 个）
| hook | 干什么 | 详情 |
|---|---|---|
| 用量告警 | 5 小时 / 7 天用量越过阈值时发 macOS 通知（配 usage-alert-setup 开通） | → |
原「桌面通知 hook」已退役,任务完成 / 失败 / 等待输入 / 对话完成的通知整体并入 cc-helper。
skill 和 hook 有什么区别
这是理解 vft-kit 的关键，两者的触发方式完全不同：
| skill | hook | |
|---|---|---|
| 谁来触发 | LLM：你用自然语言描述需求，Claude 判断该不该用 | Claude Code 本体：在固定事件（会话结束 Stop、调用工具 PreToolUse/PostToolUse 等）自动执行 |
| 本质 | 一份写给 LLM 的操作说明书（SKILL.md）+ 配套脚本 | 一段在特定时机跑的脚本，和 LLM 的判断无关 |
| 例子 | 「帮我核对下 cc 基线」→ 触发 cc-baseline | 一轮任务结束 → 自动弹「任务完成」通知 |
| 开通 | 装好插件即用 | 用量告警随插件自动注册；cc-helper / 用量数据管道需跑一次 setup skill |
FAQ
Q：装完插件，新 skill 在对话里没出现 / 改了 SKILL.md 不生效？ A：CC 的插件加载分「组件清单」和「注入给 LLM 的 SKILL.md 正文」两层，后者读的是本机 cache 拷贝，改源后必须刷 cache 再重启会话。详见 plugin-refresh。
Q：fe-auto-test 要浏览器和 Lighthouse，要我手动装吗？ A：不用。skill 每次跑第一步会检查并自动补装 npm 包 + chromium 内核，装完即用；playwright 插件 / lighthouse MCP 的注册需下次会话才加载，但当前会话会走「脚本路径」把活干完，能力等价。详见 fe-auto-test。
Q：用量告警 hook 为什么只对 macOS？ A：它靠 macOS 的 osascript / terminal-notifier 发系统通知。非 macOS 时 hook 静默退出，不影响会话。
Q：cc-baseline 会改我的配置吗？ A：不会，它纯只读，只核对状态、打印修复命令，改不改由你决定。
许可
MIT。
还没有留言，来发表第一条吧～