补充兼容性说明聊天入口

新增 /compatibility 兼容性说明摘要

补充 /next 与 /help 的兼容性入口覆盖

验证 /compatibility 不触发文件读取、运行、预览或导出

同步 AI 游戏创作 App 技术方案和决策记录
This commit is contained in:
AIGameCreator App
2026-07-04 13:47:53 +08:00
parent 345591e3c6
commit 6d2e1ffb3a
4 changed files with 229 additions and 2 deletions
+105
View File
@@ -1876,6 +1876,7 @@ const chatCommandHelp = [
'/rules:查看玩法操作与规则',
'/tutorial:查看新手引导检查',
'/mobile:查看移动试玩检查',
'/compatibility:准备兼容性说明',
'/accessibility:查看可读性与无障碍检查',
'/performance:查看性能与加载检查',
'/polish:查看试玩前打磨清单',
@@ -2653,6 +2654,89 @@ function summarizeProjectMobilePlaytestGuide(
};
}
function summarizeProjectCompatibilityNotes(
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() ||
'暂无';
const commandRuns = nextManifest.commandRuns ?? [];
const staticSmokePassed =
commandRuns.some(
(commandRun) =>
commandRun.commandId === 'game.static_smoke' &&
commandRun.status === 'completed',
) ||
Boolean(
trace?.steps.some((step) =>
step.toolCalls.some(
(toolCall) =>
toolCall.toolId === 'game.static_smoke' && toolCall.status === 'ok',
),
),
);
const inputSummary = tracePassed
? '键盘优先;触屏按 /mobile 复查'
: '待原型通过后复查键盘 / 触屏';
let draftCommand = '/mobile';
let draftCommandLabel = '查看移动试玩';
if (!trace) {
draftCommand = '/next';
draftCommandLabel = '查看下一步';
} else if (blockedTrace) {
draftCommand = '/review';
draftCommandLabel = '查看评审';
} else if (!tracePassed) {
draftCommand = '/trace';
draftCommandLabel = '查看 trace';
} else if (!previewRunning) {
draftCommand = '/run';
draftCommandLabel = '启动试玩';
}
return {
text: [
'兼容性说明:',
`- 项目:${nextManifest.name}`,
`- 目标:${goal}`,
`- 当前状态:${
tracePassed
? `最近 run 已通过${trace?.runId ? ` ${trace.runId}` : ''}`
: trace
? `最近 run 未通过 ${trace.status} / ${trace.stopReason}`
: '暂无最近 run'
} ${previewSummary}`,
`- 自检:${staticSmokePassed ? 'game.static_smoke 已通过' : '未见静态自检通过'}`,
`- 输入兼容:${inputSummary}`,
'- 推荐环境:桌面 Chrome / Edge 最新版;本机 127.0.0.1 预览;移动浏览器只做早期体验',
'- 不承诺:旧浏览器、低端设备、离线模式、云存档、账号同步、手柄或多端数据一致',
'- 反馈口径:设备 / 浏览器 / 输入方式 / 截图或录屏;问题记录走 /bug-report',
'- 参考:/mobile/accessibility/performance/known-issues',
'- 边界:只准备兼容性说明;不读取文件;不启动或打开预览;不导出试玩包;不上传云端;不发布作品;不写项目',
`- 建议:${draftCommand}`,
].join('\n'),
draftCommand,
draftCommandLabel,
};
}
function summarizeProjectAccessibilityGuide(
nextManifest: GameCreationAppManifest,
trace: GameCreationAgentRunTrace | null,
@@ -5981,6 +6065,7 @@ function summarizeNextProjectActions(
addSuggestion('查看玩法操作与规则', '/rules');
addSuggestion('查看新手引导检查', '/tutorial');
addSuggestion('查看移动试玩检查', '/mobile');
addSuggestion('准备兼容性说明', '/compatibility');
addSuggestion('查看可读性与无障碍检查', '/accessibility');
addSuggestion('查看性能与加载检查', '/performance');
addSuggestion('查看试玩前打磨清单', '/polish');
@@ -9827,6 +9912,26 @@ export function App() {
return;
}
if (prompt === '/compatibility') {
if (!requireChatProjectForUserAction()) {
return;
}
const summary = summarizeProjectCompatibilityNotes(
manifest,
agentRunTrace,
);
setMessages((current) => [
...current,
{
role: 'assistant',
text: summary.text,
draftCommand: summary.draftCommand,
draftCommandLabel: summary.draftCommandLabel,
},
]);
return;
}
if (prompt === '/accessibility' || prompt === '/a11y') {
if (!requireChatProjectForUserAction()) {
return;
@@ -2955,6 +2955,123 @@ describe('AI 游戏创作 App 界面边界', () => {
),
).toHaveLength(commandCountsBeforeMobile.exportList);
const commandCountsBeforeCompatibility = {
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('/compatibility');
const compatibilityMessages = await screen.findAllByText(/兼容性说明:/);
const compatibilityMessage =
compatibilityMessages[compatibilityMessages.length - 1];
expect(compatibilityMessage.textContent).toContain('项目:未命名游戏原型');
expect(compatibilityMessage.textContent).toContain(
'目标:做一个厨房弹幕游戏',
);
expect(compatibilityMessage.textContent).toContain(
'当前状态:最近 run 已通过 run-main-shortcut-trace;预览 未启动',
);
expect(compatibilityMessage.textContent).toContain(
'自检:game.static_smoke 已通过',
);
expect(compatibilityMessage.textContent).toContain(
'输入兼容:键盘优先;触屏按 /mobile 复查',
);
expect(compatibilityMessage.textContent).toContain(
'推荐环境:桌面 Chrome / Edge 最新版;本机 127.0.0.1 预览;移动浏览器只做早期体验',
);
expect(compatibilityMessage.textContent).toContain(
'不承诺:旧浏览器、低端设备、离线模式、云存档、账号同步、手柄或多端数据一致',
);
expect(compatibilityMessage.textContent).toContain(
'反馈口径:设备 / 浏览器 / 输入方式 / 截图或录屏;问题记录走 /bug-report',
);
expect(compatibilityMessage.textContent).toContain(
'参考:/mobile/accessibility/performance/known-issues',
);
expect(compatibilityMessage.textContent).toContain(
'边界:只准备兼容性说明;不读取文件;不启动或打开预览;不导出试玩包;不上传云端;不发布作品;不写项目',
);
expect(compatibilityMessage.textContent).toContain('建议:/run');
const compatibilityMessageList = document.querySelector('.message-list');
expect(compatibilityMessageList).not.toBeNull();
const compatibilityDraftButtons = within(
compatibilityMessageList as HTMLElement,
).getAllByRole('button', { name: '启动试玩' });
fireEvent.click(
compatibilityDraftButtons[compatibilityDraftButtons.length - 1],
);
expect(screen.getByLabelText('创作想法')).toHaveProperty('value', '/run');
expect(
invoke.mock.calls.filter(
([command]) => command === 'get_local_game_manifest',
),
).toHaveLength(commandCountsBeforeCompatibility.manifestRead);
expect(
invoke.mock.calls.filter(
([command]) => command === 'read_local_project_file',
),
).toHaveLength(commandCountsBeforeCompatibility.fileRead);
expect(
invoke.mock.calls.filter(
([command]) => command === 'list_local_project_files',
),
).toHaveLength(commandCountsBeforeCompatibility.fileList);
expect(
invoke.mock.calls.filter(
([command]) => command === 'run_limited_local_command',
),
).toHaveLength(commandCountsBeforeCompatibility.runLocal);
expect(
invoke.mock.calls.filter(
([command]) => command === 'start_local_game_preview',
),
).toHaveLength(commandCountsBeforeCompatibility.startPreview);
expect(
invoke.mock.calls.filter(
([command]) => command === 'open_local_game_preview',
),
).toHaveLength(commandCountsBeforeCompatibility.openPreview);
expect(
invoke.mock.calls.filter(
([command]) => command === 'export_local_project_package',
),
).toHaveLength(commandCountsBeforeCompatibility.exportPackage);
expect(
invoke.mock.calls.filter(
([command]) => command === 'list_local_project_export_packages',
),
).toHaveLength(commandCountsBeforeCompatibility.exportList);
expect(
invoke.mock.calls.filter(
([command]) => command === 'control_agent_run',
),
).toHaveLength(commandCountsBeforeCompatibility.controlAgentRun);
const commandCountsBeforeAccessibility = {
manifestRead: invoke.mock.calls.filter(
([command]) => command === 'get_local_game_manifest',
@@ -4726,6 +4843,7 @@ describe('AI 游戏创作 App 界面边界', () => {
expect(screen.getByText(/查看玩法操作与规则:\/rules/)).not.toBeNull();
expect(screen.getByText(/查看新手引导检查:\/tutorial/)).not.toBeNull();
expect(screen.getByText(/查看移动试玩检查:\/mobile/)).not.toBeNull();
expect(screen.getByText(/准备兼容性说明:\/compatibility/)).not.toBeNull();
expect(
screen.getByText(/查看可读性与无障碍检查:\/accessibility/),
).not.toBeNull();
@@ -12466,6 +12584,7 @@ describe('AI 游戏创作 App 界面边界', () => {
expect(screen.getByText(/\/rules:查看玩法操作与规则/)).not.toBeNull();
expect(screen.getByText(/\/tutorial:查看新手引导检查/)).not.toBeNull();
expect(screen.getByText(/\/mobile:查看移动试玩检查/)).not.toBeNull();
expect(screen.getByText(/\/compatibility:准备兼容性说明/)).not.toBeNull();
expect(
screen.getByText(/\/accessibility:查看可读性与无障碍检查/),
).not.toBeNull();
@@ -3874,6 +3874,7 @@
- 2026-07-03 调整:普通用户通过聊天输入 `/rules` 查看玩法操作与规则,只基于当前 manifest、最近 run trace.taskGraph、trace artifacts 和 steps 汇总玩法目标、操作 / 胜负 / 重开口径、设计与入口产物状态、相关任务和最近程序 / 试玩步骤,并提供 `/read game/game_design.md``/agent-resume 操作说明:...``/next` 草稿;该入口不得触发 Tauri 读写、不得读取设计文件、不得启动预览或继续 run,也不得新增普通用户规则面板。
- 2026-07-03 调整:普通用户通过聊天输入 `/tutorial` 查看新手引导检查,只基于当前 manifest、最近 run trace、preview 和任务状态汇总首屏目标、首局 30 秒引导、原型证据、试玩任务、最近引导证据和补齐项,并提供 `/rules``/review``/agent-resume 新手引导:...``/open-preview``/run` 草稿;该入口不得触发 Tauri 读写、不得读取设计文件、不得启动或打开预览、不得直接继续 run,也不得新增普通用户引导面板。
- 2026-07-03 调整:普通用户通过聊天输入 `/mobile` 查看移动试玩检查,只基于当前 manifest、最近 run trace、preview 和任务状态汇总移动试玩目标、键盘 / 触屏输入口径、原型证据、移动检查项、关联任务和最近移动相关步骤,并提供 `/rules``/review``/agent-resume 移动试玩:...``/open-preview``/run` 草稿;该入口不得触发 Tauri 读写、不得读取代码文件、不得启动或打开预览、不得直接继续 run,也不得新增普通用户移动适配面板。
- 2026-07-04 调整:普通用户通过聊天输入 `/compatibility` 准备兼容性说明,只基于当前 manifest、最近 run trace、preview 和静态自检状态汇总推荐环境、输入兼容、不承诺范围、反馈口径和参考命令,并提供 `/run``/mobile``/review``/trace``/next` 草稿;该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览、不得导出试玩包、不得上传云端、不得发布作品、不得写项目,也不得新增普通用户兼容性面板。
- 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 读写、不得读取文件、不得启动预览、不得导出试玩包、不得写项目,也不得新增普通用户打磨面板。
@@ -3921,7 +3922,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``/blockers``/ready``/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``/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``/performance``/polish``/blockers``/ready``/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``/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 读写,也不得新增普通用户轮次面板。
@@ -109,6 +109,7 @@ game-project/
- 聊天输入 `/rules` 可在普通聊天消息里查看玩法操作与规则口径,不读取设计文件、不启动预览、不直接继续 run,也不新增普通用户规则面板。
- 聊天输入 `/tutorial` 可在普通聊天消息里查看新手引导检查,不读取设计文件、不启动或打开预览、不直接继续 run,也不新增普通用户引导面板。
- 聊天输入 `/mobile` 可在普通聊天消息里查看移动试玩检查,不读取代码文件、不启动或打开预览、不直接继续 run,也不新增普通用户移动适配面板。
- 聊天输入 `/compatibility` 可在普通聊天消息里准备兼容性说明,不读取文件、不启动或打开预览、不导出试玩包、不上传云端、不发布作品、不写项目,也不新增普通用户兼容性面板。
- 聊天输入 `/accessibility` 可在普通聊天消息里查看可读性与无障碍检查,不读取代码或 trace 文件、不启动或打开预览、不直接继续 run,也不新增普通用户无障碍面板。
- 聊天输入 `/performance` 可在普通聊天消息里查看性能与加载检查,不读取产物或日志文件、不启动或打开预览、不直接继续 run,也不新增普通用户性能面板。
- 聊天输入 `/polish` 可在普通聊天消息里查看试玩前打磨清单,不读取文件、不启动预览、不导出试玩包、不写项目,也不新增普通用户打磨面板。
@@ -163,6 +164,7 @@ game-project/
- `/rules` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖:只基于当前已加载 manifest、最近 run trace.taskGraph、trace artifacts 和 steps 汇总玩法目标、操作 / 胜负 / 重开口径、设计与入口产物状态、相关任务和最近程序 / 试玩步骤,提供 `/read game/game_design.md``/agent-resume 操作说明:...``/next` 草稿,不触发 Tauri 读写、不读取设计文件、不启动预览或继续 run、不新增普通用户规则面板。
- `/tutorial` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖:只基于当前已加载 manifest、最近 run trace、preview 和任务状态汇总首屏目标、首局 30 秒引导、原型证据、试玩任务、最近引导证据和补齐项,提供 `/rules``/review``/agent-resume 新手引导:...``/open-preview``/run` 草稿,不触发 Tauri 读写、不读取设计文件、不启动或打开预览、不直接继续 run、不新增普通用户引导面板。
- `/mobile` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖:只基于当前已加载 manifest、最近 run trace、preview 和任务状态汇总移动试玩目标、键盘 / 触屏输入口径、原型证据、移动检查项、关联任务和最近移动相关步骤,提供 `/rules``/review``/agent-resume 移动试玩:...``/open-preview``/run` 草稿,不触发 Tauri 读写、不读取代码文件、不启动或打开预览、不直接继续 run、不新增普通用户移动适配面板。
- `/compatibility` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖:只基于当前已加载 manifest、最近 run trace、preview 和静态自检状态准备推荐环境、输入兼容、不承诺范围、反馈口径和参考命令,提供 `/run``/mobile``/review``/trace``/next` 草稿,不触发 Tauri 读写、不读取文件、不启动或打开预览、不导出试玩包、不上传云端、不发布作品、不写项目、不新增普通用户兼容性面板。
- `/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 读写、不读取文件、不启动预览、不导出试玩包、不写项目、不新增普通用户打磨面板。
@@ -301,7 +303,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``/blockers``/ready``/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``/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``/compatibility``/accessibility``/performance``/polish``/blockers``/ready``/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``/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 或历史仍由用户发送对应草稿并走原权限流。