# AI工程师技能集合

`Agent技能` `Claude Code` `GitHub Copilot` `开发工具` `编程框架`

# AI 工程师技能集

精心整理的 **37 个 Agent 技能**，涵盖不同编程语言、框架和开发工作流。每个技能都是一个遵循开放 [Agent Skills 标准](https://agentskills.io/) 的 `SKILL.md` 文件，同时兼容 **Claude Code 和 GitHub Copilot**。

## 兼容性

这些技能使用 **Agent Skills 开放标准**（`SKILL.md` 格式），支持多种 AI 编程助手：

| 助手 | 项目级技能 | 个人技能 | 状态 |
|------|-----------|---------|------|
| **Claude Code** | `.claude/skills/` | `~/.claude/skills/` | 完全支持 |
| **GitHub Copilot**（VS Code） | `.github/skills/` 或 `.claude/skills/` | `~/.copilot/skills/` 或 `~/.claude/skills/` | 完全支持 |
| **GitHub Copilot CLI** | `.github/skills/` 或 `.claude/skills/` | `~/.copilot/skills/` | 完全支持 |
| **Copilot 编码代理** | `.github/skills/` 或 `.claude/skills/` | 不适用（基于云端） | 完全支持 |

### SKILL.md 格式（共享标准）

Claude Code 和 GitHub Copilot 使用相同的文件格式：

```markdown
---
name: skill-name                    # 必填：小写，用连字符分隔
description: 功能描述                # 必填：说明何时使用
disable-model-invocation: false      # 可选：为 true 时仅手动触发
user-invocable: true                 # 可选：在 /slash 菜单中显示
argument-hint: "[args]"              # 可选：参数提示
allowed-tools: Read, Grep, Glob     # 可选：限制可用工具（Claude Code）
context: fork                        # 可选：在子代理中运行（Claude Code）
---

# 技能说明

详细的使用说明、规范和示例...
```

### 与自定义指令的区别

| 特性 | Agent 技能（`SKILL.md`） | 自定义指令 |
|------|------------------------|-----------|
| **格式** | 开放标准（[agentskills.io](https://agentskills.io/)） | 厂商专有 |
| **加载方式** | 按需加载（仅在相关时） | 始终应用 |
| **内容** | 指令 + 脚本 + 示例 | 仅指令 |
| **可移植性** | 跨 Claude Code、Copilot、CLI 通用 | 单平台 |
| **调用方式** | 自动加载或 `/slash` 命令 | 始终注入 |

自定义指令文件仍适用于需要持续生效的仓库规范：

| 文件 | 平台 | 用途 |
|------|------|-----|
| `.github/copilot-instructions.md` | GitHub Copilot | 仓库级编码规范 |
| `.github/instructions/*.instructions.md` | GitHub Copilot | 路径专属规则（含 `applyTo` glob） |
| `CLAUDE.md` | Claude Code | 仓库级上下文与规范 |
| `AGENTS.md` | 多代理（OpenAI 标准） | 通用代理指令 |

## 快速开始

### 安装所有技能（个人级——在所有项目中可用）

```bash
# 克隆仓库
git clone https://github.com/ai-engineer-skills/ai-engineer-skills.git

# 安装到 Claude Code 和 GitHub Copilot
cd ai-engineer-skills
bash install.sh

# 或仅安装到指定目标
bash install.sh --target claude
bash install.sh --target copilot
```

### 仅为特定项目安装

```bash
# 适用于 Claude Code
cp -r skills/python-pro /path/to/your/project/.claude/skills/

# 适用于 GitHub Copilot
cp -r skills/python-pro /path/to/your/project/.github/skills/

# 两个助手都读取 .claude/skills/，因此以下方式对两者均有效：
cp -r skills/python-pro /path/to/your/project/.claude/skills/
```

### 仅安装特定技能

```bash
bash install.sh python-pro typescript-pro react-specialist
bash install.sh --target copilot docker-expert terraform-engineer
```

## 可用技能

### 语言专家

| 技能 | 描述 |
|------|------|
| **[python-pro](skills/python-pro)** | Python 3.11+，类型提示，ruff，pytest，现代模式 |
| **[typescript-pro](skills/typescript-pro)** | 严格 TypeScript，Zod，Vitest，判别联合类型 |
| **[javascript-pro](skills/javascript-pro)** | ES2024+，ESM，现代 API，Vitest |
| **[nodejs-expert](skills/nodejs-expert)** | Node.js 22+，原生 API，ESM，node:test，性能，生产模式 |
| **[rust-engineer](skills/rust-engineer)** | 所有权，thiserror/anyhow，clippy，惯用 Rust |
| **[golang-pro](skills/golang-pro)** | 高效 Go，表驱动测试，错误包装 |
| **[csharp-developer](skills/csharp-developer)** | C# 12，.NET 8，可空引用，记录，xUnit |
| **[java-architect](skills/java-architect)** | Java 21+，记录，密封类，虚拟线程 |
| **[swift-expert](skills/swift-expert)** | Swift 5.9+，SwiftUI，结构化并发 |
| **[kotlin-specialist](skills/kotlin-specialist)** | Kotlin 2.0，Compose，协程，Flow |

### 前端框架

| 技能 | 描述 |
|------|------|
| **[react-specialist](skills/react-specialist)** | React 19，Hooks，服务端组件，TanStack Query |
| **[nextjs-developer](skills/nextjs-developer)** | Next.js 15，App Router，Server Actions |
| **[vue-expert](skills/vue-expert)** | Vue 3，组合式 API，Pinia，VueUse |
| **[angular-architect](skills/angular-architect)** | Angular 18+，信号，独立组件 |
| **[flutter-expert](skills/flutter-expert)** | Dart 3.2+，Riverpod，go_router，freezed |

### 后端框架

| 技能 | 描述 |
|------|------|
| **[django-developer](skills/django-developer)** | Django 5，DRF，pytest-django，N+1 问题预防 |
| **[fastapi-developer](skills/fastapi-developer)** | Pydantic v2，异步，SQLAlchemy 2.0，Alembic |
| **[flask-developer](skills/flask-developer)** | Flask 3，应用工厂，蓝图，Marshmallow |
| **[rails-expert](skills/rails-expert)** | Rails 7.1+，服务对象，RSpec，Turbo |
| **[laravel-specialist](skills/laravel-specialist)** | Laravel 11，PHP 8.3，Pest，Sanctum |
| **[spring-boot-engineer](skills/spring-boot-engineer)** | Spring Boot 3.2，Java 21，切片测试 |
| **[dotnet-core-expert](skills/dotnet-core-expert)** | ASP.NET Core，最小 API，EF Core，xUnit |

### 数据与 AI 基础设施

| 技能 | 描述 |
|------|------|
| **[database-architect](skills/database-architect)** | 模式设计，索引策略，迁移，分区，PostgreSQL/MySQL/SQL Server |
| **[vector-search-engineer](skills/vector-search-engineer)** | 向量数据库，嵌入，HNSW/IVF 索引，pgvector，Pinecone，Qdrant，Weaviate，Milvus，FAISS |
| **[rag-engineer](skills/rag-engineer)** | RAG 管道，分块策略，混合检索，重排序，提示组装，评估 |
| **[sql-pro](skills/sql-pro)** | SQL 查询编写，优化，PostgreSQL/MySQL/SQLite |

### 基础设施与 DevOps

| 技能 | 描述 |
|------|------|
| **[docker-expert](skills/docker-expert)** | 多阶段构建，安全性，docker-compose |
| **[terraform-engineer](skills/terraform-engineer)** | IaC 模块，状态管理，tflint |
| **[kubernetes-specialist](skills/kubernetes-specialist)** | 清单，Helm，安全上下文，GitOps |

### 工作流与质量

| 技能 | 描述 |
|------|------|
| **[security-reviewer](skills/security-reviewer)** | OWASP Top 10 安全审计（`/security-reviewer`） |
| **[code-reviewer](skills/code-reviewer)** | 代码审查清单（`/code-reviewer`） |
| **[test-generator](skills/test-generator)** | 为任意模块生成测试（`/test-generator`） |
| **[api-designer](skills/api-designer)** | REST/GraphQL API 设计模式 |
| **[git-workflow](skills/git-workflow)** | 分支管理，约定式提交（`/git-workflow`） |
| **[refactoring-specialist](skills/refactoring-specialist)** | 安全重构模式（`/refactoring-specialist`） |
| **[performance-optimizer](skills/performance-optimizer)** | 性能分析与优化（`/performance-optimizer`） |
| **[documentation-writer](skills/documentation-writer)** | README、API 文档、架构文档（`/documentation-writer`） |

## 工作原理

Claude Code 和 GitHub Copilot 均通过 `SKILL.md` 文件扩展其能力：

```
skills/python-pro/
└── SKILL.md        # 代理在处理 Python 时遵循的指令
```

每个 `SKILL.md` 包含：
- **YAML 前置内容** — `name`、`description` 及配置字段
- **Markdown 正文** — 供代理遵循的规范、模式和规则

当代理判断技能与当前工作相关时，会自动加载。设置了 `disable-model-invocation: true` 的技能仅在显式调用 `/skill-name` 时触发。

### 技能类型

| 类型 | 行为 | 示例 |
|------|------|-----|
| **参考型**（自动加载） | 代理在使用相关语言/框架时自动应用这些规范 | python-pro、react-specialist |
| **任务型**（手动 `/调用`） | 需要执行特定操作时由你手动触发 | security-reviewer、test-generator |

### 渐进式加载

代理使用三级加载系统以保持上下文高效：

1. **发现** — 代理从前置内容读取 `name` + `description`（始终可用，轻量级）
2. **指令** — 相关时，完整的 `SKILL.md` 正文加载到上下文
3. **资源** — 技能目录中的脚本、示例等文件仅在被引用时加载

## 自定义

### 覆盖某个技能

将技能复制到你的项目中，按团队规范修改：

```bash
# Claude Code
cp -r ~/.claude/skills/python-pro .claude/skills/python-pro

# GitHub Copilot
cp -r ~/.copilot/skills/python-pro .github/skills/python-pro
```

项目级技能优先于个人级技能。

### 创建新技能

```bash
mkdir -p .claude/skills/my-skill
cat > .claude/skills/my-skill/SKILL.md << 'EOF'
---
name: my-skill
description: 该技能的功能及使用时机
---

你的指令内容...
EOF
```

完整格式参考请查阅 [Agent Skills 规范](https://agentskills.io/specification)。

## 贡献

1. Fork 本仓库
2. 在 `skills/<skill-name>/SKILL.md` 中添加或改进技能
3. 遵循现有格式和规范
4. 提交 PR 并描述该技能的功能

## 许可证

MIT