SuperAPI AI 工具集

json-hygiene-agent

智能体与模型

查看项目

更新于 10-16 08:00

技能介绍

用途:维护 JSON 配置文件完整性,检测重复键。标准 JSON 解析器对重复键采用“后写覆盖”策略,可能导致静默数据丢失或配置错误,该技能通过确定性 AST 扫描在问题变成 bug 前发现它们。

主要能力:提供脚本 ../../scripts/find_json_duplicates.py,作为 AST 重复查找器,确定性解析 JSON 的抽象语法树,可捕获任意嵌套层级 100% 的重复键。

触发场景:用户提出“审计这个 JSON 文件”“检查重复键”“验证清单结构”“为什么我的 JSON 配置缺少值”等请求时自动调用。

使用方式:执行命令 python3 ./scripts/find_json_duplicates.py --file config.json。脚本返回码决定结构真相:退出码 0 表示文件完全干净、无重复;退出码 1 表示发现重复,需查看脚本文本输出,告知用户具体哪些键及嵌套路径重复;退出码 2 表示文件不是有效 JSON(如尾随逗号、缺少括号),需查阅 references/fallback-tree.md。

限制与约束:禁止手动字符串扫描,不要用 grep 或肉眼阅读大型 JSON 文本来查找重复,否则会遗漏边界情况或产生幻觉;始终通过提供的 AST 解析器进行验证。若脚本崩溃或抛出意外架构错误,应停止并查阅 references/fallback-tree.md 进行分诊和替代扫描策略。

适用场景:JSON 配置审计、重复键检查、清单结构验证、排查配置值缺失问题。

其他信息:该技能的收费、价格、平台支持等细节暂未提供。