补充当前阻塞项聊天入口

新增 /blockers 当前阻塞项摘要

补充 /next 与 /help 的阻塞入口覆盖

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

同步 AI 游戏创作 App 技术方案和决策记录
This commit is contained in:
AIGameCreator App
2026-07-04 11:31:45 +08:00
parent 29110a3907
commit 5021f3fa5f
4 changed files with 242 additions and 2 deletions
+134
View File
@@ -1880,6 +1880,7 @@ const chatCommandHelp = [
'/performance:查看性能与加载检查',
'/polish:查看试玩前打磨清单',
'/risks:查看当前项目风险',
'/blockers:查看当前阻塞项',
'/criteria:查看当前任务验收标准',
'/groups:查看专业组进度',
'/balance:查看数值与难度口径',
@@ -3069,6 +3070,121 @@ function summarizeProjectRisks(
};
}
function summarizeProjectBlockers(
nextManifest: GameCreationAppManifest,
trace: GameCreationAgentRunTrace | null,
) {
const blockers: Array<{ text: string; command?: string }> = [];
const addBlocker = (text: string, command?: string) => {
if (command && blockers.some((blocker) => blocker.command === command)) {
return;
}
blockers.push({ text, command });
};
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 latestCommandRun = commandRuns[commandRuns.length - 1] ?? 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 tracePassed = isAgentRunTracePassed(trace);
const hasVisualAsset = nextManifest.assets.some(isProjectVisualAsset);
if (!trace) {
addBlocker('暂无最近 Agent run,缺少可验原型证据。', '/next');
} else if (
trace.lifecycleStatus === 'killed' ||
trace.status === 'failed' ||
trace.status === 'needs-revision' ||
trace.stopReason === 'max-passes-exhausted'
) {
addBlocker(
`最近 run 阻塞:${trace.status} / ${trace.stopReason}。`,
'/review',
);
} else if (!tracePassed) {
addBlocker(
`最近 run 尚未通过:${trace.status} / ${trace.stopReason}。`,
'/trace',
);
}
if (failedTasks.length > 0) {
const firstFailed = failedTasks[0];
if (firstFailed) {
addBlocker(
`失败任务 ${failedTasks.length} 个:${firstFailed.title}(${firstFailed.id})。`,
'/tasks',
);
}
}
if (latestCommandRun?.status === 'failed') {
addBlocker(`最近命令失败:${latestCommandRun.commandId}。`, '/logs');
}
if (tracePassed && !previewRunning) {
addBlocker('原型已通过,但本地预览未运行。', '/run');
}
if (tracePassed && latestExportCommand?.status !== 'completed') {
addBlocker('原型已通过,但本地试玩包尚未导出。', '/export');
}
if (readyTasks.length > 0) {
const firstReady = readyTasks[0];
if (firstReady) {
addBlocker(
`ready 任务 ${readyTasks.length} 个:${taskGroupLabels[firstReady.group]} / ${firstReady.role} ${firstReady.title}(${firstReady.id})。`,
'/todo',
);
}
}
if (!hasVisualAsset) {
addBlocker('暂无可用美术素材,首版试玩可能只能使用占位。', '/art');
}
const firstAction = blockers.find((blocker) => blocker.command);
const blockerLines =
blockers.length > 0
? blockers.map(
(blocker) =>
`- ${blocker.text}${blocker.command ? ` 建议:${blocker.command}` : ''}`,
)
: ['- 暂未发现会阻断 MVP 试玩的事项。'];
return {
text: [
'当前阻塞项:',
`- 项目:${nextManifest.name}`,
trace ? `- Run:${trace.runId} · ${formatAgentRunStatus(trace)}` : null,
...blockerLines,
'- 边界:只整理阻塞项;不读取文件;不启动预览;不导出试玩包;不写项目',
`- 建议:${firstAction?.command ?? '/next'}`,
]
.filter(Boolean)
.join('\n'),
draftCommand: firstAction?.command ?? '/next',
draftCommandLabel: firstAction ? '处理首个阻塞' : '查看下一步',
};
}
function summarizeProjectAcceptanceCriteria(
nextManifest: GameCreationAppManifest,
trace: GameCreationAgentRunTrace | null,
@@ -4498,6 +4614,7 @@ function summarizeNextProjectActions(
addSuggestion('查看性能与加载检查', '/performance');
addSuggestion('查看试玩前打磨清单', '/polish');
addSuggestion('查看数值与难度口径', '/balance');
addSuggestion('查看当前阻塞项', '/blockers');
const readyTasks = selectGameCreationAppReadyTasks({
tasks: taskRowsFromManifest(nextManifest),
@@ -8393,6 +8510,23 @@ export function App() {
return;
}
if (prompt === '/blockers') {
if (!requireChatProjectForUserAction()) {
return;
}
const summary = summarizeProjectBlockers(manifest, agentRunTrace);
setMessages((current) => [
...current,
{
role: 'assistant',
text: summary.text,
draftCommand: summary.draftCommand,
draftCommandLabel: summary.draftCommandLabel,
},
]);
return;
}
if (prompt === '/criteria') {
if (!requireChatProjectForUserAction()) {
return;
@@ -3445,6 +3445,106 @@ describe('AI 游戏创作 App 界面边界', () => {
),
).toHaveLength(runLocalCountBeforeRisks);
const commandCountsBeforeBlockers = {
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('/blockers');
const blockerMessages = await screen.findAllByText(/当前阻塞项:/);
const blockerMessage = blockerMessages[blockerMessages.length - 1];
expect(blockerMessage.textContent).toContain('项目:未命名游戏原型');
expect(blockerMessage.textContent).toContain(
'Run:run-main-shortcut-trace · passed / done · 1/3 轮 · evaluator-passed',
);
expect(blockerMessage.textContent).toContain(
'原型已通过,但本地预览未运行。 建议:/run',
);
expect(blockerMessage.textContent).toContain(
'原型已通过,但本地试玩包尚未导出。 建议:/export',
);
expect(blockerMessage.textContent).toContain(
'ready 任务 1 个:美术组 / Asset 规划美术资产(art-asset-plan)。 建议:/todo',
);
expect(blockerMessage.textContent).toContain(
'边界:只整理阻塞项;不读取文件;不启动预览;不导出试玩包;不写项目',
);
expect(blockerMessage.textContent).toContain('建议:/run');
const blockerMessageList = document.querySelector('.message-list');
expect(blockerMessageList).not.toBeNull();
const blockerDraftButtons = within(
blockerMessageList as HTMLElement,
).getAllByRole('button', { name: '处理首个阻塞' });
fireEvent.click(blockerDraftButtons[blockerDraftButtons.length - 1]);
expect(screen.getByLabelText('创作想法')).toHaveProperty('value', '/run');
expect(
invoke.mock.calls.filter(
([command]) => command === 'get_local_game_manifest',
),
).toHaveLength(commandCountsBeforeBlockers.manifestRead);
expect(
invoke.mock.calls.filter(
([command]) => command === 'read_local_project_file',
),
).toHaveLength(commandCountsBeforeBlockers.fileRead);
expect(
invoke.mock.calls.filter(
([command]) => command === 'list_local_project_files',
),
).toHaveLength(commandCountsBeforeBlockers.fileList);
expect(
invoke.mock.calls.filter(
([command]) => command === 'run_limited_local_command',
),
).toHaveLength(commandCountsBeforeBlockers.runLocal);
expect(
invoke.mock.calls.filter(
([command]) => command === 'start_local_game_preview',
),
).toHaveLength(commandCountsBeforeBlockers.startPreview);
expect(
invoke.mock.calls.filter(
([command]) => command === 'open_local_game_preview',
),
).toHaveLength(commandCountsBeforeBlockers.openPreview);
expect(
invoke.mock.calls.filter(
([command]) => command === 'export_local_project_package',
),
).toHaveLength(commandCountsBeforeBlockers.exportPackage);
expect(
invoke.mock.calls.filter(
([command]) => command === 'list_local_project_export_packages',
),
).toHaveLength(commandCountsBeforeBlockers.exportList);
expect(
invoke.mock.calls.filter(([command]) => command === 'control_agent_run'),
).toHaveLength(commandCountsBeforeBlockers.controlAgentRun);
const fileReadCountBeforeCriteria = invoke.mock.calls.filter(
([command]) => command === 'read_local_project_file',
).length;
@@ -4193,6 +4293,7 @@ describe('AI 游戏创作 App 界面边界', () => {
expect(screen.getByText(/查看质量检查清单:\/qa/)).not.toBeNull();
expect(screen.getByText(/查看最近生成变更:\/changes/)).not.toBeNull();
expect(screen.getByText(/查看下一轮小步清单:\/todo/)).not.toBeNull();
expect(screen.getByText(/查看当前阻塞项:\/blockers/)).not.toBeNull();
expect(screen.getByText(/查看素材署名与来源:\/credits/)).not.toBeNull();
expect(screen.getByText(/查看美术素材:\/art/)).not.toBeNull();
expect(screen.getByText(/查看发布准备清单:\/publish/)).not.toBeNull();
@@ -10493,6 +10594,7 @@ describe('AI 游戏创作 App 界面边界', () => {
).not.toBeNull();
expect(screen.getByText(/\/polish:查看试玩前打磨清单/)).not.toBeNull();
expect(screen.getByText(/\/risks:查看当前项目风险/)).not.toBeNull();
expect(screen.getByText(/\/blockers:查看当前阻塞项/)).not.toBeNull();
expect(screen.getByText(/\/criteria:查看当前任务验收标准/)).not.toBeNull();
expect(screen.getByText(/\/groups:查看专业组进度/)).not.toBeNull();
expect(screen.getByText(/\/balance:查看数值与难度口径/)).not.toBeNull();
@@ -3878,6 +3878,7 @@
- 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-04 调整:普通用户通过聊天输入 `/blockers` 查看当前阻塞项,只基于当前 manifest、最近 run trace、preview、最近命令、ready / failed 任务、导出记录和资产概况汇总当前阻塞项,并提供 `/run`、`/export`、`/todo`、`/review`、`/trace`、`/tasks`、`/logs`、`/art` 或 `/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 文件,也不得新增普通用户专业组面板。
@@ -3903,7 +3904,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`、`/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`、`/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 读写,也不得新增普通用户轮次面板。
@@ -113,6 +113,7 @@ game-project/
- 聊天输入 `/performance` 可在普通聊天消息里查看性能与加载检查,不读取产物或日志文件、不启动或打开预览、不直接继续 run,也不新增普通用户性能面板。
- 聊天输入 `/polish` 可在普通聊天消息里查看试玩前打磨清单,不读取文件、不启动预览、不导出试玩包、不写项目,也不新增普通用户打磨面板。
- 聊天输入 `/credits` 可在普通聊天消息里查看素材署名与来源口径,不刷新资产、不读取素材清单、不导出试玩包,也不新增普通用户署名面板。
- 聊天输入 `/blockers` 可在普通聊天消息里查看当前阻塞项,不读取文件、不启动预览、不导出试玩包、不写项目,也不新增普通用户阻塞面板。
- 聊天输入 `/criteria` 可在普通聊天消息里查看当前任务验收标准和预期产物,不读取任务文件或 trace 文件,也不新增普通用户验收面板。
- 聊天输入 `/groups` 可在普通聊天消息里查看六个专业组进度和下一步任务,不读取任务文件或 trace 文件,也不新增普通用户专业组面板。
- 聊天输入 `/balance` 可在普通聊天消息里查看数值与难度口径,不读取数值表、不启动预览、不直接继续 run,也不新增普通用户数值面板。
@@ -149,6 +150,7 @@ game-project/
- `/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 读写、不刷新资产、不读取素材清单、不导出试玩包、不新增普通用户署名面板。
- `/blockers` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖:只基于当前已加载 manifest、最近 run trace、preview、最近命令、ready / failed 任务、导出记录和资产概况汇总当前阻塞项,提供 `/run`、`/export`、`/todo`、`/review`、`/trace`、`/tasks`、`/logs`、`/art` 或 `/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、不新增普通用户数值面板。
@@ -250,6 +252,7 @@ game-project/
- 聊天输入 `/performance` 只使用主窗口当前已加载的 manifest、最近 run trace、preview、资产数量和 trace artifact 摘要,在聊天里列出性能与加载检查范围、关键产物、关联任务和最近性能相关步骤;该命令不调用 Tauri 读写、不读取产物或日志文件、不启动或打开预览、不直接继续 run、不新增普通用户性能面板,真正查看产物或启动试玩仍由用户发送对应草稿并走原权限流。
- 聊天输入 `/polish` 只使用主窗口当前已加载的 manifest、最近 run trace、preview、最近自检和资产数量,在聊天里列出试玩前打磨范围、推荐顺序、关联任务和最近打磨相关步骤;该命令不调用 Tauri 读写、不读取文件、不启动预览、不导出试玩包、不写项目、不新增普通用户打磨面板,真正继续打磨、查看评审或准备反馈仍由用户发送对应草稿并走原权限流。
- 聊天输入 `/credits` 只使用主窗口当前已加载的 manifest.assets,在聊天里列出素材数量、来源分布、来源清单和交付前需要确认的授权 / 模型 / 画板资源口径;该命令不调用 Tauri 读写、不刷新资产、不读取素材清单、不导出试玩包、不新增普通用户署名面板,真正查看完整资产仍由用户发送 `/assets` 并走原资产读取流。
- 聊天输入 `/blockers` 只使用主窗口当前已加载的 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` 并走原读取流。
@@ -260,7 +263,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`、`/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`、`/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 或历史仍由用户发送对应草稿并走原权限流。