@zeyue0329/xiaoma-cli 1.0.47 → 1.0.49

package/dist/agents/architect.txt

@@ -79,6 +79,7 @@ commands:
   - create-brownfield-architecture: 使用 create-doc 和 brownfield-architecture-tmpl.yaml
   - create-front-end-architecture: 使用 create-doc 和 front-end-architecture-tmpl.yaml
   - create-full-stack-architecture: 使用 create-doc 和 fullstack-architecture-tmpl.yaml
+  - create-incremental-architecture: 基于知识库和PRD进行架构增量设计 (任务 create-incremental-architecture.md，模板 incremental-architecture-tmpl.yaml)
   - doc-out: 将完整文档输出到当前目标文件
   - document-project: 执行任务 document-project.md
   - execute-checklist {checklist}: 运行任务 execute-checklist (默认为->architect-checklist)
@@ -95,6 +96,7 @@ dependencies:
   tasks:
     - create-deep-research-prompt.md
     - create-doc.md
+    - create-incremental-architecture.md
     - document-project.md
     - execute-checklist.md
     - shard-doc.md
@@ -103,6 +105,7 @@ dependencies:
     - brownfield-architecture-tmpl.yaml
     - front-end-architecture-tmpl.yaml
     - fullstack-architecture-tmpl.yaml
