# 开发者AI技能集合

`AI工具` `开发效率` `DevOps` `技能库` `Claude`

# 开发者技能集合

面向开发者生产力的综合 AI 技能集合 —— **41 个强大工具**，涵盖测试、CI/CD、DevOps、基础设施、数据库、版本控制及实用工具。

> 完美适配 Claude、Cursor、Windsurf、Aider、Continue 和 Cline，借助 AI 辅助构建、部署和管理应用程序。

## ✨ 核心特性

- 🧪 **测试与质量保障** - Jest、Vitest、Pytest 最佳实践
- 🚀 **DevOps 与基础设施** - AWS、Kubernetes、Terraform、Docker、Nginx
- 🔧 **开发者工具** - Git 工作流、GitHub Actions、API 设计、GraphQL
- 🔐 **安全** - 密钥扫描、依赖审计、漏洞检测
- 📚 **参考资料** - 100+ 综合指南与模式
- 🤖 **AI 原生** - 兼容 Claude、Cursor、Windsurf、Cline 等
- 📦 **基于 Git** - 易于克隆并与 AI 代理集成
- 🎯 **生产就绪** - 已在真实项目中广泛使用

## 工作原理

```
┌──────────────────────────────────────────────────┐
│  AI 代理（Claude、Cursor、Windsurf、Cline）        │
└──────────────────────┬───────────────────────────┘
                       │ 请求开发帮助
                       ▼
        ┌─────────────────────────────────┐
        │  技能激活触发器                  │
        │  例如 "帮助测试"、              │
        │  "设置 git hooks"、"检查 AWS"   │
        └─────────────────────────────────┘
                       │
                       ▼
        ┌─────────────────────────────────┐
        │  技能选择与加载                  │
        │  - 解析上下文                   │
        │  - 加载相关 SKILL.md            │
        │  - 加载支持脚本                  │
        └─────────────────────────────────┘
                       │
                       ▼
        ┌─────────────────────────────────┐
        │  提供开发指导                   │
        │  - 最佳实践                     │
        │  - 代码示例                     │
        │  - 执行模式                     │
        └─────────────────────────────────┘
                       │
                       ▼
        ┌─────────────────────────────────┐
        │  AI 辅助实现                    │
        │  - 生成代码                     │
        │  - 审查模式                     │
        │  - 排查问题                     │
        └─────────────────────────────────┘
```

## 安装

### 快速安装（推荐）

