用途
update-workspace-map 用于确保 workspace-map.md 与实际的 04-workspace/ 文件夹结构保持同步，扫描深度最多 3 层。workspace-map.md 的作用是帮助 AI 理解用户在 04-workspace/ 中的自定义文件夹组织；当文件夹被新增、删除或重组而文档未更新时，AI 的导航会变得不可靠。该技能通过校验并引导更新来避免这一问题。
主要能力
- 递归扫描工作区结构，深度为 3 层（根 → 第 1 层 → 第 2 层 → 第 3 层）。
- 将实际文件夹与文档中记录的文件夹在所有层级进行比对。
- 识别不匹配项，包括缺失或多余的文件夹、错误的嵌套关系。
- 生成带深度指示符的详细结构报告。
- 引导用户完成全面更新，并在更改后校验准确性。
相较 v1 的改进：
- 支持 3 层深度扫描（v1 为 1 层）。
- 支持层级化校验（父子关系）。
- 支持文件检测（对应当被记录的文件发出警告）。
- 报告中包含深度指示符（├──、│ ├──、│ │ ├──）。
- 针对嵌套结构提供全面的文档提示。
使用方式
当用户说出“validate workspace map”“update workspace…”等触发语时加载该技能。
工作流程：
-
扫描实际工作区结构（3 层深）。递归扫描工作区，最多 3 层，例如使用
find 04-workspace -maxdepth 3 -type d | sort，并解析为层级结构。同时扫描重要文件（用于文档警告），例如find 04-workspace -maxdepth 3 -type f -name "*.md" -o -name "README*" | sort。存储 ACTUAL_STRUCTURE（3 层树）与 IMPORTANT_FILES（markdown/README 文件）。排除隐藏文件夹（.、..、.git、.DS_Store）、workspace-map.md 自身以及系统文件夹。预计耗时 10 秒。 -
解析 workspace-map.md（3 层深）。读取 04-workspace/workspace-map.md，从“Your Workspace Structure”部分的树状结构（解析带 ├──、│ ├──、│ │ ├── 的行，按缩进构建层级树，捕获以 # 表示的行内注释）以及“Folder Descriptions”部分（解析 ### 表示第 1 层、#### 表示第 2 层、##### 表示第 3 层，提取用途、内容与备注）中提取已记录结构，并交叉引用两个部分以确保完整。存储 MAPPED_STRUCTURE 与 MAPPED_DESCRIPTIONS。预计耗时 10 秒。
-
深度比对（层级化）。在第 1 层（04-workspace/ 的直接子项）比对缺失、多余（过时）与匹配项；在第 2 层（每个第 1 层文件夹内部）比对子项、跟踪父子关系、识别孤立第 2 层文件夹（父级缺失）；在第 3 层（每个第 2 层文件夹内部）比对子项、校验完整路径准确性、识别深层嵌套不匹配。识别各层缺失文件夹、各层多余（过时文档）文件夹、层级问题（记录在错误父级下）、未记录文件（无描述的重要 .md 文件）以及完全匹配（所有层级准确）。预计耗时 5 秒。
-
生成综合报告。以清晰的深度指示符和可操作反馈，展示全部 3 层的详细校验结果。
适用场景
- 重组了 04-workspace/ 文件夹之后。
- 发现 AI 找不到你的文件夹时。
- 入职流程中（Project 03，Task 5.6）。
- 作为日常维护的一部分（通过 close-session）。
集成
该技能会在 close-session 期间自动触发。若发现不匹配，会提示用户进行更新。
时间估算
- 完全匹配（3 层）：约 20 秒。
- 少量更新（1-2 个文件夹）：2-3 分钟。
- 大规模重组（5 个以上文件夹）：5-7 分钟。
- 深度重构（大量第 2-3 层变更）：8-10 分钟。
限制
资料未提供该技能的具体平台依赖、安装方式、收费模式或价格信息，暂未提供。