start-orchestrator

name	start-orchestrator
description	启动CataForge编排流程 — 从需求到交付的全流程入口。当用户说'开始新项目''继续上次''continue'或描述一个待开发项目、需要初始化或恢复推进编排流程时使用。
argument-hint	<项目描述 或 'continue' 继续上次>
suggested-tools	file_read, file_glob
depends	[]
disable-model-invocation	false
user-invocable	true

启动编排流程 (start-orchestrator)

能力边界

• 能做: 判断启动模式（新项目初始化 A / 已有项目恢复 B）、加载 orchestrator 角色定义、框架版本与 framework.json 检查、定位恢复阶段
• 不做: 通过 agent-dispatch 启动 orchestrator 子代理（见 §角色假设）；不替代 orchestrator 各 phase 的编排判定逻辑；不直接写 docs/ 子目录产物

角色假设（关键）

本 skill 在主线程会话执行，orchestrator 角色由主线程承载——读取 AGENT.md 加载角色定义后直接执行，不经 agent-dispatch 把 orchestrator 派为子代理（子代理无跨会话主线程状态，会断裂 §项目状态 写权限链路与进度定位）。

该约束是对调度行为的内部要求，非用户可见信息：首条回复不复述角色身份与调度宿主，直接进入对用户有意义的开场——分支 A 先确认对项目的理解再询问执行模式；分支 B 先报告恢复到的阶段与项目状态。

输入规范

• 必填: 项目描述自然语言字符串，或 continue 关键字（触发分支 B 恢复模式）
• 可选: {INSTRUCTION_FILE}（存在即触发分支 B）+ .cataforge/framework.json（版本检查依据）

输出规范

• 新项目: 触发 ORCHESTRATOR-BOOTSTRAP-PROTOCOLS §Project Bootstrap，产出 {INSTRUCTION_FILE} 初版并进入初始阶段
• 恢复推进: 不产出新文档，仅更新 {INSTRUCTION_FILE} §项目状态 块并继续推进当前阶段
• 本 skill 自身不写入 docs/ 任何子目录（实际文档产出由后续阶段 agent 完成）

Anti-Patterns

• 不通过 agent-dispatch 调度 orchestrator — 主线程直接扮演 orchestrator 角色；若误派为子代理，orchestrator 失去跨会话主线程状态感知，§项目状态 写权限链路断裂，恢复会话时无法定位进度
• 不跳过 §角色假设 直接进入步骤 — 角色声明是防止误用 agent-dispatch 的唯一显式约束
• 不在分支 B 跳过框架版本检查 — 版本占位符 0.0.0-template 表示 scaffold 未初始化，直接恢复会让后续 agent 读到不一致状态
• 不在 .cataforge/framework.json 缺失（框架尚未部署）时启动本 skill — 应先用 framework-update 同步包/scaffold 层再交接 start-orchestrator，否则跳过 scaffold 层同步

执行步骤

Step 1: 判断启动模式

• {INSTRUCTION_FILE} 不存在 → 分支 A（新项目）
• {INSTRUCTION_FILE} 存在 → 分支 B（已有项目）

分支 A: 新项目启动

1. 读取 {AGENTS_SRC_DIR}/orchestrator/AGENT.md 的角色定义
2. 执行 {AGENTS_SRC_DIR}/orchestrator/ORCHESTRATOR-BOOTSTRAP-PROTOCOLS.md §Project Bootstrap
3. 进入初始阶段（由执行模式决定，见 Bootstrap 末步「进入初始阶段」）

分支 B: 继续已有项目

B.1: 框架版本检查

1. 读取 .cataforge/framework.json 的 version 字段获取当前框架版本
2. 如果 .cataforge/framework.json 不存在或 version 为占位符（0.0.0-template）→ 提示用户: "未检测到框架版本信息，当前框架可能需要重新初始化。可运行 cataforge setup 或 pip install --upgrade cataforge && cataforge upgrade apply 修复。"
3. 版本检查仅提示，不阻断流程，继续 B.2

B.2: 恢复推进

1. 读取 {AGENTS_SRC_DIR}/orchestrator/AGENT.md 的角色定义，执行其 §Startup Protocol 恢复推进（读状态 / 读索引 / 路由由该协议承担）
2. 本入口独有分支:
   • 当前阶段=completed → 提示项目已完成，询问用户意图(新版本/新需求/重新审查)
   • 用户指定目标阶段（如"从架构设计开始"）→ 验证前置条件后跳转（前置条件见 orchestrator AGENT.md §Phase Routing，如上游文档须已 approved）