什么时候值得做成 Skill
当你连续几次复制同一段多步骤要求,而且这些步骤有稳定的输入和输出时,就适合整理成 Skill。若只是一个项目事实,比如“测试命令是某个命令”,可以先写入项目说明。将复杂流程与长期事实分开,之后更容易维护。
官方文档说明了 SKILL.md、项目技能目录和调用方式,详见Claude Code Skills。下面是一个原创的页面验收练习,目标是产出检查记录,而不是自动发布。
一个最小示例
在项目的 .claude/skills/page-review/SKILL.md 中写入技能用途与执行要求。前置信息使用 YAML,例如设置 description 为“检查本项目页面改动,输出可复现的问题与验证记录”。正文可以这样写:
输入:本次修改的页面和验收目标。先阅读变更涉及的文件与项目运行说明。启动页面,检查正常输入、错误输入、窄屏布局和键盘操作。每个问题记录复现步骤、实际结果和预期结果。输出已验证的项目与未验证的项目;没有证据时不要写通过。不在这个流程中自动发布网站。
这个示例的重点是定义输入、检查动作和输出证据。只写“请做到最好”无法判断技能有没有发挥作用。
如何测试是否有效
准备一个已知有问题的小页面,比如必填字段为空时没有提示。先用普通指令做一次检查,再调用 /page-review 运行技能,比较是否识别同一个问题、是否给出明确复现步骤。
还要准备一个没有该问题的页面,避免技能机械地重复同一条批评。修改技能时只调整一处要求,再复跑这两种样本。这样比不断增加长篇规则更容易找到有效部分。
Skill、MCP 和插件的区别
Skill 主要描述如何完成任务;MCP 通常连接数据或工具;插件可以打包多种扩展资源。安装 Skill 不等于它拥有数据库、邮箱或发布系统的访问权限。需要外部连接时,单独核对工具来源与授权范围。概念对照可参考官方功能概览。
怎样避免技能越来越难用
把频繁使用的步骤留在正文,把长参考资料放在独立文件;明确哪些步骤必须执行、哪些取决于输入。每次修订记录一个真实失败案例,删除已不适用的旧规则。技能应随着项目变化更新,而不是越长越好。
第一次使用 Claude Code,可以先读入门指南。如果担心检查流程重复读取大量资料,结合费用与用量说明限制不必要的任务范围。