maestro-next

<purpose>
解析 intent + project state → 路由表评分 → 推荐单个原子命令 → 确认后 `Skill()` 执行。
不创建 session、不构建 chain、不写 status.json。
</purpose>

<context>
$ARGUMENTS — 意图文本 + 可选 flags。

**Flags:**
- `-y` / `--yes` — 跳过确认，直接执行 top pick
- `--dry-run` — 仅显示推荐结果，不执行
- `--top N` — 显示前 N 个候选（默认 3）
- `--list` — 仅列出可推荐命令池，不做推荐

**候选池：** 仅 A_SCORE_CANDIDATES 路由表中列出的命令。管线编排器（`maestro` / `maestro-ralph*` / `maestro-player` / `maestro-composer`）**永远不在候选池**。
</context>

<invariants>
1. **不创建 session / 不写 status.json / 不触发后续 chain** — 单次原子执行，产出由目标命令自行管理
2. **管线编排器不在候选池** — 仅推荐原子命令
3. **空 intent 或 "继续/下一步/next/接下来"** → 直接采用 lifecycle_position 推断的自然下一步
4. **字面命中路由表优先** — lifecycle 仅作加分；命中失败时 lifecycle 上升为决定性信号
5. **参数传递** — 默认 intent 原文作为第一个 arg；用户可在确认环节修改；`-y` 仅当用户传入时透传到 skill args
6. **`--list` 模式跳过 lifecycle 推断与评分**，仅按 workflow 簇分组列出全部候选
</invariants>

<state_machine>

<states>
S_PARSE     — 解析 ARGUMENTS、提取 flags                       PERSIST: —
S_STATE     — 读 project state、推断 lifecycle_position         PERSIST: —
S_RANK      — 路由表评分、生成 top-N candidates                 PERSIST: —
S_LIST      — `--list` 模式：分组展示候选池                     PERSIST: —
S_PRESENT   — 显示 top pick + 备选 + 推荐理由 + 执行参数        PERSIST: —
S_CONFIRM   — AskUserQuestion 选择/修改参数（auto_mode 跳过）    PERSIST: —
S_EXECUTE   — `Skill({ skill, args })` 单次调用                 PERSIST: —
S_FALLBACK  — intent 空且 clarification 失败                    PERSIST: —
</states>

<transitions>

S_PARSE:
  → S_LIST       WHEN: --list flag
  → S_STATE      WHEN: intent text present
  → S_STATE      WHEN: keyword "continue"/"next"/"go"/"继续"/"下一步"/"接下来"
  → S_PARSE      WHEN: no intent (max 1 clarify round)    DO: AskUserQuestion
  → S_FALLBACK   WHEN: clarification empty

S_STATE:
  → S_RANK       DO: A_INFER_LIFECYCLE

S_RANK:
  → S_PRESENT    DO: A_SCORE_CANDIDATES

S_LIST:
  → END          DO: 按 workflow 簇分组列出全部候选 + description

S_PRESENT:
  → END          WHEN: --dry-run
  → S_EXECUTE    WHEN: -y / --yes
  → S_CONFIRM    WHEN: not auto_mode

S_CONFIRM:
  → S_EXECUTE    WHEN: 用户确认 top pick / 选备选 / 改参数
  → END          WHEN: 用户取消

S_EXECUTE:
  → END          DO: Skill({ skill: <chosen>, args: <args> }) → 输出 "✅ 已执行 /<command>"

S_FALLBACK:
  → END          DO: raise E001

</transitions>

<actions>

### A_INFER_LIFECYCLE

读 project state 推断 `lifecycle_position`（核心信号）：

```bash
cat .workflow/state.json 2>/dev/null              # phase / milestone / artifacts
ls -la .workflow/scratch/ 2>/dev/null | head -10  # 最近 artifact (mtime DESC)
ls -la .workflow/.maestro/ 2>/dev/null | head -5  # 进行中的 session
```

**项目状态 → lifecycle_position → 自然下一步：**

