antfu/skills · 上手攻略

• 仓库：antfu/skills
• 链接：https://github.com/antfu/skills
• 分类：开发工具 · Agent Skills · Vue 生态
• 作者：Tom
• 更新：2026-08-08

这是什么

antfu/skills 是 Vue/Nuxt 核心团队成员 Anthony Fu（别名 @antfu，GitHub 8 万+ Stars 的开源大神）维护的 Agent Skills 精选集合。这些 skill 以标准化格式（SKILL.md）存在，让 AI agent 能够调用 Anthony Fu 在 Vue/Vite/Nuxt 生态多年积累的最佳实践和方法论。

项目包含三类 skill： - Anthony Fu 手动的 opinionated skill（2 个） - 从官方文档自动生成的 skill（8 个），由 Anthony 精调 - 来自外部仓库的 vendored skill（8 个），通过 git submodule 同步

Anthony 在 README 中明确表示："这是 proof-of-concept 项目，用来验证从官方文档生成并同步 agent skills 的可行性，我对 skill 在实践中的表现还没有完全测试，欢迎反馈和贡献。" ——也就是说，这个项目本身是一个关于如何做 skills 的示范，同时也是一个可直接使用的 skill 集合。

解决什么问题

当 AI agent 写 Vue / Nuxt / Vite 代码时，它通常依赖训练数据中的知识——可能知道 Vue 3 reactivity 是什么，但不熟悉 Anthony Fu 本人在生产项目中的 ESLint 规则偏好、pnpm 工作流、或 UnoCSS 的原子化 CSS 设计哲学。antfu/skills 把这位 Vue 核心成员的个人偏好蒸馏进 skills，让 agent 生成代码时自动参考"正确的做法"。

典型使用场景： - 让 AI 写更符合 Vue 生态规范的代码：不只是功能正确，还符合 Anthony Fu 认可的工程风格 - 持续同步官方文档：通过 git submodule 引用上游，文档更新后 skill 可同步 - 一站式 Vue 生态 skill：不用分别找 Vue / Vite / Nuxt / Vitest / UnoCSS 的 prompt，all-in-one

快速安装

方式一：pnpx（推荐，只需 Node.js）

# 安装所有 skill（局部项目）
pnpx skills add antfu/skills --skill='*'

# 全局安装
pnpx skills add antfu/skills --skill='*' -g

需要 Node.js ≥ 18，pnpm 可通过 corepack enable pnpm 启用。

方式二：从源码构建自定义集合

# 克隆仓库
git clone https://github.com/antfu/skills
cd skills

# 安装依赖
pnpm install

# 更新 meta.ts 配置你想包含的项目和 skill 来源
# 清理已有 skill
pnpm start cleanup
# 初始化 git submodule
pnpm start init
# 同步 vendored skill
pnpm start sync

# 让 agent 生成新 skill（建议逐个执行以控制 token 消耗）
pnpm start generate <target>

方式三：直接引用 submodule

# 添加为 git submodule
git submodule add https://github.com/antfu/skills skills

方式四：手动复制 SKILL.md

访问 skills/ 目录，直接复制对应 SKILL.md 内容到你的 agent 项目中。

核心 Skill 详解

Anthony Fu 手动维护（Opinionated）

官方文档生成（Unopinionated but tilted）

外部同步（Vendored）

典型适用场景

场景 1：新 Vue 3 项目启动

让 agent 使用 antfu + vue + vite + vitest skill，一次性获得 Anthony Fu 认可的项目结构、ESLint 配置和测试设置。

场景 2：Nuxt 全栈项目

激活 nuxt + pinia + unocss skill，agent 在生成代码时自动遵循 Nuxt 文件路由规范和 UnoCSS 原子化命名约定。

场景 3：构建工具链升级

通过 vite + vitest + turborepo skill，让 agent 理解 Vite 6 的配置变化和 Turborepo 的缓存策略。

场景 4：文档站点搭建

vitepress skill 指导 agent 正确配置 VitePress，包括主题定制和部署配置。

坑与注意

1. Skill 召回存在 false negative：Anthony 本人在 README 中坦诚说明，skills 可能不会被 agent 在期望的时刻触发加载（false negative），这取决于 Claude Skills 系统的触发机制。Anthony 认为 AGENTS.md 加载一切所以更可靠，skills 的优势在于按需。建议将关键 skill 路径直接写入 AGENTS.md 引用。
2. git submodule 依赖：Vendored skill 通过 git submodule 管理，git clone --recursive 或 pnpm start init 时需要网络访问上游仓库。
3. 生成新 skill 需手动执行：pnpm start generate 需要你主动运行，不是自动化同步。上游文档更新后，skill 内容需要重新生成才能同步。
4. pnpx 依赖网络：每次 pnpx skills add 需要访问网络下载 skill 定义，首次使用较慢。
5. Proof-of-Concept 状态：Anthony 明确表示项目仍在探索阶段，skill 质量依赖于生成效果，尚非生产级稳定工具。

与同类对比

antfu/skills 的核心差异是 Anthony Fu 本人的工程判断——不只是告诉你"怎么用"，还告诉你"Anthony preferred 的做法"。

一句话推荐结论

如果你在 Vue / Vite / Nuxt 生态做开发，antfu/skills 是目前最值得信赖的 Agent Skills 集合——Vue 核心成员 Anthony Fu 亲自维护，git submodule 直连上游，一套顶八套，free（MIT）。

📌 参考：pnpx skills CLI 由 Vercel Labs 的 skills 项目 提供。