loop-orchestration

# Loop Orchestration（编排文档生成器） 产出一份 `.loop/<slug>/ORCHESTRATION.md`——定义一个 loop 里「**谁干什么**」。 它是 `loop-mode` 执行器的输入。本 skill 只**生成/校验编排文档**,不执行 loop。 ## 什么时候用 - 用户要配置一个 loop 的角色分工 / 计划-执行流程时。 - `loop-mode` 找不到 ORCHESTRATION.md 时,回退到这里先生成。 ## 两种来源 1. **用户已写死**:若 `.loop/<slug>/ORCHESTRATION.md` 已存在 → 读它、校验字段齐全即可,**不要重新生成**。 2. **访谈生成**:否则问下面几个问题(一次问一组,别轰炸),据答案写出文档。 ## 访谈要点（用 AskUser,尽量给选项） 1. **slug / 任务名**:给这个 loop 起个短名(目录 `.loop/<slug>/`)。 2. **角色→执行者**:每个角色选 `codex` / `claude-code` / `self`(codeshell 自己直接干): - `planner` 出蓝图 / 拆 milestone（可选,纯打磨 loop 不需要） - `executor` 干活出提案（必填） - `reviewer` 审查提案（可选,默认 self） 3. **阶段**:`milestone`（照蓝图推进）/ `polish`（发散打磨）/ `milestone→polish`（先推进后打磨）。 4. **蓝图来源**（若含 milestone 阶段）:指一个现成文档路径 / 让 planner 现场拆。 5. **值守**:Attended（有人,高风险停等）/ Unattended（无人,高风险堆待批继续）。 6. **闸门**:额度/时间/轮数上限（你把关的停止条件）。 ## 产出模板（写到 .loop/<slug>/ORCHESTRATION.md） ```markdown # Orchestration: <slug> ## Goal <一句话目标> ## Roles - planner: <codex|claude-code|self|none> - executor: <codex|claude-code|self> - reviewer: <codex|claude-code|self> ## Phases <milestone | polish | milestone→polish> ## Blueprint - source: <文档路径 | "planner 现场生成" | none> ## Attendance <attended | unattended> - 切换点(milestone→polish): attended=问一次 / unattended=自动切 ## Permissions（最小必要,按值守分级） - 默认: acceptEdits - 提权: 逐轮显式、有理由;unattended 禁网络写/远端写/凭证/仓库外写(除非 goal 显式授权) - 不可逆交付永远留待批 ## Gates - <额度 / 时间 deadline / 最大轮数 / 单轮上限> ``` ## 校验（生成或读取后都做一遍） - `executor` 必填;`planner=none` 时 Phases 不得含 milestone...