SuperAPI AI 工具集

skill-designer

智能体与模型

查看项目

更新于 10-30 10:24

技能介绍

Skill 设计师是一个围绕 AI Skill 设计质量的方法型工具,核心主张是「设计有用的 skill,不设计没人用的 skill」。

用途与评估:动手前先回答三个筛选问题:没有这个 skill,结果会变差吗;这个 skill 会被用 5 次以上吗;Claude 直接回答不了这个问题吗。三个问题都通过才继续设计,用于快速判断一个功能是否值得做成 skill。

三层结构:Level 1 为 YAML frontmatter,负责触发机制,始终加载;Level 2 为 SKILL.md 正文,存放执行指令,触发时加载,控制在 500 行以内;Level 3 为 references/,存放深度参考,按需读取。资料强调 Level 1 最重要,description 写不好会导致 skill 永不触发。

Description 写法:一句话说清 skill 做什么,列出 Use when 触发词(至少 10 个,覆盖精确与模糊表达)、Use for 具体场景,以及 Use other skills for 相邻场景分流。写完后用 10 个查询测试(5 个应触发、5 个不应触发),确认准确率超过 90%。

正文写法:示例比规则有效,先写例子再写规则。示例包含输入(真实、具体、带背景的用户请求)和输出(理想响应),需满足具体、现实、边缘三个标准。

迭代与测试:循环为草稿、测试 3 个案例、用户看输出、改进、重复,每轮目标是在测试案例上提升 20% 通过率。三个测试案例分别为理想输入、边界输入和近似输入(容易触发但不该触发)。

常见问题与修法:触发太宽时缩窄 description 并增加分流说明;触发太窄时补充触发词;输出格式不对时增加输出模板或示例;什么都想做时拆分 skill,每个只做一件事。

分工定位:skill-org 从目的出发设计完整组织架构与 JD 并编译成 skill 文件;skill-designer 负责快速评估和迭代已有 skill,专注触发精度与输出质量。有现成 skill 需要改进时使用本工具,从零设计 Agent 分工体系则使用 skill-org。