236 lines
9.5 KiB
Markdown
236 lines
9.5 KiB
Markdown
# 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 |