◆

vft-kit 总览:Claude Code 运维与工具箱插件

2026-07-13 02:000

这是什么

vft-kit 是一个 Claude Code 插件,装进 Claude Code 之后,会往你的会话里注入一组 skill(技能) 和 hook(钩子)。

做它的起因很实际:Claude Code 用久了,配置、插件、登录态会散落在本机各处,换电脑或者插件坏掉时没人救你;官方文档在这块写得很薄,社区踩的坑倒是不少。vft-kit 里的这些工具,就是踩坑之后沉淀下来的。

它分三大块:

  • Claude Code 自身运维——给 CC 这套工具链做体检、备份恢复、插件刷新、用量告警;
  • Codex 运维——给 Codex CLI 做同样的装配基线核对;
  • 通用开发工具——前端真实浏览器验证 + 性能体检、代码质量修复、信息图生成、PR 提交、绕过 hooks 提交、巨型 Vue 组件拆分、Office 文档改写、小程序反编译。

安装

# 添加 marketplace(本仓库路径或 git 地址)
claude plugin marketplace add <本仓库路径或 git 地址>

# 安装插件
claude plugin install vft-kit@vft-kit

装完重启一次 Claude Code 会话,skill 和 hook 才会加载进来。之后在对话里用自然语言描述需求即可触发对应 skill,不用记命令。

装了之后新 skill 没出现、或改了插件不生效?看 plugin-refresh 插件刷新 一页——这是 CC 插件机制最常见的坑。

全量速查表

CC / Codex 运维(统一入口)

skill干什么详情
agent-baseline按需执行 CC / Codex 装配核对、插件刷新、CC 备份恢复 / 清理,以及 CC Switch 供应商配置装配 · 备份恢复 · 插件刷新

备份恢复与供应商配置不会顺带运行完整装配维护。清理须先展示范围并交互确认;供应商写库前备份,默认不切换当前供应商。CC Switch 路线支持 Anthropic Messages、OpenAI Chat Completions 与 Responses;它只配置 Claude Code 供应商。

显式调用 /vft-kit:agent-baseline 并说明任务;Codex 用 $agent-baseline。原独立备份恢复与供应商入口已移除,详细用法按路线读取。

Codex 装配路线

skill干什么详情
agent-baseline 的 Codex 路线核对本机 Codex CLI、Hooks、MCP、插件和全局规范;只处理指定宿主→

通用工具类(14 个 skill)

skill干什么详情
fe-auto-testPlaywright 真实浏览器验证前端页面 + Lighthouse 全维度体检(依赖自动补装)→
co-infographic-generator结构化文字 → 信息图(HTML+CSS 排版,puppeteer 截图成 PNG)→
git-ops日常 Git 操作(提交/分支/同步/冲突/回退/tag)+ 全自动 PR 交付→
git-auto-push绕过 git hooks 提交(husky / lint-staged 卡住时的逃生通道)→
vue-sfc-split把体量过大的 Vue 单文件组件拆成「平铺入口 + 专属目录」→
office-doc-rewrite改 Office 文档(xlsx/doc/docx)文字但保留图片/样式/布局——拿模板换内容→
wechat-mp(含反编译)微信小程序反编译(已并入 wechat-mp):定位缓存包、解密解包、还原 WXSS,用于样式复刻;TikTok Minis 抓 H5 前端(仅学习研究)→
skill-creator新建 / 改进 skill,跑 eval 对比效果、优化 description 触发率(Anthropic 官方 skill,Apache 2.0)→
grill-me逼问式方案访谈:按决策树一轮轮追问计划/设计,每题附推荐答案,理解一致才动手(只手动 /grill-me,来自 mattpocock/skills,MIT)→
diagnosing-bugs疑难 bug / 性能回退诊断:先造能变红的反馈回路,再最小化复现、可证伪假设、单变量插桩、回归测试(自动触发,来自 mattpocock/skills,MIT)→
frontend-design页面、应用布局、组件、动效、视觉效果、字体与设计审查,以及技术概念等距解说图(Anatomy);按功能组织源码、检索、案例与测试,遵守各自许可→
rea已发布产物逆向分析:原生二进制、Electron/asar、网页 bundle、APK、固件的反编译与版本对比(自动触发,来自 morluto/rea,MIT)→
soft-ops桌面软件操作与后台 GUI:软件安装配置、偏好与快捷键迁移、插件兼容替代、本地配置修复、原生窗口操作,以及不打扰用户的后台 GUI(Electron 独立实例、cua-driver、macOS 虚拟机)→
ego-browser-opsego-browser(ego lite,Chromium 内核、人和 Agent 共用)操作手册:安装探测与升级、profile 指定、task space 生命周期、Page 全 API、从 Chrome 导入 profile、书签管理脚本(ego-bookmarks.sh)与排障→

