SuperAPI AI 工具集

known-good

测试与质量

查看项目

更新于 10-15 17:29

技能介绍

用途:known-good 是一个测试夹具(test fixture),供 tests/integration/test_skill_auditor.bats 使用,用来确认审计器(auditor)对符合规范(conforming)的输入返回 PASS 或 WARN 判定。它展示了一份最小但完整的 SKILL.md,满足全部 15 项审计检查(Pass 1 + Pass 2)。

主要能力与结构:其 frontmatter 采用规范形态,YAML description 使用 | 块标量,并同时包含显式的 Triggers 与 Use-when 标记,用于同时触发 description-has-triggers 的两种形式。约束(Constraints)被前置:## ⚠️ Critical Constraints 小节出现在任何其他 H2 之前,用于测试 constraints-frontloaded 启发式。每条约束都附有 Why: 理由,用于测试 rationale-present 启发式。工作流分三个阶段:Phase 1 Setup(读取夹具、解析 frontmatter,检查点:frontmatter 含 name、description、metadata.tier);Phase 2 Validate(执行全部 8 项 Pass-2 检查,检查点:8 项均返回 pass 或 n/a);Phase 3 Emit verdict(按 max-severity 规则汇总,检查点:判定为 PASS,无 warn 无 fail)。输出规范:格式为 stdout 标记 known-good 确认夹具干净加载;无文件名(仅运行时夹具);退出码 0。质量评分表包含复选框项,且要求 SKILL.md 少于 250 行。

使用方式:可通过 bash skills/skill-auditor/scripts/audit.sh tests/fixtures/skills/known-good 对该夹具运行审计器,预期退出码为 0,判定为 PASS 或 WARN。

限制:这是测试夹具,不是运行时技能,请勿调用;原因在于审计测试固定了其精确内容,运行时使用会让贡献者感到意外。若审计器返回 FAIL,通常因夹具偏离规范形态,应从 git 恢复,不要在未同步更新测试的情况下编辑。资料未提供关于收费、价格、支持平台等更多信息。