2026-03-18
今天凌晨1点30,Claude Code核心开发者Thariq Shihipar发布了,官方Skills教程和小技巧。
其实Claude内部自己人早就把 Skills 玩透了,团队里现在活跃的Skills就有上百个,踩过的坑、摸出的门道都特别多。
所以,Thariq就是想把这些宝贵的开发经验分享给咱们。

Skills到底是啥
很多人刚接触Skills,都会误以为它就是个普通的markdown文件,其实真的错了,这也是最容易踩的第一个误区。
Skills本质上是一个文件夹,里面能塞脚本、资源、数据各种东西,Claude能自己在里面找东西、研究内容、还能动手操作,这才是它的核心价值。
而且在Claude Code里,Skills还有超多配置选项,比如能注册动态钩子,不少真正好用的 Skills,都是把这些配置和文件夹的结构玩出了花样,不是单纯写几行文字就完事的。
如果是刚入门的朋友,建议先看看官方文档或者Skilljar上的Agent Skills课程,基础打牢了后面玩起来才顺。
9大高效开发Skills的技巧

1.别写废话,只给关键信息
Claude Code本身就是个编码高手,对公司的代码库和通用规范早已烂熟于心。写 Skill 时千万别画蛇添足,去教它那些基础的、人人都懂的代码知识。要把笔墨花在那些能打破它常规思维的信息上。
比如Anthropic自家的前端设计Skill,核心不在于教怎么写页面,而在于给 Claude 灌输高级审美,帮它避开那些用烂的字体和俗套的渐变。记住,只有这种反常识、反惯性的高维信息,才是Skill里的真黄金。
整个Skill里含金量最高的部分,绝对是“注意事项”板块,没有之一。你得把Claude 每次干活摔过的跤、踩过的坑,统统整理进去。
这就像是给AI 打了预防针,让它下次遇到同样的陷阱能条件反射般地绕道走。
而且这个板块不能是一锤子买卖,得长期更新,每发现一个新问题就加进去,久而久之,这个 Skill 就会进化得越来越完美,出错率直线下滑。
别把 Skill 仅仅当成一个 markdown 文本文件,它本质上是个文件夹,是能装各种资产的容器。你要学会利用文件系统做“渐进式披露”,告诉 Claude 哪个文件夹里有什么,它会在需要的时候自己去翻。
比如把复杂的函数签名扔进api.md,把输出模板塞进assets目录,再分门别类建好脚本和示例文件夹。
这样 Claude 干起活来井井有条,效率比你把所有东西都堆在一个文件里高得多。
Claude 本身就很听话,但这不代表你要把它框死。Skill 是要复用的,如果你的指令写得事无巨细、僵化死板,换个场景就废了。
给指令时要抓大放小,只提供核心的必要信息,给它留出根据实际情况灵活应变的余地。
这样一来,一个 Skill 就能适配多种复杂场景,省去了你为每个小变动都重新造轮子的麻烦。
想要Skill越用越聪明,就得给它装个大脑。利用日志文件、JSON 甚至 SQLite 数据库,把每次运行的结果存起来。
比如那个写站会报告的Skill,正是因为存了历史记录,它才能分辨出今天和昨天有什么不同,只输出真正的增量信息,而不是每次都输出一堆废话。
不过记性好也得防盗,数据别存在Skill目录里,升级时容易被误删,用 ${CLAUDE_PLUGIN_DATA} 这个稳定路径才安全。
有些Skill需要用户提供特定信息才能跑起来,比如往 Slack 发消息得知道发哪个频道。
别让用户每次都重复填,最佳实践是在目录里建个config.json,第一次询问后就把配置存下来。
要是想让用户做选择,还能调用AskUserQuestion工具出个结构化的多选题。这种一次设置、终身受益的体验,才是专业 Skill 该有的样子。
给 Claude 现成的脚本和函数库,是提升效率的大杀器。这样它就不用每次都哼哧哼哧写那些重复的样板代码,能把算力集中在组合功能和决策下一步上。
比如在数据科学Skill里预置一套取数函数,Claude就能根据你的需求现场编脚本、组合功能,哪怕是“查查周二系统发生了啥”这种复杂需求,也能秒出结果。
Skills支持按需激活的Hooks,这功能用好了能救命。有些规矩不适合一直开着,但在特定场景下必须得有。
比如操作生产环境时,开启 /careful 钩子,能强行拦住 rm -rf、删库跑路这种高危操作;调试时开个 /freeze,只准在指定目录加日志,防止手滑改坏其他代码。
这种平时不碍事、关键时刻能兜底的机制,既安全又不影响日常效率。
Skill的终极形态是团队资产。小团队可以直接往仓库里提交,简单粗暴;大团队最好搭个内部插件市场,让大家按需安装。
Anthropic现在的玩法很野,没有中心化审核,谁觉得好用就传到沙盒,在群里吆喝一声,只有那些真正经过群众考验、热度够高的 Skill,才能通过 PR 进入正式市场。
这种方式既保证了质量,又让真正的好东西能快速在团队里流动起来。
九大类实用Skills
Claude把团队里的Skills全梳理了一遍,发现好用的Skills其实都能归到固定类别里,反而那些设计得乱糟糟的,大多是跨了好几个类别没找准定位。大体上主要分为9大类。

