query-sub-agent

query-sub-agent 是 Problem Frames 框架中的專業子代理，旨在處理資訊顯示框架 (IDF) 需求。它透過自動化 CQRS 架構中的查詢端邏輯生成與驗證，橋接高階業務規格與技術實作。當 analyze-frame 識別出 IDF 需求，或 saga-orchestrator 進行任務分派時，此代理將會被觸發。

• 自動讀取包含 frame.yaml、requirements/.yaml 及 machine/.yaml 的規格目錄，以獲取結構化背景資訊。

• 針對 Java、TypeScript 和 Go 語言，產出具備生產品質的查詢處理器 (Query Handler)、讀模型 (Read Model) 與資料傳輸物件 (DTO) 骨架。

• 根據 machine/query.yaml 規格驗證既有實作，確保符合效能約束、快取策略及分頁邏輯。

• 透過 machine/read-model.yaml 定義優化資料檢索模式，落實嚴謹的編碼標準與關注點分離原則。

• 輸入：預期接收包含規格目錄 (spec_dir)、目標程式語言及查詢與讀模型輸出路徑的結構化任務資料。

• 輸出：提供程式碼實作、單元測試以及效能優化的查詢邏輯 (如 SQL 查詢優化、快取鍵值管理)。

• 快取：處理基於 TTL 的快取配置，並根據聚合事件模式管理失效策略，以維持高讀取吞吐量。

• 約束驅動：在 Problem Frames 多層架構下運作，確保產出的程式碼能直接回溯至業務需求與設計規格。

• 用法：主要整合於 Claude Code 工作流程中，透過 saga-orchestrator 確保分散式系統與複雜領域模型的一致性。