什么是Workspace Planning
Workspace Planning 是一个专为项目进度管理设计的工具，用于管理和查询存储在 planning/ 目录下的 YAML 格式项目进度表。它通过结构化的模块、里程碑和交付阶段跟踪，帮助团队清晰掌握项目整体进展与关键节点状态。该工具不直接处理具体任务或工单，而是聚焦于将功能模块与实际开发工作（如 OpenSpec 代码变更）关联起来，从而弥合 Yunxiao 工作项与工程实现之间的信息断层。
使用 Workspace Planning的前提是存在位于工作区根目录下的 planning/schedules/*.yaml 文件，其中定义了项目的核心结构和各模块的当前状态。工具支持多种操作模式：初始化新项目计划、查看当前周进度概览、更新模块状态以及将开发变更链接到对应模块。此外，它还提供了与外部系统（如 Yunxiao）同步数据的能力，确保项目管理信息在不同平台间保持一致。
整个系统基于一个明确的模块状态机运作：从 planned 到 in_progress 再到 done 构成主路径；而 deferred 状态允许临时推迟后重新激活。这种设计既保证了流程可控性，又具备应对需求变化的灵活性。所有命令均围绕 YAML 文件读写展开，避免引入额外数据库依赖，使轻量级协作成为可能。
核心功能特点
- 基于 YAML 的项目进度表管理，支持多项目并行维护
- 提供模块状态流转控制，遵循预设状态机规则（planned → in_progress → done）
- 集成 OpenSpec 变更链接功能，实现代码改动与计划模块双向追溯
- 支持按周/里程碑筛选展示进度，自动识别风险点与瓶颈
- 可同步至 Yunxiao 生成工作项，打通项目管理与开发执行链路
适用场景
当用户需要了解某个项目的整体交付情况、当前处于哪个阶段或未来几周的关键任务时，Workspace Planning 能够快速生成可视化的进度报告。例如，产品经理可以输入 ‘下周有什么要做’ 或 ‘auth 功能完成了吗’，系统会解析对应的 YAML 文件并返回模块列表及其状态标识（如 done/*/o/-），同时标注出潜在风险——比如设计未完成但已开始编码的前端模块。
对于正在推进中的敏捷开发团队而言，该工具特别适用于定期评审会议场景。通过 `planning review` 命令可一键查看所有模块按时间线分组后的完成情况，并结合里程碑倒计时提醒临近截止的任务。若发现某周后端资源过载（多个模块设定相同 ready_week），工具会在输出中高亮提示，协助协调人力分配。
此外，在跨团队协作环境中，Workspace Planning 还能作为统一的信息枢纽。开发人员提交 OpenSpec 变更前可通过 `planning link` 将其绑定到已有模块，确保后续审计或回溯时有据可依；而当新特性被加入计划时，也可借助 `planning init` 快速搭建框架，再逐步填充细节字段如优先级、依赖关系等。无论是初创公司的小团队还是大型企业级项目，都能从中获得高效透明的计划管理能力。