← 返回文章列表
Claude Code Skills 实测:把常用工作流打包成技能
亲手实测 Claude Code 的 Skills 机制:怎么写一个 Skill、怎么复用、有哪些坑。全文基于真实使用,不抄文档。
Eason2 分钟阅读
先说结论
Skills 是 Claude Code 里最被低估的功能。它解决的问题很具体:你有一套常用的工作流,每次都要从头描述一遍,Skills 让你描述一次、以后直接调用。
什么是 Skill
简单理解,Skill = 一份 Markdown 说明书 + 可选的脚本。放在 ~/.claude/skills/ 目录下,Claude Code 会自动发现,合适的时候自己调用。
实测过程
第一步:写 Skill 文件
目录结构:
~/.claude/skills/my-workflow/
SKILL.md # 技能说明:什么时候用、怎么做
scripts/ # 可选的辅助脚本
SKILL.md 里写清楚三件事:这个技能解决什么问题、触发条件是什么、执行步骤是什么。写得越具体,调用效果越好。
第二步:验证调用
在对话里描述一个符合触发条件的任务,观察 Claude Code 是否自动加载这个 Skill。我的实测里,描述准确的情况下触发率很高;描述模糊时,它会先问你确认——这反而是好事,说明它不会乱调用。
第三步:复用与迭代
用上几次之后,根据实际效果改 SKILL.md。我的经验:先写 60 分的版本,用三次,改成 90 分,比一开始就追求完美靠谱得多。
踩过的坑
- Skill 写得太长没人看——包括 AI。控制在 500 行以内,核心步骤前置
- 触发条件写模糊,导致该用的时候不用、不该用的时候乱用
- 和项目级 Skill 混在一起,个人 Skill 放
~/.claude/skills/,项目 Skill 放项目目录,分开管理
适合写成 Skill 的场景
- 固定的代码审查流程
- 每日选题采集与评分
- 发布前的检查清单
- 任何“你每周都要做三遍以上”的事
下一篇:Claude Code MCP 配置实战,把外部工具接进你的工作流。