一个文件夹 + 一个Markdown文件 = 你的第一个Skill

上个月我被临时抽调去支援一个“代码抢救”项目——一个迭代了四年的支付模块文档约等于零单元测试覆盖率不到 20%原班人马跑得就剩一个刚转正的哥们儿。leader 让我带着他把核心接口的单元测试补齐我一打开那个 repo头皮就麻了。就在那几天我头一回被一个东西救了命一个文件夹加一个 Markdown 文件。我把项目的代码规范、历史踩坑记录、需要重点测试的边界条件全塞进去然后丢给 AI 助手它突然就“懂了”这个项目生成出来的测试用例质量吊打我手写了三天的版本。那个东西就叫 Skill。今天这篇我手把手带你从零写出你自己的第一个 Skill不需要写一行代码5分钟搞定。一、Skill 到底是什么你先别想复杂了在很多 AI 工具里Skill 本质上就是一个“能力封装包”。你平时跟 AI 对话每次都得交代背景“我是后端开发”“用 Java 17”“项目遵循阿里巴巴规范”“这个模块是支付回调表结构长这样”……一套话重复无数遍。Skill 干的事特别朴素把这堆上下文、规范、知识、提示词打包成一个文件夹以后要用的时候一键加载。 它就像你给一个聪明绝顶但失忆的实习生配了一本随身携带的《项目生存手册》。你只需要做到两点新建一个文件夹里面放一个 SKILL.md 文件。完事儿。二、动手5分钟做出你人生第一个 Skill别急着怀疑先跟我走一遍流程。我用的是 Claude 的 Skills 功能如果你用其他平台思路完全通用核心就是这个文件结构。第1步新建文件夹在你的电脑上随便找个地方建一个文件夹名字就叫 my-first-skill。名字无所谓别带中文空格就行。第2步创建 SKILL.md在文件夹里新建一个 Markdown 文件文件名必须叫 SKILL.md大小写也别错。打开 SKILL.md粘贴下面这段内容name: code-review-assistantdescription: 根据团队 Java 编码规范对提交的代码片段进行深度审查输出改进建议和风险点。角色定义你是一名资深 Java 后端工程师精通代码审查熟悉阿里巴巴 Java 开发手册对并发、性能、安全有极致敏感度。审查规则逐条检查以下规范命名是否符合驼峰规范避免拼音与英文混用并发场景下是否正确使用锁或线程安全集合数据库操作是否考虑事务边界和 SQL 性能异常处理是否避免吞掉原始异常打印必要堆栈集合操作是否考虑判空避免 NPE对每一个发现的问题给出严重等级高/中/低和修改建议示例。如果没有发现问题回复“未发现明显问题但建议补充相关单元测试”。保存搞定。第3步丢进 Claude 试试在 Claude 的聊天界面里点输入框左侧那个小回形针或者加号选择 “添加技能” 或者直接把这个文件夹拖进去。不同版本的入口可能叫“Upload Skill”或“Load folder as skill”你找到就行。加载成功后直接发一段你最近写的代码过去然后看它怎么审。我上周随手喂了一段自己写的 Redis 分布式锁释放逻辑它立刻指出 finally 块里没有判断锁是否属于当前线程就直接释放还给了带 Redisson 的对比写法——比我同事 review 还狠。三、光有指令还不够把资料扔进去上面那个只是开胃菜。Skill 真正厉害的地方在于它不仅能装提示词还能把整个知识库带在身上。回到我开头说的那个支付项目我是这么操作的在 my-first-skill 文件夹里除了 SKILL.md我额外建了一个子文件夹叫 docs里面塞了三样东西payment_flow.md —— 我从代码里扒出来的支付状态流转图db_schema.sql —— 核心表结构known_issues.md —— 近半年线上故障复盘记录然后修改 SKILL.md在里面加上一句项目背景参考请在分析本项目的任何代码前务必阅读 docs/ 目录下的所有文件作为上下文基础。再次加载这个 Skill我让它“根据退款接口代码和已知问题生成 P0 级的回归测试用例”。它把半年前因为状态机并发导致重复退款的那个坑都覆盖进去了那一刻我真觉得这哥们儿比我还懂这烂摊子。本质就是你喂给它的私有资料越多它在这个狭窄领域里的表现就越接近一个贴着工牌的内部专家。四、一线老兵的几个私藏心法这东西上手实在太简单但想用好有几个点我跟周围同事反复踩坑后才琢磨明白① 提示词别写“正确的废话”见过很多人把 Skill 提示词写成高考议论文通篇“你是一个专业的、细心的、负责任的工程师”。这些形容词对 AI 来说约等于噪音。直接下命令、给规则、举反例。 比如“禁止吞掉原始异常必须用 log.error 打印完整堆栈”比“请你注意异常处理”有效一百倍。② SKILL.md 的 YAML 头一定要写对name 和 description 不是给自己看的是给 AI 调度器看的。描述写得越精准AI 才知道什么时候该自动调用你这个技能。比如 description 写“审查代码”那它只会在代码审查场景被激活。别写个“帮我干活”这种泛词否则你的 Skill 会被 AI 拿去在写诗的时候也尝试加载闹笑话。③ 把 Skill 当成代码来管理我现在所有项目都有一个 .skills 目录里面放几个不同的 Skill 文件夹然后用 Git 管起来。团队新人入职拉一份仓库把技能文件夹一加载直接具备老员工的八成功力。跨项目复用也简单把文件夹复制粘贴过去就行接口统一就是 SKILL.md。④ 调试 Skill 的唯一真理迭代没有一个 Skill 是一次写对的。我的做法是先跑 10 个真实场景的输出把不符合预期的地方截图记下来回到 SKILL.md 里补规则、加禁止项。一般改过三四轮之后这个 Skill 才会进入“有点靠谱”的阶段。五、别让你的知识烂在脑子里写完第一个 Skill 那天晚上我发了个朋友圈配图就是那个文件夹截图文案是“从业十年头一回能把脑子里的经验用一个文件夹完整地甩给 AI。”后台好几个老同事私信问我怎么搞我把文件夹直接打包发过去他们加载完就能用。这种传递方式比写 Wiki、做培训痛快得多——毕竟写 SKILL.md 只需要你会用 Markdown而分享一个可执行的“能力单元”只需要复制一个文件夹。你不需要什么工程化平台不需要学 LangChain不需要申请服务器资源。你面前这台电脑建个文件夹写个 Markdown就拥有了你的第一个 AI 技能。别光看现在就试试。从你最常跟 AI 抱怨的那句话开始——把那句“你每次都记不住我们用 Java 8 和 MyBatis”写进 SKILL.md你会回来谢我的。本文部分内容参考了霍格沃兹测试开发学社整理的相关技术资料主要涉及软件测试、自动化测试、测试开发及 AI 测试等内容侧重测试实践、工具应用与工程经验整理。