完成：aide/025 - 分析和优化 user-docs/user-graph 的分步执行能力

CHANGELOG.md

@@ -4,6 +4,41 @@
 
 ## 2025-12-19
 
+### 重大优化
+
+**三个命令的分步执行机制重构（docs / user-graph / user-docs）**
+
+针对大型项目（百万行代码级别）的分步执行和接续执行需求，对三个命令进行了根本性重构：
+
+**核心改进**：
+- **索引式计划文档**：计划文件只做索引，详细信息存在独立步骤文档（`steps/step-XXX.md`）
+- **自包含步骤文档**：每个步骤包含执行所需的全部信息，接续执行无需重新分析
+- **粒度动态控制**：根据复杂度评估动态拆分步骤，确保单次对话可完成
+- **分析与执行分离**：分析阶段产出详细计划，执行阶段直接产出
+
+**docs.md（项目文档管理）**：
+- 新增"步骤生成"阶段：为每个区块生成详细步骤文档（包含文件清单、已知上下文）
+- 区块计划升级为索引式：`block-plan.md` 只做索引，`steps/` 目录存详情
+- 支持区块内细粒度进度追踪：大型区块自动拆分为多个步骤
+- 新增配置项 `docs.steps_path`（默认 `.aide/project-docs/steps`）
+
+**user-graph.md（用户流程图生成）**：
+- 步骤文档包含已分析好的模块结构（涉及文件、模块关系、数据流、关键函数）
+- 执行阶段直接基于模块结构绘图，无需重新分析代码
+- 新增配置项 `user_docs.graph_steps_path`（默认 `docs/graph-guide/steps`）
+
+**user-docs.md（用户文档生成）**：
+- 步骤文档包含已提取的源信息（项目基础信息、相关模块、关键代码摘要）
+- 执行阶段直接基于源信息生成文档
+- 新增配置项 `user_docs.docs_steps_path`（默认 `docs/steps`）
+
+**解决的问题**：
+- 原有"分步"是形式上的分步（基于逻辑单元），对大型项目无效
+- 每次对话需重新"理解"项目，消耗大量上下文
+- 单个区块/文档可能需要多次对话才能完成，但无法追踪内部进度
+
+---
+
 ### 优化
 
 **user-docs 分步执行和接续执行能力**