SuperAPI AI 工具集

schema-updater

写作与研究

查看项目

更新于 10-16 07:25

技能介绍

用途:刷新已有 JSON Schema,使其重新匹配所校验的产物结构。适用于 schema 与产物结构不符、新增字段未同步、校验失败或用户要求审计/刷新 schema 的场景。

主要能力与流程:先评估现状,读取 schema 文件、找到其校验的产物(skills、agents、hooks、workflows),对比必填字段与实际结构,找出缺失字段、类型错误和过时描述;再研究最佳实践,阅读 .claude/schemas/CLAUDE.md 约定、参考相似 schema、检查 Draft-07 合规性,必要时使用 Skill({ skill: 'research-synthesis' });随后生成补丁待办,按必填字段新增、类型修正、描述更新的优先级排序并尽量保持向后兼容;接着按 TDD 应用更新,先写测试(RED)、再改 schema(GREEN)、最后重构(REFACTOR),使用 Edit 工具而非重写整个文件;最后验证集成并记录。

验证要求:schema 必须是合法的 JSON Schema Draft-07($schema: "http://json-schema.org/draft-07/schema#"),必须有与文件路径匹配的 $id,必须被至少一个校验器或测试引用,必填字段须匹配实际产物结构,默认值须符合框架约定。需验证至少 3 个现有产物,运行 pnpm lint:fix && pnpm format 及 schema 校验测试,重要变更通过 MemoryRecord 记录并更新 CHANGELOG.md。

限制与反模式:不得盲目更新 schema,每次刷新都须有证据、经 TDD 把关并验证集成;避免新增会破坏现有合法产物的必填字段、未检查所有消费方就删除字段、使用超出 Draft-07 的特性(如 Draft-2020-12 的 prefixItems),以及把 schema 设得过严而拒绝合法边界情况。具体安装方式与收费信息暂未提供。