站点图标 高效码农

AI编程助手秒变专家？add-skill一键安装技能包全攻略（2026最新版）

高效码农

如何使用 add-skill 一键给 AI 编程助手安装专业技能包

现在很多开发者都在使用 AI 编码助手，比如 Cursor、Claude Code、OpenCode、Codex 等等。这些工具已经非常强大，但它们本质上还是通用型助手。如果想让它们在特定领域表现得像资深专家一样（比如写出更符合团队规范的 PR、生成高质量的发布日志、遵循公司前端设计系统），就需要给它们补充“专业技能”。

2025-2026 年间出现了一个开放标准叫 Agent Skills，它把这些可复用的专业指令集打包成一个个小文件夹，里面核心是一个 SKILL.md 文件。这个标准被很多主流 AI 编码工具采纳了，形成了事实上的跨工具技能生态。

而 Vercel 实验室开源了一个非常好用的 CLI 工具 —— add-skill，它就像给 AI 代理们装了一个“技能管理器”。你只需要一条命令，就能从 GitHub、GitLab 或任意 git 仓库把技能包拉下来，自动安装到你电脑上已有的各种 AI 编码工具里。

今天我们就来完整、一步一步地聊聊这个工具到底怎么用、它解决了什么问题、怎么自己写技能，以及常见疑问的答案。全文基于官方 README 和项目文档，力求真实、实用。

Agent Skills 到底是什么？为什么它对开发者有价值？

想象一下，你每次让 AI 帮你写 React 组件，都要重复说：

  • 必须用 server component 优先
  • 数据获取要用 async/await 而不是 .then
  • 避免不必要的 client-side useEffect
  • 组件命名要符合团队规范
  • PR 描述要包含 Linear ticket 链接

你说一次两次还好，说十次二十次就很累。而且不同项目、不同同事用的提示词还不一样，容易混乱。

Agent Skills 就是把这些重复的、最佳实践的指导语 + 配套资源（模板、脚本、正则规则等）打包成一个独立的小模块。AI 看到任务相关时，会自动把这个模块的内容加载进来执行，而不是每次都靠你手动重复粘贴。

它的核心优势有三点：

  1. 一次编写，到处复用 —— 写好一个技能，全团队、全项目都能用，甚至跨不同 AI 工具。
  2. 按需加载，不占上下文 —— AI 启动时只加载技能的名称和一句话描述，真正需要时才把完整内容拉进来，节省 token。
  3. 标准化格式 —— 只要遵循 SKILL.md + YAML frontmatter 的规范，很多工具都能识别。

举几个真实场景：

  • 公司要求每个 PR 必须生成规范的变更日志 → 装一个 “generate-release-notes” 技能
  • 前端团队强制用特定设计系统组件 → 装 “frontend-design-system” 技能
  • 需要自动按照 Linear/Notion/Jira 流程创建任务 → 装对应的集成技能

add-skill CLI 是什么？它怎么工作？

add-skill 是 Vercel 开源的一个命令行工具（GitHub: vercel-labs/add-skill），专门用来从 git 仓库批量下载并安装这些 Agent Skills。

最简单的使用方式：

npx add-skill vercel-labs/agent-skills

这条命令会：

  1. 从 GitHub 仓库 vercel-labs/agent-skills 克隆代码
  2. 扫描里面所有符合规范的技能目录（通常在 skills/ 下）
  3. 检测你电脑上装了哪些支持 Agent Skills 的编码工具
  4. 把技能复制/软链接到对应工具的技能目录里
  5. 完成后你重新打开 Cursor / Claude Code / OpenCode，它们就能用这些新技能了

它支持 20+ 种主流 AI 编码工具（2026 年 1 月数据），包括但不限于：

工具名称 CLI 参数 项目级路径 全局路径
Cursor cursor .cursor/skills/ ~/.cursor/skills/
Claude Code claude-code .claude/skills/ ~/.claude/skills/
OpenCode opencode .opencode/skills/ ~/.config/opencode/skills/
Codex codex .codex/skills/ ~/.codex/skills/
GitHub Copilot github-copilot .github/skills/ ~/.copilot/skills/
Gemini CLI gemini-cli .gemini/skills/ ~/.gemini/skills/
OpenHands openhands .openhands/skills/ ~/.openhands/skills/
Kiro CLI kiro-cli .kiro/skills/ ~/.kiro/skills/
…（共 23 种） … … …

完整列表请参考项目 README 中的 Available Agents 表格。

快速上手：最常见的几种用法

1. 直接安装 Vercel 官方技能集合（推荐新手第一步）

npx add-skill vercel-labs/agent-skills

执行后会交互式询问你想装到哪些工具。如果你只用 Cursor 和 Claude Code，通常选这两个就够了。

2. 只想预览有哪些技能，不安装