| 项目状态 | lifecycle_position | 自然下一步 |
|---------|-------------------|-----------|
| 无 `.workflow/` + 无源码 | brainstorm | `maestro-brainstorm` |
| 无 `.workflow/` + 有源码 | init | `maestro-init` |
| 有 state.json，无 roadmap，无 milestones | analyze-macro | `maestro-analyze` (宏观调研) |
| 有 macro analyze artifact，无 roadmap | roadmap | `maestro-roadmap` |
| 有 roadmap，未启动 phase | analyze | `maestro-analyze {phase}` |
| 最新 artifact = analyze | plan | `maestro-plan {phase}` |
| 最新 artifact = plan | execute | `maestro-execute {phase}` |
| 最新 artifact = execute | review | `quality-review {phase}` |
| review verdict=PASS | test-gen | `quality-auto-test {phase}` |
| 测试全绿 + current_milestone 存在 | milestone-audit | `maestro-milestone-audit` |
| 测试全绿 + current_milestone=null (standalone) | review-done | 回退到 `quality-review` 或 `manage-status`（无 milestone 上下文时不推荐 milestone 命令） |
| 当前 milestone 全 phase 完成 | milestone-complete | `maestro-milestone-complete` |
| 任一 stage 产物含 gaps/failed | debug | `quality-debug {gap}` |

**Maestro Lifecycle 主线：**
```
brainstorm → blueprint → init → analyze-macro → roadmap
   → [per phase] analyze → plan → execute (includes verification)
   → [quality gate] review → auto-test → test
   → milestone-audit → milestone-complete → milestone-release
```

### A_SCORE_CANDIDATES

**评分信号**（高→低）：

| 信号 | 权重 | 说明 |
|------|------|------|
| intent 命中路由表关键词 | 高 | 字面匹配主依据 |
| **lifecycle 自然下一步** | **高** | 空 intent / "继续" / "next" 时为决定性 |
| `name` 关键词命中 intent | 中 | intent 含 "test" → quality-test/quality-auto-test 加分 |
| Workflow 簇匹配 | 中 | intent 涉及学习/知识/issue 等场景触发对应簇 |
| Recent activity 反向避免 | 低 | 刚完成的 stage 短期内降权 |
| **前置条件不满足** | **禁止** | 候选命令的前置条件未满足时，直接从候选池移除（如 `maestro-milestone-*` 在 `current_milestone=null` 时移除） |

**前置条件检查（评分前执行，不满足则移除候选）：**

| 命令 | 前置条件 |
|------|---------|
| `maestro-milestone-audit` | `current_milestone` 存在且非 null |
| `maestro-milestone-complete` | `current_milestone` 存在且非 null |
| `maestro-milestone-release` | `current_milestone` 存在且非 null |
| `maestro-merge` | 存在活跃的 fork 分支 |

**特殊意图处理：**

| Intent 模式 | top pick |
|------------|---------|
| 空 / "继续" / "下一步" / "next" / "接下来" | lifecycle 自然下一步 |
| "什么状态" / "现在到哪了" / "status" | `manage-status` |
| 字面命中路由表 | 路由表优先（lifecycle 仅加分） |
| 无任何匹配 | lifecycle 下一步 + raise W002 |

**意图 → 命令路由表**（候选池）：

| 意图关键词 | 推荐命令 |
|-----------|---------|
| 头脑风暴 / 探索 / brainstorm / ideate | `maestro-brainstorm` |
| 规格 / 正式文档 / spec-generate / blueprint | `maestro-blueprint` |
| 分析 / analyze / 多维度调研 | `maestro-analyze` |
| 规划 / plan / 任务分解 | `maestro-plan` |
| 实现 / 执行 / execute | `maestro-execute` |
| 验证 / verify / 验收 | `maestro-execute` |
| 调试 / debug / 排查 / bug | `quality-debug` |
| 审查 / review / 代码审查 | `quality-review` |
| 测试 / test / UAT | `quality-test` / `quality-auto-test` |
| 重构 / refactor / 技术债 | `quality-refactor` |
| 同步文档 / sync docs | `quality-sync` |
| 回顾 / retro | `quality-retrospective` |
| issue / 缺陷管理 | `manage-issue` / `manage-issue-discover` |
| wiki / 知识图谱 | `manage-wiki` (含 connect/digest 子命令) |
| spec / 规则 / 约束 | `spec-load` / `spec-add` / `spec-setup` |
| 项目初始化 / init | `maestro-init` |
| 状态 / status / 仪表盘 | `manage-status` |
| 文档重建 / codebase 文档 | `manage-codebase-rebuild` / `quality-sync` |
| 安全 / security / OWASP | `security-audit` |
| 跟读 / 学习 / 阅读源码 | `learn-follow` / `learn-investigate` |
| 第二意见 / challenge / consult | `learn-second-opinion` |
| 提取知识 / harvest | `manage-harve