1. 整理了项目文档结构，将 docs 下的文档按“参考、设计、计划、规范”四个分类归入对应子目录（reference / design / plans / specs），文件名统一加上分类后缀，便于查找；

2. 同步更新了代码注释、配置文件和技能文件中引用的文档路径，避免文档整理后引用失效。

backend/src/main/java/com/agent/management/engine/VariableConverter.java

@@ -11,7 +11,7 @@ import java.util.stream.Collectors;
 /**
  * 工作流变量类型转换器。
  *
- * <p>基于 docs/workflow-node-fields.md 中梳理的规则实现，支持：
+ * <p>基于 docs/design/workflow-node-fields-design.md 中梳理的规则实现，支持：
  * <ul>
  *   <li>通用基础类型转换（string/number/boolean/object/array/filePath/directoryPath）</li>
  *   <li>RAG 检索证据列表的特殊转换</li>

backend/src/main/java/com/agent/management/engine/WorkflowContext.java

@@ -11,7 +11,7 @@ import java.util.concurrent.ConcurrentHashMap;
  *
  * <p>变量作用域采用节点命名空间隔离：每个节点的输出存于 {@code nodeScopedOutputs[nodeId]}，
  * 同名变量互不覆盖。后继节点通过 {@link NodeInputResolver} 的显式 mapping 或四级隐式回退
- * 从前驱命名空间取值，参见 docs/workflow-variable-scope-design.md。</p>
+ * 从前驱命名空间取值，参见 docs/design/workflow-variable-scope-design.md。</p>
  */
 @Slf4j
 public class WorkflowContext {

backend/src/main/java/com/agent/management/model/dto/TagExportDTO.java

@@ -7,7 +7,7 @@ import java.util.List;
 
 /**
  * 标签导出数据结构
- * JSON 格式规范见 docs/tag-import-export-spec.md
+ * JSON 格式规范见 docs/specs/tag-system-spec.md
  */
 @Data
 public class TagExportDTO {

backend/src/main/resources/application.yml.example

@@ -243,7 +243,7 @@ spring:
 
 
 # 外部 API（/api/v1/**）配置
-# 第三方系统通过 X-API-Key 鉴权后调用工作流，详见 docs/external-workflow-api-spec.md
+# 第三方系统通过 X-API-Key 鉴权后调用工作流，详见 docs/specs/external-workflow-api-spec.md
 external:
   api:
     enabled: ${EXTERNAL_API_ENABLED:true}

prompt.md

@@ -1459,3 +1459,11 @@ strict模式下，不识别多余字段，只识别必需字段是否存在。
 
 ---
 
+将 docs 目录下的文档，按“参考”、“设计”、“计划”等分类进行整理，分到不同的目录下。文件名称也可以统一一下。
+
+---
+
+docs/rag 下的也根据分类放到那几个目录下，文件名称统一。必要时可以查看文件内容。
+
+---
+

skills/tag-system/SKILL.md

@@ -269,4 +269,4 @@ Skill 无数据库实体，使用 `folderName` 作为 `entityId`。
 2. 更新 `CreateGroupReq` / `UpdateGroupReq`
 3. 更新 `TagGroupExport` 和 `importCreate` / `importOverwrite`
 4. 更新前端 `TagManagement.vue` 表单
-5. 更新 `docs/tag-system-spec.md` 格式规范
+5. 更新 `docs/specs/tag-system-spec.md` 格式规范