Skills 应用场景

Skills 在软件开发的各个阶段都有广泛应用。本节介绍不同场景下的具体用法，帮助你在实际项目中落地 Skills。

新项目初始化

场景描述

新项目常需创建结构、配置文件与基础代码。Skills 可快速完成重复性工作，确保从一开始就遵循最佳实践。

应用示例

## Skill: 项目初始化

### 功能
根据项目类型自动创建项目结构和基础文件

### 输入
- 项目类型（Web 应用、CLI 工具、库等）
- 编程语言
- 框架选择
- 项目名称

### 执行步骤
1. 创建项目目录结构
2. 生成配置文件（package.json, requirements.txt 等）
3. 创建基础代码文件
4. 生成 README.md
5. 创建 .gitignore
6. 初始化版本控制
7. 生成开发环境配置

# 初始化一个 Flask Web 应用
claude --skill init-project --type web --language python --framework flask --name myapp

# 初始化一个 Node.js CLI 工具
claude --skill init-project --type cli --language javascript --framework commander --name mytool

优势

快速启动
一致性
内置最佳实践
可定制模板
减少重复劳动

代码审查

场景描述

代码审查是质量保障的重要环节，Skills 可自动化审查流程，减少遗漏与主观偏差。

应用示例

## Skill: 代码审查

### 功能
自动审查代码，检查质量、安全性和最佳实践

### 输入
- 代码文件或 PR
- 审查标准（可选）
- 严格程度

### 执行步骤
1. 分析代码结构
2. 检查代码质量
3. 检测安全漏洞
4. 评估性能影响
5. 验证最佳实践
6. 生成审查报告
7. 提供改进建议

# 审查单个文件
claude --skill code-review --file src/main.py --strict

# 审查整个 PR
claude --skill code-review --pr 123 --strictness high

# 审查特定目录
claude --skill code-review --dir src/api --include-security

审查维度

代码质量：复杂度、重复、命名、注释
安全性：SQL 注入、XSS、敏感信息泄露、权限检查
性能：算法效率、资源使用、缓存策略、并发处理
最佳实践：设计模式、SOLID、错误处理、日志记录

优势

全面覆盖
统一标准
自动化效率
具备学习性
减少主观偏差

文档生成

场景描述

文档编写容易被忽视，Skills 可自动生成多种文档类型，保持文档与代码同步。

应用示例

## Skill: API 文档生成

### 功能
从代码自动生成 API 文档

### 输入
- API 路由文件
- 数据模型定义
- 输出格式（Markdown, HTML, OpenAPI 等）

### 执行步骤
1. 分析代码结构
2. 提取 API 定义
3. 生成文档内容
4. 应用模板格式
5. 输出最终文档

# 生成 Markdown 文档
claude --skill generate-api-docs --format markdown --output docs/api.md

# 生成 OpenAPI 规范
claude --skill generate-api-docs --format openapi --output openapi.json

# 生成 HTML 文档
claude --skill generate-api-docs --format html --output docs/api.html

可生成的文档类型

API 文档：端点列表、请求响应、参数说明、认证方式、示例代码
README 文档：项目介绍、安装说明、使用指南、配置说明、常见问题
代码文档：函数说明、类文档、模块文档、示例代码
架构文档：系统架构、组件关系、数据流、部署方案

优势

自动化
保持同步
格式标准化
多格式输出
风格一致

测试生成

场景描述

编写测试耗时耗力，Skills 可自动生成测试用例，提高覆盖率与稳定性。

应用示例

## Skill: 单元测试生成
### 功能
为代码自动生成单元测试
### 输入
- 源代码文件
- 测试框架
- 覆盖率要求
### 执行步骤
1. 分析代码结构
2. 识别测试点
3. 生成测试用例
4. 应用测试框架
5. 验证测试覆盖

# 为单个文件生成测试
claude --skill generate-tests --file src/utils.py --framework pytest

# 为整个模块生成测试
claude --skill generate-tests --module src/api --framework jest --coverage 80

# 生成边界测试
claude --skill generate-tests --file src/validator.py --include-edge-cases

可生成的测试类型

单元测试：函数测试、类方法测试、边界条件、异常处理
集成测试：API 测试、数据库测试、外部服务测试、端到端测试
性能测试：压力测试、负载测试、响应时间、并发测试
安全测试：输入验证、权限测试、注入攻击测试、加密测试

优势

生成速度快
覆盖场景全面
可维护性高
可定制策略
质量可靠

代码重构

场景描述

手动重构容易出错，Skills 可安全执行重构并验证结果。

应用示例

## Skill: 代码重构

### 功能
识别重构机会并安全地执行重构

### 输入
- 代码文件或目录
- 重构类型
- 安全级别

### 执行步骤
1. 分析代码结构
2. 识别重构机会
3. 执行重构操作
4. 验证重构结果
5. 生成重构报告

# 提取函数
claude --skill refactor --file src/main.py --type extract-function --name validate_input

# 重命名变量
claude --skill refactor --file src/utils.py --type rename --old count --new totalCount

# 应用设计模式
claude --skill refactor --file src/service.py --type apply-pattern --pattern singleton

# 简化复杂函数
claude --skill refactor --file src/processor.py --type simplify --max-complexity 10

支持的重构类型

基础重构：提取函数、提取变量、内联函数、重命名、移动函数
结构重构：提取类、提取接口、移动类、合并类、分割类
模式应用：单例、工厂、观察者、策略、装饰器
代码简化：减少复杂度、消除重复、简化条件、优化循环

优势

