补充玩法规则聊天入口

新增 /rules 玩法操作与规则摘要

补充 /next 与 /help 的规则入口覆盖

同步 AI 游戏创作 App 技术方案和决策记录
This commit is contained in:
AIGameCreator App
2026-07-03 18:18:47 +08:00
parent fde0a3ae80
commit 5896350075
4 changed files with 231 additions and 2 deletions
+121
View File
@@ -1870,6 +1870,7 @@ const chatCommandHelp = [
'/brief:生成当前项目简报',
'/goal:查看创作目标',
'/mvp:查看本轮最小可玩范围',
'/rules:查看玩法操作与规则',
'/risks:查看当前项目风险',
'/criteria:查看当前任务验收标准',
'/groups:查看专业组进度',
@@ -2187,6 +2188,108 @@ function summarizeProjectMvpScope(
};
}
function summarizeProjectControlGuide(
nextManifest: GameCreationAppManifest,
trace: GameCreationAgentRunTrace | null,
) {
const manifestTasks = taskRowsFromManifest(nextManifest);
const traceTasks = trace?.taskGraph.tasks ?? [];
const tasks = manifestTasks.map(
(task) => traceTasks.find((traceTask) => traceTask.id === task.id) ?? task,
);
const tasksById = new Map(tasks.map((task) => [task.id, task]));
const readyTaskIds = new Set(
trace
? trace.taskGraph.readyTaskIds
: selectGameCreationAppReadyTasks({ tasks }).map((task) => task.id),
);
const activeTaskIds = new Set(trace?.taskGraph.activeTaskIds ?? []);
const carriedTaskIds = new Set(trace?.taskGraph.carriedTaskIds ?? []);
const formatTaskLine = (taskId: string) => {
const task = tasksById.get(taskId);
if (!task) {
return null;
}
const markers = [taskStatusLabels[task.status]];
if (readyTaskIds.has(task.id)) {
markers.push('ready');
}
if (activeTaskIds.has(task.id)) {
markers.push('active');
}
if (carriedTaskIds.has(task.id)) {
markers.push('carry');
}
return `- ${task.id}${taskGroupLabels[task.group]} / ${task.role} ${task.title} · ${markers.join(' / ')}`;
};
const taskLines = [
'design-foundation',
'code-prototype',
'preview-readiness',
'preview-playtest',
]
.map(formatTaskLine)
.filter(Boolean);
const hasDesignArtifact =
trace?.artifacts.some(
(artifact) => artifact.path === 'game/game_design.md',
) ?? false;
const hasGameArtifact =
trace?.artifacts.some(
(artifact) =>
artifact.path === 'game/index.html' || artifact.path === 'game/',
) ?? false;
const latestControlStep =
trace?.steps
.filter(
(step) =>
step.taskId === 'code-prototype' ||
step.taskId === 'preview-readiness' ||
step.taskId === 'preview-playtest' ||
step.group === 'code' ||
step.phase === 'generate' ||
step.phase === 'playtest' ||
step.toolCalls.some(
(toolCall) =>
toolCall.toolId === 'game.static_smoke' ||
toolCall.toolId.startsWith('preview.'),
),
)
.slice(-1)[0] ?? null;
const draftCommand = hasDesignArtifact
? '/read game/game_design.md'
: trace
? '/agent-resume 操作说明:在首屏明确移动/点击操作、胜负目标、失败后重开方式'
: '/next';
return {
text: [
'玩法操作:',
`- 项目:${nextManifest.name}`,
`- 目标:${nextManifest.goal ?? trace?.goal ?? trace?.taskGraph.goal ?? '暂无'}`,
'- 核心口径:目标;操作;胜负;重开;本地预览',
`- 规则来源:game/game_design.md · ${hasDesignArtifact ? '已生成' : '未见 trace 产物'}`,
`- 原型入口:game/index.html · ${hasGameArtifact ? '已生成' : '未见 trace 产物'}`,
taskLines.length > 0
? `- 任务状态:\n${taskLines.join('\n')}`
: '- 任务状态:暂无',
`- 最近程序/试玩步骤:${
latestControlStep
? `${latestControlStep.agent} #${latestControlStep.pass} · ${latestControlStep.status} · ${latestControlStep.summary}`
: '暂无'
}`,
'- 相关命令:/mvp/playtest/feedback',
`- 建议:${draftCommand}`,
].join('\n'),
draftCommand,
draftCommandLabel: hasDesignArtifact
? '读取玩法设计'
: trace
? '补充操作说明'
: '查看下一步',
};
}
function summarizeProjectRisks(
nextManifest: GameCreationAppManifest,
trace: GameCreationAgentRunTrace | null,
@@ -3263,6 +3366,7 @@ function summarizeNextProjectActions(
}
addSuggestion('查看创作目标', '/goal');
addSuggestion('查看本轮 MVP 范围', '/mvp');
addSuggestion('查看玩法操作与规则', '/rules');
addSuggestion('查看数值与难度口径', '/balance');
const readyTasks = selectGameCreationAppReadyTasks({
@@ -6914,6 +7018,23 @@ export function App() {
return;
}
if (prompt === '/rules' || prompt === '/controls') {
if (!requireChatProjectForUserAction()) {
return;
}
const summary = summarizeProjectControlGuide(manifest, agentRunTrace);
setMessages((current) => [
...current,
{
role: 'assistant',
text: summary.text,
draftCommand: summary.draftCommand,
draftCommandLabel: summary.draftCommandLabel,
},
]);
return;
}
if (prompt === '/risks') {
if (!requireChatProjectForUserAction()) {
return;
@@ -2348,6 +2348,108 @@ describe('AI 游戏创作 App 界面边界', () => {
),
).toHaveLength(commandCountsBeforeMvp.exportList);
const commandCountsBeforeControls = {
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,
};
submitChat('/rules');
expect(await screen.findByText(/玩法操作:/)).not.toBeNull();
const controlMessages = screen.getAllByText(/玩法操作:/);
const controlMessage = controlMessages[controlMessages.length - 1];
expect(controlMessage.textContent).toContain('项目:未命名游戏原型');
expect(controlMessage.textContent).toContain('目标:做一个厨房弹幕游戏');
expect(controlMessage.textContent).toContain(
'核心口径:目标;操作;胜负;重开;本地预览',
);
expect(controlMessage.textContent).toContain(
'规则来源:game/game_design.md · 未见 trace 产物',
);
expect(controlMessage.textContent).toContain(
'原型入口:game/index.html · 未见 trace 产物',
);
expect(controlMessage.textContent).toContain(
'design-foundation:策划组 / Gameplay 确定玩法规格 · 待处理',
);
expect(controlMessage.textContent).toContain(
'code-prototype:程序组 / Code 生成可运行原型 · 待处理',
);
expect(controlMessage.textContent).toContain(
'preview-playtest:程序组 / Playtest 预览并试玩验收 · 待处理',
);
expect(controlMessage.textContent).toContain(
'最近程序/试玩步骤:Generator #1 · completed · 生成可运行草案',
);
expect(controlMessage.textContent).toContain(
'相关命令:/mvp/playtest/feedback',
);
expect(controlMessage.textContent).toContain(
'建议:/agent-resume 操作说明:在首屏明确移动/点击操作、胜负目标、失败后重开方式',
);
const controlMessageList = document.querySelector('.message-list');
expect(controlMessageList).not.toBeNull();
const controlDraftButtons = within(
controlMessageList as HTMLElement,
).getAllByRole('button', { name: '补充操作说明' });
fireEvent.click(controlDraftButtons[controlDraftButtons.length - 1]);
expect(screen.getByLabelText('创作想法')).toHaveProperty(
'value',
'/agent-resume 操作说明:在首屏明确移动/点击操作、胜负目标、失败后重开方式',
);
expect(
invoke.mock.calls.filter(
([command]) => command === 'get_local_game_manifest',
),
).toHaveLength(commandCountsBeforeControls.manifestRead);
expect(
invoke.mock.calls.filter(
([command]) => command === 'read_local_project_file',
),
).toHaveLength(commandCountsBeforeControls.fileRead);
expect(
invoke.mock.calls.filter(
([command]) => command === 'list_local_project_files',
),
).toHaveLength(commandCountsBeforeControls.fileList);
expect(
invoke.mock.calls.filter(
([command]) => command === 'run_limited_local_command',
),
).toHaveLength(commandCountsBeforeControls.runLocal);
expect(
invoke.mock.calls.filter(
([command]) => command === 'start_local_game_preview',
),
).toHaveLength(commandCountsBeforeControls.startPreview);
expect(
invoke.mock.calls.filter(
([command]) => command === 'open_local_game_preview',
),
).toHaveLength(commandCountsBeforeControls.openPreview);
expect(
invoke.mock.calls.filter(
([command]) => command === 'export_local_project_package',
),
).toHaveLength(commandCountsBeforeControls.exportPackage);
const manifestReadCountBeforeRisks = invoke.mock.calls.filter(
([command]) => command === 'get_local_game_manifest',
).length;
@@ -3022,6 +3124,7 @@ describe('AI 游戏创作 App 界面边界', () => {
expect(screen.getByText(/运行自检并启动本地预览:\/run/)).not.toBeNull();
expect(screen.getByText(/查看创作目标:\/goal/)).not.toBeNull();
expect(screen.getByText(/查看本轮 MVP 范围:\/mvp/)).not.toBeNull();
expect(screen.getByText(/查看玩法操作与规则:\/rules/)).not.toBeNull();
expect(screen.getByText(/查看数值与难度口径:\/balance/)).not.toBeNull();
expect(screen.getByText(/查看 .* 个 ready 任务:\/tasks/)).not.toBeNull();
expect(screen.getByText(/查看当前任务验收标准:\/criteria/)).not.toBeNull();
@@ -9011,6 +9114,7 @@ describe('AI 游戏创作 App 界面边界', () => {
expect(screen.getByText(/\/brief:生成当前项目简报/)).not.toBeNull();
expect(screen.getByText(/\/goal:查看创作目标/)).not.toBeNull();
expect(screen.getByText(/\/mvp:查看本轮最小可玩范围/)).not.toBeNull();
expect(screen.getByText(/\/rules:查看玩法操作与规则/)).not.toBeNull();
expect(screen.getByText(/\/risks:查看当前项目风险/)).not.toBeNull();
expect(screen.getByText(/\/criteria:查看当前任务验收标准/)).not.toBeNull();
expect(screen.getByText(/\/groups:查看专业组进度/)).not.toBeNull();
@@ -3868,6 +3868,7 @@
- 2026-07-03 调整:普通用户通过聊天输入 `/brief` 触发项目简报入口,只基于主窗口当前已加载的 manifest、最近 run trace、预览状态、资产数量和最近命令生成聊天内简报,并提供 `/next` 作为后续草稿;该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览,也不得新增普通用户面板。
- 2026-07-03 调整:普通用户通过聊天输入 `/goal` 查看创作目标,只基于当前 manifest.goal、最近 run goal 和 taskGraph.goal 汇总项目目标来源,并提供 `/agent-resume 细化目标:``/next` 草稿;该入口不得触发 Tauri 读写、不得读取 spec、上下文或 trace 文件,也不得新增普通用户目标面板。
- 2026-07-03 调整:普通用户通过聊天输入 `/mvp` 查看本轮最小可玩范围,只基于当前 manifest、最近 run trace、preview、任务、资产和最近命令汇总 MVP 内、当前状态、试玩包状态和暂不做事项,并提供 `/review``/criteria``/trace``/run``/export``/exports``/next` 草稿;该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览、不得导出试玩包,也不得新增普通用户 MVP 面板。
- 2026-07-03 调整:普通用户通过聊天输入 `/rules` 查看玩法操作与规则,只基于当前 manifest、最近 run trace.taskGraph、trace artifacts 和 steps 汇总玩法目标、操作 / 胜负 / 重开口径、设计与入口产物状态、相关任务和最近程序 / 试玩步骤,并提供 `/read game/game_design.md``/agent-resume 操作说明:...``/next` 草稿;该入口不得触发 Tauri 读写、不得读取设计文件、不得启动预览或继续 run,也不得新增普通用户规则面板。
- 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 文件,也不得新增普通用户专业组面板。
@@ -3889,7 +3890,7 @@
- 2026-07-03 调整:主窗口新增音效登记和画板音频导入快捷入口,只填入 `/asset-register assets/audio/sfx.wav audio audio/wav``/import-canvas-asset assets/audio/sfx.wav ` 草稿;聊天输入 `/audio` 只基于当前 manifest 盘点音频素材、来源和路径,并给出登记音效或读取 `assets/manifest.audio.json` 的草稿。音乐组仍复用现有资产登记 / 画板回流链路,不新增独立音频生成系统。
- 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 调整:普通用户通过聊天输入 `/next` 触发下一步建议入口,只基于主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要生成聊天建议,列出 `/goal``/mvp``/tasks``/criteria``/groups``/balance``/budget``/qa``/changes``/trace``/review``/context``/timeline``/playtest``/feedback``/run``/open-preview``/assets``/art``/audio``/publish``/artifacts``/run-artifacts``/passes``/run-files``/internals``/logs``/agent-resume ` 等安全命令草稿方向,并提供一个首选草稿;该命令不得直接执行 Tauri 读写、启动或打开预览、读取本地文件,也不得绕过原有命令确认和 `file.read` 权限流。
- 2026-07-03 调整:普通用户通过聊天输入 `/next` 触发下一步建议入口,只基于主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要生成聊天建议,列出 `/goal``/mvp``/rules``/tasks``/criteria``/groups``/balance``/budget``/qa``/changes``/trace``/review``/context``/timeline``/playtest``/feedback``/run``/open-preview``/assets``/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 读写,也不得新增普通用户轮次面板。
@@ -103,6 +103,7 @@ game-project/
- 用户侧看到当前工作区项目名 / 路径、最近 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、继续或导出草稿,不新增发布面板;聊天输入 `/export` 确认后把当前可试玩原型导出为本地试玩 ZIP,聊天输入 `/exports` 可只读列出已导出的本地试玩包;Agent 状态列表和单 Agent 对话在 `/llm-status` 后显示该 agent 当前 LLM provider / 模型 / 流式 / API Key 读取状态,但不显示密钥本体;最近项目资产入口显示本地路径、kind、mediaType 和来源类型,并可一键填入 `/read` 草稿,开发环境通过独立窗口查看任务拆分、专业组细节、产物、文件面板、嵌入预览以及 `.agent/logs/command.log` / `preview.log` / `agent.log`
- 聊天输入 `/goal` 可在普通聊天消息里查看创作目标来源,不读取 spec、上下文或 trace 文件,也不新增普通用户目标面板。
- 聊天输入 `/mvp` 可在普通聊天消息里查看本轮最小可玩范围、当前状态、试玩包状态和暂不做事项,不读取文件、不启动预览、不导出试玩包,也不新增普通用户 MVP 面板。
- 聊天输入 `/rules` 可在普通聊天消息里查看玩法操作与规则口径,不读取设计文件、不启动预览、不直接继续 run,也不新增普通用户规则面板。
- 聊天输入 `/criteria` 可在普通聊天消息里查看当前任务验收标准和预期产物,不读取任务文件或 trace 文件,也不新增普通用户验收面板。
- 聊天输入 `/groups` 可在普通聊天消息里查看六个专业组进度和下一步任务,不读取任务文件或 trace 文件,也不新增普通用户专业组面板。
- 聊天输入 `/balance` 可在普通聊天消息里查看数值与难度口径,不读取数值表、不启动预览、不直接继续 run,也不新增普通用户数值面板。
@@ -125,6 +126,7 @@ game-project/
- `/risks` 聊天入口由 `appSurface.test.ts` 的主窗口 smoke 覆盖:只基于当前已加载的 manifest / trace / 预览 / 任务 / 资产 / 最近命令生成风险摘要,提供首个风险处理草稿,不触发 Tauri 读写、文件读取、预览启动或新增普通用户面板。
- `/goal` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖:只基于当前已加载 manifest.goal、最近 run goal 和 taskGraph.goal 汇总创作目标来源,提供 `/agent-resume 细化目标:``/next` 草稿,不触发 Tauri 读写、不读取 spec / 上下文 / trace 文件、不新增普通用户目标面板。
- `/mvp` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖:只基于当前已加载 manifest、最近 run trace、preview、任务、资产和最近命令汇总 MVP 内、当前状态、试玩包状态和暂不做事项,提供 `/review``/criteria``/trace``/run``/export``/exports``/next` 草稿,不触发 Tauri 读写、不读取文件、不启动或打开预览、不导出试玩包、不新增普通用户 MVP 面板。
- `/rules` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖:只基于当前已加载 manifest、最近 run trace.taskGraph、trace artifacts 和 steps 汇总玩法目标、操作 / 胜负 / 重开口径、设计与入口产物状态、相关任务和最近程序 / 试玩步骤,提供 `/read game/game_design.md``/agent-resume 操作说明:...``/next` 草稿,不触发 Tauri 读写、不读取设计文件、不启动预览或继续 run、不新增普通用户规则面板。
- `/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、不新增普通用户数值面板。
@@ -212,6 +214,7 @@ game-project/
- 聊天输入 `/brief` 只使用主窗口当前已加载的 manifest、最近 run trace、预览状态、资产数量和最近命令摘要,在聊天里生成项目简报,并提供 `/next` 作为后续草稿;该命令不调用 Tauri 读写、不读取文件、不启动或打开预览、不新增普通用户面板,用户可再发送 `/next` 草稿继续。
- 聊天输入 `/goal` 只使用主窗口当前已加载的 manifest.goal、最近 run goal 和 taskGraph.goal,在聊天里列出项目目标来源、上下文查看方向和后续目标细化草稿;该命令不调用 Tauri 读写、不读取 spec、上下文或 trace 文件、不新增普通用户目标面板,真正补充目标仍由用户发送 `/agent-resume 细化目标:` 并走原确认流。
- 聊天输入 `/mvp` 只使用主窗口当前已加载的 manifest、最近 run trace、preview、任务、资产和最近命令摘要,在聊天里列出本轮 MVP 内、当前状态、任务、预览、资产、试玩包状态和暂不做事项;该命令不调用 Tauri 读写、不读取文件、不启动或打开预览、不导出试玩包、不新增普通用户 MVP 面板,真正运行、导出或查看包仍由用户发送对应草稿并走原权限流。
- 聊天输入 `/rules` 只使用主窗口当前已加载的 manifest、最近 run trace.taskGraph、trace artifacts 和 steps,在聊天里列出玩法目标、操作 / 胜负 / 重开口径、设计与入口产物状态、相关任务和最近程序 / 试玩步骤;该命令不调用 Tauri 读写、不读取设计文件、不启动预览、不直接继续 run、不新增普通用户规则面板,真正读取设计或补充操作说明仍由用户发送对应草稿并走原权限流。
- 聊天输入 `/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` 并走原读取流。
@@ -221,7 +224,7 @@ game-project/
- 聊天输入 `/changes` 只使用主窗口当前已加载的 manifest、最近 run trace 的 artifacts / steps 和最近命令,在聊天里列出最近 run、可验产物数量、关键产物、最近输出、当前资产、全部产物读取入口、trace 入口和真实 diff 查看方向,并提供 `/read <首个可验产物>``/run-artifacts` 草稿;该命令不调用 Tauri 读写、不读取产物或日志文件、不执行 checkpoint diff、不新增普通用户变更面板,真正读取产物或对比 checkpoint 仍由用户发送对应草稿并走原权限流。
- 聊天输入 `/handoff` 只使用主窗口当前已加载的 manifest、最近 run trace、Agent 状态和已载入历史 run 批次,在聊天里生成项目交接摘要,并提供 `/next` 作为后续草稿;该命令不调用 Tauri 读写、不读取文件、不启动或打开预览、不新增普通用户面板,用户必须再发送草稿并按原命令权限流继续。
- 聊天输入 `/runs` 只使用主窗口当前已加载的 latest trace 和已载入历史 run 批次,在聊天里列出 `/trace``/read .agent/runs/...` 读取草稿;该命令不调用 Tauri 读写、不滚动加载更多历史、不启动或打开预览、不新增普通用户面板,用户必须再发送草稿并按原命令权限流继续。
- 聊天输入 `/next` 只使用主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要,在聊天里给出下一步建议,列出 `/goal``/mvp``/tasks``/criteria``/groups``/balance``/budget``/qa``/changes``/trace``/review``/context``/timeline``/playtest``/feedback``/run``/export``/exports``/open-preview``/assets``/art``/audio``/publish``/artifacts``/run-artifacts``/passes``/run-files``/internals``/logs``/agent-resume ` 等安全命令草稿方向,并提供一个首选草稿;该命令不调用 Tauri 读写、不启动或打开预览、不读取文件,用户必须再发送草稿并按原命令权限流继续。
- 聊天输入 `/next` 只使用主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要,在聊天里给出下一步建议,列出 `/goal``/mvp``/rules``/tasks``/criteria``/groups``/balance``/budget``/qa``/changes``/trace``/review``/context``/timeline``/playtest``/feedback``/run``/export``/exports``/open-preview``/assets``/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 或历史仍由用户发送对应草稿并走原权限流。