GenarrativeAI/Genarrative
10
0
Fork 0
Code Issues 21 Pull Requests 6 Actions Packages Projects 1 Releases Wiki Activity

补充试玩前打磨聊天入口

Browse Source 
新增 /polish 试玩前打磨清单摘要

补充 /next 与 /help 的打磨入口覆盖

验证 /polish 不触发文件读取、运行、预览、导出或 agent 控制

同步 AI 游戏创作 App 技术方案和决策记录
This commit is contained in:
AIGameCreator App
2026-07-04 11:19:37 +08:00
parent 3a96f0c7ae
commit 29110a3907
4 changed files with 257 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
apps/ai-game-creator-shell/src/App.tsx
+134
View File
@@ -1878,6 +1878,7 @@ const chatCommandHelp = [
'/mobile：查看移动试玩检查',
'/accessibility：查看可读性与无障碍检查',
'/performance：查看性能与加载检查',
'/polish：查看试玩前打磨清单',
'/risks：查看当前项目风险',
'/criteria：查看当前任务验收标准',
'/groups：查看专业组进度',
@@ -2862,6 +2863,121 @@ function summarizeProjectPerformanceCheck(
};
}
function summarizeProjectPolishChecklist(
nextManifest: GameCreationAppManifest,
trace: GameCreationAgentRunTrace | 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 goal =
nextManifest.goal?.trim() ||
trace?.goal?.trim() ||
trace?.taskGraph.goal?.trim() ||
'暂无';
const visualAssetCount =
nextManifest.assets.filter(isProjectVisualAsset).length;
const audioAssetCount = nextManifest.assets.filter(isProjectAudioAsset).length;
const latestSmokeRun =
[...(nextManifest.commandRuns ?? [])]
.reverse()
.find((run) => run.commandId === 'game.static_smoke') ?? null;
const smokeSummary = latestSmokeRun
? latestSmokeRun.status === 'completed'
? '已通过'
: '失败'
: '暂无';
const manifestTasks = taskRowsFromManifest(nextManifest);
const traceTasks = trace?.taskGraph.tasks ?? [];
const tasks = manifestTasks.map(
(task) => traceTasks.find((traceTask) => traceTask.id === task.id) ?? task,
);
const polishTaskIds = [
'art-polish',
'audio-asset-plan',
'code-prototype',
'quality-review',
'preview-readiness',
'preview-playtest',
'publish-package',
];
const taskLines = polishTaskIds
.map((taskId) => tasks.find((task) => task.id === taskId))
.filter((task): task is NonNullable<typeof task> => Boolean(task))
.map(
(task) =>
`- ${task.id}：${taskGroupLabels[task.group]} / ${task.role} ${task.title} · ${taskStatusLabels[task.status]}`,
);
const latestPolishStep =
trace?.steps
.filter(
(step) =>
(step.taskId && polishTaskIds.includes(step.taskId)) ||
step.phase === 'evaluation' ||
step.phase === 'playtest' ||
step.group === 'art' ||
step.group === 'code' ||
step.group === 'publishing' ||
step.toolCalls.some(
(toolCall) =>
toolCall.toolId === 'agent.evaluate' ||
toolCall.toolId === 'game.static_smoke' ||
toolCall.toolId.startsWith('preview.'),
),
)
.slice(-1)[0] ?? null;
let draftCommand =
'/agent-resume 打磨：补齐新手引导、触屏操作、可读性、性能、素材署名和试玩反馈';
let draftCommandLabel = '补充打磨';
if (!trace) {
draftCommand = '/next';
draftCommandLabel = '查看下一步';
} else if (!tracePassed) {
draftCommand = '/review';
draftCommandLabel = '查看评审';
} else if (previewRunning) {
draftCommand = '/feedback';
draftCommandLabel = '准备反馈';
}
return {
text: [
'试玩前打磨：',
`- 项目：${nextManifest.name}`,
`- 目标：${goal}`,
`- 当前证据：${
tracePassed
? `最近 run 已通过${trace?.runId ? ` ${trace.runId}` : ''}`
: trace
? `最近 run 未通过 ${trace.status} / ${trace.stopReason}`
: '暂无最近 run'
}；预览 ${previewSummary}；自检 ${smokeSummary}；资产 ${
nextManifest.assets.length
} 个（美术 ${visualAssetCount} / 音频 ${audioAssetCount}）`,
'- 打磨范围：新手引导；移动试玩；可读性与无障碍；性能与加载；美术 / 音频素材；试玩反馈',
'- 推荐顺序：/tutorial -> /mobile -> /accessibility -> /performance -> /credits -> /feedback',
taskLines.length > 0
? `- 关联任务：\n${taskLines.join('\n')}`
: '- 关联任务：暂无',
`- 最近打磨相关步骤：${
latestPolishStep
? `${latestPolishStep.agent} #${latestPolishStep.pass} · ${latestPolishStep.status} · ${latestPolishStep.summary}`
: '暂无'
}`,
'- 边界：只整理试玩前打磨清单；不读取文件；不启动预览；不导出试玩包；不写项目',
`- 建议：${draftCommand}`,
].join('\n'),
draftCommand,
draftCommandLabel,
};
}
function summarizeProjectRisks(
nextManifest: GameCreationAppManifest,
trace: GameCreationAgentRunTrace | null,
@@ -4380,6 +4496,7 @@ function summarizeNextProjectActions(
addSuggestion('查看移动试玩检查', '/mobile');
addSuggestion('查看可读性与无障碍检查', '/accessibility');
addSuggestion('查看性能与加载检查', '/performance');
addSuggestion('查看试玩前打磨清单', '/polish');
addSuggestion('查看数值与难度口径', '/balance');
const readyTasks = selectGameCreationAppReadyTasks({
@@ -8242,6 +8359,23 @@ export function App() {
return;
}
if (prompt === '/polish') {
if (!requireChatProjectForUserAction()) {
return;
}
const summary = summarizeProjectPolishChecklist(manifest, agentRunTrace);
setMessages((current) => [
...current,
{
role: 'assistant',
text: summary.text,
draftCommand: summary.draftCommand,
draftCommandLabel: summary.draftCommandLabel,
},
]);
return;
}
if (prompt === '/risks') {
if (!requireChatProjectForUserAction()) {
return;
apps/ai-game-creator-shell/tests/appSurface.test.ts
+117
View File
@@ -3200,6 +3200,121 @@ describe('AI 游戏创作 App 界面边界', () => {
invoke.mock.calls.filter(([command]) => command === 'control_agent_run'),
).toHaveLength(commandCountsBeforePerformance.controlAgentRun);
const commandCountsBeforePolish = {
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('/polish');
const polishMessages = await screen.findAllByText(/试玩前打磨：/);
const polishMessage = polishMessages[polishMessages.length - 1];
expect(polishMessage.textContent).toContain('项目：未命名游戏原型');
expect(polishMessage.textContent).toContain('目标：做一个厨房弹幕游戏');
expect(polishMessage.textContent).toContain(
'当前证据：最近 run 已通过 run-main-shortcut-trace；预览 未启动；自检 已通过；资产 2 个（美术 1 / 音频 0）',
);
expect(polishMessage.textContent).toContain(
'打磨范围：新手引导；移动试玩；可读性与无障碍；性能与加载；美术 / 音频素材；试玩反馈',
);
expect(polishMessage.textContent).toContain(
'推荐顺序：/tutorial -> /mobile -> /accessibility -> /performance -> /credits -> /feedback',
);
expect(polishMessage.textContent).toContain(
'art-polish：美术组 / Polish 检查美术可用性 · 待处理',
);
expect(polishMessage.textContent).toContain(
'quality-review：程序组 / Review 执行质量评审 · 待处理',
);
expect(polishMessage.textContent).toContain(
'publish-package：运营组 / Publish 整理发布包装 · 待处理',
);
expect(polishMessage.textContent).toContain(
'最近打磨相关步骤：Evaluator #1 · passed · 质量评审通过',
);
expect(polishMessage.textContent).toContain(
'边界：只整理试玩前打磨清单；不读取文件；不启动预览；不导出试玩包；不写项目',
);
expect(polishMessage.textContent).toContain(
'建议：/agent-resume 打磨：补齐新手引导、触屏操作、可读性、性能、素材署名和试玩反馈',
);
const polishMessageList = document.querySelector('.message-list');
expect(polishMessageList).not.toBeNull();
const polishDraftButtons = within(
polishMessageList as HTMLElement,
).getAllByRole('button', { name: '补充打磨' });
fireEvent.click(polishDraftButtons[polishDraftButtons.length - 1]);
expect(screen.getByLabelText('创作想法')).toHaveProperty(
'value',
'/agent-resume 打磨：补齐新手引导、触屏操作、可读性、性能、素材署名和试玩反馈',
);
expect(
invoke.mock.calls.filter(
([command]) => command === 'get_local_game_manifest',
),
).toHaveLength(commandCountsBeforePolish.manifestRead);
expect(
invoke.mock.calls.filter(
([command]) => command === 'read_local_project_file',
),
).toHaveLength(commandCountsBeforePolish.fileRead);
expect(
invoke.mock.calls.filter(
([command]) => command === 'list_local_project_files',
),
).toHaveLength(commandCountsBeforePolish.fileList);
expect(
invoke.mock.calls.filter(
([command]) => command === 'run_limited_local_command',
),
).toHaveLength(commandCountsBeforePolish.runLocal);
expect(
invoke.mock.calls.filter(
([command]) => command === 'start_local_game_preview',
),
).toHaveLength(commandCountsBeforePolish.startPreview);
expect(
invoke.mock.calls.filter(
([command]) => command === 'open_local_game_preview',
),
).toHaveLength(commandCountsBeforePolish.openPreview);
expect(
invoke.mock.calls.filter(
([command]) => command === 'export_local_project_package',
),
).toHaveLength(commandCountsBeforePolish.exportPackage);
expect(
invoke.mock.calls.filter(
([command]) => command === 'list_local_project_export_packages',
),
).toHaveLength(commandCountsBeforePolish.exportList);
expect(
invoke.mock.calls.filter(([command]) => command === 'control_agent_run'),
).toHaveLength(commandCountsBeforePolish.controlAgentRun);
const commandCountsBeforeCredits = {
manifestRead: invoke.mock.calls.filter(
([command]) => command === 'get_local_game_manifest',
@@ -4070,6 +4185,7 @@ describe('AI 游戏创作 App 界面边界', () => {
expect(
screen.getByText(/查看性能与加载检查：\/performance/),
).not.toBeNull();
expect(screen.getByText(/查看试玩前打磨清单：\/polish/)).not.toBeNull();
expect(screen.getByText(/查看数值与难度口径：\/balance/)).not.toBeNull();
expect(screen.getByText(/查看 .* 个 ready 任务：\/tasks/)).not.toBeNull();
expect(screen.getByText(/查看当前任务验收标准：\/criteria/)).not.toBeNull();
@@ -10375,6 +10491,7 @@ describe('AI 游戏创作 App 界面边界', () => {
expect(
screen.getByText(/\/performance：查看性能与加载检查/),
).not.toBeNull();
expect(screen.getByText(/\/polish：查看试玩前打磨清单/)).not.toBeNull();
expect(screen.getByText(/\/risks：查看当前项目风险/)).not.toBeNull();
expect(screen.getByText(/\/criteria：查看当前任务验收标准/)).not.toBeNull();
expect(screen.getByText(/\/groups：查看专业组进度/)).not.toBeNull();
docs/project-memory/shared-memory/decision-log.md
+2 -1
View File
@@ -3876,6 +3876,7 @@
- 2026-07-03 调整：普通用户通过聊天输入 `/mobile` 查看移动试玩检查，只基于当前 manifest、最近 run trace、preview 和任务状态汇总移动试玩目标、键盘 / 触屏输入口径、原型证据、移动检查项、关联任务和最近移动相关步骤，并提供 `/rules`、`/review`、`/agent-resume 移动试玩：...`、`/open-preview` 或 `/run` 草稿；该入口不得触发 Tauri 读写、不得读取代码文件、不得启动或打开预览、不得直接继续 run，也不得新增普通用户移动适配面板。
- 2026-07-04 调整：普通用户通过聊天输入 `/accessibility` 查看可读性与无障碍检查，只基于当前 manifest、最近 run trace、preview 和任务状态汇总文字可读、颜色对比、按钮 / 状态命名、键盘等价、可见焦点、非颜色唯一反馈和静音可玩检查，并提供 `/rules`、`/review`、`/agent-resume 可读性与无障碍：...`、`/open-preview` 或 `/run` 草稿；该入口不得触发 Tauri 读写、不得读取代码或 trace 文件、不得启动或打开预览、不得直接继续 run，也不得新增普通用户无障碍面板。
- 2026-07-04 调整：普通用户通过聊天输入 `/performance` 查看性能与加载检查，只基于当前 manifest、最近 run trace、preview、资产数量和 trace artifact 摘要汇总入口自包含、首屏不空白、素材体积、主循环稳定、无远程依赖和预览启动检查，并提供 `/run-artifacts`、`/review`、`/open-preview`、`/run` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取产物或日志文件、不得启动或打开预览、不得直接继续 run，也不得新增普通用户性能面板。
- 2026-07-04 调整：普通用户通过聊天输入 `/polish` 查看试玩前打磨清单，只基于当前 manifest、最近 run trace、preview、最近自检和资产数量汇总试玩前打磨范围、推荐检查顺序、关联任务和最近打磨相关步骤，并提供 `/agent-resume 打磨：...`、`/review`、`/feedback` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取文件、不得启动预览、不得导出试玩包、不得写项目，也不得新增普通用户打磨面板。
- 2026-07-03 调整：普通用户通过聊天输入 `/credits` 查看素材署名与来源，只基于当前 manifest.assets 汇总素材数量、上传 / 生成 / 画板来源分布、来源清单和交付前需要确认的授权 / 模型 / 画板资源口径，并提供 `/assets` 草稿；该入口不得触发 Tauri 读写、不得刷新资产、不得读取素材清单、不得导出试玩包，也不得新增普通用户署名面板。
- 2026-07-03 调整：普通用户通过聊天输入 `/risks` 查看当前项目风险，只基于主窗口当前已加载的 manifest、最近 run trace、预览状态、任务状态、资产来源和最近命令派生风险摘要，并提供首个风险处理草稿；该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览，也不得新增普通用户面板。
- 2026-07-03 调整：普通用户通过聊天输入 `/criteria` 查看当前任务验收标准，只基于当前 manifest.tasks 和最近 run trace.taskGraph 汇总 active、carry、ready、失败或待处理任务的验收条件和产物，并提供 `/tasks` 草稿；该入口不得触发 Tauri 读写、不得读取任务文件或 trace 文件，也不得新增普通用户验收面板。
@@ -3902,7 +3903,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`、`/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`、`/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 读写，也不得新增普通用户轮次面板。
docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
+4 -1
View File
@@ -111,6 +111,7 @@ game-project/
- 聊天输入 `/mobile` 可在普通聊天消息里查看移动试玩检查，不读取代码文件、不启动或打开预览、不直接继续 run，也不新增普通用户移动适配面板。
- 聊天输入 `/accessibility` 可在普通聊天消息里查看可读性与无障碍检查，不读取代码或 trace 文件、不启动或打开预览、不直接继续 run，也不新增普通用户无障碍面板。
- 聊天输入 `/performance` 可在普通聊天消息里查看性能与加载检查，不读取产物或日志文件、不启动或打开预览、不直接继续 run，也不新增普通用户性能面板。
- 聊天输入 `/polish` 可在普通聊天消息里查看试玩前打磨清单，不读取文件、不启动预览、不导出试玩包、不写项目，也不新增普通用户打磨面板。
- 聊天输入 `/credits` 可在普通聊天消息里查看素材署名与来源口径，不刷新资产、不读取素材清单、不导出试玩包，也不新增普通用户署名面板。
- 聊天输入 `/criteria` 可在普通聊天消息里查看当前任务验收标准和预期产物，不读取任务文件或 trace 文件，也不新增普通用户验收面板。
- 聊天输入 `/groups` 可在普通聊天消息里查看六个专业组进度和下一步任务，不读取任务文件或 trace 文件，也不新增普通用户专业组面板。
@@ -146,6 +147,7 @@ game-project/
- `/mobile` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview 和任务状态汇总移动试玩目标、键盘 / 触屏输入口径、原型证据、移动检查项、关联任务和最近移动相关步骤，提供 `/rules`、`/review`、`/agent-resume 移动试玩：...`、`/open-preview` 或 `/run` 草稿，不触发 Tauri 读写、不读取代码文件、不启动或打开预览、不直接继续 run、不新增普通用户移动适配面板。
- `/accessibility` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview 和任务状态汇总文字可读、颜色对比、按钮 / 状态命名、键盘等价、可见焦点、非颜色唯一反馈和静音可玩检查项，提供 `/rules`、`/review`、`/agent-resume 可读性与无障碍：...`、`/open-preview` 或 `/run` 草稿，不触发 Tauri 读写、不读取代码或 trace 文件、不启动或打开预览、不直接继续 run、不新增普通用户无障碍面板。
- `/performance` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview、资产数量和 trace artifact 摘要汇总入口自包含、首屏不空白、素材体积、主循环稳定、无远程依赖和预览启动检查，提供 `/run-artifacts`、`/review`、`/open-preview`、`/run` 或 `/next` 草稿，不触发 Tauri 读写、不读取产物或日志文件、不启动或打开预览、不直接继续 run、不新增普通用户性能面板。
- `/polish` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview、最近自检和资产数量汇总试玩前打磨范围、推荐检查顺序、关联任务和最近打磨相关步骤，提供 `/agent-resume 打磨：...`、`/review`、`/feedback` 或 `/next` 草稿，不触发 Tauri 读写、不读取文件、不启动预览、不导出试玩包、不写项目、不新增普通用户打磨面板。
- `/credits` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest.assets 汇总素材数量、上传 / 生成 / 画板来源分布、来源清单和交付前需要确认的授权 / 模型 / 画板资源口径，提供 `/assets` 草稿，不触发 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 文件、不新增普通用户专业组面板。
@@ -246,6 +248,7 @@ game-project/
- 聊天输入 `/mobile` 只使用主窗口当前已加载的 manifest、最近 run trace、preview 和任务状态，在聊天里列出移动试玩目标、键盘 / 触屏输入口径、原型证据、移动检查项、关联任务和最近移动相关步骤；该命令不调用 Tauri 读写、不读取代码文件、不启动或打开预览、不直接继续 run、不新增普通用户移动适配面板，真正补齐移动试玩、运行或打开预览仍由用户发送对应草稿并走原权限流。
- 聊天输入 `/accessibility` 只使用主窗口当前已加载的 manifest、最近 run trace、preview 和任务状态，在聊天里列出可读性与无障碍检查范围、原型证据、关联任务和最近无障碍相关步骤；该命令不调用 Tauri 读写、不读取代码或 trace 文件、不启动或打开预览、不直接继续 run、不新增普通用户无障碍面板，真正补齐可读性与无障碍事项仍由用户发送对应草稿并走原权限流。
- 聊天输入 `/performance` 只使用主窗口当前已加载的 manifest、最近 run trace、preview、资产数量和 trace artifact 摘要，在聊天里列出性能与加载检查范围、关键产物、关联任务和最近性能相关步骤；该命令不调用 Tauri 读写、不读取产物或日志文件、不启动或打开预览、不直接继续 run、不新增普通用户性能面板，真正查看产物或启动试玩仍由用户发送对应草稿并走原权限流。
- 聊天输入 `/polish` 只使用主窗口当前已加载的 manifest、最近 run trace、preview、最近自检和资产数量，在聊天里列出试玩前打磨范围、推荐顺序、关联任务和最近打磨相关步骤；该命令不调用 Tauri 读写、不读取文件、不启动预览、不导出试玩包、不写项目、不新增普通用户打磨面板，真正继续打磨、查看评审或准备反馈仍由用户发送对应草稿并走原权限流。
- 聊天输入 `/credits` 只使用主窗口当前已加载的 manifest.assets，在聊天里列出素材数量、来源分布、来源清单和交付前需要确认的授权 / 模型 / 画板资源口径；该命令不调用 Tauri 读写、不刷新资产、不读取素材清单、不导出试玩包、不新增普通用户署名面板，真正查看完整资产仍由用户发送 `/assets` 并走原资产读取流。
- 聊天输入 `/risks` 只使用主窗口当前已加载的 manifest、最近 run trace、预览状态、任务状态、资产来源和最近命令摘要，在聊天里列出当前项目风险，并提供首个风险处理草稿；该命令不调用 Tauri 读写、不读取文件、不启动或打开预览、不新增普通用户面板，用户必须再发送草稿并按原命令权限流继续。
- 聊天输入 `/criteria` 只使用主窗口当前已加载的 manifest.tasks 和最近 run trace.taskGraph，在聊天里列出 active、carry、ready、失败或待处理任务的验收条件和预期产物，并提供 `/tasks` 草稿；该命令不调用 Tauri 读写、不读取任务文件或 trace 文件、不新增普通用户验收面板，真正查看完整任务仍由用户发送 `/tasks` 并走原读取流。
@@ -257,7 +260,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`、`/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`、`/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 或历史仍由用户发送对应草稿并走原权限流。