SuperAPI AI 工具集

skill-artifacts

设计与创作

查看项目

更新于 10-16 08:48

技能介绍

用途:skill-artifacts 是编写或审查技能(skills)时加载的设计指南,面向需要创建、组织或评审 SKILL.md 的作者。技能是加载进智能体的共享知识,每个技能是 skills/ 下的一个目录,包含 SKILL.md 以及可选的 resources/、scripts/、assets/ 子目录。

主要能力:说明三级加载机制。load 表示始终在上下文中,适合每次运行都需要的技能,原则与护栏类技能属于此级;available 表示名称对智能体可见、内容按需加载,是主要发现机制;model-invocable 表示可被关键词全局发现,是 available 生效所必需的加载机制。默认建议:多数技能设 model-invocable: true;仅 load、从不 available 的技能设 model-invocable: false;尽量缩小全局 model-invocable 池。

技能类型:用 type: 声明角色,类型决定注入顺序——principle 最先(注意力最高),guardrail 其次,reference 最后。principle 塑造智能体思考方式,始终加载;guardrail 是安全边界,始终加载;mode-shift 切换智能体正在做的事,available 按需加载;checkpoint 在阶段转换处设门,available 在边界加载;reference 是操作指南,available 按需加载。mode-shift 是派生新智能体的替代方案:当认知转变仍在同一模型能力内且不需要全新上下文时,技能比派生更省;若需要不同模型或全新注意力预算,则应派生。

结构与用法:描述应以“何时加载”开头,而非“包含什么”。正文保持在 100 行以内,深入或变体专属内容放入 resources/ 并从正文路由过去,积极分解,让智能体只获取所需知识。当操作是确定性的(校验、格式化、转换)时添加 scripts/,脚本执行时不加载进上下文且结果可靠;若同一代码被智能体反复生成,说明它应成为脚本。当 SKILL.md 超过约 100 行教学内容、内容涉及不同变体(框架、平台)、或高级功能多数使用者很少需要时,拆分为 resources;每个资源文件应可独立使用,无需依赖同技能的其他资源。

限制:资料未提供具体安装命令、收费、价格、平台支持或效果数据,暂未提供。