最近我深度体验了Claude Code的技能扩展功能,发现这真是一个改变游戏规则的功能!现在我的Claude不再是一个普通的AI助手,而是变成了一个能理解我个人工作习惯、拥有专属工具的智能伙伴。分享一下我的使用流程和心得。我的工具站是----》Weelinking

第一个技能:让代码解释变得生动有趣

我一直觉得理解复杂代码很费劲,直到我创建了第一个技能。

创建过程超简单:

# 我在个人目录下创建了技能文件夹
mkdir -p ~/.claude/skills/explain-code

然后我创建了 SKILL.md 文件,这个文件的结构很清晰:

---
name: explain-code
description: 通过可视化图表和类比来解释代码。适用于以下场景:说明代码的工作原理、讲解代码库的结构,或当用户询问“这是如何工作的?”时
---

# 这是我的代码解释技能

当解释代码时,我会:
1. 从类比开始:把代码比作日常生活中熟悉的事物
2. 绘制示意图:用ASCII艺术图展示流程和关系
3. 逐行讲解:像朋友一样一步步说明
4. 指出陷阱:提醒常见的错误和误解

保持对话感,复杂的就用多个比喻!

实际使用体验:

现在我只需要输入 /explain-code 某个文件路径,或者直接问“这段代码怎么工作的?”,Claude就会自动调用这个技能。最让我惊喜的是,它真的会画出ASCII图表,用很形象的类比来解释,比如把React组件比作乐高积木,把API调用比作餐厅点餐。

如何组织技能库的

经过一段时间的使用,我形成了自己的技能管理策略:

个人技能库 (~/.claude/skills/)

这是我用得最多的,因为所有项目都能用。我把一些通用技能放这里:

  • code-review - 代码审查助手

  • debug-helper - 调试技巧合集

  • git-explainer - Git操作解释器

项目专属技能 (.claude/skills/)

对于特定项目,我会创建专门技能。比如我的电商项目里有:

  • payment-flow - 支付流程检查

  • inventory-check - 库存逻辑验证

发现的小技巧

Claude能自动发现嵌套目录中的技能!我在monorepo项目里试过,在packages/frontend/.claude/skills/里放技能,Claude在处理前端文件时会自动加载,太智能了。

技能文件结构

一个完整的技能我通常这样组织:

my-skill/
├── SKILL.md           # 主要说明(必需)
├── template.md        # 我准备好的模板
├── examples/
│   └── sample.md      # 示例输出,让Claude知道我想要什么格式
└── scripts/
    └── validate.sh    # Claude可以执行的验证脚本

实际案例:我的api-test技能里,examples/目录放了几个测试用例示例,Claude生成新测试时会参考这个格式,一致性很好。

从旧命令文件迁移

我之前有一些在.claude/commands/里的自定义命令,好消息是它们还能用!但我逐渐把它们迁移成了技能,因为技能功能更强大:

  • 支持附带文件

  • 可以控制是否自动调用

  • 结构更清晰

使用心得和小贴士

  1. 命名要直观:技能名就是斜杠命令,我用kebab-case风格,比如/generate-test而不是/generateTest

  2. 描述要具体:好的description让Claude知道何时自动调用,我尽量写得详细

  3. 中文友好:内容完全可以用中文写,Claude理解得很好

  4. 渐进式构建:我从简单技能开始,逐渐添加模板、示例等支持文件

  5. 测试很重要:创建后我都会用直接调用和触发自动调用两种方式测试

最有用的几个技能分享

  1. 代码审查助手 (/review) - 我提交PR前必用

  2. 错误解释器 (/explain-error) - 看到错误日志不再慌

  3. 文档生成 (/generate-docs) - 保持文档与代码同步

  4. 学习助手 (/learn-concept) - 学习新技术时帮我拆解概念

  5. 工具帮助 (/instrument-help) - 辅助我们更好的开发使用

结语

使用技能扩展这些日子,最大的感受是Claude真的变成了“我的”助手。它按照我喜欢的方式工作,用我习惯的术语解释,甚至能执行我写的验证脚本。如果你还没试过,强烈推荐从创建一个简单技能开始,你会惊讶于它能如此贴合你的工作流。

每个开发者的工作习惯不同,技能系统的美妙之处就在于——你可以打造完全适合自己的AI助手。我已经离不开我的这些自定义技能了,它们让编程变得更高效、更有趣!感兴趣的可以自己配置:https://api.weelinking.com/register?aff=sSdbJ5cV

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