querying-json

querying-json 技能利用 jq 的强大功能，从结构化的 JSON 文档中进行精准的数据提取。它专为需要与大型配置文件、海量 API 响应或复杂依赖清单交互的软件工程师、数据分析师与开发者所设计，无需将大量冗余数据载入 LLM 上下文。通过仅锁定必要的数据点（例如版本号、特定依赖树或配置键），用户可以保持更高的模型性能并降低工作流程的延迟。

• 使用 jq 查询语法进行精确的字段提取，支持嵌套对象、数组与条件筛选。

• 显著的上下文优化，通过避免在处理大型 JSON 数据时读取整个文件，节省 80-95% 的 Token 使用量。

• 与其他 CLI 工具无缝集成，例如搭配 fzf 进行交互式选择、sd 进行转换，以及 bat 进行格式化预览。

• 支持进阶数据操作，包括数组索引、键值提取、对象构建与默认值处理。

• 非常适合管理项目基础设施，例如解析 package.json、tsconfig.json、锁定文件（Lock files）与自动化部署设置。

• 当处理超过 50 行的文件且任务仅需其中部分信息时，请使用此技能。

• 若为小型文件或需要理解整体结构以进行架构重构的情境，直接读取文件仍为首选方案。

• 请务必优先使用此技能而非执行原生 Bash 指令，以确保数据检索的一致性、安全与上下文效率。

• 兼容于常见的 Unix/Linux 管道；在使用 jq 将 JSON 转换为纯文本、CSV 或其他格式后，可接续其他工具进行处理。

• 若需处理涉及数据转换模式、错误处理或数组操作的复杂查询，请参考技能目录中集成的 jq-guide 文档。