Agent Skills：给 AI 写代码配一套标准操作手册

它是什么

你用 AI 写代码的时候，有没有遇到过这种情况：AI 确实帮你写了，但写出来的代码风格乱七八糟，命名不统一，结构也不规范，你还得花大量时间去改？

Agent Skills 就是来解决这个问题的。它是一套AI 编程技能模板（你可以理解为给 AI 的「操作手册」）。每个模板规定了 AI 在做某类任务时应该遵循什么规范、用什么模式、注意哪些细节。

打个比方：以前你让 AI 写代码，就像让一个实习生自由发挥，写出来什么样全看心情。有了 Agent Skills，相当于你给这个实习生一本厚厚的标准操作手册——「写 React 组件必须这样写」「处理错误必须那样处理」。AI 照着手册来，输出质量直接上一个台阶。

这个项目是由 Addy Osmani 创建的，他是 Google Chrome 团队的工程负责人，写过好几本编程畅销书，在业界非常有名。所以这些模板的质量是有保障的。

解决什么问题

AI 辅助编程现在很火，但有一个普遍痛点：

• AI 写的代码「能跑」但不「专业」，缺乏工程规范
• 不同对话里 AI 的风格不一致，一会儿用这种写法一会儿用那种
• AI 不知道你的项目用了什么技术栈、什么设计模式，经常给出不合适的方案
• 每次都要重复告诉 AI「用 TypeScript」「用函数式组件」「错误要这样处理」，很烦

Agent Skills 把这些最佳实践（就是业界公认的好做法）打包成一个个可复用的模板。你只需要把对应的模板加载给 AI，它就知道该怎么做了。不用每次重复交代，也不用担心它自由发挥跑偏。

长什么样

Agent Skills 本质上是一个文件夹集合，打开 GitHub 仓库你会看到：

• 根目录：一个 README 文件，介绍整个项目的用法
• skills 文件夹：里面按类别分了很多子文件夹，比如 react/、typescript/、testing/、api-design/ 等
• 每个技能文件：是一个 Markdown 文件（就是纯文本文件），里面用自然语言写着「做这类任务时，AI 应该遵循的规则和步骤」

它没有花哨的图形界面，就是一堆写得非常专业的文本文件。但别小看这些文本——它们就是 AI 的「行为准则」，直接决定了 AI 输出代码的质量。

怎么安装

Agent Skills 不需要「安装」，它是给 AI 工具用的配置文件。具体怎么用取决于你搭配什么 AI 编程工具：

1. 首先把项目下载到本地。打开终端，输入：

   git clone https://github.com/addyosmani/agent-skills.git

   或者去 GitHub 页面点「Code」→「Download ZIP」然后解压
2. 进入文件夹，浏览 skills 目录，找到你需要的技能模板：

   cd agent-skills/skills

3. 如果你用的是 Cursor（一个 AI 代码编辑器）：把对应的 skill 文件内容复制到项目根目录的 .cursorrules 文件里
4. 如果你用的是 Claude：把 skill 文件内容粘贴到对话开头，作为系统提示（System Prompt）
5. 如果你用的是 GitHub Copilot：把 skill 文件放到项目根目录的 .github/copilot-instructions.md 里
6. 如果你用的是其他 AI 工具：把 skill 文件的内容作为「自定义指令」或「系统提示」粘贴进去就行

怎么用

这里以最常见的场景举例：

场景一：让 AI 写 React 组件

1. 打开 skills/react/ 文件夹，找到 React 组件相关的 skill 文件
2. 把文件内容复制到你 AI 工具的指令配置里
3. 然后正常跟 AI 说「帮我写一个用户资料卡片组件」
4. AI 会按照模板里的规范来写：用 TypeScript、函数式组件、正确的 Props 类型定义、合理的文件结构，全都自动到位

场景二：让 AI 做代码审查

1. 找到 skills/code-review/ 相关的 skill 文件
2. 加载后，把你的代码贴给 AI，说「帮我 review 这段代码」
3. AI 不会随便说两句「看起来不错」，而是会按照专业清单逐项检查：性能问题、安全隐患、命名规范、错误处理、边界情况……一个不落

场景三：组合使用

你可以同时加载多个 skill。比如同时加载「TypeScript 规范」+「API 设计」+「错误处理」，这样 AI 写出来的后端接口代码就会同时满足这三方面的专业标准。

需要 AI 模型吗？

Agent Skills 本身不是 AI，它只是一套「规则文本」。你需要搭配一个 AI 编程工具来使用，比如 Cursor、GitHub Copilot、Claude、ChatGPT 等。

这些工具背后都需要 AI 模型支持。如果你还没有合适的 AI 工具或模型，可以看看我们的推荐：去模型导航挑一个适合你的 AI 助手 →

简单来说：Agent Skills 是「菜谱」，AI 模型是「厨师」。光有菜谱没有厨师做不出菜，光有厨师没有菜谱就容易翻车。两个搭配起来，才能做出好菜。

费用

Agent Skills 是完全免费开源的，所有模板随便用，不花一分钱。

但你使用的 AI 编程工具可能是收费的（比如 Cursor 有免费版和付费版，GitHub Copilot 需要订阅）。具体费用取决于你选择搭配哪个工具。

适合谁

• 有经验的开发者：想让 AI 输出符合团队规范的代码，减少后期修改
• 技术负责人：把团队的编码规范做成 skill，让所有成员的 AI 助手都遵守同一套标准
• 独立开发者：一个人也要保持代码质量，让 AI 按照业界最佳实践来写
• 正在学习工程规范的人：这些 skill 文件本身就是很好的学习材料，读一遍就知道专业代码应该长什么样
• 开源项目维护者：给贡献者提供 skill 模板，让 PR 的代码风格统一

注意：这个项目更适合有一定编程基础的人。如果你刚开始学编程，建议先熟悉基本的 AI 辅助编程流程，再来用 Agent Skills 提升质量。

项目地址

GitHub 地址：https://github.com/addyosmani/agent-skills

目前已有 72k Star（就是 72000 多人点了赞），是 AI 编程领域最火的项目之一。作者是 Google Chrome 团队的 Addy Osmani，模板质量有保证。社区也很活跃，经常有人贡献新的 skill 模板。