04 · Skills 工程

从"能用"到"能发布"的技能设计

📚 《Claude Code 进阶玩法》第 4/20 篇 · 下一篇：05 · Hooks 实战场景库

skill 的解剖：描述决定触发，正文决定质量，脚本决定确定性。

01 触发调优

描述里写清"何时用/何时不用"——描述太宽（"处理文档相关任务"）会劫持别的活，太窄则永远不触发。用 10 个任务的固定测试集测触发率。

02 渐进披露

高频流程进正文，低频细节拆到 reference 文件按需读——500 行操作细节全塞正文，每次触发都白烧 token。

03 确定性下沉

能用脚本保证的（格式转换/校验），写成脚本让 skill 调用——把"祈祷模型做对"变成"脚本保证做对"。

04 动手

把一项重复工作流做成 skill，测 10 任务触发率 → 验收：≥8/10。

05 小结

skill 是可分发的能力单元。下一篇给流程装卡点。

📎 实战案例

某 skill 描述写太宽（「处理文档相关任务」），别的活儿也被它劫持。开发者补清「何时用/何时不用」、把 500 行细节拆到 reference 按需读、用 10 任务测触发后，触发准确率到 9/10。

踩坑

• 我的 skill 描述写太宽，别的任务频频被它劫持——"何时不用"救了我。
• 全部细节塞正文，触发一次烧几千 token——渐进披露是设计不是优化。