# AI助手技能集合

`AI编程` `Claude Code` `代码审查` `技能扩展` `开源工具`

# Agent Skills 集合

[![GitHub Stars](https://img.shields.io/github/stars/ajaywadhara/agent-skills?style=social)](https://github.com/ajaywadhara/agent-skills/stargazers)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
[![Skills](https://img.shields.io/badge/skills.sh-available-blue)](https://skills.sh)

一个精心策划的自定义技能集合，用于扩展 **Claude Code**、**GitHub Copilot**、**Cursor**、**Cline** 等 AI 编程助手的能力。

> **如果这些技能对你有帮助，请考虑给本仓库点个 Star！** 这有助于更多人发现这些工具，也激励我们持续开发。

## 快速开始

30 秒内即可上手：

```bash
# 一键安装
npx skills add ajaywadhara/agent-skills

# 或手动克隆
git clone https://github.com/ajaywadhara/agent-skills.git
cp -r agent-skills/*-skill .claude/skills/
```

然后直接问你的 AI 助手：*"帮我审查代码"*、*"设计一个通知服务"* 或 *"帮我迁移到 Spring Boot 4"*

---

## 什么是 Agent Skills？

Agent Skills 是**可复用的能力模块**，用于教会 AI 助手如何执行特定任务。可以把它们理解为帮助 AI 理解专业工作流、最佳实践和领域知识的操作手册。

**没有 Skills：** AI 助手只能依赖其通用训练数据。

**有了 Skills：** AI 助手获得特定任务的专家级知识，例如代码审查、API 设计或框架迁移。

## 为什么使用这些 Skills？

| 优势 | 说明 |
|------|------|
| **节省数小时** | 省去研究时间——Skills 包含经过实战验证的模式和清单 |
| **提前发现 Bug** | 在代码审查之前发现问题，而不是审查时才发现 |
| **内置最佳实践** | 每个 Skill 都融入了行业标准 |
| **随处可用** | 兼容 Claude Code、Cursor、Cline 等 |
| **持续更新** | 由社区维护并定期更新 |
| **免费开源** | MIT 协议——可自由使用、修改和分享 |

---

## 可用技能列表

| 技能 | 描述 | 适用场景 |
|------|------|----------|
| **[pr-guardian](pr-guardian-skill/)** | PR 前代码审查与 Bug 检测 | 提 PR 前审查代码、查找 Bug、检查安全问题 |
| **[openapi-architect](openapi-architect-skill/)** | REST API 设计与 OpenAPI 规范 | 设计 API、创建 OpenAPI 规范、遵循最佳实践 |
| **[spring-boot-4-migration](spring-boot-4-migration-skill/)** | Spring Boot 3.x 升级到 4.x | 升级 Spring Boot、迁移 Jackson、更新测试 |
| **[design-doc](design-doc-skill/)** | 包含 Mermaid 图的工程设计文档 | 创建架构文档、设计系统、记录决策 |

---

## 我只有模糊的想法——这能帮到我吗？

你不需要是专家。这些 Skills 能将**最简单的输入转化为专家级输出**。以下是实际效果：

### 场景一："我需要构建一个通知服务"

就这一句话。这就是你需要输入的全部内容。**design-doc** 技能接收这一句话，输出：

- 包含问题陈述、目标和非目标的完整设计文档
- 展示服务如何融入生态系统的 C4 架构图
- 数据模型的实体关系图
- 关键流程的时序图（发送通知、处理故障）
- 解释特定决策原因的决策日志
- 安全考量、风险分析和待解决问题

**你提供：** 1 句话。**你得到：** 一份 5-10 页的工程设计文档，附带 3-5 张 Mermaid 图，可直接提交团队评审。

### 场景二："帮我审查代码"

你写了一些 Java 代码，想在提 PR 前确认代码质量。只需说这三个字。**pr-guardian** 技能会：

- 检测你未提交的更改，或对比你的分支
- 扫描 30+ 种 Bug 模式（空指针安全、SQL 注入、资源泄漏）
- 执行完整的 OWASP 安全检查清单
- 计算你的变更风险评分（1-10）
- 生成详细报告，针对每个问题提供精确修复方案
- 提供**自动应用修复**的选项

**你提供：** "帮我审查代码。"**你得到：** 一份完整的代码审查报告，附带可操作的修复建议，如同一位高级工程师花了 30 分钟审查你的 PR。

### 场景三："我需要一个管理用户的 API"

这对 **openapi-architect** 技能来说已经足够。它将输出：

- 包含所有 CRUD 端点的完整 OpenAPI 3.1 规范
- 遵循 RFC 7807 的规范错误处理
- 分页、过滤和排序功能
- 认证/授权方案
- 正确的 HTTP 状态码和响应头

**你提供：** 一个粗略的想法。**你得到：** 一份遵循行业标准的生产就绪 API 规范。

### 场景四："迁移到 Spring Boot 4"

你的项目运行在 Spring Boot 3.x，想要升级。**spring-boot-4-migration** 技能会：

- 按序引导你完成 10 个迁移阶段
- 精确告知哪些依赖、配置项和 API 发生了变化
- 涵盖 Jackson 3、Spring Security 7、Spring Framework 7 等
- 提供验证脚本以验证迁移结果

**你提供：** "迁移到 Spring Boot 4。"**你得到：** 针对你的代码库量身定制的分步迁移指南。

---

> **规律很简单：** 你提供*是什么*，这些 Skills 提供*怎么做*。你对最佳实践了解越少，获得的价值越大——因为每个 Skill 都内置了专家知识，否则需要花数小时研究。

---

## 安装指南

### 方式一：使用 skills.sh（推荐）

通过 [skills.sh](https://skills.sh) CLI 安装技能的最简方式：

```bash
# 安装 skills CLI（如未安装）
npm install -g skills

# 从本仓库安装所有技能
npx skills add ajaywadhara/agent-skills

# 或安装特定技能
npx skills add ajaywadhara/agent-skills/pr-guardian-skill
npx skills add ajaywadhara/agent-skills/openapi-architect-skill
npx skills add ajaywadhara/agent-skills/spring-boot-4-migration-skill
npx skills add ajaywadhara/agent-skills/design-doc-skill
```

### 方式二：手动安装（Claude Code）

Claude Code 用户可手动将技能添加到项目中：

#### 项目级安装（推荐）

1. 在项目根目录创建 `.claude/skills/` 目录：

```bash
mkdir -p .claude/skills
```

2. 将技能文件夹克隆或复制到项目中：

```bash
# 克隆整个仓库
git clone https://github.com/ajaywadhara/agent-skills.git

# 复制所需技能
cp -r agent-skills/pr-guardian-skill .claude/skills/
cp -r agent-skills/openapi-architect-skill .claude/skills/
cp -r agent-skills/spring-boot-4-migration-skill .claude/skills/
cp -r agent-skills/design-doc-skill .claude/skills/
```

3. 你的项目结构应如下所示：

```
your-project/
├── .claude/
│   └── skills/
│       ├── pr-guardian-skill/
│       │   └── SKILL.md
│       ├── openapi-architect-skill/
│       │   └── SKILL.md
│       ├── spring-boot-4-migration-skill/
│       │   └── SKILL.md
│       └── design-doc-skill/
│           └── SKILL.md
├── src/
└── ...
```

#### 用户级安装（适用于所有项目）

全局安装技能，使其在所有项目中可用：

```bash
# 创建用户级技能目录
mkdir -p ~/.claude/skills

# 复制技能
cp -r agent-skills/pr-guardian-skill ~/.claude/skills/
```

### 方式三：Git 子模块

将本仓库添加为子模块，以保持技能持续更新：

```bash
# 添加为子模块
git submodule add https://github.com/ajaywadhara/agent-skills.git .claude/agent-skills

# 发布新版本时更新技能
git submodule update --remote
```

### 方式四：直接下载

1. 访问 [GitHub releases 页面](https://github.com/ajaywadhara/agent-skills/releases)
2. 下载 ZIP 文件
3. 解压并将技能文件夹复制到 `.claude/skills/` 或 `~/.claude/skills/`

---

## 如何使用技能

安装完成后，当你在 AI 助手中使用触发词时，技能会自动激活。

### pr-guardian 示例

```
"帮我审查代码"
"对比 develop 分支审查我的分支"
"查找 UserService.java 中的 Bug"
"检查安全问题"
"这段代码可以提 PR 了吗？"
```

### openapi-architect 示例

```
"设计一个用户管理 API"
"为支付服务创建 OpenAPI 规范"
"审查我的 API 设计"
"验证错误应该用什么状态码？"
```

### design-doc 示例

```
"设计一个通知服务"
"为用户认证创建设计文档"
"架构一个事件驱动的订单系统"
"我应该如何设计缓存层？"
```

### spring-boot-4-migration 示例

```
"迁移到 Spring Boot 4"
"帮我把 Jackson 升级到版本 3"
"Spring Security 7 有什么变化？"
"为 Spring Boot 4 更新我的测试"
```

---

## 发布你的技能

想与社区分享你的技能？以下是方法：

### 1. 在 skills.sh 上发布

[skills.sh](https://skills.sh) 会自动索引来自公开 GitHub 仓库的技能。

**步骤：**

1. 创建一个包含你的技能的公开 GitHub 仓库
2. 确保每个技能都有符合 [Agent Skills 规范](https://agentskills.io/specification) 的有效 `SKILL.md` 文件
3. 你的技能可通过以下方式被发现：
   ```bash
   npx skills add your-username/your-repo
   ```

**验证：** 发布前使用官方验证工具：

```bash
npx skills-ref validate ./your-skill-directory
```

### 2. 提交到社区目录

| 平台 | 提交方式 |
|------|----------|
| [skills.sh](https://skills.sh) | 自动收录——只需有公开 GitHub 仓库 |
| [agentskills.io](https://agentskills.io) | 遵循[规范](https://agentskills.io/specification) |
| [Anthropic 社区](https://github.com/anthropics/claude-code) | 提交 Issue 或 PR |

### 3. 在社交媒体分享

使用以下话题标签帮助他人发现你的技能：

- `#AgentSkills`
- `#ClaudeCode`
- `#AISkills`
- `#CodingAssistant`

---

## 创建你自己的技能

### 快速开始

1. 创建新目录：

```bash
mkdir my-awesome-skill
cd my-awesome-skill
```

2. 创建 `SKILL.md` 文件：

```markdown
---
name: my-awesome-skill
description: 描述你的技能的功能和使用时机。包含有助于触发该技能的关键词。
license: MIT
metadata:
  author: 你的名字
  version: "1.0"
---

# 我的超棒技能

AI 助手的指令写在这里...

## 何时使用此技能

- 触发词 1
- 触发词 2

## 分步指南

1. 首先，做这个...
2. 然后，做那个...

## 示例

输入："用户请求示例"
输出：AI 应该做什么
```

### 技能结构

```
my-skill/
├── SKILL.md              # 必需——主要指令
├── references/           # 可选——详细文档
│   ├── patterns.md
│   └── examples.md
├── scripts/              # 可选——自动化脚本
│   └── validate.sh
└── assets/               # 可选——模板、图片等
    └── template.json
```

### 验证要求

| 字段 | 是否必需 | 规则 |
|------|----------|------|
| `name` | 是 | 小写字母，仅用连字符，1-64 字符 |
| `description` | 是 | 1-1024 字符，说明功能和使用时机 |
| `license` | 否 | MIT、Apache-2.0 等 |
| `metadata` | 否 | author、version 及自定义字段 |

### 最佳实践

1. **保持 SKILL.md 在 500 行以内**——将详情移至 `references/`
2. **使用清晰的触发词**——帮助 AI 知道何时激活
3. **包含示例**——展示预期的输入和输出
4. **充分测试**——用各种提示词测试你的技能

---

## 常见问题

### 我需要安装什么吗？

使用 skills.sh：直接运行 `npx skills add`，无需全局安装。

手动安装：不需要额外软件，只需复制文件即可。

### 这些技能能在我的 AI 助手中使用吗？

技能适用于任何支持 Agent Skills 格式的 AI 助手：
- Claude Code
- Cursor
- Cline
- GitHub Copilot（带扩展）
- 其他兼容的 AI 编程工具

### 如何更新技能？

```bash
# 使用 skills.sh
npx skills update

# 使用 git 子模块
git submodule update --remote

# 手动：重新下载并替换文件
```

### 我可以根据需要修改技能吗？

可以！技能只是 Markdown 文件。你可以自由：
- 根据你的工作流调整指令
- 添加公司特定的规范
- 删除不需要的章节
- 组合多个技能

### 如何报告问题或提出改进建议？

在我们的 [GitHub 仓库](https://github.com/ajaywadhara/agent-skills/issues)提交 Issue。

---

## 贡献

我们欢迎贡献！详见 [CONTRIBUTING.md](CONTRIBUTING.md)。

**快速贡献建议：**
- 报告 Bug 或问题
- 建议新技能
- 改进文档
- 分享你的自定义技能

---

## 许可证

本项目基于 MIT 许可证——详见 [LICENSE](LICENSE)。

各个技能可能在其 `SKILL.md` 文件中指定了各自的许可证。

---

## 支持本项目

如果这些技能对你有帮助，以下是一些表达支持的方式：

### 点个 Star

支持本项目最简单的方式就是**在 GitHub 上给它点 Star**。Star 有助于他人发现这些技能，也表明社区认可其价值。

[![Star this repo](https://img.shields.io/github/stars/ajaywadhara/agent-skills?style=for-the-badge&logo=github&label=Star%20This%20Repo)](https://github.com/ajaywadhara/agent-skills)

### 广而告之

帮助他人发现这些技能：

- **发推文：** 分享你使用这些技能的体验
- **写博客：** 教程——如何在工作流中使用这些技能
- **告诉团队：** 分享给可能受益的同事
- **在演讲中提及：** 在会议演讲或技术分享中引用

**推文示例：**
> 刚发现 @AnthropicAI Claude Code 的 Agent Skills——pr-guardian 技能在代码审查前帮我找出了 3 个 Bug！快来看看：github.com/ajaywadhara/agent-skills #ClaudeCode #AgentSkills #DeveloperTools

### 在社交媒体分享

| 平台 | 操作 |
|------|------|
| **Twitter/X** | [发推介绍 Agent Skills](https://twitter.com/intent/tweet?text=Check%20out%20these%20awesome%20Agent%20Skills%20for%20Claude%20Code%20and%20other%20AI%20assistants!%20%F0%9F%9A%80&url=https://github.com/ajaywadhara/agent-skills&hashtags=ClaudeCode,AgentSkills,AI,DeveloperTools) |
| **LinkedIn** | [在 LinkedIn 分享](https://www.linkedin.com/sharing/share-offsite/?url=https://github.com/ajaywadhara/agent-skills) |
| **Reddit** | 发布到 r/programming、r/ClaudeAI 或 r/MachineLearning |
| **Hacker News** | 提交到 Show HN |
| **Dev.to** | 撰写你的使用体验 |

### 贡献

- 报告 Bug 和建议新功能
- 提交新技能
- 改进文档
- 帮助回答 Issue 中的问题

详见 [CONTRIBUTING.md](CONTRIBUTING.md)。

---

## 保持更新

关注本仓库以获取以下通知：
- 新技能添加
- 现有技能的重大更新
- Bug 修复和改进

[![Watch](https://img.shields.io/github/watchers/ajaywadhara/agent-skills?style=social)](https://github.com/ajaywadhara/agent-skills/subscription)

---

## Star 历史

如果你觉得本项目有用，请点个 Star！以下是社区的成长轨迹：

[![Star History Chart](https://api.star-history.com/svg?repos=ajaywadhara/agent-skills&type=Date)](https://star-history.com/#ajaywadhara/agent-skills&Date)

---

## 作者

**Ajay Wadhara**

- GitHub：[@ajaywadhara](https://github.com/ajaywadhara)
- Twitter：[@ajaywadhara](https://twitter.com/ajaywadhara)

有问题？欢迎[提交 Issue](https://github.com/ajaywadhara/agent-skills/issues) 或直接联系！

---

## 资源

- [Agent Skills 规范](https://agentskills.io/specification)——官方格式规范
- [skills.sh](https://skills.sh)——技能目录和 CLI
- [Claude Code 文档](https://docs.anthropic.com/claude-code)——Claude Code 官方文档

---

## 表达你的支持

```
如果本项目对你有帮助，请考虑：

  1. 给本仓库点 Star
  2. 分享给朋友和同事
  3. 贡献你自己的技能

每一个 Star、分享和贡献都有助于壮大这个社区！
```

---

由 [Ajay Wadhara](https://github.com/ajaywadhara) 用心打造