SEO 工具站扩词

seo-ops 用于技术 SEO、内容、结构化数据与竞品对照。工具站优化不能只往 meta keywords 填词:先核对真实功能,再把正式名、口语别名、英文格式词和用途分配到独立标题、可展开说明、问答与相关工具链接。

  • 参考竞品的信息组织,不照抄正文:iLoveIMG 按格式分组,PDF24 说明免费与限制,123apps 覆盖剪歌曲/铃声等用途,BeJSON 用相关工具导航承接邻近需求。
  • “免费”不等于所有功能无限额、免登录或不上传。相似但本站未实现的能力不能写成本页功能;已有专页的关键词不要再建重复 URL。
  • 摘要用本页真实导语、用途、限制与步骤,不为达到固定字数自动套上全格式、批量或隐私承诺。Google 不使用 meta keywords 排名,也不能保证关键词越多排名越高。
  • 全站优化先列真实公开路由,以全部注册页面为覆盖分母,不把热门页面抽样当作全站完成;管理工作区和个人收藏需准确说明并从公开 sitemap 排除,重定向别名不重复收录。
  • 修改后逐页测试元数据和指南 SSR 模板,再抽验原始 HTML 与水合页面:标题、canonical、说明展开与相关链接都要可用。全屏独立页应核对生产与单路由预览的包装差异。没有 Search Console 曝光、点击和索引数据,不能把代码完成写成排名已提升。

博客批量优化还需保留摘要中的行内 API 名称,用文章标题和真实小节扩主题词;手写关键词与生成词合并,空数组不能覆盖。相关文章按具体主题关联,找不到可靠匹配时只给归档入口,不用泛分类凑推荐。文章日期取原文,不伪造最新更新时间;全量数据/模板测试与浏览器整页验证分别报告。

hook 类(3 个)

hook干什么详情
用量告警5 小时 / 7 天用量越过阈值时发 macOS 通知(读 claude-hud 落盘快照)→
vft-rules按文件路径注入规范(插件版 .claude/rules)+ 保存后自动检查,违规退回;项目可继承追加→
task-completion-gate(按需启用)每轮任务状态门控:显式终态和工具验收证据才能结束,替代按回复措辞猜测→

skill 和 hook 有什么区别

这是理解 vft-kit 的关键,两者的触发方式完全不同:

skillhook
谁来触发LLM:你用自然语言描述需求,Claude 判断该不该用Claude Code 本体:在固定事件(会话结束 Stop、调用工具 PreToolUse/PostToolUse 等)自动执行
本质一份写给 LLM 的操作说明书(SKILL.md)+ 配套脚本一段在特定时机跑的脚本,和 LLM 的判断无关
例子「帮我核对下 cc 基线」→ 触发 cc-baseline一轮任务结束 → 自动弹「任务完成」通知
开通装好插件即用用量告警随插件自动注册;用量数据管道需先接通 claude-hud 落盘快照

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:基本只读——只核对状态、打印修复命令,改不改由你决定。唯一例外是 ponytail(反过度工程基线插件):缺失时会自动静默补齐(marketplace add + plugin install 两步),装完提示重启会话即可;其余所有缺失项一律仍需你确认后才动。

许可

MIT。

留言板

0 条留言
Markdown
0 字
对话记录每个声音,都值得被看见

对话,从你开始

还没有留言。分享一个想法,或只是打声招呼。

PAGE LOAD / LIVEvft-kit 总览:Claude Code 运维与工具箱插件加载中