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 确保分布式系统与复杂领域模型的一致性。