SuperAPI AI 工具集

repair-skill

测试与质量

查看项目

更新于 10-15 22:11

技能介绍

Repair Skill 的用途是对已有技能做诊断与改进,而不是从零生成技能(那是 create-skill 的职责)。它对照黄金标准找出违规与缺口:哪里坏了、缺了什么、什么能提升质量,最终输出覆盖全部维度的结构化改进计划。

主要能力按七个维度审计:一是 frontmatter 质量,检查描述人称与写法、触发短语是否为用户原话、模板覆盖度、argument-hint、命名规范、触发准确性与令牌预算;二是执行修饰符,检查 allowed-tools、技能或智能体调用、AskUserQuestion、动态内容注入等配置是否匹配;三是意向性与示例式指令之分,判断规则是否先陈述原理再用示例佐证;四是智能体与确定性步骤的拆分,识别可脚本化的重复生成、刚性契约、一致性关键等信号;五是冗长度与上下文效率,找出冗余叙述、含糊措辞、过深标题、应移入 references/ 的内容;六是流程清晰度,检查编号阶段、退出条件、变量绑定与交付格式;七是结构完整性,核对 scripts/、references/、examples/ 等目录是否缺失或未被引用。

使用方式:把技能目录路径或 SKILL.md 文件路径作为 $ARGUMENTS 传入。若是目录,先读 SKILL.md,再列出并记录 references/、examples/、scripts/、assets/ 的存在与引用情况;若是文件则直接读取并查找同级资源目录。路径缺失或含糊时用 AskUserQuestion 澄清。随后加载 skill-anatomy.md、frontmatter-options.md、audit-calibration.md 三个参考文件(审计维度四时还需 script-patterns.md),再分维度独立审计,记录维度代码、问题、违反的原则或未达标的黄金标准以及所需具体修改,最后输出改进报告,把违规与缺口分开,并按 critical、major、minor 标注严重度。

适用场景:用户要求“修复我的技能”或“审计这个技能”,或提到技能质量时使用。限制方面,资料未提供价格、平台与收费信息;其审计依据为随附参考文件中的黄金标准,是否支持 Claude 之外的运行环境暂未提供。