用途：工作区级项目排期管理，围绕功能模块（而非任务或工单）组织 schedule YAML，连接云效工作项与 OpenSpec 代码变更。触发场景包括询问项目进度、时间线、交付状态，查看某周计划，提及里程碑或“还剩多少”，更新模块状态，关联 OpenSpec 变更，创建新排期，或推送数据到云效。
数据与前置条件：排期文件位于工作区根目录 planning/schedules/<project>.yaml。仅同步云效时需要已安装并配置 yunxiao 技能。技能加载时不校验前置条件，命令因缺依赖失败时再逐步引导安装。
主要能力：模块状态机为 planned → in_progress → done（终态），以及 planned 与 deferred 之间互转；禁止从 done 再转移。模块类型分 feature（含 UI 稿、设计、figma、前后端、优先级）与 infrastructure（仅后端，无 UI）。排期支持内联 modules 列表和 split 的 module_files 引用两种布局；读取命令会合并所有引用文件，写入命令回写到正确源文件。
使用方式：确定性操作由 scripts/planning.py 处理，需先 pip install pyyaml。示例命令：python3 <skill-dir>/scripts/planning.py review；python3 <skill-dir>/scripts/planning.py update <id> --status done；python3 <skill-dir>/scripts/planning.py link <id> --change <name>；python3 <skill-dir>/scripts/planning.py week W3。可用 --file 指定主排期文件而非月份文件。review 支持 --week、--milestones 旗标。planning init 由 LLM 交互式引导创建 YAML。planning update 与 link 先用脚本校验（不写文件），再用 Edit 工具按 source_file 修改，以保留注释与格式。planning sync-yunxiao 将 yunxiao_id 为空的模块创建为云效工作项并回写 ID。
限制：完整 YAML schema 需读 references/yaml-schema.md，资料未展开字段细节；具体里程碑、阶段、容量均为用户自定，暂无固定值。常见错误包括模块 ID 拼写错误、非法状态转移、变更名不匹配、缺排期文件及未安装 yunxiao 技能。