mc-skills/catalog

Fork 0

mc-skills 52efc07510 catalog: 更新 2026-04-07 11:44

2026-04-07 11:44:56 +08:00

16 KiB

Raw Permalink Blame History

AI助手技能集合

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

Agent Skills 集合

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

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

快速开始

30 秒内即可上手：

# 一键安装
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 前代码审查与 Bug 检测	提 PR 前审查代码、查找 Bug、检查安全问题
openapi-architect	REST API 设计与 OpenAPI 规范	设计 API、创建 OpenAPI 规范、遵循最佳实践
spring-boot-4-migration	Spring Boot 3.x 升级到 4.x	升级 Spring Boot、迁移 Jackson、更新测试
design-doc	包含 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 CLI 安装技能的最简方式：

# 安装 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 用户可手动将技能添加到项目中：

项目级安装（推荐）

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

mkdir -p .claude/skills

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

# 克隆整个仓库
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/

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

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/
└── ...

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

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

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

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

方式三：Git 子模块

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

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

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

方式四：直接下载

访问 GitHub releases 页面
下载 ZIP 文件
解压并将技能文件夹复制到 .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 会自动索引来自公开 GitHub 仓库的技能。

步骤：

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

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

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

2. 提交到社区目录

平台	提交方式
skills.sh	自动收录——只需有公开 GitHub 仓库
agentskills.io	遵循规范
Anthropic 社区	提交 Issue 或 PR

3. 在社交媒体分享

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

#AgentSkills
#ClaudeCode
#AISkills
#CodingAssistant

创建你自己的技能

快速开始

mkdir my-awesome-skill
cd my-awesome-skill

创建 SKILL.md 文件：

---
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 及自定义字段

最佳实践

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

常见问题

我需要安装什么吗？

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

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

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

技能适用于任何支持 Agent Skills 格式的 AI 助手：

Claude Code
Cursor
Cline
GitHub Copilot（带扩展）
其他兼容的 AI 编程工具

如何更新技能？

# 使用 skills.sh
npx skills update

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

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

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

可以！技能只是 Markdown 文件。你可以自由：

根据你的工作流调整指令
添加公司特定的规范
删除不需要的章节
组合多个技能

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

在我们的 GitHub 仓库提交 Issue。

贡献

我们欢迎贡献！详见 CONTRIBUTING.md。

快速贡献建议：

报告 Bug 或问题
建议新技能
改进文档
分享你的自定义技能

许可证

本项目基于 MIT 许可证——详见 LICENSE。

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

支持本项目

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

点个 Star

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

广而告之

帮助他人发现这些技能：

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

推文示例：

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

在社交媒体分享

平台	操作
Twitter/X	发推介绍 Agent Skills
LinkedIn	在 LinkedIn 分享
Reddit	发布到 r/programming、r/ClaudeAI 或 r/MachineLearning
Hacker News	提交到 Show HN
Dev.to	撰写你的使用体验

贡献

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

详见 CONTRIBUTING.md。

保持更新

关注本仓库以获取以下通知：

新技能添加
现有技能的重大更新
Bug 修复和改进

Star 历史

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

作者

Ajay Wadhara

GitHub：@ajaywadhara
Twitter：@ajaywadhara

有问题？欢迎提交 Issue 或直接联系！

资源

Agent Skills 规范——官方格式规范
skills.sh——技能目录和 CLI
Claude Code 文档——Claude Code 官方文档

表达你的支持

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

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

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

由 Ajay Wadhara 用心打造

16 KiB Raw Permalink Blame History Unescape Escape

AI助手技能集合

Agent Skills 集合

快速开始

什么是 Agent Skills？

为什么使用这些 Skills？

可用技能列表

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

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

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

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

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

安装指南

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

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

项目级安装（推荐）

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

方式三：Git 子模块

方式四：直接下载

如何使用技能

pr-guardian 示例

openapi-architect 示例

design-doc 示例

spring-boot-4-migration 示例

发布你的技能

1. 在 skills.sh 上发布

2. 提交到社区目录

3. 在社交媒体分享

创建你自己的技能

快速开始

技能结构

验证要求

最佳实践

常见问题

我需要安装什么吗？

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

如何更新技能？

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

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

贡献

许可证

支持本项目

点个 Star

广而告之

在社交媒体分享

贡献

保持更新

Star 历史

作者

资源

表达你的支持

16 KiB

Raw Permalink Blame History