Vft Kit

vft-kit

Claude Code / Codex 运维工具箱、通用开发工具，以及 macOS 菜单栏应用 [ai-helper](apps/ai-helper/)。插件主体在 `plugins/vft-kit/`，ai-helper 源码在 `apps/ai-helper/`。

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

装

Claude Code

claude plugin marketplace add Miofly/vft-kit
claude plugin install vft-kit@vft-kit

Codex

codex plugin marketplace add Miofly/vft-kit
codex plugin add vft-kit@vft-kit

Codex 入口在 `plugins/vft-kit/.codex-plugin/plugin.json`，skill 目录仍是 `plugins/vft-kit/skills/`。

新增或修改非平台专属能力时，必须遵循 `plugins/vft-kit/docs/codex-compat.md`。

ai-helper（macOS）

插件不会在安装时静默写入 Applications。安装好 `vft-kit` 后，直接对 Claude Code 或 Codex 说：

安装 ai-helper

`install-ai-helper` skill 会从本仓库的 `ai-helper-v*` GitHub Release 下载 DMG，依次校验 SHA-256、Bundle ID、Developer ID 签名和 Gatekeeper，再安装并启动。用户不需要克隆或编译 `apps/ai-helper` 源码。

发布资产约定和设计取舍见 [ai-helper 分发方案](docs/ai-helper-distribution.md)。

详细文档

每个 skill / hook 的完整用法、踩坑与配置，见博客的逐篇文档（下面「Skill 分类」是速览，想看细节点进去）：

• vft-kit 总览 —— 定位、安装、全量速查表、FAQ
• CC 运维：cc-baseline · cc-backup-restore · plugin-refresh
• Codex 运维：codex-baseline
• 通用工具：fe-auto-test · fe-lint-fix · co-infographic-generator · pr-submit · git-auto-push · vue-sfc-split · office-doc-rewrite
• macOS 应用：ai-helper 源码与安装说明

Skill 分类

运行目录使用 `plugins/vft-kit/skills///`。分类清单以 [`catalog/skills.json`](catalog/skills.json) 为唯一来源，目录分类、Claude manifest 和 Codex manifest 必须一致。

| 分类 | 定位 |