SuperAPI AI 工具集

skill-debugging-assistant

测试与质量

查看项目

更新于 10-15 17:21

技能介绍

用途:该技能用于诊断技能为何没有按预期触发或运行,系统分析触发模式、参数问题、提示冲突和结构问题,定位根因并建议修复。

适用情形:技能未在预期时触发;触发错误或时机不对;行为与描述不符;技能指令与系统提示冲突;不清楚何时加载 references、何时写入 SKILL.md;打包时出现校验错误;相似查询下表现不一致。

诊断流程:先判定问题类型,再进入对应分支——不触发看“触发失败诊断”,误触发看“误报诊断”,行为异常看“指令冲突诊断”,打包/校验错误看“结构校验”,需要整体检查看“综合审计”。触发失败时依次检查 description 字段是否含用户查询词与概念触发词、是否写明“何时使用”、是否足够具体以区分其他技能,并检查竞争技能重叠、测试改写查询的边界情况。误触发时检查 description 是否过宽、指令是否越界、是否有无条件覆盖上下文的“总是/从不”表述。指令冲突时通读 SKILL.md,检查绝对化表述、与系统提示冲突、内部矛盾、渐进式披露中关键信息是否被埋在未加载的 references 里。

主要能力:提供快速诊断清单(触发失败、误报、行为问题、校验错误逐项核对);提供深度分析方法,包括 description 分析模板、指令冲突分析、令牌预算分析;并给出常见修复方向,如补充具体触发词与文件类型指示、加限定条件、把绝对化指令改为条件式(“优先 X,除非 Y”)、把关键指令从 references 移回 SKILL.md、使用“仅当……”条件逻辑。

结构校验:可运行自动校验脚本:python3 scripts/validate_skill.py path/to/skill-folder。手工检查包括 YAML frontmatter 格式正确(含 name 与 description)、名称使用 kebab-case、description 足够全面且具体(超过 50 字符)、SKILL.md 控制在 500 行以内、references 在需要时被明确指明、无多余文件(README.md、CHANGELOG.md 等)、assets/scripts 经过测试可用。

资源:references/common-issues.md 提供常见问题示例与前后修复对比,调试复杂或反复出现的问题时加载;scripts/validate_skill.py 在打包前运行以提前发现问题。

限制:资料未提供该技能的安装方式、收费情况、支持平台与具体性能数据,暂未提供。