GenarrativeAI/Genarrative
11
0
Fork 0
Code Issues 19 Pull Requests 12 Actions Packages Projects 1 Releases Wiki Activity

补充试玩定位聊天入口

Browse Source 
新增 /pitch 试玩定位与卖点摘要

补充 /next 与 /help 的定位入口覆盖

同步 AI 游戏创作 App 技术方案和决策记录
This commit is contained in:
AIGameCreator App
2026-07-03 18:45:44 +08:00
parent 44f810ba01
commit c796dac003
4 changed files with 187 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
apps/ai-game-creator-shell/src/App.tsx
+84
View File
@@ -1870,6 +1870,7 @@ const chatCommandHelp = [
'/brief：生成当前项目简报',
'/goal：查看创作目标',
'/mvp：查看本轮最小可玩范围',
'/pitch：查看试玩定位与卖点',
'/rules：查看玩法操作与规则',
'/risks：查看当前项目风险',
'/criteria：查看当前任务验收标准',
@@ -2190,6 +2191,71 @@ function summarizeProjectMvpScope(
};
}
function summarizeProjectPitch(
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 blockedTrace =
trace?.lifecycleStatus === 'killed' ||
trace?.status === 'failed' ||
trace?.status === 'needs-revision' ||
trace?.stopReason === 'max-passes-exhausted';
const goal =
nextManifest.goal?.trim() ||
trace?.goal?.trim() ||
trace?.taskGraph.goal?.trim() ||
'暂无';
let draftCommand = '/mvp';
let draftCommandLabel = '查看 MVP 范围';
if (blockedTrace) {
draftCommand = '/review';
draftCommandLabel = '查看评审';
} else if (!trace) {
draftCommand = '/mvp';
draftCommandLabel = '查看 MVP 范围';
} else if (!tracePassed) {
draftCommand = '/trace';
draftCommandLabel = '查看 trace';
} else if (previewRunning) {
draftCommand = '/open-preview';
draftCommandLabel = '打开预览';
} else {
draftCommand = '/run';
draftCommandLabel = '启动预览';
}
return {
text: [
'试玩定位：',
`- 项目：${nextManifest.name}`,
`- 一句话：${goal}`,
'- 核心乐趣：快速验证目标、操作反馈、胜负结果和重开节奏',
`- 当前可演示：${
tracePassed
? `最近 run 已通过${trace?.runId ? ` ${trace.runId}` : ''}`
: trace
? `最近 run 未通过 ${trace.status} / ${trace.stopReason}`
: '暂无最近 run'
}；预览 ${previewSummary}`,
'- 讲给测试者：先说明目标，再说明操作，然后看 30 秒内是否能理解胜负和重开',
'- 不承诺：云发布；深度美术精修；账号体系；排行榜；长期运营包装',
'- 参考：/mvp；/rules；/playtest；/listing',
`- 建议：${draftCommand}`,
].join('\n'),
draftCommand,
draftCommandLabel,
};
}
function summarizeProjectControlGuide(
nextManifest: GameCreationAppManifest,
trace: GameCreationAgentRunTrace | null,
@@ -3554,6 +3620,7 @@ function summarizeNextProjectActions(
}
addSuggestion('查看创作目标', '/goal');
addSuggestion('查看本轮 MVP 范围', '/mvp');
addSuggestion('查看试玩定位与卖点', '/pitch');
addSuggestion('查看玩法操作与规则', '/rules');
addSuggestion('查看数值与难度口径', '/balance');
@@ -7208,6 +7275,23 @@ export function App() {
return;
}
if (prompt === '/pitch') {
if (!requireChatProjectForUserAction()) {
return;
}
const summary = summarizeProjectPitch(manifest, agentRunTrace);
setMessages((current) => [
...current,
{
role: 'assistant',
text: summary.text,
draftCommand: summary.draftCommand,
draftCommandLabel: summary.draftCommandLabel,
},
]);
return;
}
if (prompt === '/rules' || prompt === '/controls') {
if (!requireChatProjectForUserAction()) {
return;
apps/ai-game-creator-shell/tests/appSurface.test.ts
+97
View File
@@ -2348,6 +2348,101 @@ describe('AI 游戏创作 App 界面边界', () => {
),
).toHaveLength(commandCountsBeforeMvp.exportList);
const commandCountsBeforePitch = {
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,
};
submitChat('/pitch');
const pitchMessages = await screen.findAllByText(/试玩定位：/);
const pitchMessage = pitchMessages[pitchMessages.length - 1];
expect(pitchMessage.textContent).toContain('项目：未命名游戏原型');
expect(pitchMessage.textContent).toContain('一句话：做一个厨房弹幕游戏');
expect(pitchMessage.textContent).toContain(
'核心乐趣：快速验证目标、操作反馈、胜负结果和重开节奏',
);
expect(pitchMessage.textContent).toContain(
'当前可演示：最近 run 已通过 run-main-shortcut-trace；预览 未启动',
);
expect(pitchMessage.textContent).toContain(
'讲给测试者：先说明目标，再说明操作，然后看 30 秒内是否能理解胜负和重开',
);
expect(pitchMessage.textContent).toContain(
'不承诺：云发布；深度美术精修；账号体系；排行榜；长期运营包装',
);
expect(pitchMessage.textContent).toContain(
'参考：/mvp；/rules；/playtest；/listing',
);
expect(pitchMessage.textContent).toContain('建议：/run');
const pitchMessageList = document.querySelector('.message-list');
expect(pitchMessageList).not.toBeNull();
const pitchDraftButtons = within(
pitchMessageList as HTMLElement,
).getAllByRole('button', { name: '启动预览' });
fireEvent.click(pitchDraftButtons[pitchDraftButtons.length - 1]);
expect(screen.getByLabelText('创作想法')).toHaveProperty('value', '/run');
expect(
invoke.mock.calls.filter(
([command]) => command === 'get_local_game_manifest',
),
).toHaveLength(commandCountsBeforePitch.manifestRead);
expect(
invoke.mock.calls.filter(
([command]) => command === 'read_local_project_file',
),
).toHaveLength(commandCountsBeforePitch.fileRead);
expect(
invoke.mock.calls.filter(
([command]) => command === 'list_local_project_files',
),
).toHaveLength(commandCountsBeforePitch.fileList);
expect(
invoke.mock.calls.filter(
([command]) => command === 'run_limited_local_command',
),
).toHaveLength(commandCountsBeforePitch.runLocal);
expect(
invoke.mock.calls.filter(
([command]) => command === 'start_local_game_preview',
),
).toHaveLength(commandCountsBeforePitch.startPreview);
expect(
invoke.mock.calls.filter(
([command]) => command === 'open_local_game_preview',
),
).toHaveLength(commandCountsBeforePitch.openPreview);
expect(
invoke.mock.calls.filter(
([command]) => command === 'export_local_project_package',
),
).toHaveLength(commandCountsBeforePitch.exportPackage);
expect(
invoke.mock.calls.filter(
([command]) => command === 'list_local_project_export_packages',
),
).toHaveLength(commandCountsBeforePitch.exportList);
const commandCountsBeforeControls = {
manifestRead: invoke.mock.calls.filter(
([command]) => command === 'get_local_game_manifest',
@@ -3124,6 +3219,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(/查看试玩定位与卖点：\/pitch/)).not.toBeNull();
expect(screen.getByText(/查看玩法操作与规则：\/rules/)).not.toBeNull();
expect(screen.getByText(/查看数值与难度口径：\/balance/)).not.toBeNull();
expect(screen.getByText(/查看 .* 个 ready 任务：\/tasks/)).not.toBeNull();
@@ -9316,6 +9412,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(/\/pitch：查看试玩定位与卖点/)).not.toBeNull();
expect(screen.getByText(/\/rules：查看玩法操作与规则/)).not.toBeNull();
expect(screen.getByText(/\/risks：查看当前项目风险/)).not.toBeNull();
expect(screen.getByText(/\/criteria：查看当前任务验收标准/)).not.toBeNull();
docs/project-memory/shared-memory/decision-log.md
+2 -1
View File
@@ -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 调整：普通用户通过聊天输入 `/pitch` 查看试玩定位与卖点，只基于当前 manifest、最近 run trace 和 preview 状态汇总试玩定位、一句话、核心乐趣、当前可演示状态、测试者讲解口径和暂不承诺事项，并提供 `/mvp`、`/review`、`/trace`、`/open-preview` 或 `/run` 草稿；该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览、不得直接继续 run，也不得新增普通用户定位面板。该入口服务试玩讲解，不承接 `/listing` 的作品页包装。
- 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 文件，也不得新增普通用户验收面板。
@@ -3892,7 +3893,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 调整：普通用户通过聊天输入 `/next` 触发下一步建议入口，只基于主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要生成聊天建议，列出 `/goal`、`/mvp`、`/rules`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/feedback`、`/share`、`/listing`、`/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`、`/pitch`、`/rules`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/feedback`、`/share`、`/listing`、`/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 读写，也不得新增普通用户轮次面板。
docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
+4 -1
View File
@@ -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、继续或导出草稿，不新增发布面板；聊天输入 `/listing` 可基于当前 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`。
- 聊天输入 `/goal` 可在普通聊天消息里查看创作目标来源，不读取 spec、上下文或 trace 文件，也不新增普通用户目标面板。
- 聊天输入 `/mvp` 可在普通聊天消息里查看本轮最小可玩范围、当前状态、试玩包状态和暂不做事项，不读取文件、不启动预览、不导出试玩包，也不新增普通用户 MVP 面板。
- 聊天输入 `/pitch` 可在普通聊天消息里查看试玩定位与卖点，不读取文件、不启动或打开预览、不直接继续 run，也不新增普通用户定位面板。
- 聊天输入 `/rules` 可在普通聊天消息里查看玩法操作与规则口径，不读取设计文件、不启动预览、不直接继续 run，也不新增普通用户规则面板。
- 聊天输入 `/criteria` 可在普通聊天消息里查看当前任务验收标准和预期产物，不读取任务文件或 trace 文件，也不新增普通用户验收面板。
- 聊天输入 `/groups` 可在普通聊天消息里查看六个专业组进度和下一步任务，不读取任务文件或 trace 文件，也不新增普通用户专业组面板。
@@ -128,6 +129,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 面板。
- `/pitch` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace 和 preview 状态汇总试玩定位、一句话、核心乐趣、可演示状态、测试者讲解口径和暂不承诺事项，提供 `/mvp`、`/review`、`/trace`、`/open-preview` 或 `/run` 草稿，不触发 Tauri 读写、不读取文件、不启动或打开预览、不直接继续 run、不新增普通用户定位面板。
- `/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 文件、不新增普通用户专业组面板。
@@ -218,6 +220,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 面板，真正运行、导出或查看包仍由用户发送对应草稿并走原权限流。
- 聊天输入 `/pitch` 只使用主窗口当前已加载的 manifest、最近 run trace 和 preview 状态，在聊天里列出试玩定位、一句话、核心乐趣、当前可演示状态、测试者讲解口径和暂不承诺事项；该命令不调用 Tauri 读写、不读取文件、不启动或打开预览、不直接继续 run、不新增普通用户定位面板，真正运行、打开预览或查看 trace 仍由用户发送对应草稿并走原权限流。
- 聊天输入 `/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` 并走原读取流。
@@ -228,7 +231,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`、`/rules`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/feedback`、`/share`、`/listing`、`/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`、`/pitch`、`/rules`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/feedback`、`/share`、`/listing`、`/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 或历史仍由用户发送对应草稿并走原权限流。