SuperAPI AI 工具集

jtbd-validator

办公与效率

查看项目

更新于 10-16 01:31

技能介绍

用途:校验 Jobs-to-be-Done(JTBD)Markdown 文件的正确性与完整性,确保结构规范、API 引用有效、步骤依赖合理。

主要校验项:frontmatter(name、description);步骤标题(顺序且与 YAML 块对应);YAML 结构(api、operationId、inputs);API URN(目录存在、spec 有效);operationId(在 API spec 中存在);步骤依赖(不允许前向引用,引用的 output 必须存在)。

使用方式:校验单个文件运行 python3 .claude/skills/jtbd-validator/scripts/validate_jtbd.py path/to/job.md .;批量校验可遍历 skills//SKILL.md 逐个执行同一脚本。查找所有 JTBD 文件可用 find . -path "/skills/*/SKILL.md" -type f | grep -v node_modules。

流程:确认待校验文件(指定路径或全部 skills/*/SKILL.md);运行校验脚本;报告结果,通过则确认有效,失败则用通俗语言说明错误及修复方法。

常见错误与修复:operationId 不存在,需核对 API 规范中的正确名称;引用未知 output,需在对应步骤补充 output 或更正名称;前向引用,步骤只能引用之前的步骤;URN 无效,需使用正确的目录名。

退出码:0 表示有效,1 表示无效。相关资料未给出收费、平台支持范围等更多信息。