SuperAPI AI 工具集

validate-skills

办公与效率

查看项目

更新于 10-16 00:32

技能介绍

用途:验证技能(skill)文件中记录的可执行命令在当前操作系统上能否成功运行,避免技能文档中的命令过期或失效。

使用时机:创建或更新包含可执行命令的技能后;评审技能以发现陈旧或损坏的指令时;切换操作系统(如 Windows→Linux)后确认命令跨平台可用性时。

主要步骤:

  1. 检测当前操作系统(如 PowerShell 判断 Windows,或 Bash 用 uname -s 判断 Linux/Darwin)。
  2. 解析目标技能的 SKILL.md,提取与当前系统匹配的 shell 命令。技能常用表格分列 Windows 与 Linux/macOS,需选择对应列;带 # Windows 或 # Linux/macOS 注释的命令只运行匹配当前系统的那条。将明显占位符(如 <path-to-csproj>、<skill-name>)替换为仓库中的真实值,无合理值则跳过。跨平台命令如 ls -la 在 Windows 无原生写法时可改用 PowerShell 等价命令(如 Get-ChildItem)。
  3. 用 SQL 工具建立跟踪表记录技能名、命令、预期与实际退出码、状态和备注。
  4. 在仓库根目录逐条运行命令,记录退出码并分类:退出 0 为 PASS;非零且属环境问题(缺 SDK、无网络)为 ENV_ISSUE;非零且属命令或文档错误为 ERROR。
  5. 安全规则:绝不能运行未过滤的集成/验收测试,耗时数小时;test.sh --integrationTest 或 test.cmd -Integration 必须带 --filter 或 -p 参数;test.sh -p smoke 可接受但可能较慢。
  6. 全部完成后输出汇总报告,包含技能名、系统、测试命令数及 PASS、ENV_ISSUE、ERROR 计数,并列出原因或失败命令。
  7. 后续处理:ERROR 属文档缺陷应更新 SKILL.md;ENV_ISSUE 若环境前提未记录应在技能中补充排查说明;PASS 无需操作。

建议顺序:先运行 restore/build 再运行测试;优先运行成本最低的命令以便尽早失败;独立测试命令可并行批量执行。资料未提供工具本身的安装方式或命令行入口。