最近我把日常工作的一个重要分支迁到了 Claude Code 上折腾了一周多最值的不是它本身的对话能力而是给这个命令行智能助手配上了一套好用的Skills。如果你也听说“Claude Code Skills”这个词但不知道它到底是什么或者装了官方客户端却发现它只能写代码、不能按你的专业方式干活那这篇文章正好适合你。我会从零开始拆解 Skills 的本质和目录结构再把我实测过比较好用的 11 个 Skills 逐个讲清楚它们解决什么问题、为什么值得装、怎么配置最顺手。后面还有安装踩坑记录、VSCode 集成方式、组合工作流示例以及一份直接能用的排查速查表。不管你是前端、后端、算法、论文排版还是数据分析方向应该都能找到能立刻上手的那一个。1. 先搞清楚一件事Claude Code Skills 到底是什么很多人第一次接触 Skills 时会把它理解成“插件”。这个类比方向是对的但太粗了。更准确地说Skills 是打包好的“专业技能包”它把某个领域的任务说明、操作步骤、工具调用方式、注意事项写成一个结构化目录放在 Claude Code 能扫描到的地方。当你在对话里提出任务时Claude Code 会根据每个 Skill 的描述来判断要不要“附身”这个技能。一旦匹配上它就不再是那个只会写通用代码的模型了而是变成一个有领域经验的“专家助手”比如它会主动检查你的依赖声明顺序、会按照团队规范生成提交信息、会记得在 LaTeX 文档里处理中文标点。1.1 Skills 的目录与文件结构拆解一个标准的 Skill 通常放在这样的路径下~/.claude/skills/skill-name/ ├── SKILL.md ├── scripts/ │ ├── check_ports.py │ └── gen_report.sh └── references/ ├── style_guide.md └── faq.md核心是SKILL.md。这个文件决定了 Claude Code 什么时候加载这个技能、加载后模型应该怎么行动。它的格式是“YAML 头 Markdown 正文”--- name: frontend-dev description: 用于从设计稿或需求描述生成响应式前端页面包含 Tailwind 配置、组件拆分规范和常见布局模式。 --- # 前端开发助手 ## 任务流程 1. 先确认目标设备的尺寸范围 2. 分析设计稿的颜色、间距、字体 3. 生成目录结构与核心组件 ...description字段尤其重要Claude Code 依靠它来决定要不要触发这个 Skill所以描述要写清楚这个技能管什么、不管什么。正文则是给模型看的“操作说明书”和给人类看的技术文档类似但更偏向步骤和检查点。1.2 Skills 的加载逻辑什么时候会被触发理解加载机制是避免“装了但不生效”的关键。Claude Code 不会一次加载所有 Skills那样会爆掉上下文窗口。它的实际做法是在构建对话上下文时把每个 Skill 的name和description暴露给模型模型根据你的当前问题去判断是否调用。这里有两种触发模式自动匹配你问“帮我生成一套登录页”模型看到 frontend-dev 这个 Skill 的描述自动激活对应技能。显式调用你在 prompt 里直接点名“用 frontend-dev 重构一下 /src/pages 下的按钮组件”。我个人的建议是高频且通用的技能比如代码审查、Git 提交规范让它自动匹配低频但流程固定的技能比如 LaTeX 排版、数学建模建议显式点名避免模型在早期判断阶段浪费 token。2. 11个顶级Skills逐个拆解下面这些 Skills 是我在本地反复用过、并且有真实产出效果的清单。没有按热度排序而是按照“最不值得错过”的顺序来。每个技能我都会说明它在什么场景下能顶一个人用以及装完之后需要改哪些配置。2.1 前端开发助手从设计稿到响应式页面这个 Skill 解决的是前端开发里最耗时的“从 0 到 1”阶段一套页面结构、组件拆分、样式体系。它会把 Tailwind 的配置文件和通用布局模式固化下来遇到需求时不用每次重新解释“我想要一个居中卡片、阴影、圆角”。我实测的场景是给它一张后台管理系统的截图要求“用 React Tailwind 实现同款布局”它能够直接给出组件树和样式代码连响应式断点都处理好。这里有个很重要的配置细节SKILL.md 里最好注明项目使用的框架版本否则它默认生成的内容会跟你的项目依赖冲突。# 典型调用 claude 用前端开发助手打开 design.png生成对应的实现代码技术栈是 React 18 Tailwind 32.2 代码审查专家把隐性问题拦在合并前代码审查 Skill 是我最推荐第一个装的。它不只是看语法错误而是围绕安全性、性能、可维护性三个维度做检查。比如未转义的 SQL 字符串、潜在的竞态条件、明显可以抽公共组件的重复代码它都能在提交前发现。这个 Skill 比较讲究“给多少上下文”。我通常的做法是配合git diff使用git diff HEAD~1 | claude -p 用 code-reviewer 审查这段变更按严重程度输出问题清单它的输出会按照Critical / Warning / Suggestion分级并且每一个问题都附带修改建议。相比人工 Review它最大的优势是稳定——不会因为 Reviewer 今天心情不好就漏掉细节。2.3 架构图与结构图生成一张图说清系统全貌写技术方案时最头疼的不是文字而是画图。这个 Skill 专门处理结构图、流程图、架构图的生成你描述系统模块和依赖关系它直接产出可在文档工具中渲染的图表代码例如 Graphviz 的 dot 格式或者 PlantUML。我在一个微服务项目里试过把服务列表、数据库、消息队列的关系讲了一遍它生成的架构图基本可以直接放进设计文档节点分组和依赖箭头都分得很清楚。配置时建议把常用约束写进 SKILL.md比如“图层从上到下接入层、业务层、数据层”这样出图才符合团队习惯。2.4 数据库设计与 SQL 调优专家表结构、索引一次拿捏这个 Skill 适合所有后端开发者。它内置了建表规范、索引设计原则和慢查询分析流程。你不需要把整个数据库交给它只要在 prompt 里描述业务场景它就能输出CREATE TABLE的 DDL、必要的索引建议以及数据量预估。另外一个很实用的子功能是慢查询分析把EXPLAIN ANALYZE的输出贴给它它会定位到是全表扫描还是索引失效并给出改写方案。配置要点是在 references 目录放一份你们团队自己的数据库命名规范这样生成的 DDL 能直接进入评审流程。2.5 图片处理与生成截图优化、图标生成、封面设计这个 Skill 面向的是“离不开代码但偶尔要处理图”的开发者。它通过封装本地的图片处理工具比如 ImageMagick 或 Sharp来实现图片缩放、格式转换、压缩、加水印等操作。遇到需要生成占位图或者简单图标时它也能用 SVG 代码快速搞定。我实际用它做过一次公众号封面在一张产品截图基础上自动加标题文字、调节对比度、输出 WebP 和多倍率版本整个过程只需要一行指令。它处理不了真正意义上的“AI 绘画”但日常开发里 90% 的图片需求它都覆盖了。# 示例批量压缩截图目录 claude 用 image-tools 把 ./screenshots 下的 PNG 全部转为 WebP质量压到 822.6 LaTeX 排版专家论文、简历、PPT 规范化如果你写过含公式的文档就知道 LaTeX 的排版工作量有多大。这个 Skill 会按照学术写作规范处理章节结构、公式编号、参考文献引用、表格浮动体。它最擅长的是把混乱的 Markdown 草稿转换成合规的.tex文件。中文场景下还有一个杀手锏功能自动处理中英文间空格、全角半角标点和字体配置。这些细节原本需要你去翻ctex文档现在它直接封装好了。配置时记得在 SKILL.md 里写明你的编译器路径和是否使用xelatex否则编译阶段可能白折腾一场。2.7 文档写作与翻译一份内容多语言输出技术文档维护里最烦的工作是同步多语言版本。这个 Skill 组织了一套“术语优先”的写作流程先把项目里的专业术语整理成术语表再按术语表进行翻译和撰写避免同一个词在不同文档里翻译不统一。它的另一个常用场景是改写把一段口语化的开发日志改成正式的技术公告或者反过来把官方的 Release Notes 改写成团队内部通俗版。相比直接在对话里说“帮我翻译”这个 Skill 的差异在于它会主动维护术语表并放在 references 目录里供后续调用。2.8 测试用例生成器覆盖率不再是嘴上功夫这个 Skill 会分析你的源码并生成单元测试和集成测试的骨架。它不只是简单地把每个函数调用一遍而是会考虑正常路径、异常路径和边界值。配置好测试框架后它会直接生成可运行的测试文件。我把它用在 Node.js 项目里效果最明显的场景是刚写完一个工具模块马上让它生成单元测试原本手动写用例要小半天现在几分钟就能跑起来。它还支持把“测试结果失败”回传给它让模型迭代修改测试用例形成一个小闭环。建议为每个语言框架单独准备一个 Skill 子目录比如test-generator-jest、test-generator-pytest避免描述冲突。2.9 Git 工作流助手提交信息、分支管理、冲突解决一条龙Git 操作命令记不全不用怕这个 Skill 更像一个“会规范动作的 Git 教练”。它会根据项目的 commit 规范Conventional Commits、Angular 规范等生成提交信息也能处理分支合并中的冲突给出每一步解决建议。让我觉得省心的是它能主动做检查提交前先跑 lint提交时把变更内容按模块拆分到多个 commit而不是一次性提交一大堆。配置时只要在 references 里放一份.gitmessage模板它就会严格按照模板产出提交信息。2.10 性能优化专家从日志定位到优化方案一步到位性能调优是最依赖“经验”的领域。这个 Skill 封装了一套系统性的分析流程先看日志和监控指标再定位瓶颈最后给出可验证的优化方案。它不会直接丢给你一句“建议加缓存”而是要求你先提供数据。实际项目里我试过把一份后端接口的耗时分析交给它。它给出的方向包括数据库索引缺失、N1 查询、无效日志输出每一条都有修改建议和预期收益。配置时你可以把公司的监控面板导出规范写进 SKILL.md比如“按 P50 / P95 分位展示响应时间”让分析结果更贴合你的真实环境。2.11 数学建模助手把模型公式变成可运行的代码最后一个适合算法工程师、数据分析师和参加建模比赛的学生。这个 Skill 覆盖从问题抽象、模型选型、公式推导到 Python 代码实现的全过程。你描述一个实际问题它会输出数学模型、必要的假设说明以及用 NumPy 或 SciPy 实现的求解代码。我拿它做过一个小型库存优化问题我把业务约束和目标函数讲清楚它先用数学语言建模再生成带注释的求解代码最后还会给出参数敏感性分析的思路。相比直接让模型写代码这个 Skill 强在“先建模、再编码”的顺序被强制固定下来不容易跑偏。3. 安装与配置从零到能用的完整路子前面把 11 个 Skills 讲完接下来是实操。这部分我会给出命令行安装、Skills 目录配置、VSCode 集成以及如何自己写一个最小可用 Skill 的完整步骤。3.1 命令行安装与初始化Claude Code 的安装方式我建议直接用官方包管理器方式执行后确认版本号npm install -g anthropic-ai/claude-code claude --version如果你不想通过 npm也可以去官方发布渠道下载对应的二进制包macOS 和 Windows 都有对应的安装方式。安装完成后第一次执行claude会引导你完成认证流程。这里有一个小建议装完第一件事是配置模型参数和权限策略。比如在交互式会话里执行claude config set --global model sonnet claude config set --global permissionMode acceptEditspermissionMode控制 Claude Code 是否可以自动修改文件。刚开始用不建议直接放开先让它输出方案、你确认后再改等信任度建立起来再切换。3.2 通过目录管理并配置 SkillsClaude Code 会自动扫描两个位置的 Skills用户级目录~/.claude/skills/项目级目录.claude/skills/放在你的项目根目录下用户级适合放通用技能项目级适合放和业务强相关的技能。推荐的目录结构是这样~/.claude/skills/ ├── frontend-dev/ ├── code-reviewer/ ├── latex-formatter/ └── ...安装一个 Skill 的方式很简单把 Skill 文件夹复制到上面的目录里然后重启 Claude Code或者在新会话中让它重新扫描。大部分第三方 Skill 都以 Git 仓库形式发布cd ~/.claude/skills git clone https://github.com/example/frontend-dev.git提示遇到无法定位到仓库的情况时可以在官网或社区搜索 Skills 合集包下载后手动解压到目录即可。本项目标题里提到的“superpower skills”就是社区命名的一个合集包概念本质上是把多个 Skills 打包分发方便一次性装完。3.3 VSCode 里的 Claude Code 体验如果你习惯在编辑器里干活那 VSCode 集成是必须配的。先在扩展市场搜索并安装 Claude Code 扩展安装后用快捷键CmdShiftPmacOS或CtrlShiftPWindows打开命令面板选择登录授权。安装完成后扩展会自动读取~/.claude/skills/目录。你可以在设置项里检查Claude Code Skills: Path是否指向正确的路径。VSCode 集成的好处有两个一是可以直接选中代码片段右键交给 Claude Code 处理二是会在侧边栏显示当前可用的 Skills 列表点名字就能在对话中激活对应技能。这对于像我一样记不住命令行的开发者来说比终端交互友好很多。3.4 从零编写一个最简单的 Skill5 分钟就能跑通把自己的工作流封装成 Skill 没有想象中复杂。我用一个“中文排版校对”的需求来演示这个技能在工作里非常实用。第一步创建目录和文件mkdir -p ~/.claude/skills/zh-copyreader cd ~/.claude/skills/zh-copyreader touch SKILL.md第二步编辑SKILL.md--- name: zh-copyreader description: 用于中文文本审校检查中英文空格、全角/半角标点、术语和数字写法。 --- # 中文排版校对 ## 适用场景 - 校对公众号文章、技术文档、博客中的中文排版 - 统一中英文混排规范 ## 校对规则 1. 中英文之间增加一个空格 2. 数字与单位之间保留空格 3. 中文语境下使用全角标点 4. 英文单词内部不得出现全角字符 5. 术语保持全篇一致优先使用项目术语表 ## 输出格式 先输出修改后的全文再附上修改点列表按原文 → 修改后 → 原因排列第三步保存后新建一个 Claude Code 会话输入用 zh-copyreader 校对一下 README.md如果 Skill 生效它会先读取README.md然后按照你的校对规则输出文本。这一点是我推荐所有开发者都尝试的把自己反复要做的事写成规则放进 SKILL.md等于把个人的经验沉淀成了可复用的资产。4. 使用技巧与组合工作流有了 Skills 不等于效率自然提升。我踩过几次坑之后总结出四个使用习惯以及一套从需求到上线的组合打法。4.1 让 Skills 真正好用的 4 个习惯第一个习惯是描述里写清边界。比如“帮我审查代码”这种说法太模糊要告诉它“审查 src/ 目录下本次变更的 JS 文件重点关注内存泄漏和错误处理”。描述越具体Skill 的触发越准确输出也越匹配。第二个习惯是完成任务后让它汇报依据。Skills 默认会直接完成任务并输出结果但我会在 prompt 里追加一句“给出结论对应的文件位置和行号”这样验证成本低很多。第三个习惯是把高频知识放进 references。比如团队的编码规范、接口命名规则、数据库字段类型约定。这些内容如果每次粘贴到对话里既累又容易抄错放进 Skill 的 references 目录后模型会在需要时主动读取。第四个习惯是关注 Skill 的更新迭代。很多 Skills 是开源社区维护的框架升级后旧版可能出现兼容问题。我一般每个月检查一次安装的 Skills 是否有新版本对长期不维护的直接淘汰。4.2 从需求到上线的组合工作流一次完整的项目实战单独使用 Skills 只是工具层面组合起来才是真正的工作流。我以一个内部工具系统的模块开发为例展示实际流程。需求是做一个带用户登录和简单数据报表的前端页面。我会按这个顺序调度技能用数据库设计专家生成用户表和报表表的 DDL以及索引建议用前端开发助手根据产品原型生成页面骨架用测试用例生成器给后端接口写单元测试和集成测试用代码审查专家审查整轮变更的git diff最后用Git 工作流助手按规范生成多个提交记录。整个过程里我做的事情从“自己写所有代码”变成了“调度多个专家并做最终确认”。这个切换是效率提升最明显的地方。第一次跑通之后这个流程可以沉淀成团队的标准流程新人照着走也能上手。4.3 在团队里分发和更新 Skills个人使用 Skills 很容易团队协作则要考虑分发机制。最朴素的做法是建一个skills私有仓库按目录组织所有 Skills然后让成员 clone 到各自的~/.claude/skills/下。更可控的方式是使用 Git 子模块或者专门的配置管理工具把 Skills 和项目代码绑定。我建议至少在团队里约定以下几点命名规范技能目录名统一用短横线连接如code-reviewer更新节奏重大更新要以 PR 形式发起Review 通过后合并文档要求每个 Skill 除了SKILL.md最好有一页说明文件写清楚适用场景和维护人。5. 常见问题与排查技巧实录这段时间我遇到的问题不算少整理几个最典型的给已经上手或者准备上手的你做个参考。5.1 Skills 不生效先查三件事第一种情况是最常见的明明把 Skill 放进目录了但对话里怎么点都不生效。我建议按下面顺序排查目录名和name字段是否一致。Claude Code 对名字大小写敏感Frontend-Dev和frontend-dev会被视为两个不同的技能。description是否写得足够清楚。如果你的描述用词和日常工作语言差别很大模型可能根本不会触发它。试试把“前端页面生成”改成“根据设计稿或需求描述生成 React / Vue 页面”。是否有权限限制。一些 Skill 会调用脚本或者修改文件如果你在配置里把权限设成了只读它可能会报错或者静默跳过。5.2 工具调用超时与上下文溢出的应对当任务步骤很多时我遇到过 Claude Code 在某个工具调用上超时或者输出到一半上下文用完的情况。这不是单一 Skill 的问题而是任务规划的问题。应对方法有三个。一是把大任务拆成小任务比如“优化整个模块性能”拆成“先分析接口耗时”和“再优化数据库访问”。二是在 prompt 里限定返回格式要求它只输出关键代码和总结不用把全部文件内容回显一遍。三是用--max-turns参数控制迭代次数防止它在某个问题上循环调用工具。# 限定最大对话轮次 claude --max-turns 20 用 code-reviewer 审查本次变更5.3 排查速查表我把日常遇到的异常情况整理成了一个表格方便你直接对照现象可能原因处理办法Skill 没有出现在可用列表目录路径不对确认SKILL.md位于~/.claude/skills/name/下模型不触发已安装的 Skilldescription 关键词太模糊重写 description覆盖常见表达方式执行到一半提示权限不足权限模式限制检查permissionMode按需开启acceptEdits输出内容与 Skill 规则不符上下文被其他任务占用新开会话显式调用 Skill 名称调用脚本时报错脚本依赖缺失查看scripts/目录按 README 安装依赖长任务中途超时单轮迭代过多拆分任务或调大--max-turns注意排查的时候多看 Claude Code 的执行日志里面会记录每次工具调用的开始、结束和错误信息大部分问题不需要猜看日志就能定位。最后再分享一点个人体会Skills 不是装得越多越好。我见过有人一口气装了几十个结果模型在匹配阶段经常被干扰反而影响响应速度。我的建议是先从两三个真正贴合自己工作的开始比如后端开发就从“数据库设计专家”和“代码审查专家”入手用顺手了再逐步扩展。技能这东西最终还是要靠实际项目养出来。
Claude Code Skills实战：11个顶级技能包助你效率翻倍
最近我把日常工作的一个重要分支迁到了 Claude Code 上折腾了一周多最值的不是它本身的对话能力而是给这个命令行智能助手配上了一套好用的Skills。如果你也听说“Claude Code Skills”这个词但不知道它到底是什么或者装了官方客户端却发现它只能写代码、不能按你的专业方式干活那这篇文章正好适合你。我会从零开始拆解 Skills 的本质和目录结构再把我实测过比较好用的 11 个 Skills 逐个讲清楚它们解决什么问题、为什么值得装、怎么配置最顺手。后面还有安装踩坑记录、VSCode 集成方式、组合工作流示例以及一份直接能用的排查速查表。不管你是前端、后端、算法、论文排版还是数据分析方向应该都能找到能立刻上手的那一个。1. 先搞清楚一件事Claude Code Skills 到底是什么很多人第一次接触 Skills 时会把它理解成“插件”。这个类比方向是对的但太粗了。更准确地说Skills 是打包好的“专业技能包”它把某个领域的任务说明、操作步骤、工具调用方式、注意事项写成一个结构化目录放在 Claude Code 能扫描到的地方。当你在对话里提出任务时Claude Code 会根据每个 Skill 的描述来判断要不要“附身”这个技能。一旦匹配上它就不再是那个只会写通用代码的模型了而是变成一个有领域经验的“专家助手”比如它会主动检查你的依赖声明顺序、会按照团队规范生成提交信息、会记得在 LaTeX 文档里处理中文标点。1.1 Skills 的目录与文件结构拆解一个标准的 Skill 通常放在这样的路径下~/.claude/skills/skill-name/ ├── SKILL.md ├── scripts/ │ ├── check_ports.py │ └── gen_report.sh └── references/ ├── style_guide.md └── faq.md核心是SKILL.md。这个文件决定了 Claude Code 什么时候加载这个技能、加载后模型应该怎么行动。它的格式是“YAML 头 Markdown 正文”--- name: frontend-dev description: 用于从设计稿或需求描述生成响应式前端页面包含 Tailwind 配置、组件拆分规范和常见布局模式。 --- # 前端开发助手 ## 任务流程 1. 先确认目标设备的尺寸范围 2. 分析设计稿的颜色、间距、字体 3. 生成目录结构与核心组件 ...description字段尤其重要Claude Code 依靠它来决定要不要触发这个 Skill所以描述要写清楚这个技能管什么、不管什么。正文则是给模型看的“操作说明书”和给人类看的技术文档类似但更偏向步骤和检查点。1.2 Skills 的加载逻辑什么时候会被触发理解加载机制是避免“装了但不生效”的关键。Claude Code 不会一次加载所有 Skills那样会爆掉上下文窗口。它的实际做法是在构建对话上下文时把每个 Skill 的name和description暴露给模型模型根据你的当前问题去判断是否调用。这里有两种触发模式自动匹配你问“帮我生成一套登录页”模型看到 frontend-dev 这个 Skill 的描述自动激活对应技能。显式调用你在 prompt 里直接点名“用 frontend-dev 重构一下 /src/pages 下的按钮组件”。我个人的建议是高频且通用的技能比如代码审查、Git 提交规范让它自动匹配低频但流程固定的技能比如 LaTeX 排版、数学建模建议显式点名避免模型在早期判断阶段浪费 token。2. 11个顶级Skills逐个拆解下面这些 Skills 是我在本地反复用过、并且有真实产出效果的清单。没有按热度排序而是按照“最不值得错过”的顺序来。每个技能我都会说明它在什么场景下能顶一个人用以及装完之后需要改哪些配置。2.1 前端开发助手从设计稿到响应式页面这个 Skill 解决的是前端开发里最耗时的“从 0 到 1”阶段一套页面结构、组件拆分、样式体系。它会把 Tailwind 的配置文件和通用布局模式固化下来遇到需求时不用每次重新解释“我想要一个居中卡片、阴影、圆角”。我实测的场景是给它一张后台管理系统的截图要求“用 React Tailwind 实现同款布局”它能够直接给出组件树和样式代码连响应式断点都处理好。这里有个很重要的配置细节SKILL.md 里最好注明项目使用的框架版本否则它默认生成的内容会跟你的项目依赖冲突。# 典型调用 claude 用前端开发助手打开 design.png生成对应的实现代码技术栈是 React 18 Tailwind 32.2 代码审查专家把隐性问题拦在合并前代码审查 Skill 是我最推荐第一个装的。它不只是看语法错误而是围绕安全性、性能、可维护性三个维度做检查。比如未转义的 SQL 字符串、潜在的竞态条件、明显可以抽公共组件的重复代码它都能在提交前发现。这个 Skill 比较讲究“给多少上下文”。我通常的做法是配合git diff使用git diff HEAD~1 | claude -p 用 code-reviewer 审查这段变更按严重程度输出问题清单它的输出会按照Critical / Warning / Suggestion分级并且每一个问题都附带修改建议。相比人工 Review它最大的优势是稳定——不会因为 Reviewer 今天心情不好就漏掉细节。2.3 架构图与结构图生成一张图说清系统全貌写技术方案时最头疼的不是文字而是画图。这个 Skill 专门处理结构图、流程图、架构图的生成你描述系统模块和依赖关系它直接产出可在文档工具中渲染的图表代码例如 Graphviz 的 dot 格式或者 PlantUML。我在一个微服务项目里试过把服务列表、数据库、消息队列的关系讲了一遍它生成的架构图基本可以直接放进设计文档节点分组和依赖箭头都分得很清楚。配置时建议把常用约束写进 SKILL.md比如“图层从上到下接入层、业务层、数据层”这样出图才符合团队习惯。2.4 数据库设计与 SQL 调优专家表结构、索引一次拿捏这个 Skill 适合所有后端开发者。它内置了建表规范、索引设计原则和慢查询分析流程。你不需要把整个数据库交给它只要在 prompt 里描述业务场景它就能输出CREATE TABLE的 DDL、必要的索引建议以及数据量预估。另外一个很实用的子功能是慢查询分析把EXPLAIN ANALYZE的输出贴给它它会定位到是全表扫描还是索引失效并给出改写方案。配置要点是在 references 目录放一份你们团队自己的数据库命名规范这样生成的 DDL 能直接进入评审流程。2.5 图片处理与生成截图优化、图标生成、封面设计这个 Skill 面向的是“离不开代码但偶尔要处理图”的开发者。它通过封装本地的图片处理工具比如 ImageMagick 或 Sharp来实现图片缩放、格式转换、压缩、加水印等操作。遇到需要生成占位图或者简单图标时它也能用 SVG 代码快速搞定。我实际用它做过一次公众号封面在一张产品截图基础上自动加标题文字、调节对比度、输出 WebP 和多倍率版本整个过程只需要一行指令。它处理不了真正意义上的“AI 绘画”但日常开发里 90% 的图片需求它都覆盖了。# 示例批量压缩截图目录 claude 用 image-tools 把 ./screenshots 下的 PNG 全部转为 WebP质量压到 822.6 LaTeX 排版专家论文、简历、PPT 规范化如果你写过含公式的文档就知道 LaTeX 的排版工作量有多大。这个 Skill 会按照学术写作规范处理章节结构、公式编号、参考文献引用、表格浮动体。它最擅长的是把混乱的 Markdown 草稿转换成合规的.tex文件。中文场景下还有一个杀手锏功能自动处理中英文间空格、全角半角标点和字体配置。这些细节原本需要你去翻ctex文档现在它直接封装好了。配置时记得在 SKILL.md 里写明你的编译器路径和是否使用xelatex否则编译阶段可能白折腾一场。2.7 文档写作与翻译一份内容多语言输出技术文档维护里最烦的工作是同步多语言版本。这个 Skill 组织了一套“术语优先”的写作流程先把项目里的专业术语整理成术语表再按术语表进行翻译和撰写避免同一个词在不同文档里翻译不统一。它的另一个常用场景是改写把一段口语化的开发日志改成正式的技术公告或者反过来把官方的 Release Notes 改写成团队内部通俗版。相比直接在对话里说“帮我翻译”这个 Skill 的差异在于它会主动维护术语表并放在 references 目录里供后续调用。2.8 测试用例生成器覆盖率不再是嘴上功夫这个 Skill 会分析你的源码并生成单元测试和集成测试的骨架。它不只是简单地把每个函数调用一遍而是会考虑正常路径、异常路径和边界值。配置好测试框架后它会直接生成可运行的测试文件。我把它用在 Node.js 项目里效果最明显的场景是刚写完一个工具模块马上让它生成单元测试原本手动写用例要小半天现在几分钟就能跑起来。它还支持把“测试结果失败”回传给它让模型迭代修改测试用例形成一个小闭环。建议为每个语言框架单独准备一个 Skill 子目录比如test-generator-jest、test-generator-pytest避免描述冲突。2.9 Git 工作流助手提交信息、分支管理、冲突解决一条龙Git 操作命令记不全不用怕这个 Skill 更像一个“会规范动作的 Git 教练”。它会根据项目的 commit 规范Conventional Commits、Angular 规范等生成提交信息也能处理分支合并中的冲突给出每一步解决建议。让我觉得省心的是它能主动做检查提交前先跑 lint提交时把变更内容按模块拆分到多个 commit而不是一次性提交一大堆。配置时只要在 references 里放一份.gitmessage模板它就会严格按照模板产出提交信息。2.10 性能优化专家从日志定位到优化方案一步到位性能调优是最依赖“经验”的领域。这个 Skill 封装了一套系统性的分析流程先看日志和监控指标再定位瓶颈最后给出可验证的优化方案。它不会直接丢给你一句“建议加缓存”而是要求你先提供数据。实际项目里我试过把一份后端接口的耗时分析交给它。它给出的方向包括数据库索引缺失、N1 查询、无效日志输出每一条都有修改建议和预期收益。配置时你可以把公司的监控面板导出规范写进 SKILL.md比如“按 P50 / P95 分位展示响应时间”让分析结果更贴合你的真实环境。2.11 数学建模助手把模型公式变成可运行的代码最后一个适合算法工程师、数据分析师和参加建模比赛的学生。这个 Skill 覆盖从问题抽象、模型选型、公式推导到 Python 代码实现的全过程。你描述一个实际问题它会输出数学模型、必要的假设说明以及用 NumPy 或 SciPy 实现的求解代码。我拿它做过一个小型库存优化问题我把业务约束和目标函数讲清楚它先用数学语言建模再生成带注释的求解代码最后还会给出参数敏感性分析的思路。相比直接让模型写代码这个 Skill 强在“先建模、再编码”的顺序被强制固定下来不容易跑偏。3. 安装与配置从零到能用的完整路子前面把 11 个 Skills 讲完接下来是实操。这部分我会给出命令行安装、Skills 目录配置、VSCode 集成以及如何自己写一个最小可用 Skill 的完整步骤。3.1 命令行安装与初始化Claude Code 的安装方式我建议直接用官方包管理器方式执行后确认版本号npm install -g anthropic-ai/claude-code claude --version如果你不想通过 npm也可以去官方发布渠道下载对应的二进制包macOS 和 Windows 都有对应的安装方式。安装完成后第一次执行claude会引导你完成认证流程。这里有一个小建议装完第一件事是配置模型参数和权限策略。比如在交互式会话里执行claude config set --global model sonnet claude config set --global permissionMode acceptEditspermissionMode控制 Claude Code 是否可以自动修改文件。刚开始用不建议直接放开先让它输出方案、你确认后再改等信任度建立起来再切换。3.2 通过目录管理并配置 SkillsClaude Code 会自动扫描两个位置的 Skills用户级目录~/.claude/skills/项目级目录.claude/skills/放在你的项目根目录下用户级适合放通用技能项目级适合放和业务强相关的技能。推荐的目录结构是这样~/.claude/skills/ ├── frontend-dev/ ├── code-reviewer/ ├── latex-formatter/ └── ...安装一个 Skill 的方式很简单把 Skill 文件夹复制到上面的目录里然后重启 Claude Code或者在新会话中让它重新扫描。大部分第三方 Skill 都以 Git 仓库形式发布cd ~/.claude/skills git clone https://github.com/example/frontend-dev.git提示遇到无法定位到仓库的情况时可以在官网或社区搜索 Skills 合集包下载后手动解压到目录即可。本项目标题里提到的“superpower skills”就是社区命名的一个合集包概念本质上是把多个 Skills 打包分发方便一次性装完。3.3 VSCode 里的 Claude Code 体验如果你习惯在编辑器里干活那 VSCode 集成是必须配的。先在扩展市场搜索并安装 Claude Code 扩展安装后用快捷键CmdShiftPmacOS或CtrlShiftPWindows打开命令面板选择登录授权。安装完成后扩展会自动读取~/.claude/skills/目录。你可以在设置项里检查Claude Code Skills: Path是否指向正确的路径。VSCode 集成的好处有两个一是可以直接选中代码片段右键交给 Claude Code 处理二是会在侧边栏显示当前可用的 Skills 列表点名字就能在对话中激活对应技能。这对于像我一样记不住命令行的开发者来说比终端交互友好很多。3.4 从零编写一个最简单的 Skill5 分钟就能跑通把自己的工作流封装成 Skill 没有想象中复杂。我用一个“中文排版校对”的需求来演示这个技能在工作里非常实用。第一步创建目录和文件mkdir -p ~/.claude/skills/zh-copyreader cd ~/.claude/skills/zh-copyreader touch SKILL.md第二步编辑SKILL.md--- name: zh-copyreader description: 用于中文文本审校检查中英文空格、全角/半角标点、术语和数字写法。 --- # 中文排版校对 ## 适用场景 - 校对公众号文章、技术文档、博客中的中文排版 - 统一中英文混排规范 ## 校对规则 1. 中英文之间增加一个空格 2. 数字与单位之间保留空格 3. 中文语境下使用全角标点 4. 英文单词内部不得出现全角字符 5. 术语保持全篇一致优先使用项目术语表 ## 输出格式 先输出修改后的全文再附上修改点列表按原文 → 修改后 → 原因排列第三步保存后新建一个 Claude Code 会话输入用 zh-copyreader 校对一下 README.md如果 Skill 生效它会先读取README.md然后按照你的校对规则输出文本。这一点是我推荐所有开发者都尝试的把自己反复要做的事写成规则放进 SKILL.md等于把个人的经验沉淀成了可复用的资产。4. 使用技巧与组合工作流有了 Skills 不等于效率自然提升。我踩过几次坑之后总结出四个使用习惯以及一套从需求到上线的组合打法。4.1 让 Skills 真正好用的 4 个习惯第一个习惯是描述里写清边界。比如“帮我审查代码”这种说法太模糊要告诉它“审查 src/ 目录下本次变更的 JS 文件重点关注内存泄漏和错误处理”。描述越具体Skill 的触发越准确输出也越匹配。第二个习惯是完成任务后让它汇报依据。Skills 默认会直接完成任务并输出结果但我会在 prompt 里追加一句“给出结论对应的文件位置和行号”这样验证成本低很多。第三个习惯是把高频知识放进 references。比如团队的编码规范、接口命名规则、数据库字段类型约定。这些内容如果每次粘贴到对话里既累又容易抄错放进 Skill 的 references 目录后模型会在需要时主动读取。第四个习惯是关注 Skill 的更新迭代。很多 Skills 是开源社区维护的框架升级后旧版可能出现兼容问题。我一般每个月检查一次安装的 Skills 是否有新版本对长期不维护的直接淘汰。4.2 从需求到上线的组合工作流一次完整的项目实战单独使用 Skills 只是工具层面组合起来才是真正的工作流。我以一个内部工具系统的模块开发为例展示实际流程。需求是做一个带用户登录和简单数据报表的前端页面。我会按这个顺序调度技能用数据库设计专家生成用户表和报表表的 DDL以及索引建议用前端开发助手根据产品原型生成页面骨架用测试用例生成器给后端接口写单元测试和集成测试用代码审查专家审查整轮变更的git diff最后用Git 工作流助手按规范生成多个提交记录。整个过程里我做的事情从“自己写所有代码”变成了“调度多个专家并做最终确认”。这个切换是效率提升最明显的地方。第一次跑通之后这个流程可以沉淀成团队的标准流程新人照着走也能上手。4.3 在团队里分发和更新 Skills个人使用 Skills 很容易团队协作则要考虑分发机制。最朴素的做法是建一个skills私有仓库按目录组织所有 Skills然后让成员 clone 到各自的~/.claude/skills/下。更可控的方式是使用 Git 子模块或者专门的配置管理工具把 Skills 和项目代码绑定。我建议至少在团队里约定以下几点命名规范技能目录名统一用短横线连接如code-reviewer更新节奏重大更新要以 PR 形式发起Review 通过后合并文档要求每个 Skill 除了SKILL.md最好有一页说明文件写清楚适用场景和维护人。5. 常见问题与排查技巧实录这段时间我遇到的问题不算少整理几个最典型的给已经上手或者准备上手的你做个参考。5.1 Skills 不生效先查三件事第一种情况是最常见的明明把 Skill 放进目录了但对话里怎么点都不生效。我建议按下面顺序排查目录名和name字段是否一致。Claude Code 对名字大小写敏感Frontend-Dev和frontend-dev会被视为两个不同的技能。description是否写得足够清楚。如果你的描述用词和日常工作语言差别很大模型可能根本不会触发它。试试把“前端页面生成”改成“根据设计稿或需求描述生成 React / Vue 页面”。是否有权限限制。一些 Skill 会调用脚本或者修改文件如果你在配置里把权限设成了只读它可能会报错或者静默跳过。5.2 工具调用超时与上下文溢出的应对当任务步骤很多时我遇到过 Claude Code 在某个工具调用上超时或者输出到一半上下文用完的情况。这不是单一 Skill 的问题而是任务规划的问题。应对方法有三个。一是把大任务拆成小任务比如“优化整个模块性能”拆成“先分析接口耗时”和“再优化数据库访问”。二是在 prompt 里限定返回格式要求它只输出关键代码和总结不用把全部文件内容回显一遍。三是用--max-turns参数控制迭代次数防止它在某个问题上循环调用工具。# 限定最大对话轮次 claude --max-turns 20 用 code-reviewer 审查本次变更5.3 排查速查表我把日常遇到的异常情况整理成了一个表格方便你直接对照现象可能原因处理办法Skill 没有出现在可用列表目录路径不对确认SKILL.md位于~/.claude/skills/name/下模型不触发已安装的 Skilldescription 关键词太模糊重写 description覆盖常见表达方式执行到一半提示权限不足权限模式限制检查permissionMode按需开启acceptEdits输出内容与 Skill 规则不符上下文被其他任务占用新开会话显式调用 Skill 名称调用脚本时报错脚本依赖缺失查看scripts/目录按 README 安装依赖长任务中途超时单轮迭代过多拆分任务或调大--max-turns注意排查的时候多看 Claude Code 的执行日志里面会记录每次工具调用的开始、结束和错误信息大部分问题不需要猜看日志就能定位。最后再分享一点个人体会Skills 不是装得越多越好。我见过有人一口气装了几十个结果模型在匹配阶段经常被干扰反而影响响应速度。我的建议是先从两三个真正贴合自己工作的开始比如后端开发就从“数据库设计专家”和“代码审查专家”入手用顺手了再逐步扩展。技能这东西最终还是要靠实际项目养出来。
