补充试玩就绪度聊天入口

新增 /ready 试玩就绪度摘要补充 /next 与 /help 的就绪度入口覆盖验证 /ready 不触发文件读取、运行、预览、导出或 agent 控制同步 AI 游戏创作 App 技术方案和决策记录
2026-07-04 11:38:13 +08:00
parent 5021f3fa5f
commit 0e8b6b98e9
4 changed files with 258 additions and 2 deletions
@@ -1881,6 +1881,7 @@ const chatCommandHelp = [
  '/polish：查看试玩前打磨清单',
  '/risks：查看当前项目风险',
  '/blockers：查看当前阻塞项',
+  '/ready：查看试玩就绪度',
  '/criteria：查看当前任务验收标准',
  '/groups：查看专业组进度',
  '/balance：查看数值与难度口径',
@@ -3185,6 +3186,132 @@ function summarizeProjectBlockers(
  };
 }

+function summarizeProjectPlaytestReadiness(
+  nextManifest: GameCreationAppManifest,
+  trace: GameCreationAgentRunTrace | null,
+) {
+  const manifestTasks = taskRowsFromManifest(nextManifest);
+  const traceTasks = trace?.taskGraph.tasks ?? [];
+  const taskSource = traceTasks.length > 0 ? traceTasks : manifestTasks;
+  const taskSourceById = new Map(taskSource.map((task) => [task.id, task]));
+  const failedTasks = taskSource.filter((task) => task.status === 'failed');
+  const readyTasks =
+    trace?.taskGraph.readyTaskIds
+      .map((taskId) => taskSourceById.get(taskId))
+      .filter((task): task is GameCreationAppTaskState => Boolean(task)) ??
+    selectGameCreationAppReadyTasks({ tasks: manifestTasks });
+  const commandRuns = nextManifest.commandRuns ?? [];
+  const latestStaticSmokeCommand =
+    [...commandRuns]
+      .reverse()
+      .find((commandRun) => commandRun.commandId === 'game.static_smoke') ??
+    null;
+  const latestExportCommand =
+    [...commandRuns]
+      .reverse()
+      .find(
+        (commandRun) => commandRun.commandId === 'project.export_package',
+      ) ?? null;
+  const preview = nextManifest.preview;
+  const previewRunning = preview?.status === 'running' && preview.url;
+  const previewSummary = previewRunning
+    ? `运行中 ${preview.url}`
+    : preview
+      ? previewStatusLabels[preview.status]
+      : '未启动';
+  const tracePassed = isAgentRunTracePassed(trace);
+  const blockedTrace =
+    trace?.lifecycleStatus === 'killed' ||
+    trace?.status === 'failed' ||
+    trace?.status === 'needs-revision' ||
+    trace?.stopReason === 'max-passes-exhausted';
+  const staticSmokePassed =
+    latestStaticSmokeCommand?.status === 'completed' ||
+    Boolean(
+      trace?.steps.some((step) =>
+        step.toolCalls.some(
+          (toolCall) =>
+            toolCall.toolId === 'game.static_smoke' && toolCall.status === 'ok',
+        ),
+      ),
+    );
+  const exportReady = latestExportCommand?.status === 'completed';
+  const hasVisualAsset = nextManifest.assets.some(isProjectVisualAsset);
+  const hasAudioAsset = nextManifest.assets.some(isProjectAudioAsset);
+
+  let draftCommand = '/share';
+  let draftCommandLabel = '准备交付';
+  if (!trace) {
+    draftCommand = '/next';
+    draftCommandLabel = '查看下一步';
+  } else if (blockedTrace) {
+    draftCommand = '/review';
+    draftCommandLabel = '查看评审';
+  } else if (!tracePassed) {
+    draftCommand = '/trace';
+    draftCommandLabel = '查看 trace';
+  } else if (failedTasks.length > 0) {
+    draftCommand = '/tasks';
+    draftCommandLabel = '查看任务';
+  } else if (!staticSmokePassed || !previewRunning) {
+    draftCommand = '/run';
+    draftCommandLabel = '启动试玩';
+  } else if (!exportReady) {
+    draftCommand = '/export';
+    draftCommandLabel = '导出试玩包';
+  } else if (readyTasks.length > 0) {
+    draftCommand = '/todo';
+    draftCommandLabel = '查看小步清单';
+  } else if (!hasVisualAsset) {
+    draftCommand = '/art';
+    draftCommandLabel = '查看美术';
+  }
+
+  const verdict =
+    tracePassed && previewRunning && staticSmokePassed && exportReady
+      ? '可交给测试者'
+      : tracePassed
+        ? '接近可测，先补齐预览 / 自检 / 试玩包'
+        : trace
+          ? '暂不建议交付，先处理最近 run'
+          : '暂不建议交付，先生成可验原型';
+
+  return {
+    text: [
+      '试玩就绪度：',
+      `- 项目：${nextManifest.name}`,
+      trace ? `- Run：${trace.runId} · ${formatAgentRunStatus(trace)}` : null,
+      `- 原型：${
+        tracePassed
+          ? '最近 run 已通过'
+          : trace
+            ? `最近 run 未通过 ${trace.status} / ${trace.stopReason}`
+            : '暂无最近 run'
+      }`,
+      `- 预览：${previewSummary}`,
+      `- 自检：${
+        staticSmokePassed
+          ? '已通过'
+          : latestStaticSmokeCommand
+            ? `${latestStaticSmokeCommand.commandId} ${latestStaticSmokeCommand.status}`
+            : '暂无'
+      }`,
+      `- 试玩包：${exportReady ? '已导出' : '未导出'}`,
+      `- 任务：失败 ${failedTasks.length} / ready ${readyTasks.length}`,
+      `- 素材：美术 ${hasVisualAsset ? '已有' : '缺少'} / 音频 ${
+        hasAudioAsset ? '已有' : '可后补'
+      }`,
+      `- 结论：${verdict}`,
+      '- 边界：只判断就绪度；不读取文件；不启动预览；不导出试玩包；不写项目',
+      `- 建议：${draftCommand}`,
+    ]
+      .filter(Boolean)
+      .join('\n'),
+    draftCommand,
+    draftCommandLabel,
+  };
+}
+
 function summarizeProjectAcceptanceCriteria(
  nextManifest: GameCreationAppManifest,
  trace: GameCreationAgentRunTrace | null,
@@ -4615,6 +4742,7 @@ function summarizeNextProjectActions(
  addSuggestion('查看试玩前打磨清单', '/polish');
  addSuggestion('查看数值与难度口径', '/balance');
  addSuggestion('查看当前阻塞项', '/blockers');
+  addSuggestion('查看试玩就绪度', '/ready');

  const readyTasks = selectGameCreationAppReadyTasks({
    tasks: taskRowsFromManifest(nextManifest),
@@ -8527,6 +8655,26 @@ export function App() {
      return;
    }

+    if (prompt === '/ready') {
+      if (!requireChatProjectForUserAction()) {
+        return;
+      }
+      const summary = summarizeProjectPlaytestReadiness(
+        manifest,
+        agentRunTrace,
+      );
+      setMessages((current) => [
+        ...current,
+        {
+          role: 'assistant',
+          text: summary.text,
+          draftCommand: summary.draftCommand,
+          draftCommandLabel: summary.draftCommandLabel,
+        },
+      ]);
+      return;
+    }
+
    if (prompt === '/criteria') {
      if (!requireChatProjectForUserAction()) {
        return;
@@ -3545,6 +3545,108 @@ describe('AI 游戏创作 App 界面边界', () => {
      invoke.mock.calls.filter(([command]) => command === 'control_agent_run'),
    ).toHaveLength(commandCountsBeforeBlockers.controlAgentRun);

+    const commandCountsBeforeReady = {
+      manifestRead: invoke.mock.calls.filter(
+        ([command]) => command === 'get_local_game_manifest',
+      ).length,
+      fileRead: invoke.mock.calls.filter(
+        ([command]) => command === 'read_local_project_file',
+      ).length,
+      fileList: invoke.mock.calls.filter(
+        ([command]) => command === 'list_local_project_files',
+      ).length,
+      runLocal: invoke.mock.calls.filter(
+        ([command]) => command === 'run_limited_local_command',
+      ).length,
+      startPreview: invoke.mock.calls.filter(
+        ([command]) => command === 'start_local_game_preview',
+      ).length,
+      openPreview: invoke.mock.calls.filter(
+        ([command]) => command === 'open_local_game_preview',
+      ).length,
+      exportPackage: invoke.mock.calls.filter(
+        ([command]) => command === 'export_local_project_package',
+      ).length,
+      exportList: invoke.mock.calls.filter(
+        ([command]) => command === 'list_local_project_export_packages',
+      ).length,
+      controlAgentRun: invoke.mock.calls.filter(
+        ([command]) => command === 'control_agent_run',
+      ).length,
+    };
+    submitChat('/ready');
+    const readyMessages = await screen.findAllByText(/试玩就绪度：/);
+    const readyMessage = readyMessages[readyMessages.length - 1];
+    expect(readyMessage.textContent).toContain('项目：未命名游戏原型');
+    expect(readyMessage.textContent).toContain(
+      'Run：run-main-shortcut-trace · passed / done · 1/3 轮 · evaluator-passed',
+    );
+    expect(readyMessage.textContent).toContain('原型：最近 run 已通过');
+    expect(readyMessage.textContent).toContain('预览：未启动');
+    expect(readyMessage.textContent).toContain('自检：已通过');
+    expect(readyMessage.textContent).toContain('试玩包：未导出');
+    expect(readyMessage.textContent).toContain('任务：失败 0 / ready 1');
+    expect(readyMessage.textContent).toContain(
+      '素材：美术 已有 / 音频 可后补',
+    );
+    expect(readyMessage.textContent).toContain(
+      '结论：接近可测，先补齐预览 / 自检 / 试玩包',
+    );
+    expect(readyMessage.textContent).toContain(
+      '边界：只判断就绪度；不读取文件；不启动预览；不导出试玩包；不写项目',
+    );
+    expect(readyMessage.textContent).toContain('建议：/run');
+    const readyMessageList = document.querySelector('.message-list');
+    expect(readyMessageList).not.toBeNull();
+    const readyDraftButtons = within(
+      readyMessageList as HTMLElement,
+    ).getAllByRole('button', { name: '启动试玩' });
+    fireEvent.click(readyDraftButtons[readyDraftButtons.length - 1]);
+    expect(screen.getByLabelText('创作想法')).toHaveProperty('value', '/run');
+    expect(
+      invoke.mock.calls.filter(
+        ([command]) => command === 'get_local_game_manifest',
+      ),
+    ).toHaveLength(commandCountsBeforeReady.manifestRead);
+    expect(
+      invoke.mock.calls.filter(
+        ([command]) => command === 'read_local_project_file',
+      ),
+    ).toHaveLength(commandCountsBeforeReady.fileRead);
+    expect(
+      invoke.mock.calls.filter(
+        ([command]) => command === 'list_local_project_files',
+      ),
+    ).toHaveLength(commandCountsBeforeReady.fileList);
+    expect(
+      invoke.mock.calls.filter(
+        ([command]) => command === 'run_limited_local_command',
+      ),
+    ).toHaveLength(commandCountsBeforeReady.runLocal);
+    expect(
+      invoke.mock.calls.filter(
+        ([command]) => command === 'start_local_game_preview',
+      ),
+    ).toHaveLength(commandCountsBeforeReady.startPreview);
+    expect(
+      invoke.mock.calls.filter(
+        ([command]) => command === 'open_local_game_preview',
+      ),
+    ).toHaveLength(commandCountsBeforeReady.openPreview);
+    expect(
+      invoke.mock.calls.filter(
+        ([command]) => command === 'export_local_project_package',
+      ),
+    ).toHaveLength(commandCountsBeforeReady.exportPackage);
+    expect(
+      invoke.mock.calls.filter(
+        ([command]) => command === 'list_local_project_export_packages',
+      ),
+    ).toHaveLength(commandCountsBeforeReady.exportList);
+    expect(
+      invoke.mock.calls.filter(([command]) => command === 'control_agent_run'),
+    ).toHaveLength(commandCountsBeforeReady.controlAgentRun);
+
    const fileReadCountBeforeCriteria = invoke.mock.calls.filter(
      ([command]) => command === 'read_local_project_file',
    ).length;
@@ -4294,6 +4396,7 @@ describe('AI 游戏创作 App 界面边界', () => {
    expect(screen.getByText(/查看最近生成变更：\/changes/)).not.toBeNull();
    expect(screen.getByText(/查看下一轮小步清单：\/todo/)).not.toBeNull();
    expect(screen.getByText(/查看当前阻塞项：\/blockers/)).not.toBeNull();
+    expect(screen.getByText(/查看试玩就绪度：\/ready/)).not.toBeNull();
    expect(screen.getByText(/查看素材署名与来源：\/credits/)).not.toBeNull();
    expect(screen.getByText(/查看美术素材：\/art/)).not.toBeNull();
    expect(screen.getByText(/查看发布准备清单：\/publish/)).not.toBeNull();
@@ -10595,6 +10698,7 @@ describe('AI 游戏创作 App 界面边界', () => {
    expect(screen.getByText(/\/polish：查看试玩前打磨清单/)).not.toBeNull();
    expect(screen.getByText(/\/risks：查看当前项目风险/)).not.toBeNull();
    expect(screen.getByText(/\/blockers：查看当前阻塞项/)).not.toBeNull();
+    expect(screen.getByText(/\/ready：查看试玩就绪度/)).not.toBeNull();
    expect(screen.getByText(/\/criteria：查看当前任务验收标准/)).not.toBeNull();
    expect(screen.getByText(/\/groups：查看专业组进度/)).not.toBeNull();
    expect(screen.getByText(/\/balance：查看数值与难度口径/)).not.toBeNull();
@@ -3879,6 +3879,7 @@
 - 2026-07-04 调整：普通用户通过聊天输入 `/polish` 查看试玩前打磨清单，只基于当前 manifest、最近 run trace、preview、最近自检和资产数量汇总试玩前打磨范围、推荐检查顺序、关联任务和最近打磨相关步骤，并提供 `/agent-resume 打磨：...`、`/review`、`/feedback` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取文件、不得启动预览、不得导出试玩包、不得写项目，也不得新增普通用户打磨面板。
 - 2026-07-03 调整：普通用户通过聊天输入 `/credits` 查看素材署名与来源，只基于当前 manifest.assets 汇总素材数量、上传 / 生成 / 画板来源分布、来源清单和交付前需要确认的授权 / 模型 / 画板资源口径，并提供 `/assets` 草稿；该入口不得触发 Tauri 读写、不得刷新资产、不得读取素材清单、不得导出试玩包，也不得新增普通用户署名面板。
 - 2026-07-04 调整：普通用户通过聊天输入 `/blockers` 查看当前阻塞项，只基于当前 manifest、最近 run trace、preview、最近命令、ready / failed 任务、导出记录和资产概况汇总当前阻塞项，并提供 `/run`、`/export`、`/todo`、`/review`、`/trace`、`/tasks`、`/logs`、`/art` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取文件、不得启动预览、不得导出试玩包、不得写项目，也不得新增普通用户阻塞面板。
+- 2026-07-04 调整：普通用户通过聊天输入 `/ready` 查看试玩就绪度，只基于当前 manifest、最近 run trace、preview、最近自检、导出记录、ready / failed 任务和资产概况汇总可交付判断，并提供 `/run`、`/export`、`/todo`、`/review`、`/trace`、`/tasks`、`/art`、`/share` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取文件、不得启动预览、不得导出试玩包、不得写项目，也不得新增普通用户就绪度面板。
 - 2026-07-03 调整：普通用户通过聊天输入 `/risks` 查看当前项目风险，只基于主窗口当前已加载的 manifest、最近 run trace、预览状态、任务状态、资产来源和最近命令派生风险摘要，并提供首个风险处理草稿；该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览，也不得新增普通用户面板。
 - 2026-07-03 调整：普通用户通过聊天输入 `/criteria` 查看当前任务验收标准，只基于当前 manifest.tasks 和最近 run trace.taskGraph 汇总 active、carry、ready、失败或待处理任务的验收条件和产物，并提供 `/tasks` 草稿；该入口不得触发 Tauri 读写、不得读取任务文件或 trace 文件，也不得新增普通用户验收面板。
 - 2026-07-03 调整：普通用户通过聊天输入 `/groups` 查看专业组进度，只基于当前 manifest.tasks 和最近 run trace.taskGraph / passPlans 汇总六个专业组的完成、active、carry、ready、失败数量和下一步任务，并提供 `/tasks` 草稿；该入口不得触发 Tauri 读写、不得读取任务文件或 trace 文件，也不得新增普通用户专业组面板。
@@ -3904,7 +3905,7 @@
 - 2026-07-03 调整：普通用户通过聊天输入 `/balance` 查看数值与难度口径，只基于当前 manifest.tasks、最近 run trace.taskGraph、trace artifacts 和 steps 汇总数值组任务、验收口径、`game/balance.json` 状态和最近数值步骤，并提供 `/read game/balance.json` 或 `/agent-resume 数值调整：...` 草稿；该入口不得触发 Tauri 读写、不得读取数值表、不得启动预览或继续 run，也不得新增普通用户数值面板。
 - 2026-07-03 调整：主窗口新增常用生成产物读取入口，只把入口 HTML、设计、数值、美术清单、音频清单和发布说明对应的 `/read` 草稿填入聊天输入框；聊天命令 `/artifacts` 只列出同一组固定读取命令并提供首个读取草稿，`/run-artifacts` 只列出最近 trace 里的产物读取命令并提供首个 `/read` 草稿，`/logs` 只列出固定日志读取命令；实际读取仍走聊天侧 `file.read` 权限流，不直接读本地文件。
 - 2026-07-03 调整：普通用户通过聊天输入 `/share` 准备试玩交付清单，只基于当前 manifest、授权项目路径、最近 run trace、preview 状态和 manifest.commandRuns 汇总原型通过状态、本地预览、本地试玩包、测试者说明和反馈收集方向，并提供 `/export`、`/exports`、`/trace`、`/review` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得导出试玩包、不得列出历史包、不得上传云端、不得生成公开分享链接，也不得新增普通用户分享面板。
- 2026-07-03 调整，2026-07-04 更新：普通用户通过聊天输入 `/next` 触发下一步建议入口，只基于主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要生成聊天建议，列出 `/goal`、`/spec`、`/mvp`、`/pitch`、`/demo`、`/rules`、`/tutorial`、`/mobile`、`/accessibility`、`/performance`、`/polish`、`/blockers`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/todo`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/test-plan`、`/feedback`、`/share`、`/listing`、`/run`、`/open-preview`、`/assets`、`/credits`、`/art`、`/audio`、`/publish`、`/artifacts`、`/run-artifacts`、`/passes`、`/run-files`、`/internals`、`/logs`、`/agent-resume ` 等安全命令草稿方向，并提供一个首选草稿；该命令不得直接执行 Tauri 读写、启动或打开预览、读取本地文件，也不得绕过原有命令确认和 `file.read` 权限流。
+- 2026-07-03 调整，2026-07-04 更新：普通用户通过聊天输入 `/next` 触发下一步建议入口，只基于主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要生成聊天建议，列出 `/goal`、`/spec`、`/mvp`、`/pitch`、`/demo`、`/rules`、`/tutorial`、`/mobile`、`/accessibility`、`/performance`、`/polish`、`/blockers`、`/ready`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/todo`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/test-plan`、`/feedback`、`/share`、`/listing`、`/run`、`/open-preview`、`/assets`、`/credits`、`/art`、`/audio`、`/publish`、`/artifacts`、`/run-artifacts`、`/passes`、`/run-files`、`/internals`、`/logs`、`/agent-resume ` 等安全命令草稿方向，并提供一个首选草稿；该命令不得直接执行 Tauri 读写、启动或打开预览、读取本地文件，也不得绕过原有命令确认和 `file.read` 权限流。
 - 2026-07-03 调整：普通用户通过聊天输入 `/publish` 生成发布准备清单，只基于主窗口当前已加载的 manifest、最近 run trace、预览状态、资产来源和最近命令摘要列出原型通过、预览、任务、资产、音频、包装说明和试玩包状态，并提供 `/run`、`/trace`、`/agent-resume ` 或 `/export` 草稿；该入口不得触发 Tauri 读写、不得启动或打开预览、不得读取文件，也不得新增普通用户发布面板。
 - 2026-07-03 调整：普通用户通过聊天输入 `/internals` 只列出 `.agent/manifest.json`、`.agent/run.latest.json`、`.agent/spec.md`、`.agent/findings.md`、`.agent/policy.json`、`.agent/project.index.json`、`.agent/agent.db` 和 `.agent/conversations/project.jsonl` 的 `/read` 草稿，并提供首个读取草稿；该入口不得直接读取内部文件、不得触发 Tauri 读写，也不得新增普通用户内部文件面板。
 - 2026-07-03 调整：普通用户通过聊天输入 `/passes` 只从当前已加载的最近 run trace artifacts 中筛选 `.agent/passes/` 轮次产物，列出 `/read` 草稿并提供首个读取草稿；该入口不得直接读取轮次文件、不得触发 Tauri 读写，也不得新增普通用户轮次面板。
@@ -114,6 +114,7 @@ game-project/
 - 聊天输入 `/polish` 可在普通聊天消息里查看试玩前打磨清单，不读取文件、不启动预览、不导出试玩包、不写项目，也不新增普通用户打磨面板。
 - 聊天输入 `/credits` 可在普通聊天消息里查看素材署名与来源口径，不刷新资产、不读取素材清单、不导出试玩包，也不新增普通用户署名面板。
 - 聊天输入 `/blockers` 可在普通聊天消息里查看当前阻塞项，不读取文件、不启动预览、不导出试玩包、不写项目，也不新增普通用户阻塞面板。
+- 聊天输入 `/ready` 可在普通聊天消息里查看试玩就绪度，不读取文件、不启动预览、不导出试玩包、不写项目，也不新增普通用户就绪度面板。
 - 聊天输入 `/criteria` 可在普通聊天消息里查看当前任务验收标准和预期产物，不读取任务文件或 trace 文件，也不新增普通用户验收面板。
 - 聊天输入 `/groups` 可在普通聊天消息里查看六个专业组进度和下一步任务，不读取任务文件或 trace 文件，也不新增普通用户专业组面板。
 - 聊天输入 `/balance` 可在普通聊天消息里查看数值与难度口径，不读取数值表、不启动预览、不直接继续 run，也不新增普通用户数值面板。
@@ -151,6 +152,7 @@ game-project/
 - `/polish` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview、最近自检和资产数量汇总试玩前打磨范围、推荐检查顺序、关联任务和最近打磨相关步骤，提供 `/agent-resume 打磨：...`、`/review`、`/feedback` 或 `/next` 草稿，不触发 Tauri 读写、不读取文件、不启动预览、不导出试玩包、不写项目、不新增普通用户打磨面板。
 - `/credits` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest.assets 汇总素材数量、上传 / 生成 / 画板来源分布、来源清单和交付前需要确认的授权 / 模型 / 画板资源口径，提供 `/assets` 草稿，不触发 Tauri 读写、不刷新资产、不读取素材清单、不导出试玩包、不新增普通用户署名面板。
 - `/blockers` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview、最近命令、ready / failed 任务、导出记录和资产概况汇总当前阻塞项，提供 `/run`、`/export`、`/todo`、`/review`、`/trace`、`/tasks`、`/logs`、`/art` 或 `/next` 草稿，不触发 Tauri 读写、不读取文件、不启动预览、不导出试玩包、不写项目、不新增普通用户阻塞面板。
+- `/ready` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview、最近自检、导出记录、ready / failed 任务和资产概况汇总试玩就绪度，提供 `/run`、`/export`、`/todo`、`/review`、`/trace`、`/tasks`、`/art`、`/share` 或 `/next` 草稿，不触发 Tauri 读写、不读取文件、不启动预览、不导出试玩包、不写项目、不新增普通用户就绪度面板。
 - `/criteria` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest.tasks 和最近 run trace.taskGraph 汇总 active、carry、ready、失败或待处理任务的验收条件和产物，提供 `/tasks` 草稿，不触发 Tauri 读写、不读取任务文件或 trace 文件、不新增普通用户验收面板。
 - `/groups` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest.tasks 和最近 run trace.taskGraph / passPlans 汇总六个专业组的完成、active、carry、ready、失败数量和下一步任务，提供 `/tasks` 草稿，不触发 Tauri 读写、不读取任务文件或 trace 文件、不新增普通用户专业组面板。
 - `/balance` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest.tasks、最近 run trace.taskGraph、trace artifacts 和 steps 汇总数值组任务、验收口径、`game/balance.json` 状态和最近数值步骤，提供 `/read game/balance.json` 或 `/agent-resume 数值调整：...` 草稿，不触发 Tauri 读写、不读取数值表、不启动预览或继续 run、不新增普通用户数值面板。
@@ -253,6 +255,7 @@ game-project/
 - 聊天输入 `/polish` 只使用主窗口当前已加载的 manifest、最近 run trace、preview、最近自检和资产数量，在聊天里列出试玩前打磨范围、推荐顺序、关联任务和最近打磨相关步骤；该命令不调用 Tauri 读写、不读取文件、不启动预览、不导出试玩包、不写项目、不新增普通用户打磨面板，真正继续打磨、查看评审或准备反馈仍由用户发送对应草稿并走原权限流。
 - 聊天输入 `/credits` 只使用主窗口当前已加载的 manifest.assets，在聊天里列出素材数量、来源分布、来源清单和交付前需要确认的授权 / 模型 / 画板资源口径；该命令不调用 Tauri 读写、不刷新资产、不读取素材清单、不导出试玩包、不新增普通用户署名面板，真正查看完整资产仍由用户发送 `/assets` 并走原资产读取流。
 - 聊天输入 `/blockers` 只使用主窗口当前已加载的 manifest、最近 run trace、preview、最近命令、ready / failed 任务、导出记录和资产概况，在聊天里列出当前阻塞项和首个处理草稿；该命令不调用 Tauri 读写、不读取文件、不启动预览、不导出试玩包、不写项目、不新增普通用户阻塞面板，真正处理阻塞仍由用户发送对应草稿并走原权限流。
+- 聊天输入 `/ready` 只使用主窗口当前已加载的 manifest、最近 run trace、preview、最近自检、导出记录、ready / failed 任务和资产概况，在聊天里列出试玩就绪度和首个处理草稿；该命令不调用 Tauri 读写、不读取文件、不启动预览、不导出试玩包、不写项目、不新增普通用户就绪度面板，真正启动预览、导出试玩包或交付仍由用户发送对应草稿并走原权限流。
 - 聊天输入 `/risks` 只使用主窗口当前已加载的 manifest、最近 run trace、预览状态、任务状态、资产来源和最近命令摘要，在聊天里列出当前项目风险，并提供首个风险处理草稿；该命令不调用 Tauri 读写、不读取文件、不启动或打开预览、不新增普通用户面板，用户必须再发送草稿并按原命令权限流继续。
 - 聊天输入 `/criteria` 只使用主窗口当前已加载的 manifest.tasks 和最近 run trace.taskGraph，在聊天里列出 active、carry、ready、失败或待处理任务的验收条件和预期产物，并提供 `/tasks` 草稿；该命令不调用 Tauri 读写、不读取任务文件或 trace 文件、不新增普通用户验收面板，真正查看完整任务仍由用户发送 `/tasks` 并走原读取流。
 - 聊天输入 `/groups` 只使用主窗口当前已加载的 manifest.tasks 和最近 run trace.taskGraph / passPlans，在聊天里列出六个专业组的完成、active、carry、ready、失败数量和下一步任务，并提供 `/tasks` 草稿；该命令不调用 Tauri 读写、不读取任务文件或 trace 文件、不新增普通用户专业组面板，真正查看完整任务仍由用户发送 `/tasks` 并走原读取流。
@@ -263,7 +266,7 @@ game-project/
 - 聊天输入 `/todo` 只使用主窗口当前已加载的 manifest 和最近 run trace，在聊天里列出下一轮优先小步，优先失败、active、carry 和 ready 任务，没有 trace 时回退当前 ready 任务，并提供 `/tasks`、`/review` 或 `/next` 草稿；该命令不调用 Tauri 读写、不读取任务文件、不启动 run、不修改项目、不新增普通用户小步面板，真正查看任务或继续修复仍由用户发送对应草稿并走原权限流。
 - 聊天输入 `/handoff` 只使用主窗口当前已加载的 manifest、最近 run trace、Agent 状态和已载入历史 run 批次，在聊天里生成项目交接摘要，并提供 `/next` 作为后续草稿；该命令不调用 Tauri 读写、不读取文件、不启动或打开预览、不新增普通用户面板，用户必须再发送草稿并按原命令权限流继续。
 - 聊天输入 `/runs` 只使用主窗口当前已加载的 latest trace 和已载入历史 run 批次，在聊天里列出 `/trace` 和 `/read .agent/runs/...` 读取草稿；该命令不调用 Tauri 读写、不滚动加载更多历史、不启动或打开预览、不新增普通用户面板，用户必须再发送草稿并按原命令权限流继续。
- 聊天输入 `/next` 只使用主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要，在聊天里给出下一步建议，列出 `/goal`、`/spec`、`/mvp`、`/pitch`、`/demo`、`/rules`、`/tutorial`、`/mobile`、`/accessibility`、`/performance`、`/polish`、`/blockers`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/todo`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/test-plan`、`/feedback`、`/share`、`/listing`、`/run`、`/export`、`/exports`、`/open-preview`、`/assets`、`/credits`、`/art`、`/audio`、`/publish`、`/artifacts`、`/run-artifacts`、`/passes`、`/run-files`、`/internals`、`/logs`、`/agent-resume ` 等安全命令草稿方向，并提供一个首选草稿；该命令不调用 Tauri 读写、不启动或打开预览、不读取文件，用户必须再发送草稿并按原命令权限流继续。
+- 聊天输入 `/next` 只使用主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要，在聊天里给出下一步建议，列出 `/goal`、`/spec`、`/mvp`、`/pitch`、`/demo`、`/rules`、`/tutorial`、`/mobile`、`/accessibility`、`/performance`、`/polish`、`/blockers`、`/ready`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/todo`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/test-plan`、`/feedback`、`/share`、`/listing`、`/run`、`/export`、`/exports`、`/open-preview`、`/assets`、`/credits`、`/art`、`/audio`、`/publish`、`/artifacts`、`/run-artifacts`、`/passes`、`/run-files`、`/internals`、`/logs`、`/agent-resume ` 等安全命令草稿方向，并提供一个首选草稿；该命令不调用 Tauri 读写、不启动或打开预览、不读取文件，用户必须再发送草稿并按原命令权限流继续。
 - 聊天输入 `/review` 只使用主窗口当前已加载的最近 run trace，在聊天里列出 Evaluator 通过 / 需返工状态、返工焦点、返工路线、下一步和最近评审步骤；该命令不调用 Tauri 读写、不读取 `.agent/findings.md`、不新增普通用户评审面板，真正读取评审记录仍由用户发送 `/read .agent/findings.md` 并走 `file.read` 权限流，需要返工时只填入 `/agent-resume ` 草稿。
 - 聊天输入 `/context` 只使用主窗口当前已加载的 manifest 和最近 run trace，在聊天里列出项目对话、短期记忆、长期记忆、项目黑板、Agent 对话、Agent 私有记忆、manifest、最近 trace 和最近 LLM 输入路径；该命令不调用 Tauri 读写、不读取上下文文件、不新增普通用户上下文面板，真正查看上下文仍由用户发送 `/read` 或 `/memory blackboard` 并走原权限流。
 - 聊天输入 `/timeline` 只使用主窗口当前已加载的 manifest.commandRuns 和最近 run trace，在聊天里列出最近命令、日志读取草稿、最近 Run 状态和最近 Agent 步骤；该命令不调用 Tauri 读写、不读取日志或 trace 文件、不新增普通用户时间线面板，真正查看日志、trace 或历史仍由用户发送对应草稿并走原权限流。