unit-planner

技能：unit-planner

触发条件与路由

• 触发条件：unit planner、生成 UNITS.csv、执行合同、工作单元模板、生成工作单元。
• 适用场景：初始化/更新执行合同：从 pipeline 选择并生成 UNITS.csv，或 scope 扩展时需要新增 units/依赖项。
• 跳过条件：UNITS.csv 已正确反映当前 scope（无需重写）。
• 网络：无。
• 防护措施：确保 CSV 合法；scope 增长时新增 units；仅在满足验收条件后标记为 DONE。

目标

• 将 pipeline（pipelines/*.pipeline.md）转换为特定工作区的具体 UNITS.csv 合同。

输入

• PIPELINE.lock.md（优先）或选定的 pipelines/*.pipeline.md
• pipeline front matter 中引用的 templates/UNITS.*.csv
• 现有工作区产物（必要时用于调整 scope）

输出

• 工作区根目录中的 UNITS.csv
• 可选：更新 STATUS.md，列出下一个可运行的 units

操作流程（必须遵循）

使用：templates/UNITS.*.csv。

1. 阅读 PIPELINE.lock.md（或通过 pipeline-router 请求创建该文件）。
2. 如果工作区中缺少 UNITS.csv，将 pipeline 的 units_template 复制到工作区并命名为 UNITS.csv。
3. 如果 UNITS.csv 已存在，仅在以下情况下编辑：
   • scope 有新增内容（添加行）
   • 依赖关系需要更正
   • 验收标准需要明确
4. 确保每个 unit 都包含：unit_id、skill、outputs、acceptance、checkpoint、status、owner。
5. 确保 checkpoint 与 CHECKPOINTS.md 一致；如果 pipeline 使用自定义 checkpoint，则添加缺失项。

验收标准（必须检查）

• UNITS.csv 可解析为 CSV，且包含所有必需列。
• 每个 depends_on 都引用现有的 U###。

副作用

• 允许：编辑 UNITS.csv、STATUS.md、CHECKPOINTS.md（用于添加自定义 checkpoint）。
• 不允许：除非收到请求，否则不得更改 pipelines/ 中的 pipeline 文件。

故障排除

问题：缺少 PIPELINE.lock.md

解决方法：

• 运行 pipeline-router（模式 A），或运行 uv run python scripts/pipeline.py kickoff|init，在生成 units 前创建 PIPELINE.lock.md。

问题：编辑后 UNITS.csv 变成无效 CSV

解决方法：

• inputs/outputs 使用分号分隔，并避免在字段中使用未转义的逗号；使用 uv run python scripts/validate_repo.py 进行验证。