Skill Description Pattern — 触发条件型描述
Tw93(HiTw93)于 2026-04-29 分析 52 个 skill 后发现关键教训:skill description 的写法决定调用率。
核心发现
80.8% 的 skill 是"装废的",原因是 description 写成"功能介绍型"。
| 类型 | 示例 | 效果 |
|---|---|---|
| 功能介绍型(错误) | "用于 X / X workflow" | AI 主线程看不到何时该调用 |
| 触发条件型(正确) | "当遇到 Y 情况时,执行 Z" | AI 主线程知道何时触发 |
工程含义
Skill 不是功能列表,而是决策触发器。Description 应该回答"什么时候用这个 skill",而不是"这个 skill 能做什么"。
与 Harness Engineering 的关系
这验证了 Harness Engineering 的核心原则:约束比指令有效。一个清晰的触发条件是可执行的约束;一个功能介绍是可解释的指令。