Skip to content

实战应用

通过实际案例学习如何使用 Skills


本章目标

通过 4 个实战案例,让你掌握:

  1. Claude Desktop 中使用 Skills
  2. Claude Code 中使用 Skills
  3. 常用 Skills 的实际应用
  4. 选择合适的 Skills

案例 1:代码搜索

场景

你想找到项目中所有使用 useState 的地方。

没有 Skills

你:帮我找到所有使用 useState 的文件

AI:我无法搜索文件,你可以手动用 grep 命令:
grep -r "useState" --include="*.js" --include="*.jsx"

步骤 1:在 Claude Desktop 中启用 Skill

  1. 打开 Claude Desktop
  2. 点击左侧 Skills 图标
  3. 搜索 "code_search"
  4. 勾选启用

步骤 2:使用 Skill

你:使用 code_search 找到所有使用 useState 的地方

AI:我来帮你搜索代码...

[使用 code_search Skill]
执行:grep -r "useState" --include="*.js" --include="*.jsx" --include="*.ts" --include="*.tsx"

找到 23 个文件:

前端文件:
- src/components/Header.jsx (line 15)
- src/hooks/useAuth.js (line 8)
- src/pages/Home.jsx (line 22)
...

测试文件:
- tests/Header.test.jsx (line 12)
...

效果

  • ✅ 自动搜索
  • ✅ 分类清晰
  • ✅ 包含行号

案例 2:代码重构

场景

你想把一个过大的函数拆分成更小的函数。

没有 Skills

你:帮我重构这个函数

AI:我可以给你建议,但无法直接修改代码。建议你:
1. 提取重复逻辑
2. 降低复杂度
3. 添加注释

(你需要手动修改)

有 Skills(refactor)

你:使用 refactor Skill 重构 src/utils/helpers.js 中的 processData 函数

AI:我来帮你重构...

[使用 refactor Skill]

1. [读取代码](read_file)
2. [分析代码](code_analyze)
3. [生成重构方案](generate_plan)
4. [应用重构](apply_changes)

分析完成!这个函数有 85 行,包含 3 个独立逻辑:

重构方案:
1. 提取 validateInput 函数(第 5-15 行)
2. 提取 transformData 函数(第 16-45 行)
3. 提取 formatOutput 函数(第 46-60 行)

是否应用重构?

你:确认应用

AI:正在应用重构...
[写入修改后的代码]

重构完成!
- 代码行数:85 → 62
- 函数复杂度:高 → 低
- 可读性:提升

效果

  • ✅ 自动分析
  • ✅ 给出方案
  • ✅ 应用修改
  • ✅ 对比效果

案例 3:生成测试

场景

你刚写了一个函数,需要生成测试用例。

没有 Skills

你:为这个函数写测试

AI:我可以给你测试代码,但你需要:
1. 创建测试文件
2. 安装测试框架
3. 手动复制代码

(给你一段测试代码)

有 Skills(test_generation)

你:使用 test_generation Skill 为 src/utils/formatDate.js 写测试

AI:我来生成测试...

[使用 test_generation Skill]

1. [读取源代码](read_file)
2. [分析函数逻辑](analyze)
3. [生成测试用例](generate_tests)

生成的测试用例:
✓ 正常日期格式化
✓ 无效日期处理
✓ 时区处理
✓ 边界情况

正在创建测试文件...
tests/utils/formatDate.test.js ✓

是否运行测试?

你:运行

AI:[运行测试]
✓ 所有测试通过(4/4)

效果

  • ✅ 自动创建测试文件
  • ✅ 覆盖多种情况
  • ✅ 可以直接运行

案例 4:文档处理

场景

你有一个 PDF 文档,需要提取其中的表格数据。

没有 Skills

你:帮我提取 PDF 中的表格

AI:我无法直接读取 PDF。你可以:
1. 手动复制粘贴
2. 使用 PDF 转换工具
3. 写代码解析

有 Skills(pdf_parser)

你:使用 pdf_parser Skill 提取 report.pdf 中的表格

AI:我来解析 PDF...

[使用 pdf_parser Skill]

解析完成!找到 3 个表格:

表格 1:销售数据
┌─────────┬──────┬──────┐
│ 月份    │ 销量 │ 收入 │
├─────────┼──────┼──────┤
│ 1月     │ 1000 │ 5万  │
│ 2月     │ 1200 │ 6万  │
└─────────┴──────┴──────┘

表格 2:用户增长
...

