catalog/repos/ai-engineer-agent--ai-engineer-skills.md

236 lines
9.5 KiB
Markdown
Raw Permalink Normal View History

2026-04-07 11:44:56 +08:00
# 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+类型提示ruffpytest现代模式 |
| **[typescript-pro](skills/typescript-pro)** | 严格 TypeScriptZodVitest判别联合类型 |
| **[javascript-pro](skills/javascript-pro)** | ES2024+ESM现代 APIVitest |
| **[nodejs-expert](skills/nodejs-expert)** | Node.js 22+,原生 APIESMnode:test性能生产模式 |
| **[rust-engineer](skills/rust-engineer)** | 所有权thiserror/anyhowclippy惯用 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.0Compose协程Flow |
### 前端框架
| 技能 | 描述 |
|------|------|
| **[react-specialist](skills/react-specialist)** | React 19Hooks服务端组件TanStack Query |
| **[nextjs-developer](skills/nextjs-developer)** | Next.js 15App RouterServer Actions |
| **[vue-expert](skills/vue-expert)** | Vue 3组合式 APIPiniaVueUse |
| **[angular-architect](skills/angular-architect)** | Angular 18+,信号,独立组件 |
| **[flutter-expert](skills/flutter-expert)** | Dart 3.2+Riverpodgo_routerfreezed |
### 后端框架
| 技能 | 描述 |
|------|------|
| **[django-developer](skills/django-developer)** | Django 5DRFpytest-djangoN+1 问题预防 |
| **[fastapi-developer](skills/fastapi-developer)** | Pydantic v2异步SQLAlchemy 2.0Alembic |
| **[flask-developer](skills/flask-developer)** | Flask 3应用工厂蓝图Marshmallow |
| **[rails-expert](skills/rails-expert)** | Rails 7.1+服务对象RSpecTurbo |
| **[laravel-specialist](skills/laravel-specialist)** | Laravel 11PHP 8.3PestSanctum |
| **[spring-boot-engineer](skills/spring-boot-engineer)** | Spring Boot 3.2Java 21切片测试 |
| **[dotnet-core-expert](skills/dotnet-core-expert)** | ASP.NET Core最小 APIEF CorexUnit |
### 数据与 AI 基础设施
| 技能 | 描述 |
|------|------|
| **[database-architect](skills/database-architect)** | 模式设计索引策略迁移分区PostgreSQL/MySQL/SQL Server |
| **[vector-search-engineer](skills/vector-search-engineer)** | 向量数据库嵌入HNSW/IVF 索引pgvectorPineconeQdrantWeaviateMilvusFAISS |
| **[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