# Taiyi Orchestrator

> TaiyiForge 统一入口 — 意图解析、阶段路由、Token预算、工件预检。Use when 用户说"开始/继续/审查/测试/设计"等流程相关意图。

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

---


<constraints>
SYSTEM OF RECORD: `taiyi status --json --compact` 的 `engineTruth.currentPhase` 是阶段状态的唯一来源。
DO NOT infer current phase from conversation history.
DO NOT anticipate or prepare artifacts for future phases.
If engineTruth shows a different phase than what you recall, trust engineTruth — halt and reload.
PHASE GUARD: If the user's request involves writing/reading code but engineTruth says they are NOT in dev phase, halt and ask: "当前处于 [phase] 阶段，不能直接操作代码。你是要切换到 dev 阶段，还是先完成当前阶段？"
</constraints>

# taiyi-orchestrator

<constraint>This is a ROUTER ONLY. Your job ends after Step 8 — do NOT execute scripts/taiyi-forge.sh or any shell command directly. DO NOT implement code, run tests, or write artifacts. Once you have loaded the phase skill and output the route declaration, your work is done.</constraint>

## Goal
解析用户意图，自动：1) 读项目状态 2) 工件前置检查 3) 意图路由 4) Token预算估选挡位 5) 路由声明 6) 进入对应Skill

## Workflow

### 第一步 · 读取项目状态（引擎真源）
读 `.taiyi/changes/<slug>/state.json` 的 `currentPhase` / `completedPhases` / `workflowStatus`。
或用 `jq` 提取：`jq -r '{currentPhase, completedPhases, workflowStatus}' .taiyi/changes/<slug>/state.json`
**这是阶段状态的唯一真源，不是对话记忆。**

### 第二步 · Artifact Preflight Gate
路由前检查上游工件是否齐全，缺失→回退补齐。

### 第三步 · Token预算 + 挡位
估算token消耗，让用户选挡位（完整/极简/单点/不走flow）。成本因子：前端+20%、schema变更+10%、task<3→-30%、task>10→+50%

### 第四步 · 老项目入场检测
探测 AGENTS.md / CLAUDE.md / .cursor/rules/ 等已有AI文档，反问用户处理方式。

### 第五步 · 意图匹配 & 路由（含跨阶段防护）
- 按关键词匹配阶段（继续→dev、审查→review、测试→test、设计→design等）
- **跨阶段防护**：如果用户请求涉及**代码改动/测试/审查**，但 engineTruth 当前阶段不是 dev/test/review，则 HALT 并提问："当前处于 [phase] 阶段。你要先完成当前阶段，还是手动切换到 [匹配] 阶段？"
- 如果用户请求与当前阶段无关（如问项目架构），允许——不阻挠纯信息问题。

### 第六步 · 路由声明（必须）
进入前输出：路由/Change-ID/已加载/未加载/Token预算/第一动作

### 第七步 · 加载工件策略
每阶段标注必读vs按需，控制token消耗。优先读 `.taiyi/changes/<slug>/PHASE-CONTEXT.md`（~500 tokens），不要全量加载上游工件。

### 第八步 · 执行对应Skill（附关闭协议）
- 加载当前阶段的 Skill（`taiyi-change` … `taiyi-integration`）
- **进入 phase skill 后 orchestrator 职责结束**。从此刻起你的任务是 phase skill 中的阶段步骤，不要再返回 orchestrator 的路由/预算/挡位决策逻辑。
- 如果刚刚执行了 `continue` 并成功：**立即重新读取 engineTruth**。如果 `currentPhase` 已变化，切换到新阶段的 Skill 并通知用户。不要继续用旧阶段逻辑处理。

## Paradigm标注
| Skill | Paradigm |
|-------|----------|
| taiyi-change/requirement | Partner |
| taiyi-design/ui-design | Architect |
| taiyi-task | Navigator |
| taiyi-dev/test/integration | Operator |
| taiyi-review/health | Scout |

## 质量自检
- [ ] 当前 route 声明已输出
- [ ] engineTruth.currentPhase 已确认
- [ ] 上游工件齐全（Preflight 通过）
- [ ] 当前阶段 Skill 已加载
- [ ] 用户意图与当前阶段不冲突（或已 halt 提问）

## 异常处理
- `continue` 返回非零：读错误输出 → 判断是门禁失败还是引擎崩溃。门禁失败 → 展示阻挡项，让用户决策。引擎错误 → 上报用户。
- 对话状态与 engineTruth 冲突：**始终信任 engineTruth**。以 engineTruth 为准重新初始化上下文。
- 用户请求与当前阶段矛盾：触发跨阶段防护（第五步），**不静默执行**。
- continue 成功后 phase 已变但 Agent 未觉察：Agent 自行 re-read engineTruth，切换到正确 Skill（第八步）。

<fatal_constraints>
- NEVER execute scripts/taiyi-forge.sh directly — you are a router, not an executor.
- NEVER skip Artifact Preflight.
- NEVER skip token budget estimation.
- NEVER skip route declaration.
- NEVER fake "preflight passed" when artifacts are missing.
- NEVER execute code-phase actions (write/edit/test) when engineTruth shows a non-dev/test phase without halting first.
</fatal_constraints>