+    - incremental-architecture-tmpl.yaml
 ```
 ==================== END: .xiaoma-core/agents/architect.md ====================
 
@@ -495,6 +498,534 @@ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
 - End with "Select 1-9 or just type your question/feedback:"
 ==================== END: .xiaoma-core/tasks/create-doc.md ====================
 
+==================== START: .xiaoma-core/tasks/create-incremental-architecture.md ====================
+# 基于知识库的架构增量设计任务
+
+## Purpose
+
+基于 Analyst 智能体的技术知识库产出（`docs/rag/technical/`）和 PM 智能体生成的 PRD/Epic 文档，进行架构增量设计。通过对比现有技术架构与新需求，识别技术变动点，生成架构增量设计文档。
+
+## 上游交接物
+
+```yaml
+必需输入:
+  PRD/Epic文档:
+    - docs/prd.md                       # PM生成的PRD文档
+    - 或 docs/epic-{name}.md            # PM生成的Epic文档
+
+  技术知识库:
+    - docs/rag/technical/architecture.md       # 现有技术架构
+    - docs/rag/technical/tech-stack.md         # 技术栈详情
+    - docs/rag/technical/module-structure.md   # 模块结构
+    - docs/rag/technical/data-model.md         # 数据模型
+
+可选输入:
+  分析报告:
+    - docs/rag/_analysis-report.md      # 需求分析报告（技术分析章节）
+
+  编码规范:
+    - docs/rag/technical/coding-standards/    # 编码规范目录
+    - docs/rag/technical/middleware/          # 中间件规范目录
+
+  约束条件:
+    - docs/rag/constraints/security.md        # 安全要求
+    - docs/rag/constraints/performance.md     # 性能要求
+```
+
+## Workflow Overview
+
+```
+技术知识库 + PRD → 架构差异分析 → 变动点识别 → 增量设计 → 影响评估 → 架构增量文档
+```
+
+---
+
+## Phase 1: 输入验证与上下文加载
+
+### 1.1 验证上游交接物
+
+```yaml
+执行步骤:
+  步骤1_检查PRD文档:
+    动作: 检查 docs/prd.md 或 docs/epic-{name}.md 是否存在
+    缺失处理: |
+      如果缺失PRD文档，提示用户：
+      "未找到PRD文档。请先执行 PM 智能体的 *create-prd-from-rag 命令生成PRD。"
+
+  步骤2_检查技术知识库:
+    动作: 检查 docs/rag/technical/ 目录是否存在核心文件
+    核心文件:
+      - architecture.md (现有架构)
+      - data-model.md (数据模型)
+    缺失处理: |
+      如果技术知识库不完整，提示用户：
+      "技术知识库不完整。建议先执行 Analyst 智能体完善技术知识：
+      - 缺少 architecture.md：需要补充整体技术架构信息
+      - 缺少 data-model.md：需要补充现有数据模型信息"
+
+  步骤3_加载现有架构:
+    动作: 读取并解析技术知识库
+    提取内容:
+      - 整体架构模式（单体/微服务/DDD等）
+      - 技术栈详情（框架、数据库、中间件）
+      - 模块结构（包结构、分层规范）
+      - 现有数据模型（表结构、实体关系）
+      - 编码规范（命名、注释、异常处理）
+      - 中间件使用方式（Redis、MQ、ES等）
+
+  步骤4_加载PRD需求:
+    动作: 读取并解析PRD文档
+    提取内容:
+      - 功能性需求（FR列表）
+      - 非功能性需求（NFR列表）
+      - 数据实体与关系
+      - 技术约束
+      - Epic/Story结构
+```
+
+### 1.2 上下文整合视图
+
+```yaml
+整合输出:
+  现有架构视图:
+    架构模式: {从architecture.md提取}
+    技术栈:
+      后端: {框架、版本}
+      数据库: {类型、版本}
+      缓存: {类型、用途}
+      消息队列: {类型、用途}
+    模块结构: {包结构、分层}
+    数据模型: {现有实体、关系}
+
+  新需求视图:
+    功能需求: {FR列表}
+    数据需求: {新增/修改实体}
+    性能需求: {NFR中的性能要求}
+    安全需求: {NFR中的安全要求}
+```
+
+---
+
+## Phase 2: 架构差异分析
+
+### 2.1 技术变动检测
+
+```yaml
+检测维度:
+  架构层面变动:
+    检测项:
+      - 是否需要新增模块/服务
+      - 是否需要调整分层结构
+      - 是否需要引入新的架构模式
+    判定标准:
+      无变动: 完全遵循现有模块结构
+      小变动: 在现有模块内新增包/类
+      中变动: 新增独立模块
+      大变动: 需要调整整体架构
+
+  技术栈变动:
+    检测项:
+      - 是否需要引入新框架/库
+      - 是否需要升级现有依赖版本
+      - 是否需要新增中间件
+    判定标准:
+      无变动: 使用现有技术栈
+      小变动: 新增工具类库
+      中变动: 引入新中间件
+      大变动: 核心框架变更
+
+  数据模型变动:
+    检测项:
+      - 新增数据实体
+      - 修改现有实体（字段增减）
+      - 新增实体关系
+      - 索引变更
+    判定标准:
+      无变动: 完全使用现有表结构
+      小变动: 现有表新增字段
+      中变动: 新增表/修改关联关系
+      大变动: 数据模型重构
+
+  接口变动:
+    检测项:
+      - 新增API端点
+      - 修改现有API
+      - 新增外部系统集成
+    判定标准:
+      无变动: 无接口变更
+      小变动: 新增内部API
+      中变动: 修改公开API/新增集成
+      大变动: API版本升级
+
+  中间件变动:
+    检测项:
+      - Redis使用变化（新增key类型、缓存策略）
+      - MQ使用变化（新增Topic/Queue）
+      - 定时任务变化
+      - ES索引变化
+    判定标准:
+      无变动: 遵循现有使用方式
+      小变动: 新增使用场景
+      中变动: 新增配置/调整策略
+      大变动: 中间件架构调整
+```
+
+### 2.2 变动分析报告
+
+```yaml
+分析输出格式:
+  变动总览:
+    总体变动等级: 无/小/中/大
+    主要变动领域: [列表]
+    风险等级: 低/中/高
+
+  详细变动清单:
+    - 变动ID: CHG-001
+      领域: 数据模型
+      类型: 新增
+      描述: 新增订单实体
+      影响范围: order模块
+      关联需求: FR1, FR2
+      风险等级: 低
+
+  兼容性分析:
+    向后兼容: 是/否
+    需要迁移: 是/否
+    影响范围: [受影响的模块/服务]
+```
+
+---
+
+## Phase 3: 架构增量设计
+
+### 3.1 设计原则
+
+```yaml
+设计原则:
+  最小变动原则:
+    - 优先在现有架构内扩展
+    - 避免不必要的重构
+    - 保持与现有代码风格一致
+
+  渐进演进原则:
+    - 设计可分阶段实施的方案
+    - 支持增量部署和回滚
+    - 考虑向后兼容性
+
+  知识复用原则:
+    - 复用知识库中的编码规范
+    - 遵循现有中间件使用模式
+    - 参考已有代码示例
+```
+
+### 3.2 增量设计内容
+
+```yaml
+设计内容:
+  模块增量设计:
+    新增模块:
+      - 模块名称
+      - 职责描述
+      - 包结构（遵循现有规范）
+      - 与现有模块的关系
+    修改模块:
+      - 模块名称
+      - 修改内容
+      - 修改理由
+      - 影响评估
+
+  数据模型增量设计:
+    新增实体:
+      - 实体名称
+      - 表名（遵循命名规范）
+      - 字段定义（遵循字段规范）
+      - 索引设计
+      - DDL语句
+    修改实体:
+      - 实体名称
+      - 修改字段
+      - 迁移脚本
+      - 兼容性说明
+
+  接口增量设计:
+    新增API:
+      - 接口路径（遵循URL规范）
+      - 请求方法
+      - 请求参数（遵循参数规范）
+      - 响应格式（遵循响应规范）
+      - 错误码定义
+    修改API:
+      - 接口路径
+      - 变更内容
+      - 版本策略
+      - 兼容性说明
+
+  中间件增量设计:
+    Redis:
+      - 新增Key定义（遵循Key命名规范）
+      - 数据结构选择
+      - 过期策略
+      - 代码示例（参考知识库）
+    MQ:
+      - 新增Topic/Queue
+      - 消息格式
+      - 消费者配置
+      - 代码示例（参考知识库）
+    定时任务:
+      - 任务名称
+      - 执行周期
+      - 实现方式
+      - 代码示例（参考知识库）
+```
+
+### 3.3 知识库规范引用
+
+```yaml
+规范引用:
+  编码规范引用:
+    来源: docs/rag/technical/coding-standards/
+    引用内容:
+      - 命名规范 → 类/方法/变量命名
+      - 分层规范 → Controller/Service/DAO实现
+      - 异常处理 → 错误处理方式
+      - 日志规范 → 日志打印方式
+
+  中间件规范引用:
+    来源: docs/rag/technical/middleware/
+    引用内容:
+      - Redis规范 → 缓存实现参考
+      - MQ规范 → 消息处理参考
+      - 定时任务规范 → 任务实现参考
+
+  SQL规范引用:
+    来源: docs/rag/technical/sql-standards/
+    引用内容:
+      - 表设计规范 → DDL编写
+      - 查询规范 → SQL编写
+      - 性能规范 → 索引设计
+```
+
+---
+
+## Phase 4: 影响评估与风险分析
+
+### 4.1 影响评估
+
+```yaml
+评估维度:
+  代码影响:
+    - 新增代码量估算
+    - 修改代码范围
+    - 测试代码需求
+
+  数据影响:
+    - 数据迁移需求
+    - 数据一致性风险
+    - 备份恢复策略
+
+  性能影响:
+    - 新增负载评估
+    - 资源需求变化
+    - 性能测试要求
+
+  部署影响:
+    - 部署步骤变更
+    - 配置变更
+    - 回滚方案
+```
+
+### 4.2 风险分析
+
+```yaml
+风险分析:
+  技术风险:
+    - 新技术引入风险
+    - 兼容性风险
+    - 性能风险
+
+  业务风险:
+    - 功能影响范围
+    - 数据安全风险
+    - 服务可用性风险
+
+  实施风险:
+    - 实施复杂度
+    - 团队技能匹配
+    - 时间约束
+
+  缓解措施:
+    - 每个风险的缓解方案
+    - 监控和告警策略
+    - 应急预案
+```
+
+---
+
+## Phase 5: 输出架构增量文档
+
+### 5.1 文档结构
+
+```yaml
+文档结构:
+  元信息:
+    - 文档版本
+    - 生成时间
+    - 关联PRD
+    - 关联知识库版本
+
+  变动总览:
+    - 变动等级
+    - 主要变动领域
+    - 风险等级
+
+  详细设计:
+    - 模块增量设计
+    - 数据模型增量设计
+    - 接口增量设计
+    - 中间件增量设计
+
+  实施指南:
+    - 实施顺序
+    - 依赖关系
+    - 检查点
+
+  知识引用:
+    - 引用的规范文档
+    - 代码示例来源
+
+  下游交接:
+    - 开发者交接
+    - QA交接
+```
+
+### 5.2 输出文件
+
+```yaml
+主输出:
+  架构增量文档:
+    路径: docs/architecture-increment.md
+    格式: Markdown
+
+辅助输出:
+  变动清单:
+    路径: docs/architecture-changes.yaml
+    格式: YAML
+    内容: 结构化的变动清单，便于追踪
+
+  DDL脚本:
+    路径: docs/ddl/
+    格式: SQL
+    内容: 数据库变更脚本
+
+  知识引用索引:
+    路径: docs/architecture-knowledge-refs.md
+    内容: 设计中引用的知识库文档清单
+```
+
+---
+
+## Phase 6: 下游交接
+
+### 6.1 交接给开发者
+
+```yaml
+开发者交接:
+  必读文件:
+    - docs/architecture-increment.md    # 架构增量设计
+    - docs/prd.md                       # PRD文档
+    - docs/rag/technical/coding-standards/  # 编码规范
+
+  关注点:
+    - 新增模块的包结构
+    - 数据模型变更
+    - 中间件使用方式（含代码示例）
+    - 接口设计规范
+
+  建议命令: "*start-development docs/architecture-increment.md"
+```
+
+### 6.2 交接给QA
+
+```yaml
+QA交接:
+  必读文件:
+    - docs/architecture-increment.md    # 架构增量设计（测试策略章节）
+    - docs/prd.md                       # PRD文档（验收标准）
+
+  关注点:
+    - 功能测试范围
+    - 集成测试要求
+    - 回归测试范围
+    - 性能测试要求
+
+  建议命令: "*create-test-plan docs/architecture-increment.md"
+```
+
+---
+
+## 使用说明
+
+### 激活命令
+
+```
+*create-incremental-architecture [prd_path] [rag_path]
+```
+
+### 执行参数
+
+```yaml
+参数:
+  prd_path: PRD文档路径 (默认: docs/prd.md)
+  rag_path: RAG知识目录路径 (默认: docs/rag/)
+  output_path: 输出路径 (默认: docs/architecture-increment.md)
+  interactive: 交互模式 (默认: true)
+```
+
+### 交互模式流程
+
+1. **验证阶段**: 检查上游交接物完整性
+2. **分析阶段**: 展示架构差异分析结果，确认变动点
+3. **设计阶段**: 逐模块进行增量设计，关键节点请求确认
+4. **评估阶段**: 展示影响评估和风险分析
+5. **输出阶段**: 生成架构增量文档，提示下游交接
+
+### YOLO模式
+
+通过 `*yolo` 命令切换YOLO模式，一次性完成所有步骤，跳过中间确认环节。
+
+---
+
+## 任务完成标志
+
+```yaml
+完成条件:
+  必要输出:
+    - docs/architecture-increment.md
+
+  完成提示: |
+    ✅ 架构增量设计完成！
+
+    📄 输出文件: docs/architecture-increment.md
+    📊 变动等级: {change_level}
+    ⚠️ 风险等级: {risk_level}
+
+    📋 变动摘要:
+    - 模块变动: {module_changes}
+    - 数据模型变动: {data_model_changes}
+    - 接口变动: {api_changes}
+    - 中间件变动: {middleware_changes}
+
+    🔄 下一步建议:
+    - 开发实施: *start-development docs/architecture-increment.md
+    - 测试计划: *create-test-plan docs/architecture-increment.md
+
+    💡 请在开发前确认架构设计，特别关注:
+    - 风险清单中的高风险项
+    - 数据迁移方案
+    - 回滚策略
+```
+==================== END: .xiaoma-core/tasks/create-incremental-architecture.md ====================
+
 ==================== START: .xiaoma-core/tasks/document-project.md ====================
 <!-- Powered by XiaoMa™ Core -->
 
@@ -3459,6 +3990,610 @@ sections:
     instruction: 在运行检查清单前，提议输出完整的架构文档。一旦用户确认，执行 architect-checklist 并在此处填充结果。
 ==================== END: .xiaoma-core/templates/fullstack-architecture-tmpl.yaml ====================
 
+==================== START: .xiaoma-core/templates/incremental-architecture-tmpl.yaml ====================
+template:
+  id: incremental-architecture-template-v1
+  name: 架构增量设计文档
+  version: 1.0
+  description: 基于知识库和PRD进行架构增量设计，识别技术变动并生成增量架构文档
+  output:
+    format: markdown
+    filename: docs/architecture-increment.md
+    title: "{{project_name}} 架构增量设计文档"
+
+workflow:
+  mode: interactive
+  elicitation: advanced-elicitation
+  upstream:
+    agents:
+      - analyst  # 提供技术知识库
+      - pm       # 提供PRD文档
+    required_files:
+      - docs/prd.md
+      - docs/rag/technical/architecture.md
+    optional_files:
+      - docs/rag/technical/tech-stack.md
+      - docs/rag/technical/data-model.md
+      - docs/rag/technical/module-structure.md
+      - docs/rag/technical/coding-standards/*
+      - docs/rag/technical/middleware/*
+      - docs/rag/constraints/*
+
+sections:
+  - id: input-validation
+    title: 输入验证
+    internal: true
+    instruction: |
+      在开始架构设计之前，执行以下验证：
+
+      1. **检查PRD文档**：
+         - docs/prd.md 或 docs/epic-{name}.md 是否存在
+         - 提取功能需求(FR)、非功能需求(NFR)、数据实体、技术约束
+
+      2. **检查技术知识库**：
+         - docs/rag/technical/architecture.md (现有架构)
+         - docs/rag/technical/data-model.md (现有数据模型)
+         - docs/rag/technical/coding-standards/ (编码规范)
+         - docs/rag/technical/middleware/ (中间件规范)
+
+      3. **加载现有架构信息**：
+         - 架构模式、技术栈、模块结构
+         - 现有数据实体和关系
+         - 编码规范和中间件使用方式
+
+      如果缺少必需文件，提示：
+      "⚠️ 缺少必需的输入文件：
+      - PRD文档：请先执行 PM 智能体 *create-prd-from-rag
+      - 技术知识库：请先执行 Analyst 智能体完善技术知识"
+
+  - id: document-header
+    title: 文档信息
+    sections:
+      - id: meta-info
+        title: 元信息
+        template: |
+          | 属性 | 值 |
+          |------|-----|
+          | 文档版本 | {{version}} |
+          | 生成时间 | {{timestamp}} |
+          | 关联PRD | {{prd_path}} |
+          | 技术知识库版本 | {{rag_version}} |
+          | 架构师 | Architect Agent |
+      - id: changelog
+        title: 变更日志
+        type: table
+        columns: [日期, 版本, 变更内容, 作者]
+
+  - id: existing-architecture-summary
+    title: 现有架构概要
+    instruction: |
+      从技术知识库提取现有架构信息，作为增量设计的基线。
+
+      **来源**：
+      - docs/rag/technical/architecture.md
+      - docs/rag/technical/tech-stack.md
+      - docs/rag/technical/module-structure.md
+    sections:
+      - id: architecture-pattern
+        title: 架构模式
+        instruction: 从 architecture.md 提取架构模式描述
+        template: |
+          **架构类型**: {{architecture_type}}
+          **分层结构**: {{layer_structure}}
+          **关键特征**: {{key_characteristics}}
+      - id: tech-stack-baseline
+        title: 技术栈基线
+        type: table
+        columns: [类别, 技术, 版本, 用途]
+        instruction: 从 tech-stack.md 提取当前技术栈
+      - id: module-structure-baseline
+        title: 模块结构基线
+        instruction: 从 module-structure.md 提取现有模块结构
+        type: code
+        language: plaintext
+      - id: data-model-baseline
+        title: 数据模型基线
+        instruction: |
+          从 data-model.md 提取现有数据实体清单。
+          使用Mermaid ER图展示核心实体关系。
+
+  - id: requirement-extraction
+    title: 需求提取
+    instruction: |
+      从PRD文档提取与架构相关的需求。
+
+      **来源**：
+      - docs/prd.md 或 docs/epic-{name}.md
+    sections:
+      - id: functional-requirements
+        title: 功能性需求摘要
+        type: table
+        columns: [需求ID, 需求描述, 架构影响, 优先级]
+        instruction: |
+          提取PRD中的功能性需求(FR)，评估每个需求的架构影响：
+          - 无影响：完全在现有架构内实现
+          - 小影响：需要新增类/方法
+          - 中影响：需要新增模块/表
+          - 大影响：需要架构调整
+      - id: non-functional-requirements
+        title: 非功能性需求摘要
+        type: table
+        columns: [需求ID, 需求描述, 约束类型, 架构影响]
+        instruction: 提取PRD中的非功能性需求(NFR)，特别关注性能、安全、可用性约束
+      - id: data-requirements
+        title: 数据需求摘要
+        type: table
+        columns: [实体名称, 操作类型, 核心属性, 关联实体]
+        instruction: |
+          从PRD中提取数据实体需求，标注：
+          - 新增：PRD中定义的新实体
+          - 修改：需要变更的现有实体
+          - 复用：直接使用的现有实体
+
+  - id: change-analysis
+    title: 架构变动分析
+    instruction: |
+      对比现有架构与新需求，识别所有技术变动点。
+
+      **分析维度**：
+      1. 架构层面变动
+      2. 技术栈变动
+      3. 数据模型变动
+      4. 接口变动
+      5. 中间件变动
+
+      展示分析结果，请用户确认变动识别是否准确。
+    elicit: true
+    sections:
+      - id: change-overview
+        title: 变动总览
+        template: |
+          | 维度 | 变动等级 | 变动数量 | 主要变动 |
+          |------|----------|----------|----------|
+          | 架构层面 | {{arch_level}} | {{arch_count}} | {{arch_main}} |
+          | 技术栈 | {{tech_level}} | {{tech_count}} | {{tech_main}} |
+          | 数据模型 | {{data_level}} | {{data_count}} | {{data_main}} |
+          | 接口 | {{api_level}} | {{api_count}} | {{api_main}} |
+          | 中间件 | {{mw_level}} | {{mw_count}} | {{mw_main}} |
+
+          **总体变动等级**: {{overall_level}}
+          **风险等级**: {{risk_level}}
+      - id: architecture-changes
+        title: 架构层面变动
+        condition: 存在架构层面变动
+        sections:
+          - id: new-modules
+            title: 新增模块
+            type: table
+            columns: [模块名称, 职责, 所属层, 关联需求]
+          - id: modified-modules
+            title: 修改模块
+            type: table
+            columns: [模块名称, 变更内容, 变更原因, 关联需求]
+      - id: tech-stack-changes
+        title: 技术栈变动
+        condition: 存在技术栈变动
+        sections:
+          - id: new-technologies
+            title: 新增技术
+            type: table
+            columns: [技术名称, 版本, 用途, 引入理由, 替代方案]
+          - id: version-upgrades
+            title: 版本升级
+            type: table
+            columns: [技术名称, 当前版本, 目标版本, 升级原因, 兼容性风险]
+      - id: data-model-changes
+        title: 数据模型变动
+        sections:
+          - id: new-entities
+            title: 新增实体
+            type: table
+            columns: [实体名称, 表名, 核心字段, 关联实体, 关联需求]
+          - id: modified-entities
+            title: 修改实体
+            type: table
+            columns: [实体名称, 变更字段, 变更类型, 兼容性, 关联需求]
+          - id: new-relationships
+            title: 新增关系
+            type: table
+            columns: [源实体, 目标实体, 关系类型, 关联字段, 关联需求]
+      - id: api-changes
+        title: 接口变动
+        condition: 存在接口变动
+        sections:
+          - id: new-apis
+            title: 新增API
+            type: table
+            columns: [接口路径, 方法, 功能描述, 关联需求]
+          - id: modified-apis
+            title: 修改API
+            type: table
+            columns: [接口路径, 变更内容, 兼容性策略, 关联需求]
+      - id: middleware-changes
+        title: 中间件变动
+        condition: 存在中间件变动
+        sections:
+          - id: redis-changes
+            title: Redis变动
+            type: table
+            columns: [Key名称, 数据结构, 用途, 过期策略, 关联需求]
+          - id: mq-changes
+            title: 消息队列变动
+            type: table
+            columns: [Topic/Queue, 消息类型, 生产者, 消费者, 关联需求]
+          - id: scheduler-changes
+            title: 定时任务变动
+            type: table
+            columns: [任务名称, 执行周期, 功能描述, 关联需求]
+
+  - id: incremental-design
+    title: 增量设计详情
+    instruction: |
+      为每个变动点提供详细的增量设计方案。
+      设计必须遵循知识库中的编码规范和中间件使用规范。
+    elicit: true
+    sections:
+      - id: module-design
+        title: 模块增量设计
+        repeatable: true
+        instruction: |
+          为每个新增/修改的模块提供详细设计。
+          包结构必须遵循 docs/rag/technical/module-structure.md 中的规范。
+        sections:
+          - id: module-detail
+            title: "{{module_name}}"
+            template: |
+              **模块类型**: 新增 / 修改
+              **职责描述**: {{responsibility}}
+              **所属层**: {{layer}}
+              **关联需求**: {{related_requirements}}
+            sections:
+              - id: package-structure
+                title: 包结构设计
+                instruction: 遵循现有模块结构规范设计包结构
+                type: code
+                language: plaintext
+              - id: class-design
+                title: 核心类设计
+                instruction: |
+                  列出核心类及其职责，命名遵循编码规范：
+                  - Controller: {Module}Controller
+                  - Service: {Module}Service / {Module}ServiceImpl
+                  - DAO: {Module}Mapper / {Module}Repository
+                type: table
+                columns: [类名, 类型, 职责, 依赖]
+              - id: integration-points
+                title: 集成点
+                instruction: 描述与现有模块的集成方式
+                type: bullet-list
+
+      - id: data-model-design
+        title: 数据模型增量设计
+        repeatable: true
+        instruction: |
+          为每个新增/修改的数据实体提供详细设计。
+          设计必须遵循 docs/rag/technical/sql-standards/ 中的规范。
+        sections:
+          - id: entity-detail
+            title: "{{entity_name}}"
+            template: |
+              **操作类型**: 新增 / 修改
+              **表名**: {{table_name}}
+              **关联需求**: {{related_requirements}}
+            sections:
+              - id: field-design
+                title: 字段设计
+                type: table
+                columns: [字段名, 类型, 长度, 约束, 默认值, 说明]
+                instruction: 字段命名遵循数据库命名规范
+              - id: index-design
+                title: 索引设计
+                type: table
+                columns: [索引名, 类型, 字段, 用途]
+                instruction: 索引命名遵循 idx_{表名}_{字段} 规范
+              - id: ddl-script
+                title: DDL脚本
+                type: code
+                language: sql
+                instruction: |
+                  生成DDL脚本，遵循SQL规范：
+                  - 包含完整的字段定义
+                  - 包含索引创建
+                  - 包含注释
+              - id: migration-script
+                title: 迁移脚本
+                condition: 修改现有表
+                type: code
+                language: sql
+                instruction: 生成安全的迁移脚本，考虑向后兼容性
+
+      - id: api-design
+        title: 接口增量设计
+        repeatable: true
+        condition: 存在接口变动
+        instruction: |
+          为每个新增/修改的API提供详细设计。
+          设计必须遵循现有API规范。
+        sections:
+          - id: api-detail
+            title: "{{api_name}}"
+            template: |
+              **操作类型**: 新增 / 修改
+              **接口路径**: {{api_path}}
+              **请求方法**: {{http_method}}
+              **功能描述**: {{description}}
+              **关联需求**: {{related_requirements}}
+            sections:
+              - id: request-design
+                title: 请求设计
+                sections:
+                  - id: request-params
+                    title: 请求参数
+                    type: table
+                    columns: [参数名, 类型, 必填, 说明, 示例]
+                  - id: request-body
+                    title: 请求体
+                    type: code
+                    language: json
+              - id: response-design
+                title: 响应设计
+                sections:
+                  - id: success-response
+                    title: 成功响应
+                    type: code
+                    language: json
+                  - id: error-codes
+                    title: 错误码
+                    type: table
+                    columns: [错误码, 错误信息, 触发场景]
+              - id: controller-skeleton
+                title: Controller骨架代码
+                type: code
+                language: java
+                instruction: |
+                  生成Controller骨架代码，遵循编码规范：
+                  - 使用正确的注解
+                  - 参数校验
+                  - 统一响应格式
+
+      - id: middleware-design
+        title: 中间件增量设计
+        condition: 存在中间件变动
+        instruction: |
+          为中间件使用提供详细设计。
+          必须参考 docs/rag/technical/middleware/ 中的规范和代码示例。
+        sections:
+          - id: redis-design
+            title: Redis设计
+            condition: 存在Redis变动
+            repeatable: true
+            sections:
+              - id: redis-detail
+                title: "{{redis_key_name}}"
+                template: |
+                  **Key模式**: {{key_pattern}}
+                  **数据结构**: {{data_structure}}
+                  **用途**: {{purpose}}
+                  **过期策略**: {{expiration}}
+                  **关联需求**: {{related_requirements}}
+                sections:
+                  - id: redis-code-example
+                    title: 代码示例
+                    type: code
+                    language: java
+                    instruction: 参考 docs/rag/technical/middleware/redis.md 中的代码示例
+          - id: mq-design
+            title: 消息队列设计
+            condition: 存在MQ变动
+            repeatable: true
+            sections:
+              - id: mq-detail
+                title: "{{topic_name}}"
+                template: |
+                  **Topic/Queue**: {{topic_queue}}
+                  **消息类型**: {{message_type}}
+                  **生产者**: {{producer}}
+                  **消费者**: {{consumer}}
+                  **关联需求**: {{related_requirements}}
+                sections:
+                  - id: message-schema
+                    title: 消息格式
+                    type: code
+                    language: json
+                  - id: producer-code
+                    title: 生产者代码示例
+                    type: code
+                    language: java
+                    instruction: 参考 docs/rag/technical/middleware/mq.md 中的代码示例
+                  - id: consumer-code
+                    title: 消费者代码示例
+                    type: code
+                    language: java
+          - id: scheduler-design
+            title: 定时任务设计
+            condition: 存在定时任务变动
+            repeatable: true
+            sections:
+              - id: scheduler-detail
+                title: "{{task_name}}"
+                template: |
+                  **任务名称**: {{task_name}}
+                  **执行周期**: {{cron_expression}}
+                  **功能描述**: {{description}}
+                  **关联需求**: {{related_requirements}}
+                sections:
+                  - id: scheduler-code
+                    title: 任务代码示例
+                    type: code
+                    language: java
+                    instruction: 参考 docs/rag/technical/middleware/scheduler.md 中的代码示例
+
+  - id: impact-assessment
+    title: 影响评估
+    instruction: 评估架构变动的影响范围和风险
+    elicit: true
+    sections:
+      - id: code-impact
+        title: 代码影响
+        template: |
+          **新增代码量估算**: {{new_code_estimate}}
+          **修改代码范围**: {{modified_code_scope}}
+          **测试代码需求**: {{test_code_requirement}}
+      - id: data-impact
+        title: 数据影响
+        template: |
+          **数据迁移需求**: {{migration_requirement}}
+          **数据一致性风险**: {{consistency_risk}}
+          **备份恢复策略**: {{backup_strategy}}
+      - id: performance-impact
+        title: 性能影响
+        template: |
+          **新增负载评估**: {{load_estimate}}
+          **资源需求变化**: {{resource_change}}
+          **性能测试要求**: {{performance_test_requirement}}
+      - id: deployment-impact
+        title: 部署影响
+        template: |
+          **部署步骤变更**: {{deployment_change}}
+          **配置变更**: {{config_change}}
+          **回滚方案**: {{rollback_plan}}
+
+  - id: risk-analysis
+    title: 风险分析
+    sections:
+      - id: risk-list
+        title: 风险清单
+        type: table
+        columns: [风险ID, 风险类型, 风险描述, 可能性, 影响, 缓解措施]
+        instruction: |
+          识别所有风险，类型包括：
+          - 技术风险：新技术引入、兼容性、性能
+          - 业务风险：功能影响、数据安全、服务可用性
+          - 实施风险：复杂度、技能匹配、时间约束
+      - id: critical-risks
+        title: 关键风险详述
+        instruction: 对高风险项提供详细分析和缓解方案
+        repeatable: true
+        template: |
+          ### {{risk_name}}
+
+          **风险描述**: {{description}}
+          **可能性**: {{probability}}
+          **影响程度**: {{impact}}
+
+          **根因分析**: {{root_cause}}
+
+          **缓解措施**:
+          {{mitigation_measures}}
+
+          **应急预案**:
+          {{contingency_plan}}
+
+          **监控指标**:
+          {{monitoring_metrics}}
+
+  - id: implementation-guide
+    title: 实施指南
+    sections:
+      - id: implementation-sequence
+        title: 实施顺序
+        instruction: |
+          基于依赖关系，规划实施顺序。
+          每个阶段对应PRD中的Epic/Story。
+        type: numbered-list
+        template: |
+          1. **阶段1: {{phase1_name}}**
+             - Story: {{story_refs}}
+             - 前置条件: {{prerequisites}}
+             - 产出物: {{deliverables}}
+             - 检查点: {{checkpoints}}
+      - id: dependency-diagram
+        title: 依赖关系图
+        type: mermaid
+        mermaid_type: graph
+        instruction: 使用Mermaid图展示实施依赖关系
+      - id: checkpoints
+        title: 关键检查点
+        type: table
+        columns: [检查点, 阶段, 验证内容, 负责人]
+
+  - id: knowledge-references
+    title: 知识引用索引
+    instruction: 列出设计中引用的所有知识库文档
+    sections:
+      - id: architecture-refs
+        title: 架构知识引用
+        type: table
+        columns: [文件路径, 引用章节, 引用内容]
+      - id: coding-standard-refs
+        title: 编码规范引用
+        type: table
+        columns: [文件路径, 引用规范, 应用位置]
+      - id: middleware-refs
+        title: 中间件规范引用
+        type: table
+        columns: [文件路径, 引用示例, 应用位置]
+
+  - id: next-steps
+    title: 后续步骤
+    sections:
+      - id: developer-handoff
+        title: 开发者交接
+        instruction: |
+          生成给开发者的交接提示，包含：
+          - 需要阅读的文档清单
+          - 编码规范要点
+          - 实施注意事项
+        template: |
+          **交接给开发者**
+
+          请基于本架构增量设计文档进行开发：
+
+          **必读文档**：
+          - 架构增量设计: docs/architecture-increment.md
+          - PRD文档: {{prd_path}}
+          - 编码规范: docs/rag/technical/coding-standards/
+
+          **开发重点**：
+          - 变动模块: {{changed_modules}}
+          - 数据模型变更: {{data_changes}}
+          - 接口变更: {{api_changes}}
+
+          **注意事项**：
+          - 严格遵循编码规范
+          - 参考中间件代码示例
+          - 每个Story完成后进行集成验证
+
+          **执行命令**: *start-development docs/architecture-increment.md
+      - id: qa-handoff
+        title: QA交接
+        instruction: |
+          生成给QA的交接提示，包含：
+          - 测试范围
+          - 重点测试项
+          - 回归测试要求
+        template: |
+          **交接给QA**
+
+          请基于本架构增量设计制定测试计划：
+
+          **必读文档**：
+          - 架构增量设计: docs/architecture-increment.md (影响评估章节)
+          - PRD文档: {{prd_path}} (验收标准)
+
+          **测试范围**：
+          - 新增功能: {{new_features}}
+          - 修改功能: {{modified_features}}
+          - 回归范围: {{regression_scope}}
+
+          **重点关注**：
+          - 数据迁移验证
+          - 接口兼容性测试
+          - 性能影响验证
+
+          **执行命令**: *create-test-plan docs/architecture-increment.md
+==================== END: .xiaoma-core/templates/incremental-architecture-tmpl.yaml ====================
+
 ==================== START: .xiaoma-core/checklists/architect-checklist.md ====================
 <!-- Powered by XiaoMa™ Core -->