@zeyue0329/xiaoma-cli 1.0.48 → 1.0.49

package/dist/teams/team-fullstack-with-database.txt

@@ -1132,6 +1132,7 @@ commands:
   - create-brownfield-story: 运行任务 brownfield-create-story.md
   - create-epic: 为现有项目项目创建模块 (任务 brownfield-create-epic)
   - create-prd: 使用模板 prd-tmpl.yaml 运行任务 create-doc.md
+  - create-prd-from-rag: 基于Analyst需求分析产出物生成PRD (任务 create-prd-from-rag.md，模板 prd-from-rag-tmpl.yaml)
   - create-story: 从需求创建用户故事 (任务 brownfield-create-story)
   - doc-out: 将完整文档输出到当前目标文件
   - shard-prd: 为提供的 prd.md 运行任务 shard-doc.md (如果未找到则询问)
@@ -1149,11 +1150,13 @@ dependencies:
     - correct-course.md
     - create-deep-research-prompt.md
     - create-doc.md
+    - create-prd-from-rag.md
     - execute-checklist.md
     - shard-doc.md
   templates:
     - brownfield-prd-tmpl.yaml
     - prd-tmpl.yaml
+    - prd-from-rag-tmpl.yaml
 ```
 ==================== END: .xiaoma-core/agents/pm.md ====================
 
@@ -1246,6 +1249,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)
@@ -1262,6 +1266,7 @@ dependencies:
   tasks:
     - create-deep-research-prompt.md
     - create-doc.md
+    - create-incremental-architecture.md
     - document-project.md
     - execute-checklist.md
     - shard-doc.md
@@ -1270,6 +1275,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 ====================
 
@@ -1354,16 +1360,56 @@ persona:
   role: 技术 Scrum Master - 故事准备专家
   style: 任务导向、高效、精确、专注于清晰的开发者交接
   identity: 为 AI 开发者准备详细、可操作故事的故事创建专家
-  focus: 创建清晰明了的故事，以便“愚笨的”AI 智能体可以毫无困惑地实施
+  focus: 创建清晰明了的故事，以便"愚笨的"AI 智能体可以毫无困惑地实施
   core_principles:
-    - 严格遵循 `create-next-story` 流程来生成详细的用户故事
-    - 将确保所有信息都来自 PRD 和架构文档，以指导“愚笨的”开发智能体
+    - 严格遵循 `create-next-story` 或 `create-story-with-rag` 流程来生成详细的用户故事
+    - 将确保所有信息都来自 PRD、架构文档和知识库，以指导"愚笨的"开发智能体
     - 你绝对不允许实施故事或修改任何代码！
+    - 知识库对接规则: 当使用 draft-with-rag 命令时，必须融合知识库中的业务规则、技术规范和架构增量设计
+    - 知识库文件路径:
+        - 需求分析报告: docs/rag/_analysis-report.md
+        - 业务规则: docs/rag/business/rules-*.md
+        - 架构增量设计: docs/architecture-increment.md
+        - 编码规范: docs/rag/technical/coding-standards/
+        - 模块结构: docs/rag/technical/module-structure.md
+        - 中间件规范: docs/rag/technical/middleware/
+        - 安全约束: docs/rag/constraints/security.md
+        - 性能约束: docs/rag/constraints/performance.md
+    - 知识引用记录: 故事创建后必须在 Knowledge References 部分记录引用的知识文件
 commands:
   - help: 显示以下命令的编号列表以供选择
   - correct-course: 执行任务 correct-course.md
   - draft: 执行任务 create-next-story.md
   - draft-enhanced: 执行任务 create-enhanced-story-with-database.md (增强版用户故事，包含数据库和API设计)
+  - draft-with-rag:
+      - description: 基于知识库和架构增量设计创建用户故事 (任务 create-story-with-rag.md)
+      - workflow: |
+          1. 加载知识上下文
+             - 读取架构增量设计 (docs/architecture-increment.md)
+             - 读取需求分析报告 (docs/rag/_analysis-report.md)
+             - 读取业务规则 (docs/rag/business/rules-*.md)
+             - 读取编码规范 (docs/rag/technical/coding-standards/)
+             - 读取约束条件 (docs/rag/constraints/)
+          2. 识别下一个 Story，提取 Epic 中的 Story 定义
+          3. 知识融合生成:
+             - AC增强: 融合业务规则和约束条件
+             - 任务生成: 基于架构增量设计生成详细任务
+             - Dev Notes: 整合架构设计、编码规范、中间件示例
+          4. 生成 Story 文件，记录 Knowledge References
+          5. 执行 story-draft-checklist 验证
+      - knowledge-sources:
+          - docs/architecture-increment.md
+          - docs/rag/_analysis-report.md
+          - docs/rag/business/rules-*.md
+          - docs/rag/technical/coding-standards/
+          - docs/rag/technical/module-structure.md
+          - docs/rag/technical/middleware/
+          - docs/rag/constraints/
+      - output-enhancements:
+          - AC增强: 融合业务规则细节和技术约束
+          - 任务详细化: 每个任务带有架构设计参考
+          - Dev Notes: 包含完整的技术上下文和代码示例参考
+          - Knowledge References: 记录所有引用的知识文件
   - story-checklist: 使用清单 story-draft-checklist.md 执行任务 execute-checklist.md
   - exit: 作为 Scrum Master 道别，然后放弃扮演此角色
 dependencies:
@@ -1373,11 +1419,29 @@ dependencies:
     - correct-course.md
     - create-next-story.md
     - create-enhanced-story-with-database.md
+    - create-story-with-rag.md
     - execute-checklist.md
   templates:
     - story-tmpl.yaml
+    - story-with-rag-tmpl.yaml
     - enhanced-story-with-database-tmpl.yaml
     - api-design-tmpl.yaml
+  knowledge-files:
+    description: 知识库文件路径（按需加载，执行 draft-with-rag 时使用）
+    analysis:
+      - docs/rag/_analysis-report.md
+      - docs/rag/_requirement-parsing.yaml
+    business:
+      - docs/rag/business/rules-*.md
+    architecture:
+      - docs/architecture-increment.md
+    technical:
+      - docs/rag/technical/coding-standards/
+      - docs/rag/technical/module-structure.md
+      - docs/rag/technical/middleware/
+    constraints:
+      - docs/rag/constraints/security.md
+      - docs/rag/constraints/performance.md
 ```
 ==================== END: .xiaoma-core/agents/sm.md ====================
 
@@ -1407,9 +1471,20 @@ persona:
 core_principles:
   - 关键提示: 除了您在启动命令期间加载的内容外，故事（Story）中已包含您需要的所有信息。除非故事笔记中明确指示或用户直接命令，否则绝不加载 PRD/架构/其他文档文件。
   - 关键提示: 在开始您的故事任务之前，务必检查当前的文件夹结构，如果工作目录已存在，请勿创建新的。当您确定这是一个全新的项目时，才创建一个新的。
-  - 关键提示: 仅更新故事文件中的 Dev Agent Record 部分 (复选框/Debug Log/Completion Notes/Change Log)
-  - 关键提示: 当用户告诉您实施故事时，请遵循 develop-story 命令
+  - 关键提示: 仅更新故事文件中的 Dev Agent Record 部分 (复选框/Debug Log/Completion Notes/Change Log/Knowledge References)
+  - 关键提示: 当用户告诉您实施故事时，请遵循 develop-story 或 develop-story-with-rag 命令
   - 编号选项 - 向用户呈现选择时，始终使用编号列表
+  - 知识库对接规则: 当使用 develop-story-with-rag 命令时，必须加载并遵循知识库中的技术规范
+  - 知识库文件路径:
+      - 架构增量设计: docs/architecture-increment.md
+      - 编码规范: docs/rag/technical/coding-standards/
+      - 模块结构: docs/rag/technical/module-structure.md
+      - 数据模型: docs/rag/technical/data-model.md
+      - 中间件规范: docs/rag/technical/middleware/
+      - SQL规范: docs/rag/technical/sql-standards/
+      - 安全约束: docs/rag/constraints/security.md
+      - 性能约束: docs/rag/constraints/performance.md
+  - 知识引用记录: 开发完成后必须在故事文件的 Knowledge References 部分记录引用的知识文件
 commands:
   - help: 显示以下命令的编号列表以供选择
   - develop-story:
@@ -1421,17 +1496,71 @@ commands:
       - blocking: 在以下情况暂停：需要未经批准的依赖项，与用户确认 | 检查故事后发现内容模糊 | 尝试实现或修复某问题连续失败3次 | 缺少配置 | 回归测试失败
       - ready-for-review: 代码符合需求 + 所有验证通过 + 遵循标准 + File List 已完成
       - completion: '所有任务和子任务都标记为 [x] 并且有测试→验证和完整回归测试通过 (不要偷懒，执行所有测试并确认)→确保 File List 已完成→为清单 story-dod-checklist 运行任务 execute-checklist→设置故事状态为: ''Ready for Review''→暂停'
+  - develop-story-with-rag:
+      - description: 基于知识库和架构增量设计开发用户故事 (任务 develop-story-with-rag.md)
+      - order-of-execution: |
+          1. 加载知识上下文
+             - 读取架构增量设计 (docs/architecture-increment.md)
+             - 读取相关编码规范 (docs/rag/technical/coding-standards/)
+             - 读取模块结构 (docs/rag/technical/module-structure.md)
+             - 按需读取中间件规范 (docs/rag/technical/middleware/)
+             - 按需读取SQL规范 (docs/rag/technical/sql-standards/)
+             - 按需读取约束条件 (docs/rag/constraints/)
+          2. 读取当前任务，分析任务类型，匹配相关规范
+          3. 按照知识库规范实现任务（命名、分层、异常处理、日志等）
+          4. 参考中间件代码示例实现缓存/消息/定时任务
+          5. 编写测试，执行验证
+          6. 更新故事文件，记录 Knowledge References
+          7. 重复直至完成所有任务
+      - knowledge-loading-strategy:
+          - 按需加载: 仅加载当前任务所需的规范文件
+          - 优先级: 编码规范 > 架构设计 > 中间件规范 > SQL规范 > 约束条件
+          - 任务类型匹配:
+              - 数据模型任务: docs/rag/technical/sql-standards/, docs/architecture-increment.md#数据模型增量设计
+              - 接口开发任务: docs/rag/technical/coding-standards/, docs/architecture-increment.md#接口增量设计
+              - 业务逻辑任务: docs/rag/technical/coding-standards/, docs/rag/technical/module-structure.md
+              - 中间件任务: docs/rag/technical/middleware/redis.md, docs/rag/technical/middleware/mq.md, docs/rag/technical/middleware/scheduler.md
+      - story-file-updates-ONLY:
+          - 关键提示: 仅使用对下述部分的更新来更新故事文件。请勿修改任何其他部分。
+          - 关键提示: 您仅被授权编辑故事文件的这些特定部分 - Tasks / Subtasks 复选框, Dev Agent Record 部分及其所有子部分, Agent Model Used, Debug Log References, Completion Notes List, File List, Knowledge References, Change Log, Status
+          - Knowledge References 格式: |
+              ## Knowledge References
+              | 知识文件 | 引用内容 | 应用位置 |
+              |----------|----------|----------|
+              | docs/rag/technical/coding-standards/naming.md | 类命名规范 | XxxController.java |
+      - blocking: 在以下情况暂停：架构增量设计与故事任务严重不一致 | 知识库规范相互冲突 | 安全约束无法满足 | 连续3次实现失败 | 需要未批准的依赖
+      - ready-for-review: 代码符合需求 + 所有验证通过 + 遵循知识库规范 + File List 已完成 + Knowledge References 已记录
+      - completion: 所有任务标记为 [x] + 测试通过→确保 File List 和 Knowledge References 已完成→执行 story-dod-checklist→设置状态为 'Ready for Review'→暂停
   - explain: 详细地教我你刚才做了什么以及为什么这么做，以便我能学习。请像培训初级工程师一样向我解释。
   - review-qa: 运行任务 `apply-qa-fixes.md`
   - run-tests: 执行代码规范检查和测试
+  - load-knowledge: 手动加载指定的知识库文件，用于查阅规范或代码示例
   - exit: 作为开发人员道别，然后放弃扮演此角色
 dependencies:
   checklists:
     - story-dod-checklist.md
   tasks:
     - apply-qa-fixes.md
+    - develop-story-with-rag.md
     - execute-checklist.md
     - validate-next-story.md
