JSON检查工具

校验工作区内所有JSON文件的语法正确性，自动检测并报告配置中的语法错误和无效文件。

功能说明: 本技能涵盖 中文交互、时使用 等核心能力。

功能说明: 本技能涵盖 化流程、化工作流场景 等核心能力。

Json Linter

专业版增值服务

能力	免费版	付费版
基础功能	支持	支持
Json Linter排查配置	不支持	支持
代码静态分析与质量评分	不支持	支持
依赖缺陷检测与升级建议	不支持	支持
批量代码审查与报告生成	不支持	支持
CI/CD流水线集成	不支持	支持

上线流程

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

应用场景

场景	输入	输出
配置管理	配置项与目标值	配置生效状态与差异
校验工作区JSON语	目标数据与配置参数	处理结果与执行状态
排查配置语法错误	目标数据与配置参数	处理结果与执行状态

不适用于：需要人工判断的复杂决策场景

输入定义

参数名	类型	必填	说明

| instruction | string | 是 | 用户指令文本 | | context | string | 否 | 上下文信息 |

输出规范

JSON report containing:

• scanned_at: Timestamp
• total_files: Number of .json files scanned
• valid_files: Number of valid files
• invalid_files: Number of invalid files
• errors: Array of error objects:
  • path: Relative path to file
  • error: Error message (e.g., "Unexpected token } in JSON at position 42")

安装与配置

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux

依赖说明(补充)

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

可用性分类

• 分类: MD+execute()
• 说明: 基于Markdown的AI Skill,

API Key配置方式:

bash

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

案例展示

json

{
  "scanned_at": "2026-02-14T21:45:00.000Z",
  "total_files": 150,
  "valid_files": 149,
  "invalid_files": 1,
  "errors": [
    {
      "path": "config/broken.json",
      "error": "Unexpected token } in JSON at position 42"
    }
  ]
}

错误应对体系

错误场景(续)	原因	处理方式
LLM响应超时或无响应	网络延迟或模型负载过高	请求重试；确认Agent平台LLM服务正常
输入内容格式不正确	用户输入不符合skill预期格式	检查输入是否符合skill使用说明中的格式要求，参考示例章节
执行结果与预期不符	指令描述不够明确或上下文不足	提供更详细的指令描述，补充必要的上下文信息
命令执行失败	运行环境不满足要求或权限不足	确认运行环境符合依赖说明中的要求；检查命令权限设置

限制条件

• 需要API Key，无Key环境无法使用

差异化分析

效率提升量化分析

操作步骤	手动耗时	自动化耗时	时间节约	准确率提升
手动检查JSON文件	30分钟/文件	5秒/文件	29分55秒	10%
批量检查多个文件	2小时	1分钟	1小时59秒	15%
定期检查更新	1小时/天	30秒/天	59分30秒	20%
检查大型项目	1天	10分钟	23小时50分钟	25%
集成到开发流程	2天	30分钟	1天30分钟	30%

差异化对比

对比维度	本技能	手动操作	Python脚本	专业软件
界面友好性	高	低	中	高
学习成本	低	高	中	高
批量处理能力	高	低	中	高
检查速度	快	慢	中	快
易用性	高	低	中	高

核心痛点解决

痛点	描述	影响范围	解决方案	量化效果
人工检查效率低	JSON文件配置复杂，人工检查效率低，易出错	项目进度和质量	自动化检查，提高效率，减少错误	效率提升30%
缺乏批量处理能力	人工检查无法同时处理多个文件，效率低下	项目规模和进度	批量处理功能，提高处理速度	效率提升15%
检查结果不清晰	人工检查结果不统一，难以跟踪	项目维护	清晰的检查报告，方便问题跟踪	效率提升20%

常见问题FAQ

Q1: 如何开始使用JSON检查工具？

A: 首先阅读使用流程章节，按步骤配置环境和参数后即可开始使用。首次使用建议先阅读依赖说明章节确认环境就绪。

Q2: JSON检查工具支持哪些类型的JSON文件？

A: JSON检查工具支持所有标准的JSON文件，包括配置文件、数据文件等。

Q3: JSON检查工具是否支持自定义规则？

A: 目前版本不支持自定义规则，但我们可以根据用户反馈进行后续功能扩展。

Q4: JSON检查工具的输出结果如何展示？

A: 检查结果以JSON格式返回，包含扫描时间、文件总数、有效文件数、无效文件数和错误详情。

Q5: JSON检查工具是否支持跨平台使用？

A: 是的，JSON检查工具支持Windows、macOS和Linux操作系统。

诊断与修复

错误现象	可能原因	诊断步骤	解决方案
检查结果为空	环境配置错误	检查环境配置是否正确	重新配置环境
检查速度慢	文件数量过多	检查文件数量是否过多	优化检查策略
无法连接到服务器	网络连接问题	检查网络连接是否正常	修复网络连接
权限不足	缺少运行权限	检查运行权限是否足够	获取相应权限

安全合规准则

1. 确保API Key不被泄露，避免被恶意利用。
2. 定期更新工具，以修复已知的安全漏洞。
3. 避免在公共网络环境中使用API Key。
4. 限制工具的使用权限，仅授权给信任的用户。
5. 对输入数据进行验证，防止注入攻击。

安全风险防范

风险项	等级	防护措施	验证方法
API密钥泄露	高	通过环境变量配置，禁止硬编码	定期检查代码和配置文件
命令执行风险	高	仅执行白名单命令，避免拼接用户输入	使用沙箱环境测试
网络通信安全	中	使用HTTPS协议，验证SSL证书	定期检查证书有效期
敏感数据暴露	高	输出结果中不包含密钥、令牌等敏感信息	日志脱敏审查
未授权访问	中	限制访问权限，实施认证机制	定期审计访问日志