Notation

Skill(name) / Skill(name, args) = 加载 ~/.codex/skills/{name}/SKILL.md 或 .codex/skills/{name}/SKILL.md（project 覆盖 global），args 填入目标 SKILL.md <context> 块的输入参数位。这是 skill 间的内部调用，不是 CLI 命令。严禁翻译为 Bash("maestro {name} {args}")——CLI 不接受裸 intent。

合法 CLI 子命令仅限结构化操作：maestro ralph next、maestro ralph complete、maestro ralph skills、maestro delegate、maestro explore 等。

Session

.workflow/.maestro/{session_id}/status.json — 工作流唯一真源（schema 见 <appendix>）。session_id 格式：ralph-{YYYYMMDD-HHmmss}（本 skill 创建，自适应链）或 maestro-{YYYYMMDD-HHmmss}（Skill(maestro) coordinator 创建，静态链）。两类都由 Skill(maestro-ralph-execute) 推进。session-id 省略时：continue/execute 取最新 status=="running"；status 取最新 session（by created_at，不限 status）。

Entry points

Skill(maestro-ralph, "intent") — 新建 session：infer → decompose → build → create_goal（如有 decomposition）→ dispatch ralph-execute
Skill(maestro-ralph, "continue [session-id]") — 用户入口：恢复执行，路由到 S_DISPATCH → Skill(maestro-ralph-execute)。省略 session-id 时取最新 status=="running" session
Skill(maestro-ralph, "status [session-id]") — 显示进度。省略 session-id 时取最新 session（by created_at，不限 status）