From 7fc7f930c687a7898b533e23f649c3f8ea056554 Mon Sep 17 00:00:00 2001 From: AIGameCreator App Date: Sat, 4 Jul 2026 14:36:13 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=E4=B8=8B=E4=B8=80=E8=BD=AE?= =?UTF-8?q?=E5=88=86=E5=B7=A5=E8=AE=A1=E5=88=92=E8=81=8A=E5=A4=A9=E5=85=A5?= =?UTF-8?q?=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 新增 /plan 下一轮分工计划摘要 补充 /next 与 /help 的计划入口覆盖 验证 /plan 不触发文件读取、运行、预览、导出或写入 同步 AI 游戏创作 App 技术方案和决策记录 --- apps/ai-game-creator-shell/src/App.tsx | 136 ++++++++++++++++++ .../tests/appSurface.test.ts | 106 ++++++++++++++ .../shared-memory/decision-log.md | 3 +- ...案】AI游戏创作智能体App实施计划-2026-06-24.md | 4 + 4 files changed, 248 insertions(+), 1 deletion(-) diff --git a/apps/ai-game-creator-shell/src/App.tsx b/apps/ai-game-creator-shell/src/App.tsx index 01180abc1..8ab4b3806 100644 --- a/apps/ai-game-creator-shell/src/App.tsx +++ b/apps/ai-game-creator-shell/src/App.tsx @@ -1913,6 +1913,7 @@ const chatCommandHelp = [ '/timeline：查看项目活动时间线', '/handoff：生成当前项目交接摘要', '/next：查看下一步建议', + '/plan：查看下一轮分工计划', '/todo：查看下一轮小步清单', '/publish：查看发布准备清单', '/listing：准备作品页文案清单', @@ -5039,6 +5040,123 @@ function summarizeProjectTodoList( }; } +function summarizeProjectNextRoundPlan( + nextManifest: GameCreationAppManifest, + trace: GameCreationAgentRunTrace | null, +) { + const manifestTasks = taskRowsFromManifest(nextManifest); + const traceTasks = trace?.taskGraph.tasks ?? []; + const taskSource = traceTasks.length > 0 ? traceTasks : manifestTasks; + const manifestTasksById = new Map( + manifestTasks.map((task) => [task.id, task]), + ); + const taskSourceById = new Map(taskSource.map((task) => [task.id, task])); + const selectedTasks: Array<{ + task: GameCreationAppTaskState; + marker: string; + }> = []; + const seenTaskIds = new Set(); + const addTask = (taskId: string, marker: string) => { + if (seenTaskIds.has(taskId)) { + return; + } + const task = taskSourceById.get(taskId) ?? manifestTasksById.get(taskId); + if (!task) { + return; + } + selectedTasks.push({ task, marker }); + seenTaskIds.add(task.id); + }; + + taskSource + .filter((task) => task.status === 'failed') + .forEach((task) => addTask(task.id, '失败')); + trace?.taskGraph.activeTaskIds.forEach((taskId) => + addTask(taskId, 'active'), + ); + trace?.taskGraph.carriedTaskIds.forEach((taskId) => + addTask(taskId, 'carry'), + ); + trace?.taskGraph.readyTaskIds.forEach((taskId) => addTask(taskId, 'ready')); + + if (selectedTasks.length === 0) { + selectGameCreationAppReadyTasks({ tasks: manifestTasks }).forEach((task) => + addTask(task.id, 'ready'), + ); + } + + if (selectedTasks.length === 0) { + taskSource + .filter((task) => task.status !== 'completed') + .slice(0, 6) + .forEach((task) => addTask(task.id, taskStatusLabels[task.status])); + } + + const groups: GameCreationAppAgentGroup[] = [ + 'design', + 'art', + 'code', + 'balance', + 'audio', + 'publishing', + ]; + const groupLines = groups.flatMap((group) => { + const groupTasks = selectedTasks.filter(({ task }) => task.group === group); + return groupTasks.slice(0, 2).map(({ task, marker }) => { + const acceptance = task.acceptanceCriteria[0] ?? '暂无'; + return `- ${taskGroupLabels[group]}：${marker} · ${task.role} ${task.title}(${task.id}) · 验收：${acceptance}`; + }); + }); + const selectedGroups = groups.filter((group) => + selectedTasks.some(({ task }) => task.group === group), + ); + const idleGroups = groups.filter((group) => !selectedGroups.includes(group)); + const firstTask = selectedTasks[0]?.task ?? null; + const blockedTrace = + trace?.lifecycleStatus === 'killed' || + trace?.status === 'failed' || + trace?.status === 'needs-revision' || + trace?.stopReason === 'max-passes-exhausted'; + const draftCommand = blockedTrace + ? '/review' + : firstTask + ? `/agent-resume 下一轮计划：${taskGroupLabels[firstTask.group]} / ${firstTask.role} ${firstTask.title}` + : '/next'; + const draftCommandLabel = blockedTrace + ? '查看评审' + : firstTask + ? '继续执行计划' + : '查看下一步'; + + return { + text: [ + '下一轮分工计划：', + `- 项目：${nextManifest.name}`, + trace ? `- Run：${trace.runId} · ${formatAgentRunStatus(trace)}` : null, + trace?.nextStep ? `- 编排焦点：${trace.nextStep}` : null, + selectedGroups.length > 0 + ? `- 协作顺序：${selectedGroups + .map((group) => taskGroupLabels[group]) + .join(' -> ')}` + : '- 协作顺序：暂无', + groupLines.length > 0 + ? `- 分工：\n${groupLines.join('\n')}` + : '- 分工：暂无待接手任务', + idleGroups.length > 0 + ? `- 空档组：${idleGroups + .map((group) => taskGroupLabels[group]) + .join('、')}` + : '- 空档组：暂无', + '- 边界：只整理下一轮分工；不读取任务文件；不启动 run；不修改项目', + `- 建议：${draftCommand}`, + ] + .filter(Boolean) + .join('\n'), + draftCommand, + draftCommandLabel, + }; +} + function summarizeProjectSpecSheet( nextManifest: GameCreationAppManifest, trace: GameCreationAgentRunTrace | null, @@ -6438,6 +6556,7 @@ function summarizeNextProjectActions( } addSuggestion('查看质量检查清单', '/qa'); addSuggestion('查看最近生成变更', '/changes'); + addSuggestion('查看下一轮分工计划', '/plan'); addSuggestion('查看下一轮小步清单', '/todo'); if (nextManifest.assets.length > 0) { @@ -10954,6 +11073,23 @@ export function App() { return; } + if (prompt === '/plan') { + if (!requireChatProjectForUserAction()) { + return; + } + const summary = summarizeProjectNextRoundPlan(manifest, agentRunTrace); + setMessages((current) => [ + ...current, + { + role: 'assistant', + text: summary.text, + draftCommand: summary.draftCommand, + draftCommandLabel: summary.draftCommandLabel, + }, + ]); + return; + } + if (prompt === '/todo') { if (!requireChatProjectForUserAction()) { return; diff --git a/apps/ai-game-creator-shell/tests/appSurface.test.ts b/apps/ai-game-creator-shell/tests/appSurface.test.ts index 5dd5d3c31..254fd43bd 100644 --- a/apps/ai-game-creator-shell/tests/appSurface.test.ts +++ b/apps/ai-game-creator-shell/tests/appSurface.test.ts @@ -5071,6 +5071,110 @@ describe('AI 游戏创作 App 界面边界', () => { ), ).toHaveLength(commandCountsBeforeTodo.exportList); + const commandCountsBeforePlan = { + 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('/plan'); + const planMessages = await screen.findAllByText(/下一轮分工计划：/); + const planMessage = planMessages[planMessages.length - 1]; + expect(planMessage.textContent).toContain('项目：未命名游戏原型'); + expect(planMessage.textContent).toContain( + 'Run：run-main-shortcut-trace · passed / done · 1/3 轮 · evaluator-passed', + ); + expect(planMessage.textContent).toContain('编排焦点：preview'); + expect(planMessage.textContent).toContain('协作顺序：美术组'); + expect(planMessage.textContent).toContain( + '美术组：ready · Asset 规划美术资产(art-asset-plan) · 验收：角色、场景、UI 和动画需求已映射到画板或本地资产', + ); + expect(planMessage.textContent).toContain( + '空档组：策划组、程序组、数值组、音乐组、运营组', + ); + expect(planMessage.textContent).toContain( + '边界：只整理下一轮分工；不读取任务文件；不启动 run；不修改项目', + ); + expect(planMessage.textContent).toContain( + '建议：/agent-resume 下一轮计划：美术组 / Asset 规划美术资产', + ); + const planMessageList = document.querySelector('.message-list'); + expect(planMessageList).not.toBeNull(); + const planDraftButtons = within( + planMessageList as HTMLElement, + ).getAllByRole('button', { name: '继续执行计划' }); + fireEvent.click(planDraftButtons[planDraftButtons.length - 1]); + expect(screen.getByLabelText('创作想法')).toHaveProperty( + 'value', + '/agent-resume 下一轮计划：美术组 / Asset 规划美术资产', + ); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'get_local_game_manifest', + ), + ).toHaveLength(commandCountsBeforePlan.manifestRead); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'read_local_project_file', + ), + ).toHaveLength(commandCountsBeforePlan.fileRead); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'list_local_project_files', + ), + ).toHaveLength(commandCountsBeforePlan.fileList); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'run_limited_local_command', + ), + ).toHaveLength(commandCountsBeforePlan.runLocal); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'start_local_game_preview', + ), + ).toHaveLength(commandCountsBeforePlan.startPreview); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'open_local_game_preview', + ), + ).toHaveLength(commandCountsBeforePlan.openPreview); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'export_local_project_package', + ), + ).toHaveLength(commandCountsBeforePlan.exportPackage); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'list_local_project_export_packages', + ), + ).toHaveLength(commandCountsBeforePlan.exportList); + expect( + invoke.mock.calls.filter(([command]) => command === 'control_agent_run'), + ).toHaveLength(commandCountsBeforePlan.controlAgentRun); + const runLocalCountBeforeNext = invoke.mock.calls.filter( ([command]) => command === 'run_limited_local_command', ).length; @@ -5102,6 +5206,7 @@ describe('AI 游戏创作 App 界面边界', () => { expect(screen.getByText(/查看专业组进度：\/groups/)).not.toBeNull(); expect(screen.getByText(/查看质量检查清单：\/qa/)).not.toBeNull(); expect(screen.getByText(/查看最近生成变更：\/changes/)).not.toBeNull(); + expect(screen.getByText(/查看下一轮分工计划：\/plan/)).not.toBeNull(); expect(screen.getByText(/查看下一轮小步清单：\/todo/)).not.toBeNull(); expect(screen.getByText(/查看当前阻塞项：\/blockers/)).not.toBeNull(); expect(screen.getByText(/查看试玩就绪度：\/ready/)).not.toBeNull(); @@ -13000,6 +13105,7 @@ describe('AI 游戏创作 App 界面边界', () => { expect(screen.getByText(/\/timeline：查看项目活动时间线/)).not.toBeNull(); expect(screen.getByText(/\/handoff：生成当前项目交接摘要/)).not.toBeNull(); expect(screen.getByText(/\/next：查看下一步建议/)).not.toBeNull(); + expect(screen.getByText(/\/plan：查看下一轮分工计划/)).not.toBeNull(); expect(screen.getByText(/\/todo：查看下一轮小步清单/)).not.toBeNull(); expect(screen.getByText(/\/publish：查看发布准备清单/)).not.toBeNull(); expect(screen.getByText(/\/listing：准备作品页文案清单/)).not.toBeNull(); diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md index fbda728bf..d5f90fb43 100644 --- a/docs/project-memory/shared-memory/decision-log.md +++ b/docs/project-memory/shared-memory/decision-log.md @@ -3893,6 +3893,7 @@ - 2026-07-03 调整：普通用户通过聊天输入 `/qa` 查看质量检查清单，只基于当前 manifest、最近 run trace、最近命令和 preview 状态汇总 Evaluator、任务、静态自检、试玩和产物状态，并提供 `/review`、`/tasks`、`/trace`、`/playtest`、`/publish` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取 trace 或日志文件、不得启动或打开预览，也不得新增普通用户 QA 面板。 - 2026-07-03 调整：普通用户通过聊天输入 `/changes` 查看最近生成变更，只基于当前 manifest、最近 run trace 的 artifacts / steps 和最近命令汇总可验产物、最近输出、当前资产和真实差异查看方向，并提供 `/read <首个可验产物>` 或 `/run-artifacts` 草稿；该入口不得触发 Tauri 读写、不得读取产物或日志文件、不得执行 checkpoint diff，也不得新增普通用户变更面板。 - 2026-07-04 调整：普通用户通过聊天输入 `/todo` 查看下一轮小步清单，只基于当前 manifest 和最近 run trace 汇总失败、active、carry、ready 或待处理任务，并提供 `/tasks`、`/review` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取任务文件、不得启动 run、不得修改项目，也不得新增普通用户小步面板。 +- 2026-07-04 调整：普通用户通过聊天输入 `/plan` 查看下一轮分工计划，只基于当前 manifest 和最近 run trace 汇总协作顺序、各专业组接手任务、空档组和首个继续执行草稿，并提供 `/agent-resume 下一轮计划：...`、`/review` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取任务文件、不得启动 run、不得修改项目，也不得新增普通用户计划面板。 - 2026-07-03 调整：普通用户通过聊天输入 `/review` 查看 Evaluator 评审状态，只基于主窗口当前已加载的最近 run trace 派生通过 / 需返工状态、返工焦点、返工路线和最近评审步骤，并提供 `/read .agent/findings.md` 或 `/agent-resume ` 草稿；该入口不得直接读取评审文件、不得触发 Tauri 读写，也不得新增普通用户评审面板。 - 2026-07-03 调整：普通用户通过聊天输入 `/context` 查看生成上下文来源，只基于当前 manifest 和最近 run trace 列出项目对话、短期记忆、长期记忆、项目黑板、Agent 对话、Agent 私有记忆、manifest、最近 trace 和最近 LLM 输入路径，并提供 `/read` 或 `/memory blackboard` 草稿；该入口不得触发 Tauri 读写、不得读取上下文文件，也不得新增普通用户上下文面板。 - 2026-07-03 调整：普通用户通过聊天输入 `/timeline` 查看项目活动时间线，只基于当前 manifest.commandRuns 和最近 run trace 汇总最近命令、日志读取草稿和最近 Agent 步骤，并提供 `/read`、`/trace` 或 `/history` 草稿；该入口不得触发 Tauri 读写、不得读取日志或 trace 文件，也不得新增普通用户时间线面板。 @@ -3925,7 +3926,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`、`/compatibility`、`/accessibility`、`/localization`、`/performance`、`/polish`、`/blockers`、`/ready`、`/evidence`、`/deps`、`/revise`、`/privacy`、`/audience`、`/invite`、`/bug-report`、`/survey`、`/cover`、`/screenshots`、`/trailer`、`/faq`、`/post`、`/store`、`/media-kit`、`/release-notes`、`/known-issues`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/todo`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/test-plan`、`/feedback`、`/retention`、`/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`、`/compatibility`、`/accessibility`、`/localization`、`/performance`、`/polish`、`/blockers`、`/ready`、`/evidence`、`/deps`、`/revise`、`/privacy`、`/audience`、`/invite`、`/bug-report`、`/survey`、`/cover`、`/screenshots`、`/trailer`、`/faq`、`/post`、`/store`、`/media-kit`、`/release-notes`、`/known-issues`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/plan`、`/todo`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/test-plan`、`/feedback`、`/retention`、`/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 读写，也不得新增普通用户轮次面板。 diff --git a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md index e59f40f97..ad4e661d9 100644 --- a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md +++ b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md @@ -100,6 +100,7 @@ game-project/ ## v1 验收 - 用户能创建本地 Web 游戏项目。 +- 聊天输入 `/plan` 可在普通聊天消息里查看下一轮分工计划，不读取任务文件、不启动 run、不修改项目，也不新增普通用户计划面板。 - 用户侧看到当前工作区项目名 / 路径、最近 run、预览状态、任务完成数 / ready 数、资产数量 / 来源分布、最近命令摘要、聊天框、上传入口、Agent 状态列表和单 Agent 对话；聊天输入 `/brief` 可在普通聊天消息里生成当前项目简报并提供 `/next` 草稿，不新增普通用户面板；聊天输入 `/risks` 可在普通聊天消息里查看当前项目风险并提供首个风险处理草稿，不新增普通用户面板；聊天输入 `/review` 可在普通聊天消息里查看 Evaluator 评审、返工焦点和返工路线并提供读取评审记录或继续修复草稿，不新增普通用户面板；聊天输入 `/context` 可在普通聊天消息里查看生成上下文来源并提供读取首个上下文或查看黑板草稿，不新增上下文面板；聊天输入 `/timeline` 可在普通聊天消息里查看项目活动时间线并提供最近日志、trace 或历史草稿，不新增时间线面板；聊天输入 `/playtest` 可在普通聊天消息里查看最近 run 是否可试玩、当前预览状态和 Playtest 任务状态并提供启动或打开预览草稿，不新增普通用户试玩面板；聊天输入 `/handoff` 可在普通聊天消息里生成当前项目交接摘要并提供 `/next` 草稿，不新增普通用户面板；聊天输入 `/runs` 可在普通聊天消息里列出已加载 Run 历史读取命令，不新增普通用户面板；聊天输入 `/run-files` 可在普通聊天消息里列出 Agent 运行辅助文件读取命令，不新增普通用户面板；聊天输入 `/internals` 可在普通聊天消息里列出项目内部真相源读取命令，不新增内部文件面板；聊天输入 `/art` 可基于当前 manifest 盘点美术素材并提供生成或读取草稿，不新增美术面板；聊天输入 `/audio` 可基于当前 manifest 盘点音频素材并提供登记或读取草稿，不新增音频生成系统；聊天输入 `/publish` 可基于当前 manifest 和最近 run 生成发布准备清单并提供运行、trace、继续或导出草稿，不新增发布面板；聊天输入 `/listing` 可基于当前 manifest 和最近 run 汇总作品页标题、卖点、标签口径、封面素材和发布说明状态并提供读取发布说明或发布准备草稿，不新增作品页面板；聊天输入 `/cover` 可基于当前 manifest 和最近 run 准备封面与缩略图检查并提供运行、美术或作品页草稿，不新增封面面板；聊天输入 `/screenshots` 可基于当前 manifest 和最近 run 准备宣传截图清单并提供运行或作品页草稿，不新增截图面板；聊天输入 `/trailer` 可基于当前 manifest 和最近 run 准备试玩短视频脚本并提供运行或交付草稿，不新增录屏面板；聊天输入 `/faq` 可基于当前 manifest 和最近 run 准备试玩常见问答并提供运行或交付草稿，不新增 FAQ 面板；聊天输入 `/post` 可基于当前 manifest 和最近 run 准备社区发布文案并提供运行或上架草稿，不新增社区发布面板；聊天输入 `/store` 可基于当前 manifest 和最近 run 准备上架资料清单并提供运行或作品页草稿，不新增上架面板；聊天输入 `/media-kit` 可基于当前 manifest 和最近 run 准备媒体资料包清单并提供运行、截图或发布说明草稿，不新增媒体包面板；聊天输入 `/release-notes` 可基于当前 manifest 和最近 run 准备试玩更新说明并提供运行、资料包或发布说明草稿，不新增更新说明面板；聊天输入 `/known-issues` 可基于当前 manifest 和最近 run 准备已知问题清单并提供运行、评审或交付草稿，不新增已知问题面板；聊天输入 `/export` 确认后把当前可试玩原型导出为本地试玩 ZIP，聊天输入 `/exports` 可只读列出已导出的本地试玩包；Agent 状态列表和单 Agent 对话在 `/llm-status` 后显示该 agent 当前 LLM provider / 模型 / 流式 / API Key 读取状态，但不显示密钥本体；最近项目资产入口显示本地路径、kind、mediaType 和来源类型，并可一键填入 `/read` 草稿，开发环境通过独立窗口查看任务拆分、专业组细节、产物、文件面板、嵌入预览以及 `.agent/logs/command.log` / `preview.log` / `agent.log`。 - 聊天输入 `/llm-routes` 会触发同一只读 LLM 配置检查，在普通聊天消息里列出全局 LLM 和每个 agent resolved 后的 provider 路由、模型、API 类型、流式开关、API Key 是否已读取、单独路由数量和缺口数量；该命令不请求上游、不显示 API Key 本体、不写本地项目、不新增普通用户配置面板，缺口处理只提供 `/config` 草稿。 - 聊天输入 `/goal` 可在普通聊天消息里查看创作目标来源，不读取 spec、上下文或 trace 文件，也不新增普通用户目标面板。 @@ -187,6 +188,7 @@ game-project/ - `/qa` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、最近命令和 preview 状态汇总 Evaluator、任务、静态自检、试玩和产物状态，提供 `/review`、`/tasks`、`/trace`、`/playtest`、`/publish` 或 `/next` 草稿，不触发 Tauri 读写、不读取 trace 或日志文件、不启动或打开预览、不新增普通用户 QA 面板。 - `/changes` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace 的 artifacts / steps 和最近命令汇总可验产物、最近输出、当前资产和真实差异查看方向，提供 `/read <首个可验产物>` 或 `/run-artifacts` 草稿，不触发 Tauri 读写、不读取产物或日志文件、不执行 checkpoint diff、不新增普通用户变更面板。 - `/todo` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest 和最近 run trace 汇总失败、active、carry、ready 或待处理任务的下一轮小步，提供 `/tasks`、`/review` 或 `/next` 草稿，不触发 Tauri 读写、不读取任务文件、不启动 run、不修改项目、不新增普通用户小步面板。 +- `/plan` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest 和最近 run trace 汇总下一轮协作顺序、各专业组接手任务、空档组和首个继续执行草稿，提供 `/agent-resume 下一轮计划：...`、`/review` 或 `/next` 草稿，不触发 Tauri 读写、不读取任务文件、不启动 run、不修改项目、不新增普通用户计划面板。 - `/review` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 run trace 汇总 Evaluator 状态、返工焦点、返工路线和最近评审步骤，提供 `/read .agent/findings.md` 或 `/agent-resume ` 草稿，不直接读取评审文件、不触发 Tauri 读写或新增普通用户面板。 - `/context` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest 和最近 run trace 列出项目对话、短期 / 长期记忆、黑板、Agent 对话、Agent 私有记忆、manifest、最近 trace 和最近 LLM 输入路径，提供 `/read` 或 `/memory blackboard` 草稿，不触发 Tauri 读写、不读取上下文文件或新增普通用户面板。 - `/timeline` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest.commandRuns 和最近 run trace 汇总最近命令、日志读取草稿和最近 Agent 步骤，提供 `/read`、`/trace` 或 `/history` 草稿，不触发 Tauri 读写、不读取日志或 trace 文件、不新增普通用户时间线面板。 @@ -308,9 +310,11 @@ game-project/ - 聊天输入 `/qa` 只使用主窗口当前已加载的 manifest、最近 run trace、最近命令和 preview 状态，在聊天里列出 Evaluator、任务、静态自检、试玩、最近试玩步骤和产物数量，并提供 `/review`、`/tasks`、`/trace`、`/playtest`、`/publish` 或 `/next` 草稿；该命令不调用 Tauri 读写、不读取 trace 或日志文件、不启动或打开预览、不新增普通用户 QA 面板，真正运行自检或打开预览仍由用户发送对应草稿并走原确认流。 - 聊天输入 `/changes` 只使用主窗口当前已加载的 manifest、最近 run trace 的 artifacts / steps 和最近命令，在聊天里列出最近 run、可验产物数量、关键产物、最近输出、当前资产、全部产物读取入口、trace 入口和真实 diff 查看方向，并提供 `/read <首个可验产物>` 或 `/run-artifacts` 草稿；该命令不调用 Tauri 读写、不读取产物或日志文件、不执行 checkpoint diff、不新增普通用户变更面板，真正读取产物或对比 checkpoint 仍由用户发送对应草稿并走原权限流。 - 聊天输入 `/todo` 只使用主窗口当前已加载的 manifest 和最近 run trace，在聊天里列出下一轮优先小步，优先失败、active、carry 和 ready 任务，没有 trace 时回退当前 ready 任务，并提供 `/tasks`、`/review` 或 `/next` 草稿；该命令不调用 Tauri 读写、不读取任务文件、不启动 run、不修改项目、不新增普通用户小步面板，真正查看任务或继续修复仍由用户发送对应草稿并走原权限流。 +- 聊天输入 `/plan` 只使用主窗口当前已加载的 manifest 和最近 run trace，在聊天里列出下一轮协作顺序、各专业组接手任务、空档组和继续执行草稿；该命令不调用 Tauri 读写、不读取任务文件、不启动 run、不修改项目、不新增普通用户计划面板，真正继续执行仍由用户发送 `/agent-resume 下一轮计划：...` 并走原确认流。 - 聊天输入 `/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`、`/compatibility`、`/accessibility`、`/localization`、`/performance`、`/polish`、`/blockers`、`/ready`、`/evidence`、`/llm-routes`、`/deps`、`/revise`、`/privacy`、`/audience`、`/invite`、`/bug-report`、`/survey`、`/cover`、`/screenshots`、`/trailer`、`/faq`、`/post`、`/store`、`/media-kit`、`/release-notes`、`/known-issues`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/todo`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/test-plan`、`/feedback`、`/retention`、`/share`、`/listing`、`/run`、`/export`、`/exports`、`/open-preview`、`/assets`、`/credits`、`/art`、`/audio`、`/publish`、`/artifacts`、`/run-artifacts`、`/passes`、`/run-files`、`/internals`、`/logs`、`/agent-resume ` 等安全命令草稿方向，并提供一个首选草稿；该命令不调用 Tauri 读写、不启动或打开预览、不读取文件，用户必须再发送草稿并按原命令权限流继续。 +- `/next` 的安全命令草稿方向同步包含 `/plan`，用于从下一步建议进入下一轮分工摘要；该补充不改变 `/next` 的只读边界。 - 聊天输入 `/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 或历史仍由用户发送对应草稿并走原权限流。