SuperAPI AI 工具集

skill-authoring

通用与其它

查看项目

更新于 10-16 03:39

技能介绍

用途:规范与改进可复用智能体技能。适用于新建 SKILL.md、优化已有技能的名称与描述、判断技能过宽或过窄、审查本地技能集合的冗余与触发重叠、把大型技能拆成 SKILL.md 加 references/、assets/ 或 scripts/,以及设计评测提示词验证触发与行为。不适用于与技能无关的通用文档写作、README 润色或营销文案。

主要能力:编写高质量名称与描述,把真实触发语境放进 description 而非只写在正文;设计渐进式披露,让主 SKILL.md 在触发后明确改变智能体行为,深层内容放入引用文件按需加载;用路由表决定读哪个参考文件,避免默认加载全部;对技能集合进行集合级审查,检查重叠、重复、触发边界与渐进披露;基于证据给出具体文件引用与改写建议。

必要用法:先判定任务类别(新建、审查、改进触发质量、结构或评测);优先打磨名称与描述;按任务查阅对应参考文件,如 frontmatter-patterns.md、structure-patterns.md、templates.md、repo-skill-review.md、cloudbase-skill-review.md、evaluation.md、examples.md。针对 config/source/skills 的审查还需应用仓库基线与 CloudBase 特定规范。若技能随 plugin/cloudbase 发布,需编写 plugin/cloudbase/skill-metadata.json 并运行 npm run build:skill-manifest。完成后创建应触发与不应触发的评测提示词,运行并迭代。

适用场景:面向 CloudBase 等仓库管理型技能集的审查;拆分大型技能;评测技能触发与行为是否正确。

限制:不处理技能以外的文档与规则文件;不得添加面向智能体的远程技能抓取 URL,同级路由应保持本地相对路径(如 ../other-skill/SKILL.md),缺失同级时提示用户安装完整插件包;面向市场的安装文档不得凭源码树臆测公开路径。提供的自检清单要求名称简短稳定、描述同时说明能力与触发条件、明确不适用场景、路由正确,并能说明与最近邻技能的差异。