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 文件。