npx add-skill vercel-labs/agent-skills --list

3. 只安装特定的技能

npx add-skill vercel-labs/agent-skills --skill frontend-design --skill release-notes

4. 只安装到特定工具（比如只给 Cursor）

npx add-skill vercel-labs/agent-skills -a cursor

5. 全局安装（所有项目共用，不用每个项目都装一遍）

npx add-skill vercel-labs/agent-skills -g -y

-g 表示全局，-y 表示不问直接确认，非常适合 CI 或个人主力机。

6. 从其他 git 仓库安装

支持 GitHub shorthand、完整 URL、GitLab、甚至 ssh 协议：

npx add-skill https://github.com/你的用户名/你的技能仓库
npx add-skill git@gitlab.com:团队/技能集.git

自己写一个技能需要哪些步骤？

写技能其实很简单，只需要一个文件夹 + 一个 Markdown 文件。

基本结构：

my-awesome-skill/
└── SKILL.md

SKILL.md 内容示例：

---
name: pr-convention
description: 按照公司规范自动生成 PR 标题和正文，并关联 Linear ticket
---

# 按照公司 PR 规范操作

## 何时使用本技能

- 用户请求 create pr、make pull request、提交变更
- 用户提到 Linear、ticket、issue

## 必须执行的步骤

1. 读取最近的 git commit 消息和 diff
2. 判断变更类型（feat、fix、refactor、chore 等）
3. 从 commit / branch name 中提取 Linear ticket ID（格式 LINEAR-123）
4. 生成 PR 标题：`[组件/页面] 简短描述 (LINEAR-123)`
5. 生成 PR 正文模板：
   - What：做了什么
   - Why：为什么做
   - How：实现思路
   - Testing：如何验证
   - Linear: https://linear.app/公司/project/issue/LINEAR-123

要求：

  • name：小写字母、连字符，不能重复
  • description：一句话说明用途，AI 用它判断是否相关
  • 正文用 Markdown 写得越清晰越好，可以分级标题、编号列表、代码块

把这个文件夹推到 GitHub，然后别人就能用 npx add-skill 你的仓库 安装了。

常见问题解答（FAQ）

Q：装完技能后 AI 还是不会用怎么办？

A：大部分工具是自动识别的，但部分工具（如 Kiro CLI）需要手动在配置文件里声明资源路径。检查对应工具的文档。

Q：为什么有的技能有 allowed-tools、有的没有？

A：不同工具支持的技能特性不同。比如 Claude Code 支持 context: fork 和 hooks，其他很多工具不支持。基本指令部分几乎都兼容。

Q：技能装哪里了？我怎么删掉？

A：项目级装在项目下的 .xxx/skills/，全局装在 ~/xxx/skills/。目前 add-skill 没有内置 remove 命令，可以手动删除对应文件夹。

Q：能不能只装某个子目录的技能？

A：可以，直接给出子目录路径：

npx add-skill https://github.com/vercel-labs/agent-skills/tree/main/skills/frontend-design

Q：仓库里没有 skills/ 目录它还能找到技能吗？

A：会递归搜索常见路径，包括根目录、skills/、.cursor/skills/ 等 20+ 种约定位置。

Q：我想完全禁用数据上报怎么办？

A：设置环境变量：

DISABLE_TELEMETRY=1 npx add-skill ...
# 或者
DO_NOT_TRACK=1 npx add-skill ...

CI 环境会自动禁用。

不同工具的兼容性对比

特性 Cursor Claude Code OpenCode Codex GitHub Copilot Kiro CLI Gemini CLI
基础技能支持 是 是 是 是 是 是 是
allowed-tools 是 是 是 是 是 否 是
context: fork 否 是 否 否 否 否 否
Hooks / 事件 否 是 否 否 否 否 否

大部分日常使用的技能（写代码、生成文档、遵循规范）兼容性都很好。只有极少数高级特性才会有差异。

最后：为什么现在值得花时间了解 Agent Skills？

因为它正在成为 AI 编程工具的“基础设施”。就像当年 npm 让前端模块化成为可能一样，Agent Skills + add-skill 正在让 AI 编码助手的专业能力模块化、可组合、可分享。

你今天花 5 分钟装几个技能，明天写需求、改代码、开 PR 的效率可能提升 30%-50%。更重要的是，整个团队可以用同一套技能，避免“每个人提示词都不一样”的混乱。

如果你已经在用 Cursor / Claude Code / OpenCode，不妨现在就跑一遍：

npx add-skill vercel-labs/agent-skills -y

然后打开你的 AI 工具，问它：“帮我按照公司规范创建一个新 PR”，看看效果是不是比以前聪明了很多。

有任何安装、使用中的具体问题，欢迎留言，我们可以继续深入讨论。祝你 coding 愉快！

退出移动版