SuperAPI AI 工具集

validate-skill-functionality

智能体与模型

查看项目

更新于 10-15 11:02

技能介绍

Validate Skill Functionality

用途:这是对技能执行后的系统性审查流程,用于验证技能功能并记录发现。它应在技能完成完整执行工作流之后使用。

触发时机:当用户说出“validate skill”“validate this skill”“review skill execution”“check skill”或“skill validation”时加载,且位于技能执行结束时。

工作流

按照以下步骤验证技能功能:

第1步:回顾执行上下文

  • 确定刚刚执行的是哪个技能
  • 回顾该技能原本应完成什么
  • 查看 SKILL.md 以理解预期行为
  • 回顾对话历史,找出执行期间发生的所有工具调用

第2步:验证文件加载

检查所有必需文件是否被正确加载:

  • 回顾对话中所有 Read 工具调用
  • 确认 SKILL.md 已加载(作为技能执行上下文)
  • 检查技能是否引用了其他文件(references/、scripts/、assets/)
  • 确认被引用的文件在需要时确实已被加载
  • 查找“File not found”错误或截断的读取
  • 验证文件路径与预期位置一致

示例检查:

  • ✅ SKILL.md 已加载:是(第1-88行,完整)
  • ✅ references/workflow.md 已加载:是(在第2步需要时)
  • ❌ references/error-handling.md 已加载:否(本应加载但未加载)
  • ✅ scripts/bulk-complete.py 已执行:是(参数正确)

第3步:验证技能嵌套/包装

检查技能是否正确加载了嵌套技能:

  • 判断该技能是否调用了其他技能(例如 execute-project 调用 create-skill)
  • 验证嵌套技能是通过 nexus-loader.py 还是显式 Read 加载
  • 确认嵌套技能的工作流被正确遵循
  • 检查技能之间的上下文是否正确传递
  • 验证嵌套技能的输出是否正确回传

示例检查:

主技能:execute-project

  • ✅ 已加载:是(通过 nexus-loader.py --skill execute-project)

嵌套技能:create-skill

  • ✅ 已加载:是(通过 nexus-loader.py --skill create-skill)
  • ✅ SKILL.md 已读取:是(完整)
  • ✅ 工作流已遵循:是(全部7步)
  • ✅ 上下文已传递:是(用户的工作流 → create-skill)

嵌套技能:close-session

  • ✅ 已加载:是(自动触发)
  • ✅ workflow.md 已加载:是(按要求)
  • ✅ 全部8步已执行:是

第4步:确认预期输出

  • 确认技能完成了其工作流
  • 检查输出是否符合预期
  • 验证所有步骤是否正确执行
  • 确认文件是否按预期创建/修改

第5步:检查错误或边界情况

  • 查找执行期间的任何错误或警告
  • 识别边界情况或意外行为
  • 记录与预期工作流的任何偏差
  • 检查是否存在不完整的读取或缺失的上下文

第6步:报告发现(≤5行)

以口头方式向用户报告:

  • ✅ 哪些工作正常
  • ❌ 发现的问题(如有)
  • 💡 建议(如有)

不生成文档文件——遵循 orchestrator.md 的≤5行规则。

适用场景:技能执行完成后需要系统性验证其功能、文件加载、嵌套调用和输出结果时。

限制:仅用于技能执行后的验证环节;不生成文档文件;报告输出受≤5行规则限制。