# Start Orchestrator

> 启动CataForge编排流程 — 从需求到交付的全流程入口。当用户说'开始新项目''继续上次''continue'或描述一个待开发项目、需要初始化或恢复推进编排流程时使用。

- Skill: `lync-cyber/start-orchestrator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lync-cyber/start-orchestrator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lync-cyber/start-orchestrator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lync-cyber (https://skillmd.com/u/lync-cyber)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lync-cyber/start-orchestrator

---


# 启动编排流程 (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）