SuperAPI AI 工具集

skill-composition

通用与其它

查看项目

更新于 10-15 22:12

技能介绍

用途:对单个技能包(目录技能、.skill-proposals 草稿或 lifecycle fixture)的 SKILL.md 做 invoke/forbid/require 边一致性检查,判断其引用的技能名是否与目录一致。输入须为三者之一:skills/INDEX.md 中列出的 target、.skill-proposals/<name>/SKILL.md 的 proposal_path,或 skills/lifecycle-build/fixtures/**/SKILL.md 的 fixture_path;为空、缺失或超出这些根路径则 blocked,INDEX 缺失或不可读也 blocked。

主要能力:只读取目标 SKILL.md,提取小写连字符形式的目录技能名引用,区分 invokes(指示调用/运行某技能)、forbids(禁止调用、吸收或替换某技能)、requires(硬性前置技能);忽略仅涉及方式(manner-only)的约束,也不从 WORKFLOW.md 单独推断边。一致性规则包括:所有目标须存在于 INDEX ∩ skills/<name>/SKILL.md;同一名称不得同时出现在 invokes 与 forbids;主体不得 invokes 自身;检查器不得编辑任何文件。全部通过则 composition_ok 并附提取的边列表,否则 composition_fail 并给出带 id、规则、引文和修复提示的封闭 findings。

使用方式:调用名 skill-composition、composition check 或 check skill deps。流程为解析输入到单一 SKILL.md 或 blocked、加载目录、按表提取边、应用一致性规则、输出一个主结论后停止。交付物为 YAML,含 subject(解析出的路径)、verdict、提取的 invokes/forbids/requires,失败时含 findings,blocked 时含 missing。

适用场景:单个技能包需要针对 INDEX 目录做 invoke/forbid/require 一致性检查时。

限制:不编辑 SKILL.md、INDEX、README、WORKFLOW,不运行 npx skills install;不设计新技能路径,不构建全仓库组合图谱,不做 purpose review(skill-review)或路由(skill-router),不推荐或执行技能链;规则 4(检查器不编辑)由 agent 保证而非机器校验,从 SKILL.md 散文提取边仍由 agent 判断;自测脚本 node skills/skill-composition/scripts/self-test.mjs 覆盖规则 1–3。发布到 skills/ 前需人工批准。