自动验证结果
全面影响分析
可追溯记录
支持回滚
高效处理复杂重构

错误诊断与修复

场景描述

Skills 能快速诊断错误并提供修复建议，减少调试时间。

应用示例

## Skill: 错误诊断
### 功能
分析错误信息，诊断问题并提供修复方案
### 输入
- 错误消息
- 堆栈跟踪
- 相关代码
### 执行步骤
1. 分析错误信息
2. 定位问题代码
3. 识别根本原因
4. 生成修复方案
5. 验证修复效果

# 诊断运行时错误
claude --skill diagnose --error "TypeError: Cannot read property 'x' of undefined" --stacktrace <stacktrace.txt>

# 诊断编译错误
claude --skill diagnose --error "Module not found: Error: Can't resolve './utils'" --file src/index.js

# 诊断测试失败
claude --skill diagnose --test-failure --test-file tests/api.test.js

可诊断的错误类型

运行时错误：类型错误、引用错误、空指针异常、超时错误
编译错误：语法错误、类型错误、模块未找到、依赖冲突
逻辑错误：业务逻辑错误、算法错误、边界条件错误、状态管理错误
性能问题：内存泄漏、性能瓶颈、资源竞争、死锁

优势

快速定位
诊断准确
修复可操作
具备教育性
覆盖全面

代码迁移

场景描述

迁移平台或框架复杂且耗时，Skills 可自动化大部分迁移工作。

应用示例

## Skill: 框架迁移

### 功能
将代码从一个框架迁移到另一个框架

### 输入
- 源框架
- 目标框架
- 代码目录

### 执行步骤
1. 分析源代码结构
2. 识别迁移模式
3. 执行代码转换
4. 验证迁移结果
5. 生成迁移报告

# 从 Express 迁移到 Fastify
claude --skill migrate --from express --to fastify --dir src/

# 从 jQuery 迁移到 React
claude --skill migrate --from jquery --to react --dir src/

# 从 Python 2 迁移到 Python 3
claude --skill migrate --from python2 --to python3 --dir src/

支持的迁移类型

框架迁移：Web 框架、UI 框架、测试框架、构建工具
语言迁移：Python 2 → 3、JavaScript → TypeScript、Java → Kotlin
平台迁移：本地 → 云平台、单体 → 微服务、传统 → 容器化
数据库迁移：SQL → NoSQL、单库 → 多库

优势

自动化迁移
减少人为错误
自动验证结果
支持回滚
高效完成复杂迁移

性能优化

场景描述

性能优化需要深入理解代码与系统，Skills 可分析瓶颈并提供建议。

应用示例

## Skill: 性能分析

### 功能
分析代码性能，识别瓶颈并提供优化建议

### 输入
- 代码文件
- 性能数据（可选）
- 优化目标

# 分析函数性能
claude --skill analyze-performance --file src/processor.py --function process_data

# 分析数据库查询
claude --skill analyze-performance --type database --query "SELECT * FROM users WHERE active = true"

# 分析 API 响应时间
claude --skill analyze-performance --type api --endpoint /api/users --target-time 100ms

可优化的性能类型

算法优化：时间复杂度、空间复杂度、算法选择、数据结构优化
数据库优化：查询优化、索引优化、连接优化、缓存策略
网络优化：请求合并、数据压缩、并发控制、连接池
前端优化：资源加载、渲染优化、代码分割、缓存策略

优势

覆盖多个性能维度
准确定位瓶颈
提供可执行方案
支持效果验证

安全审计

场景描述

安全是系统的重要考量，Skills 可自动识别潜在安全问题。

应用示例

## Skill: 安全审计

### 功能
审计代码安全性，识别潜在的安全漏洞

### 输入
- 代码目录
- 审计标准（OWASP, CWE 等）

### 执行步骤
1. 分析代码结构
2. 识别潜在安全漏洞
3. 生成审计报告
4. 提供修复建议

# 执行安全审计
claude --skill security-audit --dir src/ --standard owasp

# 审计特定漏洞类型
claude --skill security-audit --dir src/ --vulnerabilities sql-injection,xss,csrf

# 生成安全报告
claude --skill security-audit --dir src/ --output security-report.md

审计内容

注入攻击：SQL/NoSQL/命令/LDAP 注入
XSS：反射型、存储型、DOM 型
认证与授权：弱密码、会话管理、权限提升、认证绕过
数据保护：敏感数据泄露、加密不足、数据完整性、隐私保护

优势

覆盖多种安全问题
遵循安全标准
可追溯审计历史
提供修复建议

持续集成/部署

场景描述

CI/CD 自动化能显著提升效率，Skills 可集成到流程中执行自动化任务。

应用示例

## Skill: CI/CD 自动化

### 功能
自动化 CI/CD 流程中的各种任务

### 输入
- CI/CD 配置
- 任务类型

### 执行步骤
1. 分析 CI/CD 配置
2. 执行自动化任务
3. 生成执行报告
4. 通知结果

# 在 CI 流程中运行
claude --skill ci-pipeline --stage test --pr $PR_NUMBER

# 在 CD 流程中运行
claude --skill cd-pipeline --stage deploy --environment production

# 生成部署报告
claude --skill generate-deployment-report --commit $COMMIT_SHA

# .github/workflows/ci.yml
name: CI Pipeline
on: [pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Run Claude Code Skills
        run: |
          claude --skill code-review --pr ${{ github.event.number }}
          claude --skill run-tests --coverage 80
          claude --skill generate-docs

优势

自动化流程
保障一致性
易于扩展
便于监控
支持回滚

Skills 应用场景

On this page