addyosmani/agent-skills

## 技能简介

在当今的 AI 辅助编程时代，Cursor、Claude Code 等工具已经能帮我们快速生成代码。然而，很多开发者发现：AI 写出的代码往往只能跑通“理想路径（Happy Path）”，缺乏对边界条件、安全性、可维护性等**生产级工程标准**的考量。

**Agent Skills** 正是为了解决这一痛点而生的。这是一套由知名技术专家 Addy Osmani 开源的、面向 AI 编程代理的生产级工程技能集合。它将资深工程师的“工程思维”和“最佳实践”封装成了可复用的技能模板（Prompt/Skills）。通过加载这些技能，你的 AI 助手将不再只是一个“代码生成器”，而是蜕变为一位懂架构、重测试、严把关的“资深研发工程师”。

## 核心优势

### 1. 注入生产级质量标准，告别“玩具代码”
普通 AI 生成的代码往往缺乏对异常处理和安全的考虑。**场景**：当你让 AI 编写一个用户注册接口时，未加载技能的 AI 可能只实现基本的入库逻辑；而加载了 Agent Skills 的 AI，会自动引入密码哈希、输入校验、防 SQL 注入以及接口限流等生产级细节，直接输出可上线的高质量代码。

### 2. 跨平台高度兼容，统一团队 AI 输出规范
该技能集采用平台无关的文本模板设计，完美支持 Claude Code、Cursor 等主流 AI 编程平台。**场景**：你的团队中有人习惯用 Cursor，有人偏好 Claude Code。通过统一导入 Agent Skills，无论使用什么工具，团队成员都能获得一致的高标准代码输出，大幅降低代码审查（Code Review）的沟通成本。

### 3. 模块化开箱即用，免除“提示词工程”烦恼
无需每次都在对话框里输入长篇大论的约束条件。**场景**：在需要为遗留系统补充单元测试时，你只需一键调用“自动化测试”技能模板，AI 就会自动按照高覆盖率、Mock 规范、边界条件测试的标准生成测试用例，极大提升开发效率。

## 主要功能

| 功能模块 | 核心能力描述 | 预期输出效果 |
| :--- | :--- | :--- |
| **代码审查 (Code Review)** | 自动化审查代码质量、安全性、性能，识别反模式并提供重构建议。 | 输出结构化的审查报告，包含严重等级分类及具体的代码修改 Diff 建议。 |
| **架构设计 (Architecture)** | 辅助进行系统架构设计、模块划分、API 契约定义及技术选型评估。 | 生成清晰的架构决策记录（ADR）、模块交互图描述及标准化的接口定义。 |
| **自动化测试 (Testing)** | 生成高覆盖率的单元测试与集成测试，强制包含边界条件与异常流处理。 | 输出符合项目测试框架（如 Jest/PyTest）规范、包含完整 Mock 和断言的测试代码。 |
| **调试与排错 (Debugging)** | 结构化分析错误日志与堆栈信息，定位根因并提供多套修复方案。 | 提供从“表面现象”到“根本原因”的逻辑推导过程，并给出带有防御性编程的修复代码。 |

## 如何获取与安装

**Agent Skills 是完全免费且开源的**。以下是具体的获取与配置指南，只需几分钟即可让你的 AI 助手完成“能力升级”。

### 第一步：获取技能库
打开终端，将官方 GitHub 仓库克隆到本地（或直接下载 ZIP 解压）：
```bash
git clone https://github.com/addyosmani/agent-skills.git
cd agent-skills

第二步：在 Cursor 中安装配置

1. 在你的项目根目录下，创建或打开 .cursorrules 文件（如果是全局配置，可在 Cursor 设置中的 Rules 区域添加）。
2. 打开克隆下来的 agent-skills 文件夹，找到你需要的技能文件（例如 skills/code-review.md）。
3. 将文件中的 Prompt 内容复制，并粘贴到你的 .cursorrules 或 Cursor 的自定义指令（Custom Instructions）中。
4. 进阶用法：你可以将不同的技能保存为 Cursor 的 @Codebase 提示词模板，在需要时通过 @ 快速唤起。

第三步：在 Claude Code (CLI) 中安装配置

1. 在项目根目录创建 .claude 文件夹（如果不存在）。
2. 将 agent-skills 中的 Markdown 技能文件复制到 .claude/commands/ 目录下。
3. 重命名文件以匹配你的命令习惯（例如将 code-review.md 重命名为 review.md）。
4. 在 Claude Code 终端中，你可以通过输入 /review 直接触发该技能，AI 将严格按照模板中的工程标准执行任务。

适用场景

1. 核心业务逻辑重构：在对老旧、臃肿的核心模块进行重构时，使用“代码审查”和“架构设计”技能，确保重构后的代码符合 SOLID 原则且不引入新 Bug。
2. 新项目脚手架搭建：在项目初期，利用“架构设计”技能让 AI 帮你规划目录结构、设计数据库 Schema 和 API 契约，奠定良好的工程基础。
3. 提升测试覆盖率：面对缺乏测试的遗留代码，使用“自动化测试”技能，让 AI 批量生成高质量的单元测试，为后续的重构提供安全网。
4. 复杂线上 Bug 排查：遇到难以复现的线上问题时，使用“调试与排错”技能，将日志喂给 AI，让其以结构化的思维帮你梳理排查路径。

小贴士

• 结合项目上下文：在调用这些技能时，建议同时提供项目的 README.md、架构文档或现有的代码规范文件，AI 会结合上下文生成更贴合你项目的代码。
• 按需裁剪与微调：Agent Skills 提供的是通用最佳实践。你可以根据团队的具体技术栈（如特定的 lint 规则或测试框架）对模板中的约束条件进行微调。
• 保持同步更新：该仓库会持续迭代新的工程技能，建议定期 git pull 获取最新的 Prompt 优化和新增场景。

---

免责声明：Agent Skills 提供的技能模板旨在辅助和提升 AI 编程助手的输出质量。AI 生成的所有代码、架构设计和测试用例仍需经过专业开发人员的人工审查与验证。作者及贡献者不对因直接使用 AI 生成内容而导致的生产环境故障、数据丢失或任何直接或间接损失承担责任。