+  knowledge-files:
+    description: 知识库文件路径（按需加载，非启动时加载）
+    architecture:
+      - docs/architecture-increment.md
+    technical:
+      - 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/technical/coding-standards/
+      - docs/rag/technical/middleware/redis.md
+      - docs/rag/technical/middleware/mq.md
+      - docs/rag/technical/middleware/scheduler.md
+      - docs/rag/technical/sql-standards/
+    constraints:
+      - docs/rag/constraints/security.md
+      - docs/rag/constraints/performance.md
 ```
 ==================== END: .xiaoma-core/agents/dev.md ====================
 
@@ -8405,6 +8534,444 @@ The story creation is successful when:
 - **Implicit:** An annotated change-checklist (or the record of its completion) reflecting the discussions, findings, and decisions made during the process.
 ==================== END: .xiaoma-core/tasks/correct-course.md ====================
 
+==================== START: .xiaoma-core/tasks/create-prd-from-rag.md ====================
+# 基于需求分析创建PRD任务
+
+## Purpose
+
+基于 Analyst 智能体的需求分析产出物（`docs/rag/` 目录），结合原始需求文档，生成高质量的 PRD 或 Epic 文档。本任务是 Analyst 智能体的下游任务，承接需求分析报告并转化为可执行的产品文档。
+
+## 上游交接物
+
+```yaml
+必需输入:
+  - docs/rag/_analysis-report.md      # 需求分析报告（核心输入）
+  - docs/rag/_requirement-parsing.yaml # 需求解析结果
+  - req.txt                            # 原始需求文档
+
+可选输入:
+  - docs/rag/_questions.md            # 问题清单
+  - docs/rag/_index.md                # 知识索引
+  - docs/rag/business/                # 业务知识
+  - docs/rag/technical/               # 技术知识
+  - docs/rag/constraints/             # 约束条件
+```
+
+## Workflow Overview
+
+```
+Analyst产出物 → 输入验证 → 复杂度评估 → 文档类型选择 → 文档生成 → 质量检查
+```
+
+---
+
+## Phase 1: 输入验证与上下文加载
+
+### 1.1 验证上游交接物
+
+```yaml
+执行步骤:
+  步骤1_检查必需文件:
+    动作: 检查 docs/rag/ 目录是否存在以下文件
+    必需文件:
+      - _analysis-report.md
+      - _requirement-parsing.yaml
+    缺失处理: |
+      如果缺失必需文件，提示用户：
+      "未找到需求分析报告。请先执行 Analyst 智能体的 *analyze-requirement 命令完成需求分析。"
+
+  步骤2_加载分析报告:
+    动作: 读取并解析 _analysis-report.md
+    提取内容:
+      - 需求概述（背景、目标、范围）
+      - 功能分析（功能清单、优先级、依赖关系）
+      - 用户分析（角色、旅程）
+      - 数据分析（实体、关系）
+      - 技术分析（可行性、兼容性）
+      - 业务规则汇总
+      - 差距分析
+      - 风险分析
+      - 待澄清事项
+
+  步骤3_加载原始需求:
+    动作: 读取 req.txt 原始需求文档
+    目的: 确保不遗漏原始需求中的细节
+
+  步骤4_加载知识上下文:
+    动作: 扫描 docs/rag/ 子目录，加载相关知识文件
+    加载顺序:
+      - technical/architecture.md      # 技术架构
+      - technical/coding-standards/    # 编码规范
+      - technical/data-model.md        # 数据模型
+      - business/                      # 业务知识
+      - constraints/                   # 约束条件
+```
+
+### 1.2 上下文整合
+
+```yaml
+整合输出:
+  项目上下文:
+    - 项目背景与目标
+    - 技术栈与架构约束
+    - 现有系统兼容性要求
+
+  需求上下文:
+    - 功能清单与优先级
+    - 用户角色与权限
+    - 数据实体与关系
+    - 业务规则
+
+  约束上下文:
+    - 技术约束
+    - 安全合规要求
+    - 性能要求
+
+  风险上下文:
+    - 已识别风险
+    - 待澄清事项
+```
+
+---
+
+## Phase 2: 复杂度评估与文档类型选择
+
+### 2.1 复杂度评估矩阵
+
+```yaml
+评估维度:
+  功能复杂度:
+    低: 功能点 <= 3，无复杂业务流程
+    中: 功能点 4-8，存在中等复杂度业务流程
+    高: 功能点 > 8，存在复杂业务流程或多系统集成
+
+  技术复杂度:
+    低: 遵循现有模式，无架构变更
+    中: 部分新技术引入，小范围架构调整
+    高: 重大技术决策，架构级变更
+
+  集成复杂度:
+    低: 单一系统，无外部集成
+    中: 2-3个系统集成
+    高: 多系统集成，复杂数据流
+
+  风险等级:
+    低: 风险清单中无高风险项
+    中: 存在1-2个中等风险项
+    高: 存在高风险项或多个中等风险项
+```
+
+### 2.2 文档类型选择规则
+
+```yaml
+选择规则:
+  生成完整PRD:
+    条件:
+      - 功能复杂度 >= 中 OR
+      - 技术复杂度 >= 中 OR
+      - 需要架构设计 OR
+      - 涉及多个Epic
+    输出: docs/prd.md
+    模板: prd-from-rag-tmpl.yaml
+
+  生成单Epic:
+    条件:
+      - 功能复杂度 = 低
+      - 技术复杂度 = 低
+      - 可在1-3个Story内完成
+      - 无重大架构变更
+    输出: docs/epic-{name}.md
+    模板: epic-from-rag-tmpl.yaml
+
+  需要澄清:
+    条件:
+      - 待澄清事项 > 5 OR
+      - 存在阻塞性待澄清项
+    动作: 暂停生成，先与用户澄清关键问题
+```
+
+### 2.3 交互确认
+
+```yaml
+确认点:
+  展示内容:
+    - 复杂度评估结果
+    - 建议的文档类型
+    - 预计的Epic/Story数量
+    - 关键风险提示
+
+  用户选项:
+    - 确认并继续
+    - 调整文档类型
+    - 先澄清待定事项
+```
+
+---
+
+## Phase 3: PRD文档生成
+
+### 3.1 PRD结构映射
+
+将分析报告内容映射到PRD结构：
+
+```yaml
+映射规则:
+  目标与背景:
+    来源: 分析报告.需求概述
+    映射:
+      - 需求背景 → PRD.背景上下文
+      - 核心目标 → PRD.目标
+      - 范围边界 → PRD.范围定义
+
+  需求章节:
+    来源: 分析报告.功能分析 + 业务规则汇总
+    映射:
+      - 功能清单 → PRD.功能性需求 (FR)
+      - 业务规则 → PRD.功能性需求 (补充)
+      - 技术分析.性能要求 → PRD.非功能性需求 (NFR)
+      - 约束条件 → PRD.非功能性需求 (NFR)
+
+  UI设计目标:
+    来源: 分析报告.用户分析
+    映射:
+      - 用户角色 → PRD.用户角色定义
+      - 用户旅程 → PRD.关键交互范式
+      - 功能清单中的UI相关项 → PRD.核心屏幕与视图
+
+  技术假设:
+    来源: docs/rag/technical/ + 分析报告.技术分析
+    映射:
+      - architecture.md → PRD.服务架构
+      - coding-standards/ → PRD.编码规范约束
+      - 技术可行性评估 → PRD.技术假设
+
+  Epic结构:
+    来源: 分析报告.功能分析
+    映射:
+      - 功能清单(按优先级分组) → Epic列表
+      - 功能依赖关系 → Story顺序
+      - P0功能 → Epic 1 (核心功能)
+      - P1功能 → Epic 2+ (增强功能)
+
+  风险与待办:
+    来源: 分析报告.风险分析 + 待澄清事项
+    映射:
+      - 风险清单 → PRD.风险评估
+      - 待澄清事项 → PRD.开放问题
+```
+
+### 3.2 Epic/Story 生成规则
+
+```yaml
+Epic生成规则:
+  分组策略:
+    - 按功能模块分组
+    - 每个Epic交付独立可测试的功能增量
+    - Epic 1 优先包含P0功能
+    - 后续Epic按优先级和依赖关系排列
+
+  Epic结构:
+    - Epic标题
+    - Epic目标 (2-3句话)
+    - 包含的功能点
+    - 技术实现要点（来自技术知识）
+    - Story列表
+
+Story生成规则:
+  拆分策略:
+    - 每个Story是垂直切片
+    - 单个AI Agent会话可完成（2-4小时工作量）
+    - 明确的输入输出边界
+
+  Story结构:
+    - Story标题
+    - 用户故事格式 (As a... I want... So that...)
+    - 验收标准 (基于分析报告中的业务规则)
+    - 技术实现提示（来自技术知识）
+    - 集成验证点（来自数据关系分析）
+
+  排序规则:
+    - 基础设施优先
+    - 数据模型优先于业务逻辑
+    - 核心流程优先于边缘场景
+    - 遵循功能依赖关系图
+```
+
+### 3.3 知识融合
+
+```yaml
+知识融合点:
+  业务规则融合:
+    来源: docs/rag/business/rules-*.md
+    融合到: 验收标准、业务逻辑描述
+
+  数据模型融合:
+    来源: docs/rag/technical/data-model.md
+    融合到: 数据实体定义、关联关系说明
+
+  编码规范融合:
+    来源: docs/rag/technical/coding-standards/
+    融合到: 技术实现提示、代码示例引用
+
+  中间件规范融合:
+    来源: docs/rag/technical/middleware/
+    融合到: 技术假设、实现约束
+
+  安全要求融合:
+    来源: docs/rag/constraints/security.md
+    融合到: 非功能性需求、验收标准
+```
+
+---
+
+## Phase 4: 质量检查与输出
+
+### 4.1 PRD质量检查清单
+
+```yaml
+完整性检查:
+  - [ ] 所有P0功能已覆盖
+  - [ ] 所有P1功能已覆盖或标记为后续迭代
+  - [ ] 所有已识别的业务规则已融入
+  - [ ] 所有数据实体已定义
+  - [ ] 所有用户角色已覆盖
+
+一致性检查:
+  - [ ] 功能需求与分析报告一致
+  - [ ] 技术假设与知识库一致
+  - [ ] Epic/Story顺序符合依赖关系
+  - [ ] 验收标准可测试
+
+可执行性检查:
+  - [ ] 每个Story大小适合AI Agent执行
+  - [ ] Story之间无循环依赖
+  - [ ] 技术实现路径清晰
+  - [ ] 风险缓解措施具体
+
+交接完整性检查:
+  - [ ] 包含UX专家提示
+  - [ ] 包含架构师提示
+  - [ ] 待澄清事项已列出
+```
+
+### 4.2 输出文件
+
+```yaml
+主输出:
+  PRD文档:
+    路径: docs/prd.md
+    格式: Markdown
+
+  或 Epic文档:
+    路径: docs/epic-{name}.md
+    格式: Markdown
+
+辅助输出:
+  知识引用索引:
+    路径: docs/prd-knowledge-refs.md
+    内容: PRD中引用的知识文件清单
+
+  待澄清事项:
+    路径: docs/prd-open-questions.md
+    内容: 需要进一步确认的问题
+```
+
+---
+
+## Phase 5: 下游交接
+
+### 5.1 交接给UX专家
+
+```yaml
+UX专家交接:
+  必读文件:
+    - docs/prd.md (UI设计目标章节)
+    - docs/rag/_analysis-report.md (用户分析章节)
+
+  关注点:
+    - 用户角色与权限
+    - 核心屏幕与视图
+    - 关键用户旅程
+    - 无障碍性要求
+
+  建议命令: "*create-ux-design docs/prd.md"
+```
+
+### 5.2 交接给架构师
+
+```yaml
+架构师交接:
+  必读文件:
+    - docs/prd.md (技术假设章节)
+    - docs/rag/technical/ (技术知识目录)
+    - docs/rag/_analysis-report.md (技术分析章节)
+
+  关注点:
+    - 技术栈与架构约束
+    - 数据模型与关系
+    - 集成点与接口
+    - 性能与安全要求
+
+  建议命令: "*create-architecture docs/prd.md"
+```
+
+---
+
+## 使用说明
+
+### 激活命令
+
+```
+*create-prd-from-rag [rag_path]
+```
+
+### 执行参数
+
+```yaml
+参数:
+  rag_path: RAG知识目录路径 (默认: docs/rag/)
+  output_path: PRD输出路径 (默认: docs/prd.md)
+  doc_type: 文档类型 (auto|prd|epic, 默认: auto)
+  interactive: 交互模式 (默认: true)
+```
+
+### 交互模式流程
+
+1. **验证阶段**: 检查上游交接物完整性
+2. **评估阶段**: 展示复杂度评估结果，确认文档类型
+3. **生成阶段**: 逐章节生成PRD，关键节点请求确认
+4. **检查阶段**: 执行质量检查清单
+5. **输出阶段**: 生成最终文档，提示下游交接
+
+### YOLO模式
+
+通过 `*yolo` 命令切换YOLO模式，一次性完成所有步骤，跳过中间确认环节。
+
+---
+
+## 任务完成标志
+
+```yaml
+完成条件:
+  必要输出:
+    - docs/prd.md 或 docs/epic-{name}.md
+
+  完成提示: |
+    ✅ PRD/Epic 文档生成完成！
+
+    📄 输出文件: {output_path}
+    📊 Epic数量: {epic_count}
+    📝 Story数量: {story_count}
+
+    🔄 下一步建议:
+    - UX设计: *create-ux-design docs/prd.md
+    - 架构设计: *create-architecture docs/prd.md
+
+    ⚠️ 待澄清事项: {open_questions_count} 项
+    请在开发前确认这些问题。
+```
+==================== END: .xiaoma-core/tasks/create-prd-from-rag.md ====================
+
 ==================== START: .xiaoma-core/tasks/execute-checklist.md ====================
 <!-- Powered by XIAOMA™ Core -->
 
@@ -8969,96 +9536,509 @@ sections:
               - template: "IV3: {{performance_impact_verification}}"
 ==================== END: .xiaoma-core/templates/brownfield-prd-tmpl.yaml ====================
 
-==================== START: .xiaoma-core/checklists/change-checklist.md ====================
-<!-- Powered by XiaoMa™ Core -->
-
-# Change Navigation Checklist
+==================== START: .xiaoma-core/templates/prd-from-rag-tmpl.yaml ====================
+template:
+  id: prd-from-rag-template-v1
+  name: 基于需求分析的PRD文档
+  version: 1.0
+  description: 基于Analyst智能体的需求分析产出物生成PRD
+  output:
+    format: markdown
+    filename: docs/prd.md
+    title: "{{project_name}} 产品需求文档 (PRD)"
 
-**Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow.
+workflow:
+  mode: interactive
+  elicitation: advanced-elicitation
+  upstream:
+    agent: analyst
+    required_files:
+      - docs/rag/_analysis-report.md
+      - docs/rag/_requirement-parsing.yaml
+    optional_files:
+      - docs/rag/_questions.md
+      - docs/rag/_index.md
+      - docs/rag/business/*
+      - docs/rag/technical/*
+      - docs/rag/constraints/*
 
-**Instructions:** Review each item with the user. Mark `[x]` for completed/confirmed, `[N/A]` if not applicable, or add notes for discussion points.
+sections:
+  - id: input-validation
+    title: 输入验证
+    internal: true
+    instruction: |
+      在开始生成PRD之前，执行以下验证：
 
-[[LLM: INITIALIZATION INSTRUCTIONS - CHANGE NAVIGATION
+      1. **检查必需文件**：
+         - docs/rag/_analysis-report.md 是否存在
+         - docs/rag/_requirement-parsing.yaml 是否存在
+         - req.txt 原始需求文档是否存在
 
-Changes during development are inevitable, but how we handle them determines project success or failure.
+      2. **加载分析报告**：
+         - 读取并解析 _analysis-report.md 的所有章节
+         - 提取关键信息：功能清单、用户角色、数据实体、风险、待澄清事项
 
-Before proceeding, understand:
+      3. **加载知识上下文**：
+         - 扫描 docs/rag/technical/ 获取技术约束
+         - 扫描 docs/rag/business/ 获取业务规则
+         - 扫描 docs/rag/constraints/ 获取约束条件
 
-1. This checklist is for SIGNIFICANT changes that affect the project direction
-2. Minor adjustments within a story don't require this process
-3. The goal is to minimize wasted work while adapting to new realities
-4. User buy-in is critical - they must understand and approve changes
+      如果缺少必需文件，提示：
+      "⚠️ 未找到需求分析报告。请先执行 Analyst 智能体完成需求分析：*analyze-requirement req.txt"
 
-Required context:
+  - id: complexity-assessment
+    title: 复杂度评估
+    instruction: |
+      基于分析报告内容，评估项目复杂度并推荐文档类型。
 
-- The triggering story or issue
-- Current project state (completed stories, current epic)
-- Access to PRD, architecture, and other key documents
-- Understanding of remaining work planned
+      **评估维度**：
+      1. 功能复杂度：基于功能清单数量和依赖关系
+      2. 技术复杂度：基于技术可行性评估
+      3. 集成复杂度：基于数据关系和外部依赖
+      4. 风险等级：基于风险清单
 
-APPROACH:
-This is an interactive process with the user. Work through each section together, discussing implications and options. The user makes final decisions, but provide expert guidance on technical feasibility and impact.
+      **推荐文档类型**：
+      - 完整PRD：复杂度 >= 中等，或涉及多个Epic
+      - 单Epic：复杂度低，可在1-3个Story内完成
 
-REMEMBER: Changes are opportunities to improve, not failures. Handle them professionally and constructively.]]
+      展示评估结果并请用户确认文档类型。
+    elicit: true
+    sections:
+      - id: assessment-result
+        title: 评估结果
+        type: table
+        columns: [评估维度, 等级, 依据]
+      - id: recommendation
+        title: 推荐方案
+        instruction: 基于评估结果给出文档类型推荐和理由
 
----
+  - id: goals-context
+    title: 目标与背景
+    instruction: |
+      从分析报告的"需求概述"章节提取内容，映射到PRD结构。
 
-## 1. Understand the Trigger & Context
+      **映射规则**：
+      - 分析报告.需求背景 → 背景上下文
+      - 分析报告.核心目标 → 目标
+      - 分析报告.范围边界 → 范围定义
 
-[[LLM: Start by fully understanding what went wrong and why. Don't jump to solutions yet. Ask probing questions:
+      如果分析报告中信息不足，参考 req.txt 原始需求补充。
+    sections:
+      - id: goals
+        title: 目标
+        type: bullet-list
+        instruction: |
+          从分析报告提取核心目标，转换为PRD目标格式。
+          每个目标应该是：
+          - 可衡量的成果
+          - 用户或业务价值
+          - 与原始需求对应
+      - id: background
+        title: 背景上下文
+        type: paragraphs
+        instruction: |
+          综合以下来源生成背景描述：
+          - 分析报告.需求背景
+          - 分析报告.业务分析
+          - 原始需求文档中的背景信息
+      - id: scope
+        title: 范围定义
+        instruction: 从分析报告.范围边界提取，明确包含和不包含的内容
+        sections:
+          - id: in-scope
+            title: 范围内
+            type: bullet-list
+          - id: out-of-scope
+            title: 范围外
+            type: bullet-list
+      - id: changelog
+        title: 变更日志
+        type: table
+        columns: [日期, 版本, 描述, 作者]
 
-- What exactly happened that triggered this review?
-- Is this a one-time issue or symptomatic of a larger problem?
-- Could this have been anticipated earlier?
-- What assumptions were incorrect?
+  - id: requirements
+    title: 需求
+    instruction: |
+      从分析报告的"功能分析"和"业务规则汇总"章节提取需求。
 
-Be specific and factual, not blame-oriented.]]
+      **功能性需求来源**：
+      - 分析报告.功能清单 → FR列表
+      - 分析报告.业务规则 → FR补充说明
+      - docs/rag/business/rules-*.md → 详细规则
 
-- [ ] **Identify Triggering Story:** Clearly identify the story (or stories) that revealed the issue.
-- [ ] **Define the Issue:** Articulate the core problem precisely.
-  - [ ] Is it a technical limitation/dead-end?
-  - [ ] Is it a newly discovered requirement?
-  - [ ] Is it a fundamental misunderstanding of existing requirements?
-  - [ ] Is it a necessary pivot based on feedback or new information?
-  - [ ] Is it a failed/abandoned story needing a new approach?
-- [ ] **Assess Initial Impact:** Describe the immediate observed consequences (e.g., blocked progress, incorrect functionality, non-viable tech).
-- [ ] **Gather Evidence:** Note any specific logs, error messages, user feedback, or analysis that supports the issue definition.
+      **非功能性需求来源**：
+      - 分析报告.技术分析.性能要求
+      - docs/rag/constraints/security.md
+      - docs/rag/constraints/performance.md
 
-## 2. Epic Impact Assessment
+      确保每个需求都可追溯到分析报告或知识库文档。
+    elicit: true
+    sections:
+      - id: functional
+        title: 功能性需求
+        type: numbered-list
+        prefix: FR
+        instruction: |
+          按优先级排列功能性需求：
+          - P0功能优先列出
+          - 每个FR包含：需求描述 + 来源标注
+          - 复杂业务规则单独标注参考文档
 
-[[LLM: Changes ripple through the project structure. Systematically evaluate:
+          格式示例：
+          FR1: [P0] 用户可以创建订单 (来源: 分析报告.功能清单.F001)
+        examples:
+          - "FR1: [P0] 系统支持用户通过手机号注册账户 (来源: _analysis-report.md#功能清单)"
+          - "FR2: [P0] 订单状态流转遵循：待支付→已支付→已发货→已完成 (来源: business/rules-order.md)"
+      - id: non-functional
+        title: 非功能性需求
+        type: numbered-list
+        prefix: NFR
+        instruction: |
+          从约束条件和技术分析中提取非功能性需求。
+          包括：性能、安全、可用性、兼容性等。
+        examples:
+          - "NFR1: 接口响应时间P99 < 500ms (来源: constraints/performance.md)"
+          - "NFR2: 敏感数据传输必须使用HTTPS加密 (来源: constraints/security.md)"
 
-1. Can we salvage the current epic with modifications?
-2. Do future epics still make sense given this change?
-3. Are we creating or eliminating dependencies?
-4. Does the epic sequence need reordering?
+  - id: data-model
+    title: 数据模型
+    instruction: |
+      从分析报告的"数据分析"章节和技术知识中提取数据模型。
 
-Think about both immediate and downstream effects.]]
+      **来源**：
+      - 分析报告.数据实体清单
+      - 分析报告.数据关系图
+      - docs/rag/technical/data-model.md
+    sections:
+      - id: entities
+        title: 数据实体
+        type: table
+        columns: [实体名称, 描述, 核心属性, 来源]
+        instruction: 列出所有数据实体及其核心属性
+      - id: relationships
+        title: 数据关系
+        instruction: |
+          描述实体间的关系，使用Mermaid ER图表示。
+          从分析报告.数据关系图提取，补充详细说明。
+        examples:
+          - |
+            ```mermaid
+            erDiagram
+                User ||--o{ Order : creates
+                Order ||--|{ OrderItem : contains
+            ```
 
-- [ ] **Analyze Current Epic:**
-  - [ ] Can the current epic containing the trigger story still be completed?
-  - [ ] Does the current epic need modification (story changes, additions, removals)?
-  - [ ] Should the current epic be abandoned or fundamentally redefined?
-- [ ] **Analyze Future Epics:**
-  - [ ] Review all remaining planned epics.
-  - [ ] Does the issue require changes to planned stories in future epics?
-  - [ ] Does the issue invalidate any future epics?
-  - [ ] Does the issue necessitate the creation of entirely new epics?
-  - [ ] Should the order/priority of future epics be changed?
-- [ ] **Summarize Epic Impact:** Briefly document the overall effect on the project's epic structure and flow.
+  - id: technical-constraints
+    title: 技术约束
+    instruction: |
+      整合技术知识库中的约束条件，指导后续架构设计。
+
+      **来源**：
+      - docs/rag/technical/architecture.md
+      - docs/rag/technical/tech-stack.md
+      - docs/rag/technical/coding-standards/
+      - docs/rag/technical/middleware/
+      - 分析报告.技术分析.与现有系统兼容性
+    elicit: true
+    sections:
+      - id: tech-stack
+        title: 技术栈约束
+        instruction: |
+          从技术知识库提取技术栈要求：
+          - 后端框架和版本
+          - 数据库类型和版本
+          - 中间件要求
+        template: |
+          **后端**: {{backend_framework}}
+          **数据库**: {{database}}
+          **缓存**: {{cache}}
+          **消息队列**: {{mq}}
+      - id: architecture-constraints
+        title: 架构约束
+        instruction: 从 architecture.md 提取架构模式和约束
+      - id: coding-standards
+        title: 编码规范约束
+        instruction: |
+          从 coding-standards/ 目录提取关键规范：
+          - 命名规范
+          - 分层规范
+          - 异常处理规范
+      - id: integration-constraints
+        title: 集成约束
+        instruction: 从分析报告.技术分析提取集成相关约束
 
-## 3. Artifact Conflict & Impact Analysis
+  - id: epic-list
+    title: 模块列表
+    instruction: |
+      基于分析报告的功能分析，规划Epic结构。
 
-[[LLM: Documentation drives development in BMad. Check each artifact:
+      **规划原则**：
+      - 按功能优先级分组：P0功能 → Epic 1
+      - 遵循功能依赖关系
+      - 每个Epic交付独立可测试的功能增量
 
-1. Does this change invalidate documented decisions?
-2. Are architectural assumptions still valid?
-3. Do user flows need rethinking?
-4. Are technical constraints different than documented?
+      **Epic分组策略**：
+      1. 从分析报告.功能清单提取所有功能
+      2. 按优先级排序：P0 > P1 > P2
+      3. 分析依赖关系，确定Epic边界
+      4. 每个Epic包含相关联的功能集
 
-Be thorough - missed conflicts cause future problems.]]
+      展示Epic列表，请用户确认分组是否合理。
+    elicit: true
+    sections:
+      - id: epic-overview
+        title: Epic概览
+        type: table
+        columns: [Epic, 标题, 包含功能, 优先级, Story数量(预估)]
+        instruction: 展示所有Epic的概览表格
 
-- [ ] **Review PRD:**
+  - id: epic-details
+    title: "Epic {{epic_number}}: {{epic_title}}"
+    repeatable: true
+    instruction: |
+      为每个Epic生成详细内容，包含所有Story和验收标准。
+
+      **Epic内容来源**：
+      - 分析报告.功能清单 (对应功能)
+      - 分析报告.业务规则 (相关规则)
+      - docs/rag/business/ (详细业务知识)
+      - docs/rag/technical/ (技术实现参考)
+
+      **Story生成规则**：
+      - 每个Story是垂直切片
+      - 单个AI Agent会话可完成（2-4小时）
+      - 验收标准来源于分析报告中的业务规则
+      - 包含技术实现提示（来自技术知识）
+
+      **Story排序**：
+      - 遵循分析报告.功能依赖关系
+      - 基础设施和数据模型优先
+      - 核心流程优先于边缘场景
+    elicit: true
+    template: |
+      **Epic目标**: {{epic_goal}}
+
+      **包含功能**:
+      {{功能列表，来源于分析报告}}
+
+      **技术要点**:
+      {{技术实现要点，来源于技术知识库}}
+    sections:
+      - id: story
+        title: "Story {{epic_number}}.{{story_number}}: {{story_title}}"
+        repeatable: true
+        template: |
+          作为一名 {{user_type}}，
+          我想要 {{action}}，
+          以便 {{benefit}}。
+        sections:
+          - id: acceptance-criteria
+            title: 验收标准
+            type: numbered-list
+            instruction: |
+              从以下来源生成验收标准：
+              - 分析报告.业务规则 (对应规则)
+              - docs/rag/business/rules-*.md (详细规则)
+              - 分析报告.数据分析 (数据约束)
+
+              每个标准必须：
+              - 可测试、可验证
+              - 明确无歧义
+              - 包含边界条件
+            item_template: "AC{{criterion_number}}: {{criteria}} (来源: {{source}})"
+          - id: technical-hints
+            title: 技术实现提示
+            instruction: |
+              从技术知识库提取实现提示：
+              - 相关编码规范
+              - 中间件使用示例
+              - 数据模型参考
+            type: bullet-list
+          - id: knowledge-refs
+            title: 知识引用
+            instruction: 列出Story实现时需要参考的知识文档
+            type: bullet-list
+
+  - id: risks-and-open-items
+    title: 风险与待澄清事项
+    instruction: |
+      从分析报告直接提取风险和待澄清事项。
+
+      **来源**：
+      - 分析报告.风险分析
+      - 分析报告.待澄清事项
+    sections:
+      - id: risks
+        title: 风险清单
+        type: table
+        columns: [风险ID, 风险描述, 等级, 缓解措施]
+        instruction: 从分析报告.风险清单直接映射
+      - id: open-questions
+        title: 待澄清事项
+        type: table
+        columns: [序号, 问题, 上下文, 建议选项, 状态]
+        instruction: |
+          从分析报告.待澄清事项提取。
+          标注状态：待确认/已确认/已关闭
+          在PRD评审时需要逐一确认这些问题。
+
+  - id: knowledge-index
+    title: 知识引用索引
+    instruction: |
+      列出本PRD引用的所有知识文档，便于追溯和维护。
+    sections:
+      - id: analysis-refs
+        title: 分析报告引用
+        type: table
+        columns: [章节, 引用位置, 用途]
+      - id: knowledge-refs
+        title: 知识库引用
+        type: table
+        columns: [文件路径, 引用位置, 用途]
+
+  - id: next-steps
+    title: 后续步骤
+    sections:
+      - id: ux-expert-prompt
+        title: UX专家交接
+        instruction: |
+          生成给UX专家的交接提示，包含：
+          - 需要关注的用户角色
+          - 核心屏幕和交互
+          - 品牌和无障碍要求
+          - 相关知识文档路径
+        template: |
+          **交接给UX专家**
+
+          请基于本PRD的用户分析部分设计UI/UX方案：
+
+          **关键输入**：
+          - PRD文档: docs/prd.md
+          - 用户分析: docs/rag/_analysis-report.md#用户分析
+          - 用户角色: {{user_roles}}
+          - 核心屏幕: {{core_screens}}
+
+          **设计重点**：
+          {{design_focus}}
+
+          **执行命令**: *create-ux-design docs/prd.md
+      - id: architect-prompt
+        title: 架构师交接
+        instruction: |
+          生成给架构师的交接提示，包含：
+          - 技术栈约束
+          - 数据模型要点
+          - 集成需求
+          - 相关知识文档路径
+        template: |
+          **交接给架构师**
+
+          请基于本PRD和技术知识库设计系统架构：
+
+          **关键输入**：
+          - PRD文档: docs/prd.md
+          - 技术分析: docs/rag/_analysis-report.md#技术分析
+          - 技术知识: docs/rag/technical/
+          - 数据模型: docs/rag/technical/data-model.md
+
+          **架构重点**：
+          - 技术栈: {{tech_stack}}
+          - 关键集成点: {{integration_points}}
+          - 性能要求: {{performance_requirements}}
+
+          **执行命令**: *create-architecture docs/prd.md
+==================== END: .xiaoma-core/templates/prd-from-rag-tmpl.yaml ====================
+
+==================== START: .xiaoma-core/checklists/change-checklist.md ====================
+<!-- Powered by XiaoMa™ Core -->
+
+# Change Navigation Checklist
+
+**Purpose:** To systematically guide the selected Agent and user through the analysis and planning required when a significant change (pivot, tech issue, missing requirement, failed story) is identified during the BMad workflow.
+
+**Instructions:** Review each item with the user. Mark `[x]` for completed/confirmed, `[N/A]` if not applicable, or add notes for discussion points.
+
+[[LLM: INITIALIZATION INSTRUCTIONS - CHANGE NAVIGATION
+
+Changes during development are inevitable, but how we handle them determines project success or failure.
+
+Before proceeding, understand:
+
+1. This checklist is for SIGNIFICANT changes that affect the project direction
+2. Minor adjustments within a story don't require this process
+3. The goal is to minimize wasted work while adapting to new realities
+4. User buy-in is critical - they must understand and approve changes
+
+Required context:
+
+- The triggering story or issue
+- Current project state (completed stories, current epic)
+- Access to PRD, architecture, and other key documents
+- Understanding of remaining work planned
+
+APPROACH:
+This is an interactive process with the user. Work through each section together, discussing implications and options. The user makes final decisions, but provide expert guidance on technical feasibility and impact.
+
+REMEMBER: Changes are opportunities to improve, not failures. Handle them professionally and constructively.]]
+
+---
+
+## 1. Understand the Trigger & Context
+
+[[LLM: Start by fully understanding what went wrong and why. Don't jump to solutions yet. Ask probing questions:
+
+- What exactly happened that triggered this review?
+- Is this a one-time issue or symptomatic of a larger problem?
+- Could this have been anticipated earlier?
+- What assumptions were incorrect?
+
+Be specific and factual, not blame-oriented.]]
+
+- [ ] **Identify Triggering Story:** Clearly identify the story (or stories) that revealed the issue.
+- [ ] **Define the Issue:** Articulate the core problem precisely.
+  - [ ] Is it a technical limitation/dead-end?
+  - [ ] Is it a newly discovered requirement?
+  - [ ] Is it a fundamental misunderstanding of existing requirements?
+  - [ ] Is it a necessary pivot based on feedback or new information?
+  - [ ] Is it a failed/abandoned story needing a new approach?
+- [ ] **Assess Initial Impact:** Describe the immediate observed consequences (e.g., blocked progress, incorrect functionality, non-viable tech).
+- [ ] **Gather Evidence:** Note any specific logs, error messages, user feedback, or analysis that supports the issue definition.
+
+## 2. Epic Impact Assessment
+
+[[LLM: Changes ripple through the project structure. Systematically evaluate:
+
+1. Can we salvage the current epic with modifications?
+2. Do future epics still make sense given this change?
+3. Are we creating or eliminating dependencies?
+4. Does the epic sequence need reordering?
+
+Think about both immediate and downstream effects.]]
+
+- [ ] **Analyze Current Epic:**
+  - [ ] Can the current epic containing the trigger story still be completed?
+  - [ ] Does the current epic need modification (story changes, additions, removals)?
+  - [ ] Should the current epic be abandoned or fundamentally redefined?
+- [ ] **Analyze Future Epics:**
+  - [ ] Review all remaining planned epics.
+  - [ ] Does the issue require changes to planned stories in future epics?
+  - [ ] Does the issue invalidate any future epics?
+  - [ ] Does the issue necessitate the creation of entirely new epics?
+  - [ ] Should the order/priority of future epics be changed?
+- [ ] **Summarize Epic Impact:** Briefly document the overall effect on the project's epic structure and flow.
+
+## 3. Artifact Conflict & Impact Analysis
+
+[[LLM: Documentation drives development in BMad. Check each artifact:
+
+1. Does this change invalidate documented decisions?
+2. Are architectural assumptions still valid?
+3. Do user flows need rethinking?
+4. Are technical constraints different than documented?
+
+Be thorough - missed conflicts cause future problems.]]
+
+- [ ] **Review PRD:**
   - [ ] Does the issue conflict with the core goals or requirements stated in the PRD?
   - [ ] Does the PRD need clarification or updates based on the new understanding?
 - [ ] **Review Architecture Document:**
@@ -9952,122 +10932,650 @@ sections:
     instruction: 如果存在 UI/UX 清单，请用其检查本文档并在此处报告结果。
 ==================== END: .xiaoma-core/templates/front-end-spec-tmpl.yaml ====================
 
-==================== START: .xiaoma-core/templates/architecture-tmpl.yaml ====================
-template:
-  id: architecture-template-v2
-  name: 架构文档
-  version: 2.0
-  output:
-    format: markdown
-    filename: docs/architecture.md
-    title: "{{project_name}} Architecture Document"
+==================== START: .xiaoma-core/tasks/create-incremental-architecture.md ====================
+# 基于知识库的架构增量设计任务
 
-workflow:
-  mode: interactive
-  elicitation: advanced-elicitation
+## Purpose
 
-sections:
-  - id: introduction
-    title: 引言
-    instruction: |
-      如果可以，请在开始前审查所有提供的相关文档以收集全部背景信息。如果至少无法找到 docs/prd.md，请询问用户哪些文档将为架构设计提供基础。
-    sections:
-      - id: intro-content
-        content: |
-          本文档概述了 {{project_name}} 的整体项目架构，包括后端系统、共享服务以及非 UI 特定的问题。其主要目标是作为 AI 驱动开发的指导性架构蓝图，确保遵循所选模式和技术的一致性。
+基于 Analyst 智能体的技术知识库产出（`docs/rag/technical/`）和 PM 智能体生成的 PRD/Epic 文档，进行架构增量设计。通过对比现有技术架构与新需求，识别技术变动点，生成架构增量设计文档。
 
-          **与前端架构的关系：**
-          如果项目包含重要的用户界面，将有一份独立的前端架构文档详细说明前端特定的设计，并且该文档必须与本文档结合使用。本文档中记录的核心技术栈选择（见“技术栈”）对整个项目（包括任何前端组件）具有决定性作用。
-      - id: starter-template
-        title: 启动模板或现有项目
-        instruction: |
-          在进一步进行架构设计之前，请检查项目是否基于启动模板或现有代码库：
+## 上游交接物
 
-          1. 审查 PRD 和头脑风暴简报中是否提及：
-          - 启动模板（例如，Create React App, Next.js, Vue CLI, Angular CLI 等）
-          - 作为基础的现有项目或代码库
-          - 脚手架项目或工具
-          - 需要克隆或改造的先前项目
+```yaml
+必需输入:
+  PRD/Epic文档:
+    - docs/prd.md                       # PM生成的PRD文档
+    - 或 docs/epic-{name}.md            # PM生成的Epic文档
 
-          2. 如果提及了启动模板或现有项目：
-          - 要求用户通过以下方式之一提供访问权限：
-            - 启动模板文档的链接
-            - 上传/附加项目文件（适用于小型项目）
-            - 分享项目仓库的链接（GitHub, GitLab 等）
-          - 分析启动模板/现有项目以了解：
-            - 预配置的技术栈和版本
-            - 项目结构和组织模式
-            - 内置脚本和工具
-            - 现有的架构模式和约定
-            - 启动模板带来的任何限制或约束
-          - 利用此分析来指导和调整您的架构决策
+  技术知识库:
+    - docs/rag/technical/architecture.md       # 现有技术架构
+    - docs/rag/technical/tech-stack.md         # 技术栈详情
+    - docs/rag/technical/module-structure.md   # 模块结构
+    - docs/rag/technical/data-model.md         # 数据模型
 
-          3. 如果没有提及启动模板但这是一个全新的项目：
-          - 根据技术栈偏好建议合适的启动模板
-          - 解释其好处（更快的设置、最佳实践、社区支持）
-          - 让用户决定是否使用
+可选输入:
+  分析报告:
+    - docs/rag/_analysis-report.md      # 需求分析报告（技术分析章节）
 
-          4. 如果用户确认不使用启动模板：
-          - 从头开始进行架构设计
-          - 注意所有工具和配置都需要手动设置
+  编码规范:
+    - docs/rag/technical/coding-standards/    # 编码规范目录
+    - docs/rag/technical/middleware/          # 中间件规范目录
 
-          在继续进行架构设计之前，在此处记录决策。如果没有，则填写“不适用”。
-        elicit: true
-      - id: changelog
-        title: 变更日志
-        type: table
-        columns: [日期, 版本, 描述, 作者]
-        instruction: 跟踪文档版本和变更
+  约束条件:
+    - docs/rag/constraints/security.md        # 安全要求
+    - docs/rag/constraints/performance.md     # 性能要求
+```
 
-  - id: high-level-architecture
-    title: 高层架构
-    instruction: |
-      本节包含多个为架构奠定基础的子章节。请一次性呈现所有子章节。
-    elicit: true
-    sections:
-      - id: technical-summary
-        title: 技术摘要
-        instruction: |
-          提供一段简短的概述（3-5句话），内容包括：
-          - 系统的整体架构风格
-          - 关键组件及其关系
-          - 主要的技术选择
-          - 使用的核心架构模式
-          - 回顾 PRD 目标以及此架构如何支持这些目标
-      - id: high-level-overview
-        title: 高层概览
-        instruction: |
-          根据 PRD 的技术假设部分，描述：
+## Workflow Overview
 
-          1. 主要的架构风格（例如，单体、微服务、无服务器、事件驱动）
-          2. PRD 中决定的仓库结构（Monorepo/Polyrepo）
-          3. PRD 中决定的服务架构
-          4. 概念层面上的主要用户交互流程或数据流
-          5. 关键的架构决策及其理由
-      - id: project-diagram
-        title: 高层项目图
-        type: mermaid
-        mermaid_type: graph
-        instruction: |
-          创建一个 Mermaid 图，以可视化高层架构。考虑：
-          - 系统边界
-          - 主要组件/服务
-          - 数据流方向
-          - 外部集成
-          - 用户入口点
+```
+技术知识库 + PRD → 架构差异分析 → 变动点识别 → 增量设计 → 影响评估 → 架构增量文档
+```
 
-      - id: architectural-patterns
-        title: 架构与设计模式
-        instruction: |
-          列出将指导架构的关键高层模式。对于每个模式：
+---
 
-          1. 如果存在多个选项，请提出 2-3 个可行的方案
-          2. 提出您的建议并附上明确的理由
-          3. 在最终确定前获得用户确认
-          4. 这些模式应与 PRD 的技术假设和项目目标保持一致
+## Phase 1: 输入验证与上下文加载
 
-          需要考虑的常见模式：
-          - 架构风格模式（无服务器、事件驱动、微服务、CQRS、六边形架构）
+### 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/templates/architecture-tmpl.yaml ====================
+template:
+  id: architecture-template-v2
+  name: 架构文档
+  version: 2.0
+  output:
+    format: markdown
+    filename: docs/architecture.md
+    title: "{{project_name}} Architecture Document"
+
+workflow:
+  mode: interactive
+  elicitation: advanced-elicitation
+
+sections:
+  - id: introduction
+    title: 引言
+    instruction: |
+      如果可以，请在开始前审查所有提供的相关文档以收集全部背景信息。如果至少无法找到 docs/prd.md，请询问用户哪些文档将为架构设计提供基础。
+    sections:
+      - id: intro-content
+        content: |
+          本文档概述了 {{project_name}} 的整体项目架构，包括后端系统、共享服务以及非 UI 特定的问题。其主要目标是作为 AI 驱动开发的指导性架构蓝图，确保遵循所选模式和技术的一致性。
+
+          **与前端架构的关系：**
+          如果项目包含重要的用户界面，将有一份独立的前端架构文档详细说明前端特定的设计，并且该文档必须与本文档结合使用。本文档中记录的核心技术栈选择（见“技术栈”）对整个项目（包括任何前端组件）具有决定性作用。
+      - id: starter-template
+        title: 启动模板或现有项目
+        instruction: |
+          在进一步进行架构设计之前，请检查项目是否基于启动模板或现有代码库：
+
+          1. 审查 PRD 和头脑风暴简报中是否提及：
+          - 启动模板（例如，Create React App, Next.js, Vue CLI, Angular CLI 等）
+          - 作为基础的现有项目或代码库
+          - 脚手架项目或工具
+          - 需要克隆或改造的先前项目
+
+          2. 如果提及了启动模板或现有项目：
+          - 要求用户通过以下方式之一提供访问权限：
+            - 启动模板文档的链接
+            - 上传/附加项目文件（适用于小型项目）
+            - 分享项目仓库的链接（GitHub, GitLab 等）
+          - 分析启动模板/现有项目以了解：
+            - 预配置的技术栈和版本
+            - 项目结构和组织模式
+            - 内置脚本和工具
+            - 现有的架构模式和约定
+            - 启动模板带来的任何限制或约束
+          - 利用此分析来指导和调整您的架构决策
+
+          3. 如果没有提及启动模板但这是一个全新的项目：
+          - 根据技术栈偏好建议合适的启动模板
+          - 解释其好处（更快的设置、最佳实践、社区支持）
+          - 让用户决定是否使用
+
+          4. 如果用户确认不使用启动模板：
+          - 从头开始进行架构设计
+          - 注意所有工具和配置都需要手动设置
+
+          在继续进行架构设计之前，在此处记录决策。如果没有，则填写“不适用”。
+        elicit: true
+      - id: changelog
+        title: 变更日志
+        type: table
+        columns: [日期, 版本, 描述, 作者]
+        instruction: 跟踪文档版本和变更
+
+  - id: high-level-architecture
+    title: 高层架构
+    instruction: |
+      本节包含多个为架构奠定基础的子章节。请一次性呈现所有子章节。
+    elicit: true
+    sections:
+      - id: technical-summary
+        title: 技术摘要
+        instruction: |
+          提供一段简短的概述（3-5句话），内容包括：
+          - 系统的整体架构风格
+          - 关键组件及其关系
+          - 主要的技术选择
+          - 使用的核心架构模式
+          - 回顾 PRD 目标以及此架构如何支持这些目标
+      - id: high-level-overview
+        title: 高层概览
+        instruction: |
+          根据 PRD 的技术假设部分，描述：
+
+          1. 主要的架构风格（例如，单体、微服务、无服务器、事件驱动）
+          2. PRD 中决定的仓库结构（Monorepo/Polyrepo）
+          3. PRD 中决定的服务架构
+          4. 概念层面上的主要用户交互流程或数据流
+          5. 关键的架构决策及其理由
+      - id: project-diagram
+        title: 高层项目图
+        type: mermaid
+        mermaid_type: graph
+        instruction: |
+          创建一个 Mermaid 图，以可视化高层架构。考虑：
+          - 系统边界
+          - 主要组件/服务
+          - 数据流方向
+          - 外部集成
+          - 用户入口点
+
+      - id: architectural-patterns
+        title: 架构与设计模式
+        instruction: |
+          列出将指导架构的关键高层模式。对于每个模式：
+
+          1. 如果存在多个选项，请提出 2-3 个可行的方案
+          2. 提出您的建议并附上明确的理由
+          3. 在最终确定前获得用户确认
+          4. 这些模式应与 PRD 的技术假设和项目目标保持一致
+
+          需要考虑的常见模式：
+          - 架构风格模式（无服务器、事件驱动、微服务、CQRS、六边形架构）
           - 代码组织模式（依赖注入、仓库、模块、工厂）
           - 数据模式（事件溯源、Saga、每个服务一个数据库）
           - 通信模式（REST, GraphQL, 消息队列, 发布/订阅）
@@ -12287,20 +13795,624 @@ sections:
     instruction: 在运行检查清单前，提议输出完整的架构文档。一旦用户确认，执行 architect-checklist 并在此处填充结果。
 ==================== END: .xiaoma-core/templates/fullstack-architecture-tmpl.yaml ====================
 
-==================== START: .xiaoma-core/checklists/architect-checklist.md ====================
-<!-- Powered by XiaoMa™ Core -->
+==================== 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}} 架构增量设计文档"
 
-# Architect Solution Validation Checklist
+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/*
 
-This checklist serves as a comprehensive framework for the Architect to validate the technical design and architecture before development execution. The Architect should systematically work through each item, ensuring the architecture is robust, scalable, secure, and aligned with the product requirements.
+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: [日期, 版本, 变更内容, 作者]
 
-[[LLM: INITIALIZATION INSTRUCTIONS - REQUIRED ARTIFACTS
+  - id: existing-architecture-summary
+    title: 现有架构概要
+    instruction: |
+      从技术知识库提取现有架构信息，作为增量设计的基线。
 
-Before proceeding with this checklist, ensure you have access to:
+      **来源**：
+      - 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图展示核心实体关系。
 
-1. architecture.md - The primary architecture document (check docs/architecture.md)
-2. prd.md - Product Requirements Document for requirements alignment (check docs/prd.md)
-3. frontend-architecture.md or fe-architecture.md - If this is a UI project (check docs/frontend-architecture.md)
+  - 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 -->
+
+# Architect Solution Validation Checklist
+
+This checklist serves as a comprehensive framework for the Architect to validate the technical design and architecture before development execution. The Architect should systematically work through each item, ensuring the architecture is robust, scalable, secure, and aligned with the product requirements.
+
+[[LLM: INITIALIZATION INSTRUCTIONS - REQUIRED ARTIFACTS
+
+Before proceeding with this checklist, ensure you have access to:
+
+1. architecture.md - The primary architecture document (check docs/architecture.md)
+2. prd.md - Product Requirements Document for requirements alignment (check docs/prd.md)
+3. frontend-architecture.md or fe-architecture.md - If this is a UI project (check docs/frontend-architecture.md)
 4. Any system diagrams referenced in the architecture
 5. API documentation if available
 6. Technology stack details and version specifications
@@ -13727,94 +15839,1019 @@ benefit: "{{user_benefit}}"
 - [ ] 错误处理机制明确
 - [ ] 数据映射关系清晰
 
-#### 3.2 一致性检查
+#### 3.2 一致性检查
+
+- [ ] API参数与数据库字段对应
+- [ ] 数据类型一致
+- [ ] 业务规则与数据库约束匹配
+- [ ] 接口设计符合RESTful规范
+
+#### 3.3 可实现性检查
+
+- [ ] 任务分解合理可执行
+- [ ] 技术实现方案可行
+- [ ] 测试覆盖充分
+- [ ] 开发者说明详细
+
+### 4. 输出文件
+
+生成的用户故事文件：`docs/stories/{{epic_num}}.{{story_num}}.{{story_title_short}}.md`
+
+### 5. 后续协作
+
+#### 5.1 与开发者协作
+
+- 确保开发者理解数据库设计和API规范
+- 提供必要的技术支持和澄清
+- 跟踪开发进度和问题解决
+
+#### 5.2 与QA协作
+
+- 明确测试重点和验收标准
+- 提供API测试用例和数据
+- 确保质量标准得到执行
+
+## 模板使用示例
+
+### 示例：用户注册功能
+
+**用户故事**：
+
+> 作为新用户，我希望能够注册账户，以便使用系统的各项功能。
+
+**相关实体**：
+
+- Users表：存储用户基本信息
+- UserProfiles表：存储用户详细资料
+
+**涉及API**：
+
+- POST /api/users：创建用户账户
+- POST /api/users/verify-email：验证邮箱
+- GET /api/users/check-username：检查用户名可用性
+
+**数据操作**：
+
+- 插入用户基本信息到users表
+- 验证用户名和邮箱的唯一性
+- 创建用户会话信息
+
+**API详细设计**：
+
+```json
+// POST /api/users
+{
+  "username": "johndoe",
+  "email": "john@example.com",
+  "password": "hashedPassword"
+}
+
+// 响应
+{
+  "code": 200,
+  "message": "用户创建成功",
+  "data": {
+    "userId": 12345,
+    "username": "johndoe",
+    "email": "john@example.com",
+    "status": "active"
+  }
+}
+```
+
+## 注意事项
+
+1. **数据一致性**：确保API设计与数据库设计保持一致
+2. **安全性**：考虑数据验证、权限控制和敏感信息保护
+3. **性能**：关注查询效率和接口响应时间
+4. **可维护性**：保持代码结构清晰和文档完整
+5. **可测试性**：确保功能可以被充分测试
+==================== END: .xiaoma-core/tasks/create-enhanced-story-with-database.md ====================
+
+==================== START: .xiaoma-core/tasks/create-story-with-rag.md ====================
+# 基于知识库的用户故事创建任务
+
+## Purpose
+
+基于知识库（`docs/rag/`）中的业务知识、技术知识以及架构增量设计文档（`docs/architecture-increment.md`），创建详细、可操作且自包含的用户故事。确保故事内容与真实需求、业务规则和技术规范完全对齐，使开发智能体能够高效实施。
+
+## 上游交接物
+
+```yaml
+必需输入:
+  PRD/Epic文档:
+    - docs/prd.md                               # PM生成的PRD文档
+    - 或 docs/prd/{epic-name}.md                # 切分后的Epic文档
+
+  架构增量设计:
+    - docs/architecture-increment.md            # Architect生成的增量设计
+
+  需求分析报告:
+    - docs/rag/_analysis-report.md              # Analyst生成的需求分析报告
+
+可选输入:
+  业务知识库:
+    - docs/rag/business/rules-*.md              # 业务规则文件
+    - docs/rag/_requirement-parsing.yaml        # 需求解析结果
+
+  技术知识库:
+    - 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/technical/coding-standards/      # 编码规范目录
+    - docs/rag/technical/middleware/            # 中间件规范目录
+    - docs/rag/technical/sql-standards/         # SQL规范目录
+
+  约束条件:
+    - docs/rag/constraints/security.md          # 安全要求
+    - docs/rag/constraints/performance.md       # 性能要求
+
+  上一个故事:
+    - docs/project/stories/{epic}.{story-1}.*.md  # 上一个完成的故事
+```
+
+## Workflow Overview
+
+```
+PRD/Epic + 知识库 + 架构增量设计 → 识别Story → 知识融合 → 生成详细Story → 检查清单验证
+```
+
+---
+
+## Phase 0: 加载核心配置与知识上下文
+
+### 0.1 加载核心配置
+
+```yaml
+执行步骤:
+  步骤1_加载配置:
+    动作: 读取 .xiaoma-core/core-config.yaml
+    提取:
+      - devStoryLocation     # 故事文件存放位置
+      - prd.*                # PRD配置
+      - architecture.*       # 架构文档配置
+    缺失处理: |
+      如果配置文件不存在，提示：
+      "core-config.yaml 未找到。请先配置项目。"
+```
+
+### 0.2 验证上游交接物
+
+```yaml
+执行步骤:
+  步骤1_检查PRD:
+    动作: 检查 docs/prd.md 或切分后的 Epic 文件
+    缺失处理: 提示执行 PM 智能体 *create-prd-from-rag
+
+  步骤2_检查架构增量设计:
+    动作: 检查 docs/architecture-increment.md
+    缺失处理: |
+      如果不存在：
+      - 提示执行 Architect 智能体 *create-incremental-architecture
+      - 或询问是否使用传统架构文档继续
+
+  步骤3_检查需求分析报告:
+    动作: 检查 docs/rag/_analysis-report.md
+    缺失处理: |
+      如果不存在：
+      - 提示执行 Analyst 智能体完成需求分析
+      - 或询问是否仅使用 PRD 继续（功能受限）
+
+  步骤4_扫描知识库:
+    动作: 扫描 docs/rag/ 目录，识别可用的知识文件
+    输出:
+      available_knowledge:
+        business_rules: [文件列表]
+        technical_specs: [文件列表]
+        constraints: [文件列表]
+```
+
+### 0.3 知识上下文整合
+
+```yaml
+知识整合:
+  业务上下文:
+    来源:
+      - docs/rag/_analysis-report.md#功能分析
+      - docs/rag/_analysis-report.md#业务规则汇总
+      - docs/rag/business/rules-*.md
+    提取内容:
+      - 功能清单与优先级
+      - 业务规则与约束
+      - 用户角色与权限
+      - 数据实体与关系
+
+  技术上下文:
+    来源:
+      - docs/architecture-increment.md
+      - docs/rag/technical/coding-standards/
+      - docs/rag/technical/module-structure.md
+      - docs/rag/technical/middleware/
+    提取内容:
+      - 模块设计与包结构
+      - 数据模型设计与DDL
+      - 接口设计与API规范
+      - 中间件使用方式与代码示例
+      - 编码规范要点
+
+  约束上下文:
+    来源:
+      - docs/rag/constraints/security.md
+      - docs/rag/constraints/performance.md
+      - docs/rag/_analysis-report.md#技术分析
+    提取内容:
+      - 安全要求
+      - 性能要求
+      - 兼容性约束
+```
+
+---
+
+## Phase 1: 识别下一个 Story
+
+### 1.1 定位 Epic 和 Story
+
+```yaml
+执行步骤:
+  步骤1_定位Epic:
+    动作: 根据 PRD 配置定位当前 Epic
+    来源:
+      - docs/prd.md 中的 Epic 列表
+      - 或 docs/prd/{epic-name}.md 切分文件
+
+  步骤2_确定Story编号:
+    动作: 扫描 devStoryLocation 目录
+    逻辑:
+      - 如果无故事文件: 下一个是 1.1
+      - 如果有故事文件: 找到最高编号，确定下一个
+      - 检查最高编号故事状态，非Done则警告
+
+  步骤3_提取Story需求:
+    动作: 从 Epic/PRD 中提取当前 Story 的定义
+    提取内容:
+      - Story 标题
+      - 用户故事描述
+      - 验收标准 (AC)
+      - 关联的功能点 (FR)
+```
+
+### 1.2 关联知识映射
+
+```yaml
+知识映射:
+  目的: 将 Story 需求映射到知识库中的具体内容
+
+  映射维度:
+    业务规则映射:
+      - Story AC → 相关业务规则 (docs/rag/business/rules-*.md)
+      - 功能点 → 分析报告中的功能分析
+
+    技术设计映射:
+      - Story → 架构增量设计中的相关章节
+      - 数据需求 → 数据模型增量设计
+      - API需求 → 接口增量设计
+      - 中间件需求 → 中间件增量设计
+
+    约束映射:
+      - 安全相关AC → security.md
+      - 性能相关AC → performance.md
+```
+
+---
+
+## Phase 2: 知识融合与 Story 内容生成
+
+### 2.1 用户故事描述生成
+
+```yaml
+用户故事生成:
+  来源:
+    - PRD/Epic 中的 Story 定义
+    - docs/rag/_analysis-report.md#用户分析
+
+  格式:
+    作为: {用户角色，来自用户分析}
+    我希望: {功能描述，来自功能分析}
+    以便: {业务价值，来自需求背景}
+
+  验证:
+    - 用户角色在分析报告中有定义
+    - 功能在功能清单中有对应
+    - 价值与业务目标对齐
+```
+
+### 2.2 验收标准增强
+
+```yaml
+验收标准增强:
+  基础AC:
+    来源: PRD/Epic 中定义的验收标准
+
+  业务规则增强:
+    来源: docs/rag/business/rules-*.md
+    动作: |
+      对每个AC，检查是否有相关业务规则：
+      - 如有，将业务规则细节融入AC
+      - 标注来源: (来源: business/rules-{name}.md)
+
+  技术约束增强:
+    来源: docs/rag/constraints/
+    动作: |
+      检查AC是否涉及安全/性能要求：
+      - 如有，添加技术约束说明
+      - 标注来源: (来源: constraints/{name}.md)
+
+  示例:
+    原始AC: "用户可以创建订单"
+    增强后: |
+      用户可以创建订单
+      - 订单状态初始为"待支付" (来源: business/rules-order.md)
+      - 订单号格式: ORD{yyyyMMdd}{6位序号} (来源: business/rules-order.md)
+      - 创建接口响应时间 < 500ms (来源: constraints/performance.md)
+```
+
+### 2.3 任务/子任务生成
+
+```yaml
+任务生成:
+  来源整合:
+    架构设计:
+      - docs/architecture-increment.md#模块增量设计
+      - docs/architecture-increment.md#数据模型增量设计
+      - docs/architecture-increment.md#接口增量设计
+      - docs/architecture-increment.md#中间件增量设计
+
+    编码规范:
+      - docs/rag/technical/coding-standards/
+      - docs/rag/technical/module-structure.md
+
+  任务生成规则:
+    数据层任务:
+      条件: Story涉及数据模型变更
+      来源: architecture-increment.md#数据模型增量设计
+      任务模板: |
+        - [ ] 创建/修改数据模型 (AC: {相关AC})
+          - [ ] 创建实体类 {EntityName} [参考: architecture-increment.md#entity-detail]
+          - [ ] 执行DDL脚本 [参考: architecture-increment.md#ddl-script]
+          - [ ] 创建Mapper/Repository [遵循: coding-standards/]
+
+    接口层任务:
+      条件: Story涉及API开发
+      来源: architecture-increment.md#接口增量设计
+      任务模板: |
+        - [ ] 实现API接口 (AC: {相关AC})
+          - [ ] 创建Controller [参考: architecture-increment.md#api-detail]
+          - [ ] 实现请求参数校验 [遵循: coding-standards/]
+          - [ ] 实现响应格式 [参考: architecture-increment.md#response-design]
+
+    业务层任务:
+      条件: Story涉及业务逻辑
+      来源: architecture-increment.md#模块增量设计
+      任务模板: |
+        - [ ] 实现业务逻辑 (AC: {相关AC})
+          - [ ] 创建Service类 [参考: architecture-increment.md#class-design]
+          - [ ] 实现业务规则 [参考: business/rules-{name}.md]
+          - [ ] 添加事务管理 [遵循: coding-standards/]
+
+    中间件任务:
+      条件: Story涉及缓存/消息/定时任务
+      来源: architecture-increment.md#中间件增量设计
+      任务模板: |
+        - [ ] 实现中间件功能 (AC: {相关AC})
+          - [ ] Redis缓存实现 [参考: architecture-increment.md#redis-design, middleware/redis.md]
+          - [ ] 消息队列实现 [参考: architecture-increment.md#mq-design, middleware/mq.md]
+
+    测试任务:
+      来源: docs/rag/technical/coding-standards/ (测试部分)
+      任务模板: |
+        - [ ] 编写测试用例 (AC: ALL)
+          - [ ] 单元测试 [遵循: coding-standards/testing]
+          - [ ] 集成测试（如需要）
+          - [ ] 验收标准验证
+```
+
+### 2.4 开发者说明生成
+
+```yaml
+开发者说明生成:
+  结构:
+    上一个Story洞察:
+      来源: 上一个Story的Dev Agent Record
+      内容: 关键经验、技术决策、注意事项
+
+    架构设计参考:
+      来源: docs/architecture-increment.md
+      内容: |
+        ### 架构设计参考
+        **模块设计**: [参考: architecture-increment.md#module-design]
+        - 包结构: {package_structure}
+        - 核心类: {class_list}
+
+        **数据模型**: [参考: architecture-increment.md#data-model-design]
+        - 表名: {table_name}
+        - 核心字段: {fields}
+
+        **接口设计**: [参考: architecture-increment.md#api-design]
+        - 路径: {api_path}
+        - 方法: {http_method}
+
+    业务规则:
+      来源: docs/rag/business/rules-*.md
+      内容: |
+        ### 业务规则
+        [参考: business/rules-{name}.md]
+        - 规则1: {rule_description}
+        - 规则2: {rule_description}
+
+    编码规范要点:
+      来源: docs/rag/technical/coding-standards/
+      内容: |
+        ### 编码规范要点
+        [参考: coding-standards/]
+        - 命名规范: {naming_rules}
+        - 分层规范: {layer_rules}
+        - 异常处理: {exception_rules}
+
+    中间件使用:
+      条件: Story涉及中间件
+      来源: docs/rag/technical/middleware/
+      内容: |
+        ### 中间件使用
+        **Redis**: [参考: middleware/redis.md]
+        - Key命名: {key_pattern}
+        - 代码示例: {code_example}
+
+        **MQ**: [参考: middleware/mq.md]
+        - Topic: {topic_name}
+        - 代码示例: {code_example}
+
+    约束条件:
+      来源: docs/rag/constraints/
+      内容: |
+        ### 约束条件
+        **安全要求**: [参考: constraints/security.md]
+        - {security_requirements}
+
+        **性能要求**: [参考: constraints/performance.md]
+        - {performance_requirements}
+
+    文件位置:
+      来源: docs/rag/technical/module-structure.md
+      内容: |
+        ### 文件位置
+        [参考: module-structure.md]
+        - Controller: {path}
+        - Service: {path}
+        - Mapper: {path}
+        - Entity: {path}
+```
+
+### 2.5 测试说明生成
+
+```yaml
+测试说明生成:
+  来源:
+    - docs/rag/technical/coding-standards/ (测试部分)
+    - docs/architecture-increment.md#测试策略 (如有)
+
+  内容:
+    测试框架:
+      来源: coding-standards/
+      内容: {test_framework}
+
+    测试文件位置:
+      来源: module-structure.md
+      内容: {test_file_location}
+
+    测试场景:
+      来源: AC + 业务规则
+      内容: |
+        - 正常流程测试: {scenarios}
+        - 异常流程测试: {error_scenarios}
+        - 边界条件测试: {edge_cases}
+
+    验收测试:
+      来源: Story AC
+      内容: 每个AC对应的测试方法
+```
+
+### 2.6 知识引用索引
+
+```yaml
+知识引用索引:
+  目的: 记录Story中引用的所有知识文件，便于追溯
+
+  格式:
+    ## Knowledge References
+
+    | 知识文件 | 引用章节 | 应用位置 |
+    |----------|----------|----------|
+    | docs/architecture-increment.md | 模块设计 | 任务列表、Dev Notes |
+    | docs/rag/business/rules-order.md | 订单规则 | AC增强、业务逻辑任务 |
+    | docs/rag/technical/coding-standards/ | 命名规范 | Dev Notes |
+    | docs/rag/technical/middleware/redis.md | 缓存示例 | 中间件任务 |
+    | docs/rag/constraints/performance.md | 响应时间要求 | AC约束 |
+```
+
+---
+
+## Phase 3: Story 文件生成与验证
+
+### 3.1 生成 Story 文件
+
+```yaml
+输出文件:
+  路径: {devStoryLocation}/{epicNum}.{storyNum}.{story_title_short}.md
+  状态: Draft
+
+  内容结构:
+    - 状态
+    - 用户故事
+    - 验收标准（增强版）
+    - 任务/子任务（带知识引用）
+    - 开发者说明（知识融合版）
+    - 测试说明
+    - Knowledge References（新增）
+    - 变更日志
+    - 开发者代理记录
+    - QA结果
+```
+
+### 3.2 执行检查清单
+
+```yaml
+检查清单:
+  执行: .xiaoma-core/checklists/story-draft-checklist.md
+
+  额外检查项:
+    知识引用完整性:
+      - [ ] 架构增量设计已引用
+      - [ ] 相关业务规则已引用
+      - [ ] 编码规范已引用
+      - [ ] 约束条件已引用
+
+    知识一致性:
+      - [ ] AC与业务规则一致
+      - [ ] 任务与架构设计一致
+      - [ ] 技术选型与技术栈一致
+```
+
+### 3.3 完成报告
+
+```yaml
+完成报告:
+  格式: |
+    ✅ 用户故事创建完成！
+
+    📄 故事文件: {story_path}
+    📊 状态: Draft
+    🔢 Story编号: {epicNum}.{storyNum}
+
+    📚 知识融合摘要:
+    - 架构设计: {architecture_sections_used}
+    - 业务规则: {business_rules_used}
+    - 技术规范: {technical_specs_used}
+    - 约束条件: {constraints_used}
+
+    📋 任务概要:
+    - 数据层任务: {data_task_count}
+    - 接口层任务: {api_task_count}
+    - 业务层任务: {business_task_count}
+    - 测试任务: {test_task_count}
+
+    ✅ 检查清单: {checklist_result}
+
+    🔄 下一步建议:
+    - 审核故事: 请PO/用户审核后批准
+    - 验证故事: 可执行 *validate-story 进行深度验证
+    - 开始开发: 批准后执行 Dev智能体 *develop-story-with-rag
+```
+
+---
+
+## 阻塞条件
+
+```yaml
+阻塞条件:
+  必须停止:
+    - PRD/Epic 文件不存在
+    - 架构增量设计与PRD严重不一致
+    - 关键业务规则缺失
+
+  警告继续:
+    - 部分知识文件缺失（记录后继续）
+    - 上一个Story未完成（用户确认后继续）
+```
+
+---
+
+## 使用说明
+
+### 激活命令
+
+```
+*draft-with-rag [epic_num] [story_num]
+```
+
+### 执行参数
+
+```yaml
+参数:
+  epic_num: Epic编号 (可选，默认自动识别)
+  story_num: Story编号 (可选，默认自动识别下一个)
+  rag_path: RAG知识目录路径 (默认: docs/rag/)
+  interactive: 交互模式 (默认: true)
+```
+
+### 与原有命令的区别
+
+| 命令 | 知识来源 | 适用场景 |
+|------|----------|----------|
+| `*draft` | 仅PRD + 架构文档 | 传统项目 |
+| `*draft-with-rag` | PRD + 知识库 + 架构增量设计 | 有知识库的项目 |
+
+---
+
+## 任务完成标志
+
+```yaml
+完成条件:
+  必要输出:
+    - Story文件已创建
+    - Knowledge References已记录
+    - 检查清单已执行
+
+  Story就绪标志:
+    - 所有AC都有知识来源支撑
+    - 所有任务都有技术参考
+    - Dev Notes包含足够上下文
+    - 知识引用索引完整
+```
+==================== END: .xiaoma-core/tasks/create-story-with-rag.md ====================
+
+==================== START: .xiaoma-core/templates/story-with-rag-tmpl.yaml ====================
+template:
+  id: story-with-rag-template-v1
+  name: 基于知识库的用户故事文档
+  version: 1.0
+  description: 融合知识库业务规则、技术规范和架构增量设计的用户故事模板
+  output:
+    format: markdown
+    filename: docs/stories/{{epic_num}}.{{story_num}}.{{story_title_short}}.md
+    title: "Story {{epic_num}}.{{story_num}}: {{story_title_short}}"
+
+workflow:
+  mode: interactive
+  elicitation: advanced-elicitation
+  upstream:
+    agents:
+      - analyst  # 提供需求分析报告和知识库
+      - pm       # 提供PRD文档
+      - architect # 提供架构增量设计
+    required_files:
+      - docs/prd.md
+      - docs/architecture-increment.md
+    optional_files:
+      - docs/rag/_analysis-report.md
+      - docs/rag/business/*
+      - docs/rag/technical/*
+      - docs/rag/constraints/*
+
+agent_config:
+  editable_sections:
+    - Status
+    - Story
+    - Acceptance Criteria
+    - Tasks / Subtasks
+    - Dev Notes
+    - Testing
+    - Knowledge References
+    - Change Log
+
+sections:
+  - id: status
+    title: 状态
+    type: choice
+    choices: [Draft, Approved, InProgress, Review, Done]
+    instruction: 选择此用户故事的当前状态
+    owner: scrum-master
+    editors: [scrum-master, po-agent, dev-agent]
+
+  - id: story
+    title: 用户故事
+    type: template-text
+    template: |
+      **作为** {{role}}，
+      **我希望** {{action}}，
+      **以便** {{benefit}}
+    instruction: |
+      使用标准格式定义用户故事。
+      - 角色来源: docs/rag/_analysis-report.md#用户分析
+      - 功能来源: PRD/Epic 中的 Story 定义
+      - 价值来源: 需求分析报告中的业务目标
+    elicit: true
+    owner: scrum-master
+    editors: [scrum-master]
+
+  - id: acceptance-criteria
+    title: 验收标准
+    type: numbered-list
+    instruction: |
+      从 Epic 文件中复制验收标准，并融合知识库内容增强：
+
+      **增强规则**：
+      1. 检查每个AC是否有对应的业务规则 (docs/rag/business/rules-*.md)
+         - 如有，将业务规则细节融入AC
+         - 标注来源: (来源: business/rules-{name}.md)
+
+      2. 检查每个AC是否涉及约束条件 (docs/rag/constraints/)
+         - 如有安全要求，添加安全约束
+         - 如有性能要求，添加性能指标
+         - 标注来源: (来源: constraints/{name}.md)
+
+      **示例**：
+      1. 用户可以创建订单
+         - 订单状态初始为"待支付" (来源: business/rules-order.md)
+         - 订单号格式: ORD{yyyyMMdd}{6位序号} (来源: business/rules-order.md)
+         - 接口响应时间 < 500ms (来源: constraints/performance.md)
+    elicit: true
+    owner: scrum-master
+    editors: [scrum-master]
+
+  - id: tasks-subtasks
+    title: 任务 / 子任务
+    type: bullet-list
+    instruction: |
+      基于架构增量设计 (docs/architecture-increment.md) 生成详细任务。
+
+      **任务生成规则**：
+
+      1. **数据层任务** (如Story涉及数据模型):
+         来源: architecture-increment.md#数据模型增量设计
+         ```
+         - [ ] 创建/修改数据模型 (AC: {相关AC})
+           - [ ] 创建实体类 [参考: architecture-increment.md#entity-detail]
+           - [ ] 执行DDL脚本 [参考: architecture-increment.md#ddl-script]
+           - [ ] 创建Mapper/Repository [遵循: coding-standards/]
+         ```
+
+      2. **接口层任务** (如Story涉及API):
+         来源: architecture-increment.md#接口增量设计
+         ```
+         - [ ] 实现API接口 (AC: {相关AC})
+           - [ ] 创建Controller [参考: architecture-increment.md#api-detail]
+           - [ ] 实现参数校验 [遵循: coding-standards/]
+           - [ ] 实现响应格式 [参考: architecture-increment.md#response-design]
+         ```
+
+      3. **业务层任务** (如Story涉及业务逻辑):
+         来源: architecture-increment.md#模块增量设计
+         ```
+         - [ ] 实现业务逻辑 (AC: {相关AC})
+           - [ ] 创建Service类 [参考: architecture-increment.md#class-design]
+           - [ ] 实现业务规则 [参考: business/rules-{name}.md]
+         ```
+
+      4. **中间件任务** (如Story涉及缓存/消息):
+         来源: architecture-increment.md#中间件增量设计
+         ```
+         - [ ] 实现缓存逻辑 (AC: {相关AC})
+           - [ ] Redis实现 [参考: architecture-increment.md#redis-design]
+           - [ ] 代码示例 [参考: middleware/redis.md]
+         ```
+
+      5. **测试任务**:
+         ```
+         - [ ] 编写测试用例 (AC: ALL)
+           - [ ] 单元测试 [遵循: coding-standards/testing]
+           - [ ] 集成测试（如需要）
+         ```
+    template: |
+      - [ ] 任务 1 (AC: #) [参考: {knowledge_ref}]
+        - [ ] 子任务 1.1 [遵循: {standard_ref}]
+      - [ ] 任务 2 (AC: #) [参考: {knowledge_ref}]
+        - [ ] 子任务 2.1 [遵循: {standard_ref}]
+    elicit: true
+    owner: scrum-master
+    editors: [scrum-master, dev-agent]
+
+  - id: dev-notes
+    title: 开发者说明
+    instruction: |
+      整合知识库内容，为开发者提供完整的技术上下文。
+
+      **来源整合**：
+      - 架构设计: docs/architecture-increment.md
+      - 编码规范: docs/rag/technical/coding-standards/
+      - 模块结构: docs/rag/technical/module-structure.md
+      - 中间件规范: docs/rag/technical/middleware/
+      - 业务规则: docs/rag/business/rules-*.md
+      - 约束条件: docs/rag/constraints/
+
+      **填充规则**：
+      - 每个技术细节必须标注来源
+      - 提供足够上下文使开发者无需阅读原始文档
+      - 包含相关代码示例引用
+    elicit: true
+    owner: scrum-master
+    editors: [scrum-master]
+    sections:
+      - id: previous-story-insights
+        title: 上一个Story洞察
+        instruction: |
+          从上一个Story的Dev Agent Record中提取关键信息：
+          - 技术决策和实现方式
+          - 遇到的问题和解决方案
+          - 对当前Story的建议
+        owner: scrum-master
+        editors: [scrum-master]
+
+      - id: architecture-reference
+        title: 架构设计参考
+        instruction: |
+          从 docs/architecture-increment.md 提取与当前Story相关的设计：
 
-- [ ] API参数与数据库字段对应
-- [ ] 数据类型一致
-- [ ] 业务规则与数据库约束匹配
-- [ ] 接口设计符合RESTful规范
+          **模块设计** [参考: architecture-increment.md#module-design]
+          - 包结构: {提取的包结构}
+          - 核心类: {提取的类列表}
 
-#### 3.3 可实现性检查
+          **数据模型** [参考: architecture-increment.md#data-model-design]
+          - 表名: {table_name}
+          - 核心字段: {fields}
+          - DDL参考: {ddl_section_ref}
 
-- [ ] 任务分解合理可执行
-- [ ] 技术实现方案可行
-- [ ] 测试覆盖充分
-- [ ] 开发者说明详细
+          **接口设计** [参考: architecture-increment.md#api-design]
+          - 路径: {api_path}
+          - 方法: {http_method}
+          - 请求/响应参考: {api_detail_ref}
 
-### 4. 输出文件
+          **中间件设计** [参考: architecture-increment.md#middleware-design]
+          - Redis设计: {redis_ref}
+          - MQ设计: {mq_ref}
+        owner: scrum-master
+        editors: [scrum-master]
 
-生成的用户故事文件：`docs/stories/{{epic_num}}.{{story_num}}.{{story_title_short}}.md`
+      - id: business-rules
+        title: 业务规则
+        instruction: |
+          从 docs/rag/business/rules-*.md 提取与当前Story相关的业务规则：
 
-### 5. 后续协作
+          [参考: business/rules-{name}.md]
+          - 规则1: {rule_description}
+          - 规则2: {rule_description}
 
-#### 5.1 与开发者协作
+          确保每条规则都标注来源文件。
+        owner: scrum-master
+        editors: [scrum-master]
 
-- 确保开发者理解数据库设计和API规范
-- 提供必要的技术支持和澄清
-- 跟踪开发进度和问题解决
+      - id: coding-standards
+        title: 编码规范要点
+        instruction: |
+          从 docs/rag/technical/coding-standards/ 提取关键规范：
 
-#### 5.2 与QA协作
+          [参考: coding-standards/]
+          - 命名规范: {naming_rules}
+          - 分层规范: {layer_rules}
+          - 异常处理: {exception_rules}
+          - 日志规范: {logging_rules}
+        owner: scrum-master
+        editors: [scrum-master]
 
-- 明确测试重点和验收标准
-- 提供API测试用例和数据
-- 确保质量标准得到执行
+      - id: middleware-usage
+        title: 中间件使用
+        condition: Story涉及中间件
+        instruction: |
+          从 docs/rag/technical/middleware/ 提取使用规范和代码示例：
 
-## 模板使用示例
+          **Redis** [参考: middleware/redis.md]
+          - Key命名: {key_pattern}
+          - 过期策略: {expiration}
+          - 代码示例参考: middleware/redis.md#{section}
 
-### 示例：用户注册功能
+          **MQ** [参考: middleware/mq.md]
+          - Topic: {topic_name}
+          - 消息格式: {message_format}
+          - 代码示例参考: middleware/mq.md#{section}
+        owner: scrum-master
+        editors: [scrum-master]
 
-**用户故事**：
+      - id: constraints
+        title: 约束条件
+        instruction: |
+          从 docs/rag/constraints/ 提取相关约束：
 
-> 作为新用户，我希望能够注册账户，以便使用系统的各项功能。
+          **安全要求** [参考: constraints/security.md]
+          - {security_requirements}
 
-**相关实体**：
+          **性能要求** [参考: constraints/performance.md]
+          - {performance_requirements}
+        owner: scrum-master
+        editors: [scrum-master]
 
-- Users表：存储用户基本信息
-- UserProfiles表：存储用户详细资料
+      - id: file-locations
+        title: 文件位置
+        instruction: |
+          从 docs/rag/technical/module-structure.md 提取文件位置规范：
+
+          [参考: module-structure.md]
+          - Controller: {path}
+          - Service: {path}
+          - Mapper/Repository: {path}
+          - Entity: {path}
+          - Test: {path}
+        owner: scrum-master
+        editors: [scrum-master]
 
-**涉及API**：
+      - id: testing-standards
+        title: 测试说明
+        instruction: |
+          从 docs/rag/technical/coding-standards/ 提取测试规范：
+
+          [参考: coding-standards/testing]
+          - 测试框架: {test_framework}
+          - 测试文件位置: {test_file_location}
+          - 测试场景:
+            - 正常流程: {normal_scenarios}
+            - 异常流程: {error_scenarios}
+            - 边界条件: {edge_cases}
+        elicit: true
+        owner: scrum-master
+        editors: [scrum-master]
 
-- POST /api/users：创建用户账户
-- POST /api/users/verify-email：验证邮箱
-- GET /api/users/check-username：检查用户名可用性
+  - id: knowledge-references
+    title: 知识引用索引
+    instruction: |
+      记录Story中引用的所有知识文件，便于追溯和验证。
+
+      | 知识文件 | 引用章节 | 应用位置 |
+      |----------|----------|----------|
+      | docs/architecture-increment.md | 模块设计 | 任务列表、Dev Notes |
+      | docs/rag/business/rules-*.md | 业务规则 | AC增强、业务逻辑任务 |
+      | docs/rag/technical/coding-standards/ | 编码规范 | Dev Notes |
+      | docs/rag/technical/middleware/*.md | 中间件示例 | 中间件任务 |
+      | docs/rag/constraints/*.md | 约束条件 | AC约束 |
+    type: table
+    columns: [知识文件, 引用章节, 应用位置]
+    owner: scrum-master
+    editors: [scrum-master, dev-agent]
 
-**数据操作**：
+  - id: change-log
+    title: 变更日志
+    type: table
+    columns: [日期, 版本, 描述, 作者]
+    instruction: 跟踪此用户故事文档的变更
+    owner: scrum-master
+    editors: [scrum-master, dev-agent, qa-agent]
 
-- 插入用户基本信息到users表
-- 验证用户名和邮箱的唯一性
-- 创建用户会话信息
+  - id: dev-agent-record
+    title: 开发者代理记录
+    instruction: 此部分由开发代理在实施过程中填充
+    owner: dev-agent
+    editors: [dev-agent]
+    sections:
+      - id: agent-model
+        title: 使用的代理模型
+        template: "{{agent_model_name_version}}"
+        instruction: 记录用于开发的特定 AI 代理模型和版本
+        owner: dev-agent
+        editors: [dev-agent]
 
-**API详细设计**：
+      - id: debug-log-references
+        title: 调试日志参考
+        instruction: 引用开发过程中生成的任何调试日志或跟踪信息
+        owner: dev-agent
+        editors: [dev-agent]
 
-```json
-// POST /api/users
-{
-  "username": "johndoe",
-  "email": "john@example.com",
-  "password": "hashedPassword"
-}
+      - id: completion-notes
+        title: 完成说明列表
+        instruction: 关于任务完成情况和遇到的任何问题的说明
+        owner: dev-agent
+        editors: [dev-agent]
 
-// 响应
-{
-  "code": 200,
-  "message": "用户创建成功",
-  "data": {
-    "userId": 12345,
-    "username": "johndoe",
-    "email": "john@example.com",
-    "status": "active"
-  }
-}
-```
+      - id: file-list
+        title: 文件列表
+        instruction: 列出在用户故事实施过程中创建、修改或影响的所有文件
+        owner: dev-agent
+        editors: [dev-agent]
 
-## 注意事项
+      - id: knowledge-usage-record
+        title: 知识使用记录
+        instruction: |
+          记录实际开发中使用的知识文件和参考内容：
+          | 知识文件 | 使用内容 | 应用代码位置 |
+          |----------|----------|--------------|
+        type: table
+        columns: [知识文件, 使用内容, 应用代码位置]
+        owner: dev-agent
+        editors: [dev-agent]
 
-1. **数据一致性**：确保API设计与数据库设计保持一致
-2. **安全性**：考虑数据验证、权限控制和敏感信息保护
-3. **性能**：关注查询效率和接口响应时间
-4. **可维护性**：保持代码结构清晰和文档完整
-5. **可测试性**：确保功能可以被充分测试
-==================== END: .xiaoma-core/tasks/create-enhanced-story-with-database.md ====================
+  - id: qa-results
+    title: QA 结果
+    instruction: QA 代理对已完成的用户故事实施进行 QA 审查的结果
+    owner: qa-agent
+    editors: [qa-agent]
+==================== END: .xiaoma-core/templates/story-with-rag-tmpl.yaml ====================
 
 ==================== START: .xiaoma-core/templates/enhanced-story-with-database-tmpl.yaml ====================
 template:
@@ -15265,6 +18302,545 @@ Fix plan:
 - Gate ownership remains with QA; Dev signals readiness via Status
 ==================== END: .xiaoma-core/tasks/apply-qa-fixes.md ====================
 
+==================== START: .xiaoma-core/tasks/develop-story-with-rag.md ====================
+# 基于知识库的故事开发任务
+
+## Purpose
+
+基于知识库（`docs/rag/`）中的技术规范和架构增量设计文档（`docs/architecture-increment.md`），对用户故事进行标准化开发。确保开发过程中严格遵循项目技术规范、编码标准和架构设计。
+
+## 上游交接物
+
+```yaml
+必需输入:
+  故事文件:
+    - docs/project/stories/{epic}.{story}.*.md  # 待开发的用户故事
+
+  架构增量设计:
+    - docs/architecture-increment.md            # Architect生成的增量设计文档
+
+可选输入:
+  技术知识库:
+    - 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/technical/coding-standards/      # 编码规范目录
+    - docs/rag/technical/middleware/            # 中间件规范目录
+    - docs/rag/technical/sql-standards/         # SQL规范目录
+
+  约束条件:
+    - docs/rag/constraints/security.md          # 安全要求
+    - docs/rag/constraints/performance.md       # 性能要求
+
+  PRD文档:
+    - docs/prd.md                               # PRD文档（可选参考）
+```
+
+## Workflow Overview
+
+```
+故事文件 + 知识库 + 架构增量设计 → 知识加载 → 任务实现 → 规范校验 → 测试验证 → 故事更新
+```
+
+---
+
+## Phase 0: 知识上下文加载
+
+### 0.1 验证上游交接物
+
+```yaml
+执行步骤:
+  步骤1_检查故事文件:
+    动作: 确认故事文件存在且状态为可开发
+    验证项:
+      - 故事文件路径有效
+      - 故事状态不是 Draft
+      - 任务列表已定义
+    缺失处理: |
+      如果故事文件缺失或状态不对，提示：
+      "故事文件未就绪。请先确认故事状态，或执行 PM 智能体完善故事定义。"
+
+  步骤2_检查架构增量设计:
+    动作: 检查 docs/architecture-increment.md 是否存在
+    提取内容:
+      - 与当前故事相关的模块设计
+      - 数据模型变动
+      - 接口设计
+      - 中间件设计
+    缺失处理: |
+      如果架构增量设计不存在：
+      - 检查是否有传统架构文档可用
+      - 提示用户是否继续（使用通用规范）或先生成架构设计
+
+  步骤3_加载技术知识库:
+    动作: 扫描并加载 docs/rag/technical/ 目录
+    加载策略:
+      - 按需加载：仅加载与当前任务相关的规范文件
+      - 优先级：编码规范 > 中间件规范 > SQL规范
+    关键文件:
+      - docs/rag/technical/coding-standards/   # 编码规范（必须）
+      - docs/rag/technical/module-structure.md # 模块结构（必须）
+      - docs/rag/technical/middleware/         # 中间件规范（按需）
+      - docs/rag/technical/sql-standards/      # SQL规范（按需）
+```
+
+### 0.2 知识上下文整合
+
+```yaml
+整合输出:
+  开发上下文:
+    架构设计:
+      来源: docs/architecture-increment.md
+      提取: 与当前Story相关的设计章节
+      内容:
+        - 模块设计（包结构、类设计）
+        - 数据模型设计（表结构、DDL）
+        - 接口设计（API定义）
+        - 中间件设计（Redis/MQ/定时任务）
+
+    编码规范:
+      来源: docs/rag/technical/coding-standards/
+      内容:
+        - 命名规范（类/方法/变量/常量）
+        - 分层规范（Controller/Service/DAO）
+        - 异常处理规范
+        - 日志规范
+
+    模块结构:
+      来源: docs/rag/technical/module-structure.md
+      内容:
+        - 包结构规范
+        - 分层结构
+        - 模块依赖关系
+
+    中间件规范:
+      来源: docs/rag/technical/middleware/
+      内容:
+        - Redis使用规范和代码示例
+        - MQ使用规范和代码示例
+        - 定时任务规范和代码示例
+
+    SQL规范:
+      来源: docs/rag/technical/sql-standards/
+      内容:
+        - 表设计规范
+        - 索引设计规范
+        - 查询优化规范
+
+    约束条件:
+      来源: docs/rag/constraints/
+      内容:
+        - 安全要求（来自 security.md）
+        - 性能要求（来自 performance.md）
+```
+
+---
+
+## Phase 1: 任务分析与规范匹配
+
+### 1.1 任务类型识别
+
+```yaml
+任务类型识别:
+  数据模型任务:
+    识别标志: 创建表、修改表、添加字段、创建索引
+    关联规范:
+      - docs/rag/technical/sql-standards/          # SQL规范
+      - docs/rag/technical/data-model.md           # 数据模型
+      - docs/architecture-increment.md#数据模型增量设计
+
+  接口开发任务:
+    识别标志: 创建API、修改接口、添加端点
+    关联规范:
+      - docs/rag/technical/coding-standards/       # 编码规范
+      - docs/architecture-increment.md#接口增量设计
+
+  业务逻辑任务:
+    识别标志: 实现Service、业务流程、校验逻辑
+    关联规范:
+      - docs/rag/technical/coding-standards/       # 编码规范
+      - docs/rag/technical/module-structure.md     # 模块结构
+      - docs/architecture-increment.md#模块增量设计
+
+  中间件任务:
+    识别标志: 缓存、消息队列、定时任务
+    关联规范:
+      - docs/rag/technical/middleware/redis.md     # Redis规范
+      - docs/rag/technical/middleware/mq.md        # MQ规范
+      - docs/rag/technical/middleware/scheduler.md # 定时任务规范
+      - docs/architecture-increment.md#中间件增量设计
+
+  前端任务:
+    识别标志: 组件、页面、交互
+    关联规范:
+      - docs/rag/technical/coding-standards/       # 前端编码规范
+      - docs/architecture-increment.md#前端设计（如有）
+```
+
+### 1.2 规范加载策略
+
+```yaml
+加载策略:
+  按任务类型加载:
+    原则: 仅加载当前任务所需的规范文件
+    避免: 一次性加载所有规范导致上下文过载
+
+  加载顺序:
+    1. 架构增量设计中的相关章节
+    2. 编码规范（通用）
+    3. 任务特定规范（SQL/中间件等）
+    4. 约束条件（安全/性能）
+
+  缓存策略:
+    - 会话内缓存已加载的规范
+    - 跨任务复用通用规范
+```
+
+---
+
+## Phase 2: 任务实现
+
+### 2.1 实现前检查
+
+```yaml
+实现前检查:
+  检查项:
+    架构对齐:
+      - 当前任务在架构增量设计中是否有对应设计
+      - 包结构是否与 module-structure.md 一致
+      - 类命名是否遵循编码规范
+
+    数据模型对齐:
+      - 表结构是否与架构设计一致
+      - 字段定义是否符合SQL规范
+      - 索引设计是否合理
+
+    接口对齐:
+      - API路径是否与架构设计一致
+      - 请求/响应格式是否符合规范
+      - 错误码是否按规范定义
+
+  不一致处理:
+    - 记录偏差到 Debug Log
+    - 如有重大偏差，暂停并询问用户
+```
+
+### 2.2 代码实现规范
+
+```yaml
+代码实现规范:
+  命名规范:
+    来源: docs/rag/technical/coding-standards/
+    要求:
+      - Controller: {Module}Controller
+      - Service: {Module}Service / {Module}ServiceImpl
+      - DAO: {Module}Mapper / {Module}Repository
+      - Entity: {Entity}
+      - DTO: {Entity}DTO / {Entity}VO / {Entity}Request / {Entity}Response
+
+  分层规范:
+    来源: docs/rag/technical/coding-standards/
+    要求:
+      - Controller: 仅处理请求/响应，不含业务逻辑
+      - Service: 业务逻辑层，事务管理
+      - DAO: 数据访问层，仅数据操作
+      - 禁止: 跨层调用、循环依赖
+
+  异常处理:
+    来源: docs/rag/technical/coding-standards/
+    要求:
+      - 使用统一异常类
+      - 业务异常与系统异常分离
+      - 异常信息包含上下文
+
+  日志规范:
+    来源: docs/rag/technical/coding-standards/
+    要求:
+      - 关键操作必须有日志
+      - 日志级别正确使用
+      - 敏感信息脱敏
+```
+
+### 2.3 中间件使用规范
+
+```yaml
+中间件使用规范:
+  Redis使用:
+    来源: docs/rag/technical/middleware/redis.md
+    规范:
+      - Key命名: {业务}:{模块}:{标识}
+      - 必须设置过期时间
+      - 使用正确的数据结构
+      - 参考知识库中的代码示例
+
+  MQ使用:
+    来源: docs/rag/technical/middleware/mq.md
+    规范:
+      - Topic命名规范
+      - 消息格式标准化
+      - 消费者幂等处理
+      - 参考知识库中的代码示例
+
+  定时任务:
+    来源: docs/rag/technical/middleware/scheduler.md
+    规范:
+      - 任务命名规范
+      - 分布式锁使用
+      - 异常处理
+      - 参考知识库中的代码示例
+```
+
+### 2.4 SQL实现规范
+
+```yaml
+SQL实现规范:
+  表设计:
+    来源: docs/rag/technical/sql-standards/
+    规范:
+      - 表名小写下划线
+      - 主键统一命名
+      - 必须有创建/更新时间字段
+      - 必须有表和字段注释
+
+  索引设计:
+    来源: docs/rag/technical/sql-standards/
+    规范:
+      - 索引命名: idx_{表名}_{字段}
+      - 唯一索引: uk_{表名}_{字段}
+      - 避免冗余索引
+
+  查询规范:
+    来源: docs/rag/technical/sql-standards/
+    规范:
+      - 禁止 SELECT *
+      - 分页必须有限制
+      - 避免大事务
+```
+
+---
+
+## Phase 3: 实现过程中的规范校验
+
+### 3.1 实时校验点
+
+```yaml
+校验点:
+  代码创建时:
+    - 文件路径是否符合 module-structure.md
+    - 类名是否符合命名规范
+    - 包声明是否正确
+
+  代码编写时:
+    - 方法命名是否规范
+    - 异常处理是否符合规范
+    - 日志打印是否规范
+
+  代码完成时:
+    - 是否遵循分层规范
+    - 是否有必要的注释
+    - 是否处理了边界情况
+```
+
+### 3.2 规范偏差处理
+
+```yaml
+偏差处理:
+  轻微偏差:
+    定义: 命名风格略有差异、注释不够详细
+    处理: 记录到 Debug Log，继续执行
+
+  中等偏差:
+    定义: 分层不清晰、缺少必要校验
+    处理: 立即修正，记录到 Completion Notes
+
+  严重偏差:
+    定义: 架构不一致、安全风险
+    处理: 暂停开发，询问用户确认
+```
+
+---
+
+## Phase 4: 测试与验证
+
+### 4.1 测试要求
+
+```yaml
+测试要求:
+  单元测试:
+    - Service层必须有单元测试
+    - 覆盖正常流程和异常流程
+    - Mock外部依赖
+
+  集成测试:
+    - API接口必须有集成测试
+    - 数据库操作必须验证
+
+  验收标准验证:
+    - 逐条验证故事中的AC
+    - 记录验证结果
+```
+
+### 4.2 规范合规检查
+
+```yaml
+合规检查:
+  代码规范检查:
+    执行: lint工具检查
+    标准: docs/rag/technical/coding-standards/
+
+  安全检查:
+    执行: 安全扫描（如配置）
+    标准: docs/rag/constraints/security.md
+
+  性能检查:
+    执行: 性能测试（如需要）
+    标准: docs/rag/constraints/performance.md
+```
+
+---
+
+## Phase 5: 故事文件更新
+
+### 5.1 允许更新的部分
+
+```yaml
+允许更新部分:
+  任务状态:
+    - Tasks / Subtasks 复选框标记为 [x]
+
+  Dev Agent Record:
+    - Agent Model Used: 使用的模型
+    - Debug Log References: 调试日志
+    - Completion Notes List: 完成说明
+    - File List: 新增/修改/删除的文件
+    - Knowledge References: 【新增】引用的知识文件
+
+  Change Log:
+    - 新增变更日志条目
+
+  Status:
+    - 更新为 Ready for Review
+```
+
+### 5.2 知识引用记录
+
+```yaml
+知识引用记录:
+  格式:
+    ## Knowledge References
+
+    | 知识文件 | 引用内容 | 应用位置 |
+    |----------|----------|----------|
+    | docs/rag/technical/coding-standards/naming.md | 类命名规范 | UserController.java |
+    | docs/rag/technical/middleware/redis.md | 缓存实现示例 | UserCacheService.java |
+    | docs/architecture-increment.md#用户模块设计 | 模块设计 | user/ 目录结构 |
+
+  目的:
+    - 便于代码审查时验证规范遵循
+    - 便于后续维护时理解实现依据
+    - 建立代码与知识库的可追溯关系
+```
+
+---
+
+## 执行顺序总结
+
+```yaml
+执行顺序:
+  order-of-execution: |
+    1. 加载知识上下文
+       - 读取架构增量设计 (docs/architecture-increment.md)
+       - 读取相关编码规范 (docs/rag/technical/coding-standards/)
+       - 读取任务相关规范 (按需)
+
+    2. 读取当前任务
+       - 分析任务类型
+       - 匹配相关规范
+       - 提取架构设计中的对应章节
+
+    3. 实现任务
+       - 按照规范创建代码文件
+       - 遵循命名和分层规范
+       - 参考中间件代码示例
+
+    4. 编写测试
+       - 按照测试规范编写
+       - 覆盖正常和异常流程
+
+    5. 执行验证
+       - 运行lint检查
+       - 运行测试
+       - 验证AC
+
+    6. 更新故事文件
+       - 标记任务完成 [x]
+       - 更新 File List
+       - 记录 Knowledge References
+       - 更新 Completion Notes
+
+    7. 重复直至完成所有任务
+
+    8. 最终检查
+       - 执行 story-dod-checklist
+       - 验证所有规范遵循
+       - 设置状态为 Ready for Review
+```
+
+---
+
+## 阻塞条件
+
+```yaml
+阻塞条件:
+  暂停情况:
+    - 架构增量设计与故事任务严重不一致
+    - 知识库规范相互冲突
+    - 安全约束无法满足
+    - 连续3次实现失败
+    - 需要未批准的依赖
+
+  处理方式:
+    - 记录问题到 Debug Log
+    - 暂停并询问用户
+    - 等待用户确认后继续
+```
+
+---
+
+## 完成标志
+
+```yaml
+完成条件:
+  必要条件:
+    - 所有任务和子任务标记为 [x]
+    - 所有测试通过
+    - lint检查通过
+    - 验收标准全部满足
+    - Knowledge References 已记录
+
+  完成提示: |
+    ✅ 故事开发完成！
+
+    📄 故事文件: {story_path}
+    📊 任务完成: {completed_tasks}/{total_tasks}
+    🧪 测试状态: 全部通过
+
+    📚 知识引用:
+    - 编码规范: docs/rag/technical/coding-standards/
+    - 架构设计: docs/architecture-increment.md
+    - 中间件规范: {middleware_refs}
+
+    📁 文件变更:
+    - 新增: {new_files}
+    - 修改: {modified_files}
+    - 删除: {deleted_files}
+
+    🔄 下一步:
+    - QA审查: 请QA执行 *review-story
+    - 代码审查: 请进行代码评审
+==================== END: .xiaoma-core/tasks/develop-story-with-rag.md ====================
+
 ==================== START: .xiaoma-core/checklists/story-dod-checklist.md ====================
 <!-- Powered by XiaoMa™ Core -->