SuperAPI AI 工具集

skill-authoring

智能体与模型

查看项目

更新于 10-16 02:10

技能介绍

Skill Authoring 是一套用于创建、审计和整合 Agent Skills 的元技能,遵循 Agent Skills 开放标准,最终交付一份经过起草或修复的技能以及审查清单。它的目标是通过渐进式披露、强上下文指针、可检查的完成标准和单一来源的行为,让 Agent Skills 变得可预测。

用途

该技能面向需要编写或维护 Agent Skill 的作者,用于从零创建技能、审查与修复既有技能,以及把重叠的技能整合为更少的技能。

主要能力

方案给出一组设计原则。第一,每个触发短语只对应一个技能:一个技能只声明用户可能会说的一件事;若两个技能会回答同一句话,它们就是一个技能;若一个技能回答多个不相关的语句,它就是多个技能。第二,按动词拆分而非按名词拆分,因为动词负责路由,名词会相互碰撞,例如 create 和 refine 是两个技能,而 Feature、Epic、Story 属于一个能推断类型的技能。第三,按误路由的代价来权衡拆分:误路由会导致错误写入的地方应合并,会导致明显错误答案的地方应拆分,因为只读的误路由立即可见,而错误的变更不然。第四,如果技能需要用一个消歧子命令,那就说明它其实是两个技能。第五,把每个分支都要走的步骤放在 SKILL.md,把仅分支需要的参考资料放在指针之后,并由指针说明何时去读。第六,引用保持一层深度并可独立使用。第七,描述保持在 1024 字符以下,技能正文保持在 500 行以下,行数限制只约束 SKILL.md,同时也要测量整个目录,并以“调用者需要学习哪套词汇”来最终判断,一个触发短语让调用者只承诺一套词汇。资料提到本包中有两个技能总行数分别达到 4,029 行和 7,784 行,而它们的 SKILL.md 仍然合规。第八,把确定性的校验与转换放进脚本。

关于重复,方案主张按层判断而不是按数量判断。提示词重复是禁止的:当同一套指令、协议或领域规则出现在两个技能中时,若无人拥有它则抽取一个参考技能,若某模块已拥有则强制使用既有接口,若它是规则而非能力则只记录一次;抽取的阈值是两个调用方,只有一个调用方意味着它属于其拥有者内部。代码重复是预期存在的:捆绑脚本是自包含的,以便技能可以单独安装,因此应复制辅助代码而不是跨越边界去引用。运行时智能体在任意仓库中需要的规则必须放在技能里;某个仓库自己的 AGENTS.md、决策记录和术语表只约束该检出内的工作,不会随已安装的技能一起迁移,因此引用它们的技能对每个安装者都是坏的。

命名方面,名称描述其主体,按领域再加动词命名,并与技能声明的触发短语一致,例如 <domain>-create、<domain>-review;同级技能对同一事物使用同一个词。应以“技能是关于什么的”来决定名称:关于某一产品或系统的技能取该产品的名字,真正通用的技能取通用名字,即使它与产品专属技能一起发布;夸大范围的前缀比没有前缀更糟。名称是给人看的,出现在文件夹已消失的扁平列表中;路由是另一个问题,由描述解决,应保留字面专有名词(项目键、仓库名、文件名、工具名、示例标识符),因为字面 token 是最强的锚点。这种锚定依靠存在性生效,所以绝不要为了否认而把字面量放进描述;“像 ABC-123 这样的键不是 sprint”会让技能恰好成为它所拒绝请求的候选,应改为不带该 token 地陈述排除,例如“作用于团队和看板,绝不对单个 issue key 生效”。

在宿主仓库内工作时,设计技能前应先阅读仓库声明的约定,通常是 AGENTS.md、术语表和决策记录;它们约束你即将编写的技能,但在技能安装后不再约束它,因此写进技能的任何内容都不能依赖于能否读到它们。若仓库发布了一个集合,应预期它定义了哪些技能由人调用、是否适用名称前缀、技能如何组合、成员清单放在哪里以及测试保护什么,并遵循其答案。

使用方式

该技能采用条件引用,每次只加载一个分支,该分支自己的指针会说明后续需要的规范、描述、架构、脚本或质量参考。读 references/create.md 用于面试、起草并审查一个新技能,对应“create a skill”“draft a SKILL.md”“package this expertise”。读 references/audit.md 用于审查、修复或诊断既有技能,对应“why does this never trigger”“check this SKILL.md”“improve this skill”。读 references/consolidation-guide.md 用于把重叠技能合并为更少的技能,或测试某次合并是否已经过度,并需通过 references/create.md 中的 Phase 5 审查来完成。创建或面试式起草依赖一个名为 /grilling 的面试技能,在起草前对范围做压力测试;如果宿主无法按名调用它,应在起草任何内容前停下并说明创建以它为前提。审计和整合除非开启面试,否则不需要它。

适用场景

适用于需要按 Agent Skills 开放标准编写新技能、诊断既有技能为何不触发、改进 SKILL.md,以及合并重叠技能的场景。

完成标准

当所选分支的审查清单通过、每个被引用的资源都能解析、没有行为以旧技能名继续重复,并且每个被修改的 .py 文件都通过宿主 linter 时,工作即告完成。

限制

该技能创建或面试式起草依赖 /grilling 面试技能,宿主无法按名调用时创建被阻断。技能正文的行数限制只针对 SKILL.md。技能的规则不能依赖某个仓库的 AGENTS.md、决策记录或术语表,因为这些不随安装迁移。资料未提供具体安装命令、收费或价格、支持平台等事实,暂未提供。