workspace-organization 是一个面向 AI 编码代理的工作区组织技能，主要解决“项目应该放在哪里、目录如何划分、下次会话如何快速了解工作区”的问题。
用途：在开始或搭建项目、或进入一个没有工作区地图的环境时使用，先确定工作区根目录，再维持整洁的目录布局，并维护工作区记忆文件。
主要能力：
- 确认工作区根目录：如果根目录尚未建立，必须先询问用户，而不是直接创建。应提供两到三个具体候选路径（如项目盘或已有文件夹），不要使用开放式提问，也不要默认使用用户个人目录（如 C:\Users<name>），因为那是操作系统的家目录，不是工作区，项目放进去会落入配置文件备份、漫游同步和清理流程。
- 一次询问并记录：询问一次后，将答案记录到工作区记忆文件而非聊天记忆中，避免下次会话重复询问。若必须先推进工作，可提出一个路径并标注为“建议”，同时保持其易于移动。
- 目录布局：将源码、构建输出和临时工作分开。示例布局包含 WORKSPACE.md、项目文件夹，项目内包括 src\（源码，若项目为单仓库则为 Git 仓库根）、build\（编译输出，应被 git 忽略，也可按技术栈使用 dist\ 或 bin\）、docs\（笔记、计划、变更日志）、artifacts\（发布压缩包和发布临时文件，应被 git 忽略）。构建产物不应放在源码树内，否则会混淆跟踪内容、git 忽略语义和清理删除范围。
- 一项目一文件夹：版本默认使用 Git 标签；仅在项目确实需要快照文件夹（如模组包、二进制发布）时，才使用版本文件夹规则。
- WORKSPACE.md 工作区记忆文件：位于工作区根目录，是下一次会话读取的地图，避免重新探索目录树和重复获取上下文。内容包含根路径、项目表格（名称、路径、技术栈、构建方式、版本方案、发布方式）和注意事项（如会误导的路径、需要额外参数的命令、慢步骤）。进入工作区时应先读取它；当路径、构建命令或发布目标变化时更新对应行；保持在一屏以内，不包含密钥、令牌或个人数据。若已有项目但没有地图，应提议创建。
- 完成标准：新的会话（人或代理）打开工作区根目录，读取 WORKSPACE.md 后，即可知道源码位置、构建方式、输出位置和发布方式；若仍需搜索，说明地图缺失或过时。
使用方式：资料以说明性指导为主，未提供安装命令或具体调用步骤。
适用场景：AI 编码代理在开始新项目、放置项目文件、搭建项目骨架或进入陌生工作区时。
限制：资料未提供平台支持范围、收费方式或与其他工具的集成细节；其规则主要针对 Windows 路径环境（如 C:\Users<name>），路径中的特殊字符、目录联接和 MSYS 引号问题由相关技能处理，临时工作也不应落在工作区内。