diff --git a/.aide/flow-status.json b/.aide/flow-status.json
index 3b60e02..24c65e0 100644
--- a/.aide/flow-status.json
+++ b/.aide/flow-status.json
@@ -1,7 +1,7 @@
 {
   "task_id": "2025-12-17T02-28-46",
   "current_phase": "task-optimize",
-  "current_step": 2,
+  "current_step": 3,
   "started_at": "2025-12-17T02:28:46+08:00",
   "history": [
     {
@@ -17,7 +17,15 @@
       "action": "next-step",
       "phase": "task-optimize",
       "step": 2,
-      "summary": "任务分析完成：问题根因是 docs.md 缺少强制完整覆盖规则"
+      "summary": "任务分析完成：问题根因是 docs.md 缺少强制完整覆盖规则",
+      "git_commit": "29604d00415aea7d747eb7063f981c31ba72b92a"
+    },
+    {
+      "timestamp": "2025-12-17T02:32:39+08:00",
+      "action": "next-step",
+      "phase": "task-optimize",
+      "step": 3,
+      "summary": "完成 docs.md 修改：增加完整覆盖规则和验证步骤"
     }
   ]
 }
diff --git a/.aide/flow-status.lock b/.aide/flow-status.lock
index 6586e53..2663efd 100755
--- a/.aide/flow-status.lock
+++ b/.aide/flow-status.lock
@@ -1 +1 @@
-16719
\ No newline at end of file
+16899
\ No newline at end of file
diff --git a/aide-marketplace/aide-plugin/commands/docs.md b/aide-marketplace/aide-plugin/commands/docs.md
index 6755a7a..253d741 100644
--- a/aide-marketplace/aide-plugin/commands/docs.md
+++ b/aide-marketplace/aide-plugin/commands/docs.md
@@ -62,17 +62,26 @@ find . -not -path './.git/*' -not -name '.git' | sort
 
 生成类似 `tree` 命令输出的完整目录结构，对于 .gitignore 中的项目标注 `[ignored]`：
 
+**目录树必须完整**：
+- 根目录下的**所有**子目录都必须列出（包括非代码目录如 docs/、assets/、discuss/ 等）
+- 每个目录至少有简短说明
+- 被忽略的目录也要列出并标注 `[ignored]`
+
 ```
 project/
-├── src/
+├── src/                     源码目录
 │   ├── main.py
 │   ├── utils/
 │   │   ├── helper.py
 │   │   └── config.py
 │   └── __init__.py
-├── tests/
+├── tests/                   测试目录
 │   └── test_main.py
-├── docs/                    [空目录]
+├── docs/                    项目文档目录
+│   ├── design.md
+│   └── api.md
+├── discuss/                 讨论记录目录
+├── assets/                  [空目录] 资源文件
 ├── cache/                   [ignored]
 ├── node_modules/            [ignored]
 ├── .gitignore
@@ -98,6 +107,9 @@ project/
 2. **按功能模块**：相关功能的文件归为一个区块
 3. **包含空目录**：空目录也要归入相应区块
 4. **低耦合**：区块间依赖关系尽量简单
+5. **完整覆盖**：根目录下每个非忽略的子目录都必须归入某个区块
+
+> **强制规则**：非代码目录（如 `docs/`、`assets/`、`discuss/` 等）同样必须作为区块进行覆盖，不能因为"非核心代码"而跳过。
 
 生成初步区块计划：
 
@@ -125,6 +137,15 @@ project/
 ### 区块 2：[名称]
 ...
 
+### 区块 N：项目文档与资源
+- 路径：docs/, assets/, discuss/, statements/
+- 文件数：xx
+- 空目录：xx
+- 状态：待处理
+- 说明：非代码资源文件（文档、讨论记录、声明等）
+
+> 注：即使是非代码目录，也必须作为区块进行完整深度探索
+
 ## 进度追踪
 - [ ] 区块 1
 - [ ] 区块 2
@@ -139,6 +160,18 @@ project/
 3. 调整区块边界（如需要）
 4. 确保没有遗漏任何文件或目录
 
+**强制完整性检查**：
+
+```bash
+# 列出根目录下所有子目录（排除 .git）
+ls -d */ 2>/dev/null | sort
+```
+
+对照检查结果，确认：
+- 每个子目录都出现在某个区块中，或被标记为 `[ignored]`
+- 如有未归属的目录，必须补充区块或归入现有区块
+- 运行以下验证：`所有区块覆盖的目录 ∪ 被忽略的目录 = 根目录下所有子目录`
+
 ### 阶段 4：逐区块完全深度探索
 
 **对每个区块，必须完整阅读该区块内的每一个文件，从头到尾，不允许遗漏任何一行。**
@@ -219,19 +252,22 @@ project/
 
 ## 项目结构（简化版）
 
-[展示前两层目录结构，包含空目录和忽略项标注]
+[展示前两层目录结构，**必须包含所有顶层子目录**，包含空目录和忽略项标注]
 
 ```
 project/
 ├── src/                     源码目录
 ├── tests/                   测试目录
-├── docs/                    [空目录]
+├── docs/                    项目文档目录
+├── discuss/                 讨论记录目录
+├── assets/                  [空目录] 资源文件
 ├── cache/                   [ignored]
 ├── .gitignore
 └── README.md
 ```
 
 > 详细结构见各区块文档
+> **注意**：此处必须列出根目录下的所有子目录，不能遗漏非代码目录
 
 ## 架构概述
 
@@ -344,7 +380,13 @@ xxx/
 2. 确认每个区块都有完整目录树
 3. 确认总导览包含简化版目录结构
 4. 确认没有遗漏任何文件或目录（包括空目录）
-5. 向用户汇报完成情况
+5. **运行目录完整性最终检查**：
+   ```bash
+   # 列出根目录下所有子目录
+   ls -d */ 2>/dev/null | sort
+   ```
+   逐一核对每个子目录，确认都出现在项目文档中（区块覆盖或标记 [ignored]）
+6. 向用户汇报完成情况
 
 ```
 项目文档已更新：