mc-skills/catalog
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
catalog/repos/ajaywadhara--agent-skills.md

537 lines
16 KiB
Markdown
Raw Normal View History

catalog: 更新 2026-04-07 11:44
2026-04-07 11:44:56 +08:00
# 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) 用心打造
Reference in New Issue Copy Permalink