SuperAPI AI 工具集

testing

测试与质量

查看项目

更新于 10-16 07:18

技能介绍

用途:为自然语言工件提供测试驱动开发(NL-TDD)。在编写技能、智能体、命令、规则、钩子或提示词前,先写规格文件,再迭代直到通过。

主要能力:

  • 规格文件存放在项目根目录的 .nlpm-test/ 目录,命名约定为 <artifact-name>.spec.md,与工件文件名对应。
  • 规格头部字段包括 artifact(被测工件路径)、type(agent | skill | command | rule | hook | prompt)、min_score(/nlpm:score 最低阈值)。
  • 正文可选段落:triggers_on(应触发的查询)、does_not_trigger_on(不应触发的查询)、output_contains(输出应含内容)、output_format(输出格式)、handles_input(命令输入及预期行为)、follows_rules(应遵守/违反规则的代码)、frontmatter_valid(必填字段)。
  • 运行 /nlpm:test 得到 RED/GREEN 结果,/nlpm:score 检查质量分,迭代至全部通过且分数达标。

使用方式(NL-TDD 循环):

  1. 写规格 .nlpm-test/artifact-name.spec.md
  2. 运行 /nlpm:test(RED:规格失败,工件不存在)
  3. 编写工件
  4. 再运行 /nlpm:test 检查是否通过
  5. 运行 /nlpm:score 检查质量分
  6. 迭代至 GREEN:全部规格通过且分数达标

适用场景:在编写或重构 NL 工件时,用规格作为契约,工件作为实现;测试器通过匹配 .nlpm-test/ 规格文件名与工件文件名(使用 artifact 头部字段)发现测试;工件路径不存在时规格默认 RED,即 TDD 的“先写测试”状态。

限制:规格若触发查询覆盖不足或分数低于 min_score,测试会失败;具体评分细则见 nlpm:scoring,工件 frontmatter 模式见 nlpm:conventions。其他细节暂未提供。