# Vue/Vite智能技能集合

`Agent Skills` `Vue` `Vite` `Nuxt` `工具集合`

# froQ 的技能集

由 [froQ](https://github.com/0froq) 维护的精选 [Agent Skills](https://agentskills.io/home) 合集，以及相关工具的使用文档。

> [!IMPORTANT]
> 这是一个概念验证项目，用于从源文档生成 Agent 技能并保持同步。
> 我尚未完整测试这些技能在实际使用中的表现，因此非常欢迎反馈和贡献。

## 安装

```bash
pnpx skills add 0froq/skills --skill='*'
```

或全局安装所有技能：

```bash
pnpx skills add 0froq/skills --skill='*' -g
```

了解更多 CLI 用法请访问 [skills](https://github.com/vercel-labs/skills)。

## 技能列表

本合集旨在为主要使用 Vite/Nuxt 的开发者提供一站式技能库，收录了来自不同来源、覆盖不同范围的技能。

### 手动维护的技能

> 具有主观倾向性

由 Anthony Fu 根据其偏好的工具、配置规范和最佳实践手动维护。

| 技能 | 描述 |
|------|------|
| [antfu](skills/antfu) | Anthony Fu 针对应用/库项目的偏好和最佳实践（eslint、pnpm、vitest、vue 等） |

### 从官方文档生成的技能

> 无主观倾向，但有一定侧重（如 TypeScript、ESM、Composition API 及其他现代技术栈）

从官方文档生成，并由 froQ 在此 Fork 中进行微调。

| 技能 | 描述 | 来源 |
|------|------|------|
| [vue](skills/vue) | Vue.js 核心 - 响应式、组件、Composition API | [vuejs/docs](https://github.com/vuejs/docs) |
| [nuxt](skills/nuxt) | Nuxt 框架 - 基于文件的路由、服务端路由、模块 | [nuxt/nuxt](https://github.com/nuxt/nuxt) |
| [pinia](skills/pinia) | Pinia - 直观、类型安全的 Vue 状态管理 | [vuejs/pinia](https://github.com/vuejs/pinia) |
| [vite](skills/vite) | Vite 构建工具 - 配置、插件、SSR、库模式 | [vitejs/vite](https://github.com/vitejs/vite) |
| [vitepress](skills/vitepress) | VitePress - 由 Vite 驱动的静态站点生成器 | [vuejs/vitepress](https://github.com/vuejs/vitepress) |
| [vitest](skills/vitest) | Vitest - 由 Vite 驱动的单元测试框架 | [vitest-dev/vitest](https://github.com/vitest-dev/vitest) |
| [unocss](skills/unocss) | UnoCSS - 原子化 CSS 引擎、预设、转换器 | [unocss/unocss](https://github.com/unocss/unocss) |
| [pnpm](skills/pnpm) | pnpm - 快速、节省磁盘空间的包管理器 | [pnpm/pnpm.io](https://github.com/pnpm/pnpm.io) |
| [conventionalcommits](skills/conventionalcommits) | 约定式提交：核心规范语义与实用提交模式 | [conventional-commits/conventionalcommits.org](https://github.com/conventional-commits/conventionalcommits.org) |

### 外部同步的技能

从维护自有技能的外部仓库同步而来。

| 技能 | 描述 | 来源 |
|------|------|------|
| [slidev](skills/slidev)（官方） | Slidev - 面向开发者的演示幻灯片 | [slidevjs/slidev](https://github.com/slidevjs/slidev) |
| [tsdown](skills/tsdown)（官方） | tsdown - 由 Rolldown 驱动的 TypeScript 库打包工具 | [rolldown/tsdown](https://github.com/rolldown/tsdown) |
| [turborepo](skills/turborepo)（官方） | Turborepo - 高性能 Monorepo 构建系统 | [vercel/turborepo](https://github.com/vercel/turborepo) |
| [vueuse-functions](skills/vueuse-functions)（官方） | VueUse - 200+ Vue 组合式工具函数 | [vueuse/skills](https://github.com/vueuse/skills) |
| [vue-best-practices](skills/vue-best-practices) | Vue 3 + TypeScript 最佳实践 | [vuejs-ai/skills](https://github.com/vuejs-ai/skills) |
| [vue-router-best-practices](skills/vue-router-best-practices) | Vue Router 最佳实践 | [vuejs-ai/skills](https://github.com/vuejs-ai/skills) |
| [vue-testing-best-practices](skills/vue-testing-best-practices) | Vue 测试最佳实践 | [vuejs-ai/skills](https://github.com/vuejs-ai/skills) |
| [web-design-guidelines](skills/web-design-guidelines) | 构建精美界面的 Web 设计指南 | [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) |

## 常见问题

### 这个合集有什么不同之处？

本合集具有一定的主观倾向性，但关键区别在于它使用 git 子模块直接引用源文档。这提供了更可靠的上下文，并使技能能够随时间推移与上游变化保持同步。如果你主要使用 Vue/Vite/Nuxt，这里旨在成为一个全面的一站式合集。

该项目还被设计为灵活可扩展——你可以将其作为模板来生成自己的技能合集。

### Skills vs llms.txt vs AGENTS.md

在我看来，技能的价值在于**可共享性**和**按需加载**。

可共享性使提示词更易于跨项目管理和复用。按需加载意味着技能可以在需要时按需引入，其规模远超任何 Agent 上下文窗口一次能容纳的内容。

你可能听说过"AGENTS.md 比 skills 表现更好"。我认为这是事实——AGENTS.md 在启动时就加载所有内容，因此 Agent 总会遵守它；而技能可能存在漏召回的情况，即 Agent 在你期望它调用技能时没有调用。不过，我认为这更多是工具和集成层面的不足，会随时间改善。技能本质上只是一种供 Agent 消费的标准化格式——归根结底就是普通的 Markdown 文件，可以把它们理解为 Agent 的知识库。如果你希望某些技能始终生效，可以在 AGENTS.md 中直接引用它们。

## 生成你自己的技能

Fork 本项目以创建你自己的定制技能合集。

1. Fork 或克隆本仓库
2. 安装依赖：`pnpm install`
3. 在 `meta.ts` 中更新你自己的项目和技能来源
4. 运行 `pnpm start cleanup` 删除现有子模块和技能
5. 运行 `pnpm start init` 克隆子模块
6. 运行 `pnpm start sync` 同步外部技能
7. 让你的 Agent 执行 `Generate skills for <项目名>` （建议每次一个，以控制 token 用量）

详细生成指南请参阅 [AGENTS.md](AGENTS.md)。

## 赞助商

<p align="center">
  <a href="https://cdn.jsdelivr.net/gh/antfu/static/sponsors.svg">
    <img src='https://cdn.jsdelivr.net/gh/antfu/static/sponsors.svg'/>
  </a>
</p>

## 许可证

本仓库中的技能及脚本采用 [MIT](LICENSE.md) 许可证。

来自外部仓库的外部同步技能保留其原始许可证——详见各技能目录。