库与API参考类
这类就是给Claude做专属使用手册,不管是公司内部的库,还是那些Claude自己处理起来容易出问题的通用库、CLI、SDK,都能做这类Skills。
里面放些参考代码片段,再把常见的坑列出来,Claude写脚本的时候就能直接避开,不用再反复踩雷。比如内部的账单库、平台CLI的使用示例,甚至是公司的设计系统规范,都能做成这类Skills,让Claude精准贴合团队需求。
产品验证类
做开发最头疼的就是验证代码好不好用,这类Skills就是专门解决这个问题的,一般会和playwright、tmux这些工具配合使用,能让Claude自己完成测试验证。
别小看这类Skills,Anthropic说投入一个工程师一周的时间打磨,性价比超高,能从根本上保证Claude输出的代码是能用的。
比如让Claude在无头浏览器里走完注册到新用户引导的全流程,每一步都验证状态,或者用测试卡测试结账流程,确认发票状态,这些操作都能交给这类Skills搞定。
数据获取与分析类
现在做开发都离不开数据,这类Skills就是Claude的专属数据连接器,能直接对接公司的数仓和监控系统。
里面可以放带权限的查询库、仪表板的ID,再写清楚常用的查询方法和工作流,Claude就能自己取数、做分析了。
比如想查注册到付费的转化漏斗,不用自己写关联语句,Claude能直接通过这类Skills找到对应的数据表和查询方式。
想对比两个用户群的留存率,它也能直接标记出有意义的差异,比自己手动查效率高多了。
业务流程与团队自动化类
把团队里那些重复的活打包成一个命令,这就是这类Skills的核心作用。比如每天写站会报告,要整合工单、GitHub记录、Slack消息,做个Skills就能让Claude自动聚合,只出变更内容;
每周写复盘,合并的PR、关闭的工单、部署记录,它也能一键整理好。
这类Skills指令一般都不复杂,但可能会依赖其他Skills,把运行结果存到日志里,还能让Claude保持输出一致,回头看之前的执行情况也方便。
代码脚手架与模板类
写样板代码是开发里最枯燥的活,这类Skills就是Claude的代码生成器,能针对代码库的特定功能,直接生成框架级的样板代码。如果脚手架的需求需要自然语言描述,没法纯用代码实现,那这类Skills的作用就更明显了。
比如想基于公司的框架搭新服务、写数据库迁移文件、创建内部应用,这类Skills能直接把认证、日志、部署配置都预装好,不用再从头写起,省下来的时间能做更多核心工作。
代码质量与评审类
想让团队的代码质量保持统一,这类Skills就是刚需。它能在公司内部推行代码规范,还能辅助做代码评审,里面可以放些确定性的脚本和工具,保证稳定性。
甚至能把它集成到GitHubAction里,自动运行,不用人工反复检查。比如让Claude启动一个“第三方视角”的子智能体做评审,一直优化到只剩小细节问题。
或者强制推行代码风格,把Claude默认处理不好的规范重点优化,从源头减少代码问题。
CI/CD与发布类
代码的拉取、推送、部署,全流程都能靠这类Skills提效,它还能引用其他Skills的内容,整合数据完成全流程操作。比如监控PR的状态,CITask失败了自动重试,有合并冲突了自己解决,最后还能开启自动合并。
部署服务的时候,从构建、冒烟测试,到慢慢放流量、对比错误率,一旦出问题自动回滚,整个流程不用人工盯着,省心又不容易出错。
运行手册类
线上出问题的时候,这类Skills就是Claude的专属排障手册。只要给它故障症状,比如Slack里的告警、系统的错误特征,它就能调用多个工具联合排查,最后还能生成结构化的排障报告。
比如公司高流量的服务出问题,它能根据症状匹配对应的排查工具和查询方式;拿到告警信息,能自动排查常见故障点,把结果整理清楚,大大缩短排障时间。
基础设施运维类
日常的运维工作,还有那些有风险的操作,都能交给这类Skills,里面可以设置防护机制,避免误操作。
比如发现集群里孤立的pod或者卷,能先在团队群里发通知,等一段时间确认后再自动清理。
处理依赖包的审批、排查存储或流量费用激增的原因,这些运维工作都能标准化,让工程师不用再反复做重复操作,还能保证遵循最佳实践。
其实说到底,想要真正用好Skills,最关键的就是动手去做,别害怕试错。Anthropic自己的大多数Skills,一开始也只是几行代码,加一个注意事项。
后面随着Claude遇到的边缘案例越来越多,团队不断补充内容、优化细节,才慢慢变成现在的提效神器。
想系统掌握AI核心技能、获取行业认可资质?
CAIE注册人工智能工程师认证
助你拓宽职业赛道,成为AI领域持证实力派
企业、高校及渠道合作
请联系微信:FYLlaoshi

完 谢谢观看