使用 [skills.sh](https://skills.sh) 提供的 `skills` CLI 安装全部 41 个技能：

```bash
npx skills add 1Mangesh1/dev-skills-collection
```

该命令将：
- 即时下载全部 41 个技能
- 为你的 AI 代理（Claude、Cursor、Windsurf 等）配置技能
- 根据请求自动激活对应技能
- 无需手动配置！

### 安装后如何使用

安装完成后，只需自然地向 AI 代理提问：

```bash
# 在 Claude、Cursor 或 Windsurf 中：
"如何使用 Jest？" → 激活 jest-vitest 技能
"搭建 AWS 基础设施" → 激活 aws-cli + terraform 技能
"改善 git 工作流" → 激活 git-hooks + git-emoji 技能
"扫描密钥" → 激活 secret-scanner 技能
```

AI 代理会自动加载与你请求匹配的技能！

### 验证安装

```bash
# 列出所有已安装技能
npx skills list

# 查看特定技能的文档
npx skills view jest-vitest
```

### 手动安装（备选方案）

如果你偏好 git clone：

```bash
git clone https://github.com/1Mangesh1/dev-skills-collection.git
cd dev-skills-collection

# 将 skills 目录复制到配置目录
cp -r skills/ ~/.claude/skills/
```

## 快速入门示例

### 示例 1：为项目配置测试

**安装**：`npx skills add 1Mangesh1/dev-skills-collection`

**向 AI 代理提问**：
```
"帮我为项目配置 Jest 和 Vitest 测试"
```

**发生的事情**：
1. jest-vitest 技能自动加载
2. AI 提供测试模式、最佳实践和配置
3. AI 帮助你编写第一批测试文件
4. 获得框架搭建指南和示例

**结果**：Jest/Vitest 配置完毕，具备专业的测试结构

### 示例 2：管理 AWS 基础设施

**向 AI 代理提问**：
```
"帮我用 Terraform 和 AWS CLI 搭建 AWS 基础设施"
```

**发生的事情**：
1. aws-cli 和 terraform 技能自动加载
2. AI 引导你了解 AWS 最佳实践
3. AI 帮助你安全地编写基础设施即代码
4. 获得安全与生产部署模式

**AI 现在可以协助执行**：
```bash
aws s3 ls
aws ec2 describe-instances
terraform init
terraform plan
terraform apply
```

**结果**：通过 AI 引导安全管理并文档化的基础设施

### 示例 3：Git 工作流配置

**向 AI 代理提问**：
```
"配置专业的 git hooks、emoji 提交和高级 git 工作流"
```

**发生的事情**：
1. git-hooks、git-emoji 和 git-advanced 技能加载
2. AI 引导你了解专业的 git 实践
3. AI 帮助配置 pre-commit hooks 和提交规范
4. 获得团队工作流模式和 GitHub Actions 集成

**你的提交将变得专业**：
```bash
# AI 帮助你编写语义化提交
git commit -m "🎨 refactor: 优化代码结构"
git commit -m "✨ feat: 添加新的认证流程"
git commit -m "🐛 fix: 修复缓存中的内存泄漏"
```

**结果**：团队统一、专业的 git 工作流

### 示例 4：数据库迁移管理

**向 AI 代理提问**：
```
"帮我安全地设置和管理数据库迁移"
```

**发生的事情**：
1. sql-migrations 技能自动加载
2. AI 提供迁移最佳实践和模式
3. AI 引导安全的数据库 schema 变更
4. 获得回滚流程和版本控制集成

**结果**：通过 AI 辅助自动化实现安全、可追溯的数据库变更

## 可用技能（共 41 个）

### 测试（2 个技能）
- **jest-vitest** - Jest 和 Vitest 测试框架
- **pytest** - Python pytest 测试框架

### CI/CD（1 个技能）
- **github-actions** - GitHub Actions 工作流与 CI/CD

### 基础设施（8 个技能）
- **aws-cli** - AWS CLI 命令与基础设施管理
- **kubernetes** - Kubernetes 与容器编排
- **nginx** - Nginx Web 服务器配置
- **redis** - Redis 数据库与缓存
- **sql-migrations** - 数据库迁移与 SQL 最佳实践
- **ssh-config** - SSH 配置与密钥管理
- **terraform** - Terraform 基础设施即代码

### 开发者工具（13 个技能）
- **api-design** - 设计 RESTful 和 GraphQL API
- **curl-http** - cURL 与 HTTP 客户端命令
- **gh-cli** - GitHub CLI 命令与工作流
- **git-advanced** - 高级 Git 工作流与命令
- **git-emoji** - Git 提交的 Emoji 规范
- **git-hooks** - Git hooks 与自动化
- **graphql** - GraphQL 查询语言与 API
- **lint-format** - 代码检查与格式化工具
- **npm-scripts** - NPM 脚本与任务自动化
- **python-env** - Python 虚拟环境与包管理
- **code-review** - 代码审查清单与最佳实践
- **env-debug** - 调试环境变量与配置
- **mcp-setup** - Model Context Protocol 配置

### 实用工具（15 个技能）
- **ascii-art** - 创建和操作 ASCII 艺术
- **changelog** - 生成和管理更新日志
- **color** - 颜色操作与调色板工具
- **cron** - Cron 任务调度与语法
- **dotfiles** - 管理和配置 dotfiles
- **http-status** - HTTP 状态码参考
- **jq-yq** - JSON 和 YAML 处理
- **makefile** - Makefile 语法与构建自动化
- **markdown** - Markdown 语法与文档
- **one-liners** - 实用命令行单行命令
- **placeholder-data** - 生成占位符和模拟数据
- **regex** - 正则表达式与模式匹配
- **shortcuts** - 键盘快捷键与生产力技巧
- **tmux** - Tmux 终端复用器
- **vim-motions** - Vim 动作与键盘快捷键

### 安全（2 个技能）
- **dependency-audit** - 审计和管理项目依赖
- **secret-scanner** - 检测和扫描代码中的密钥

### 元技能（1 个技能）
- **skill-creator** - 创建新技能的框架

## 技能分类一览

| 类别 | 数量 | 技能 |
|------|------|------|
| 测试 | 2 | jest-vitest, pytest |
| CI/CD | 1 | github-actions |
| 基础设施 | 8 | aws-cli, kubernetes, nginx, redis, sql-migrations, ssh-config, terraform |
| 开发者工具 | 13 | api-design, curl-http, gh-cli, git-advanced, git-emoji, git-hooks, graphql, lint-format, npm-scripts, python-env, code-review, env-debug, mcp-setup |
| 实用工具 | 15 | ascii-art, changelog, color, cron, dotfiles, http-status, jq-yq, makefile, markdown, one-liners, placeholder-data, regex, shortcuts, tmux, vim-motions |
| 安全 | 2 | dependency-audit, secret-scanner |
| 元技能 | 1 | skill-creator |

## 代理兼容性

所有技能均针对现代 AI 编程代理进行了兼容性设计：

| 代理 | 状态 | 说明 |
|------|------|------|
| Claude Code | ✅ 支持 | 完整 MCP 集成 |
| Cursor | ✅ 支持 | 兼容所有技能 |
| Windsurf | ✅ 支持 | 完全兼容 |
| Aider | ✅ 支持 | 兼容核心技能 |
| Continue | ✅ 支持 | 扩展功能支持 |
| Cline | ✅ 支持 | 完整功能支持 |

## 真实使用场景

### 场景 1：发布生产就绪的应用程序

**挑战**：需要搭建包含测试、CI/CD 和部署的新应用

**使用技能**：jest-vitest、github-actions、aws-cli、terraform、nginx、sql-migrations

**工作流**：
1. "配置测试框架" → jest-vitest 技能提供配置
2. "创建 GitHub Actions 工作流" → github-actions 技能启用 CI/CD
3. "部署到 AWS" → aws-cli + terraform 技能处理基础设施
4. "配置 Web 服务器" → nginx 技能设置反向代理
5. "管理数据库" → sql-migrations 技能追踪 schema 变更

**结果**：完整的生产就绪应用，具备自动化测试和部署

### 场景 2：提升代码质量与安全性

**挑战**：审计依赖、检测密钥、提高代码规范

**使用技能**：dependency-audit、secret-scanner、lint-format、code-review、git-hooks

**工作流**：
1. "审计项目依赖" → dependency-audit 发现漏洞
2. "扫描密钥" → secret-scanner 检测硬编码凭证
3. "设置代码检查" → lint-format 强制执行规范
4. "创建代码审查流程" → code-review 提供检查清单
5. "自动化检查" → git-hooks 阻止问题提交

**结果**：安全、可维护的代码库，具备自动化质量门控

### 场景 3：掌握开发者工作流

**挑战**：团队效率 —— 需要专业的 git、终端和编辑器

**使用技能**：git-advanced、git-hooks、tmux、vim-motions、shortcuts

**工作流**：
1. "高级 git 工作流" → git-advanced 传授协作模式
2. "优化终端使用" → tmux 技能提升生产力
3. "掌握 Vim" → vim-motions 解锁编辑器潜力
4. "快捷键技巧" → shortcuts 发现平台专属技巧

**结果**：团队以专业工作流达到最高效率

### 场景 4：大规模基础设施管理

**挑战**：多云基础设施，含 Kubernetes、监控、日志

**使用技能**：kubernetes、terraform、aws-cli、nginx、redis、python-env

**工作流**：
1. "搭建 Kubernetes 集群" → kubernetes 技能提供模式
2. "基础设施即代码" → terraform 技能管理资源
3. "AWS 云" → aws-cli 技能处理云操作
4. "缓存层" → redis 技能优化性能
5. "Web 服务器" → nginx 技能处理路由

**结果**：通过代码管理的可扩展、高可用基础设施

## 技能激活短语（快速参考）

### 测试与质量保障
- "如何使用 Jest？" → **jest-vitest** 技能
- "为 Python 测试配置 pytest" → **pytest** 技能
- "代码审查最佳实践" → **code-review** 技能

### 基础设施与 DevOps
- "帮助使用 AWS CLI" → **aws-cli** 技能
- "配置 Kubernetes" → **kubernetes** 技能
- "Terraform 基础设施" → **terraform** 技能
- "配置 Nginx" → **nginx** 技能
- "Redis 缓存模式" → **redis** 技能

### Git 与版本控制
- "高级 git 工作流" → **git-advanced** 技能
- "设置 git hooks" → **git-hooks** 技能
- "专业提交消息" → **git-emoji** 技能
- "GitHub CLI 命令" → **gh-cli** 技能

### API 与集成
- "设计 RESTful API" → **api-design** 技能
- "GraphQL 最佳实践" → **graphql** 技能
- "cURL 和 HTTP 命令" → **curl-http** 技能

### 环境与调试
- "调试环境变量" → **env-debug** 技能
- "Python 虚拟环境" → **python-env** 技能
- "配置 MCP 服务器" → **mcp-setup** 技能

### 通用实用工具
- "正则表达式模式" → **regex** 技能
- "生成测试数据" → **placeholder-data** 技能
- "JSON/YAML 处理" → **jq-yq** 技能
- "Tmux 终端复用器" → **tmux** 技能
- "Vim 键盘快捷键" → **vim-motions** 技能

## 常见问题

**Q：我可以在我的 AI 代理中使用这些技能吗？**
A：可以！技能兼容 Claude、Cursor、Windsurf、Aider、Continue 和 Cline。每个技能均符合 MCP 规范，与代理无关。

**Q：如何为我的任务找到合适的技能？**
A：描述你想做的事（例如"配置测试"、"管理数据库"、"改善 git 工作流"），AI 代理会自动识别并加载对应技能。

**Q：我可以为团队定制技能吗？**
A：可以！每个技能都包含 SKILL.md 供自定义。Fork 仓库并修改技能以符合团队标准。

**Q：是否有质量保障？**
A：所有技能遵循生产标准，包括：
- 完整文档（SKILL.md）
- 参考指南（references/ 目录）
- 实用示例和模式
- 最佳实践与安全注意事项

**Q：如何贡献新技能？**
A：在 `skills/` 下新建目录，包含：
- SKILL.md（主技能文档）
- references/（支持指南）
- examples/ 或 scripts/（实用代码）
参见 skill-creator 技能了解框架详情。

**Q：技能需要配置吗？**
A：大多数技能开箱即用。部分技能（aws-cli、terraform、kubernetes）需要在系统上安装相应工具，技能文档会提供引导。

## 故障排查

**问题：技能未在代理中显示**
- 确保技能的 SKILL.md 包含清晰的激活短语
- 检查代理系统提示中的技能集成设置
- 验证技能位于 `/skills/` 目录下

**问题：技能执行时命令失败**
- 验证所需工具已安装（`aws`、`kubectl`、`terraform` 等）
- 检查工具版本是否符合技能要求
- 查阅 references/ 目录中的技能专属配置

**问题：示例无法运行**
- 部分示例需要环境配置（AWS 凭证、Kubernetes 集群等）
- 阅读每个技能 SKILL.md 中的"前提条件"部分
- 查阅 references/ 目录获取详细配置指南

**问题：需要特定用例的技能**
- 搜索"可用技能"部分
- 尝试用不同的激活短语向 AI 代理提问
- 查看"真实使用场景"中的组合场景
- 在 [GitHub Issues](https://github.com/1Mangesh1/dev-skills-collection/issues) 上申请新技能

## 支持与社区

- **Issues**：在 [GitHub Issues](https://github.com/1Mangesh1/dev-skills-collection/issues) 上报告错误或申请新功能
- **讨论**：加入 [GitHub Discussions](https://github.com/1Mangesh1/dev-skills-collection/discussions) 提问交流
- **文档**：每个技能的 SKILL.md 中包含完整文档
- **贡献**：欢迎提交 Pull Request！请参阅贡献指南
- **反馈**：分享你的使用体验并提出改进建议

## 许可证

MIT - 详见 [LICENSE](LICENSE) 文件

---

**为使用 AI 编程助手的现代开发者而生** 🚀