SuperAPI AI 工具集

skill-authoring

智能体与模型

查看项目

更新于 10-15 23:58

技能介绍

用途:创建、修订或审查技能(skill)文档,使常驻指令保留在 SKILL.md 中,细节仅在对应动作点加载,让具备中等能力的智能体无需隐藏上下文或专家推断即可执行。

主要能力:规定预算(frontmatter 描述目标 1–3 行、硬上限 280 折叠字符;SKILL.md 硬上限 200 行、词预算 1800、目标 600–1500;引用文件硬上限 200 行、词预算 1800、目标 300–1200,仅行数上限会导致审计失败);给出规范结构(frontmatter 的 name/description、Always、Do、Load if needed、Stop if、Output);要求渐进式披露、单一权威来源、安全关键指令就近重复、正向表述动作;提供 Pruning Gate 与 Consumer Followability Gate 两道完成前检查;支持 review 与 create/revise 两种模式,并可用脚本审计:${SUPER_DEVELOPER_PLUGIN_ROOT}/skills/skill-authoring/scripts/audit-skill.py <skill-dir-or-SKILL.md>。

使用方式:先确定模式与授权范围,检查仓库指令、目标技能及其引用/脚本、现有技能清单与共享契约;识别用途、目标智能体、成功条件、输入、触发与近似误触发、目标宿主与调用策略;选择执行面(独立直接、编排者加工作者契约、显式混合);再起草 frontmatter、设计消费者工作流、撰写规范章节、按需添加引用与脚本,最后跑两道门与审计脚本并解决所有错误。

适用场景:新增、重写或结构性审查技能文档时。

限制:目的、目标智能体、触发、输入、输出、宿主或调用策略在一次澄清后仍不明确时应停止;无法从权威宿主证据证明 user-only/model-only 限制时停止;执行面无法从可见任务行为判定时停止;诚实压缩后仍超硬上限、引用无具体父加载条件或形成隐藏二次跳转、重复其他技能而非按名调用、确定性校验失败或干跑暴露重大猜测时停止。审查模式只报告不修改文件。