SuperAPI AI 工具集

skill-schema-v2

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

Skill Schema V2 是 v2 技能规范的兼容入口,可安装的 v2 包位于 skill-schema-v2.skill/。适用于用户设计、审计、重构或修复 Agent Skill 的场景。

核心规则:技能包含三个面——路由面(name、description、frontmatter)、契约面(goal、inputs、permissions、evidence、output、verification、handoff)、运行时边界面(docs、examples、scripts、operators、fallback paths)。三个面必须对齐:description 路由某任务时,契约需治理该任务,运行时资源需支持该任务且不把无关上下文强塞进模型。

v2 增加三项 2026 发现:契约式技能,技能应成为边界明确、有验收标准的可读任务契约;138K SKILL.md 可复用性研究表明,路由缺陷、正文膨胀、资源不佳、安全问题、可移植性缺口、人设与范围冲突都是可度量缺陷;SkillSmith 表明原始技能注入浪费上下文,技能应暴露最小运行时边界并渐进加载细节。

审计输出按百分制评分:Routing 15、Contract 20、Runtime Boundary 15、Reusability 15、Safety 15、Signal Density 10、Versioning 5、Self-Consistency 5。

运行时资源按需加载:skill-schema-v2.skill/SKILL.md 提供完整 v2 契约;docs/v2-design-spec.md 提供设计依据;docs/audit-rubric.md 提供评分细节;docs/repair-playbook.md 提供修复模式;docs/paper-digests.md 提供论文证据。