| 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: 新项目启动
- 读取 {AGENTS_SRC_DIR}/orchestrator/AGENT.md 的角色定义
- 执行
{AGENTS_SRC_DIR}/orchestrator/ORCHESTRATOR-BOOTSTRAP-PROTOCOLS.md §Project Bootstrap
- 进入初始阶段(由执行模式决定,见 Bootstrap 末步「进入初始阶段」)
分支 B: 继续已有项目
B.1: 框架版本检查
- 读取
.cataforge/framework.json 的 version 字段获取当前框架版本
- 如果
.cataforge/framework.json 不存在或 version 为占位符(0.0.0-template)→ 提示用户: "未检测到框架版本信息,当前框架可能需要重新初始化。可运行 cataforge setup 或 pip install --upgrade cataforge && cataforge upgrade apply 修复。"
- 版本检查仅提示,不阻断流程,继续 B.2
B.2: 恢复推进
- 读取 {AGENTS_SRC_DIR}/orchestrator/AGENT.md 的角色定义,执行其 §Startup Protocol 恢复推进(读状态 / 读索引 / 路由由该协议承担)
- 本入口独有分支:
- 当前阶段=completed → 提示项目已完成,询问用户意图(新版本/新需求/重新审查)
- 用户指定目标阶段(如"从架构设计开始")→ 验证前置条件后跳转(前置条件见 orchestrator AGENT.md §Phase Routing,如上游文档须已 approved)