SuperAPI AI 工具集

skill-doc-authoring

智能体与模型

查看项目

更新于 10-15 20:25

技能介绍

用途:把用户的工作流、SOP 或重复性流程整理成一份 agent 能真正触发并遵循的 SKILL.md,避免两类失败:描述太弱导致技能从不触发,或正文含糊导致触发后无帮助。

文件契约:目录名与 name 必须一致,小写、仅连字符、不超过 64 字符;文件名必须精确为 SKILL.md(区分大小写);frontmatter 只有 name、description 两个键,description 不超过 1024 字符;路径为 skills/<skill-name>/SKILL.md。

描述即触发:agent 仅凭 description 决定是否加载技能。用第三人称,先写做什么,再写“Use when …”,给出用户真实会输入的具体说法与场景,并写明何时不该使用,避免与相近技能触发重叠。

正文结构:面向无项目上下文的 agent,简洁、命令式、面向决策。包含标题与一行目的,以及 When to use(含何时不用)、Procedure / The loop(编号、具体、带命令)、Quality bar(如何判断做对了)、Anti-patterns(诱人的错误做法)。规则:用祈使句;每步可验证或有具体命令/示例;删去 Notes、Overview 等填充与重复;长参考资料放同级文件并链接,SKILL.md 保持可略读(约 200 行以内)。

流程:从用户处提取真实步骤、决策与标准;识别触发点;起草描述并做触发测试;按结构写正文;校验文件名、name/目录一致、frontmatter 键与描述长度;用 2–3 个样例请求做无上下文心智演练。

限制:资料未提供具体安装命令、收费、平台或效果信息。