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
|