需要导出为 CSV 还是 JSON?

你:导出为 CSV

AI:正在导出...
✓ sales_data.csv
✓ user_growth.csv
✓ product_stats.csv

效果

  • ✅ 自动提取
  • ✅ 格式清晰
  • ✅ 可导出

在 Claude Code 中使用 Skills

Claude Code 内建 Skills

Claude Code 已经内置了很多常用 Skills,不需要手动启用

  • code_search:代码搜索
  • refactor:代码重构
  • debug:调试辅助
  • test_generation:测试生成
  • documentation:文档生成

使用示例

你:搜索所有使用 useEffect 的文件

Claude Code:我来搜索...
[自动使用 code_search Skill]
找到结果...
你:帮我重构这个函数

Claude Code:我来重构...
[自动使用 refactor Skill]
重构完成...

优势

  • ✅ 自动识别需要哪个 Skill
  • ✅ 无需手动启用
  • ✅ 更智能的编排

常用 Skills 清单

代码操作类

Skill功能使用场景
code_search搜索代码找函数、找变量、找调用
refactor重构代码拆分函数、提取逻辑、优化代码
code_explain解释代码理解别人写的代码
debug调试辅助排查 Bug、分析报错
test_generation生成测试写单元测试、集成测试

文件操作类

Skill功能使用场景
file_operations文件读写创建文件、读取配置、写入日志
batch_operations批量操作批量重命名、批量处理

文档处理类

Skill功能使用场景
pdf_parserPDF 解析提取文本、提取表格
markdown_toolsMarkdown 操作转换格式、生成目录
document_summarizer文档摘要总结长文档

Web 操作类

Skill功能使用场景
web_scraper网页抓取抓取文章、抓取数据
api_clientAPI 调用调用第三方 API
web_search网络搜索搜索最新信息

如何选择合适的 Skill?

决策流程

你有一个任务

    ├─ 涉及代码?
    │   ├─ 搜索代码 → code_search
    │   ├─ 修改代码 → refactor
    │   ├─ 理解代码 → code_explain
    │   └─ 找 Bug → debug

    ├─ 涉及文档?
    │   ├─ PDF → pdf_parser
    │   ├─ Markdown → markdown_tools
    │   └─ 长文档 → document_summarizer

    └─ 涉及 Web?
        ├─ 抓取网页 → web_scraper
        ├─ 调用 API → api_client
        └─ 搜索信息 → web_search

例子

任务:找到项目中过时的 API 调用

思考过程:
1. 涉及代码 ✓
2. 需要搜索 ✓
3. → 使用 code_search Skill

任务:重构一个复杂函数

思考过程:
1. 涉及代码 ✓
2. 需要修改 ✓
3. → 使用 refactor Skill

任务:从年度报告 PDF 中提取数据

思考过程:
1. 涉及文档 ✓
2. 是 PDF ✓
3. → 使用 pdf_parser Skill

实战练习

练习 1:代码考古

任务:找出项目中最古老的代码(根据 Git 历史)

提示词

使用 code_search 和 git_operations Skills
找出项目中最后修改时间超过 2 年的文件

练习 2:批量优化

任务:找出所有超过 100 行的函数,并给出重构建议

提示词

使用 code_search 和 refactor Skills
1. 搜索所有超过 100 行的函数
2. 为每个函数给出重构建议

练习 3:测试覆盖

任务:找出没有测试的文件

提示词

使用 code_search 和 test_generation Skills
1. 列出所有 src/ 下的 .js 文件
2. 检查是否有对应的测试文件
3. 为没有测试的文件生成测试

模块三总结

恭喜你完成了 Skills 指南模块的学习!

核心收获

  1. Skills 是 AI 的技能包

    • 让 AI 能完成更多任务
    • 封装了最佳实践
  2. Skills 和 MCP 是相辅相成的

    • MCP 提供工具
    • Skills 封装逻辑
    • 两者配合效率最高
  3. 常用 Skills

    • code_search:代码搜索
    • refactor:代码重构
    • test_generation:测试生成
    • pdf_parser:PDF 解析
  4. 实战应用

    • Claude Desktop:手动启用 Skills
    • Claude Code:自动使用 Skills
    • 根据任务选择合适的 Skill

下一步

接下来,我们将学习工具推荐实战,了解日常使用和 IDE 编程的推荐工具。


← 返回模块目录 | 继续学习:工具推荐实战 →

最近更新

基于 Apache 2.0 许可发布