补充任务验收标准聊天入口

新增 /criteria 当前任务验收摘要和任务草稿

补充 /next 与 /help 的验收入口覆盖

同步技术方案和项目决策记录
This commit is contained in:
AIGameCreator App
2026-07-03 17:13:07 +08:00
parent 3a4504a04f
commit 3353ea37ef
4 changed files with 151 additions and 2 deletions
+100
View File
@@ -1869,6 +1869,7 @@ const chatCommandHelp = [
'/status:查看项目状态',
'/brief:生成当前项目简报',
'/risks:查看当前项目风险',
'/criteria:查看当前任务验收标准',
'/review:查看 Evaluator 评审和返工焦点',
'/context:查看生成上下文来源',
'/timeline:查看项目活动时间线',
@@ -2168,6 +2169,83 @@ function summarizeProjectRisks(
};
}
function summarizeProjectAcceptanceCriteria(
nextManifest: GameCreationAppManifest,
trace: GameCreationAgentRunTrace | null,
) {
const tasks = taskRowsFromManifest(nextManifest);
const manifestTasksById = new Map(tasks.map((task) => [task.id, task]));
const traceTasksById = new Map(
trace?.taskGraph.tasks.map((task) => [task.id, task]) ?? [],
);
const selectedTasks: Array<{
task: GameCreationAppTaskState;
marker: string;
}> = [];
const seenTaskIds = new Set<string>();
const addTask = (taskId: string, marker: string) => {
if (seenTaskIds.has(taskId)) {
return;
}
const task = traceTasksById.get(taskId) ?? manifestTasksById.get(taskId);
if (!task) {
return;
}
selectedTasks.push({ task, marker });
seenTaskIds.add(task.id);
};
trace?.taskGraph.activeTaskIds.forEach((taskId) => addTask(taskId, 'active'));
trace?.taskGraph.carriedTaskIds.forEach((taskId) => addTask(taskId, 'carry'));
trace?.taskGraph.readyTaskIds.forEach((taskId) => addTask(taskId, 'ready'));
tasks
.filter((task) => task.status === 'failed')
.forEach((task) => addTask(task.id, '失败'));
if (selectedTasks.length === 0) {
selectGameCreationAppReadyTasks({ tasks }).forEach((task) =>
addTask(task.id, 'ready'),
);
}
if (selectedTasks.length === 0) {
tasks
.filter((task) => task.status !== 'completed')
.slice(0, 3)
.forEach((task) => addTask(task.id, taskStatusLabels[task.status]));
}
const visibleTasks = selectedTasks.slice(0, 6);
const taskLines = visibleTasks.map(({ task, marker }) => {
const criteria =
task.acceptanceCriteria.length > 0
? task.acceptanceCriteria.join('')
: '暂无';
const artifacts =
task.artifacts.length > 0
? task.artifacts.slice(0, 3).join(', ')
: '暂无';
return `- ${marker}${taskGroupLabels[task.group]} / ${task.role} ${task.title}(${task.id}) · ${taskStatusLabels[task.status]} · 验收:${criteria} · 产物:${artifacts}`;
});
if (selectedTasks.length > visibleTasks.length) {
taskLines.push(
`- 还有 ${selectedTasks.length - visibleTasks.length} 个任务`,
);
}
return {
text: [
'当前验收标准:',
trace ? `- Run${trace.runId} · ${formatAgentRunStatus(trace)}` : null,
taskLines.length > 0 ? taskLines.join('\n') : '- 暂无待验收任务',
]
.filter(Boolean)
.join('\n'),
draftCommand: '/tasks',
draftCommandLabel: '查看任务',
};
}
function isAgentRunTracePassed(trace: GameCreationAgentRunTrace | null) {
return (
trace?.status === 'passed' ||
@@ -2669,8 +2747,10 @@ function summarizeNextProjectActions(
});
if (readyTasks.length > 0) {
addSuggestion(`查看 ${readyTasks.length} 个 ready 任务`, '/tasks');
addSuggestion('查看当前任务验收标准', '/criteria');
} else {
addSuggestion('查看任务拆分和等待项', '/tasks');
addSuggestion('查看当前任务验收标准', '/criteria');
}
if (nextManifest.assets.length > 0) {
@@ -6288,6 +6368,26 @@ export function App() {
return;
}
if (prompt === '/criteria') {
if (!requireChatProjectForUserAction()) {
return;
}
const summary = summarizeProjectAcceptanceCriteria(
manifest,
agentRunTrace,
);
setMessages((current) => [
...current,
{
role: 'assistant',
text: summary.text,
draftCommand: summary.draftCommand,
draftCommandLabel: summary.draftCommandLabel,
},
]);
return;
}
if (prompt === '/review') {
if (!requireChatProjectForUserAction()) {
return;
@@ -2243,6 +2243,49 @@ describe('AI 游戏创作 App 界面边界', () => {
),
).toHaveLength(runLocalCountBeforeRisks);
const fileReadCountBeforeCriteria = invoke.mock.calls.filter(
([command]) => command === 'read_local_project_file',
).length;
const manifestReadCountBeforeCriteria = invoke.mock.calls.filter(
([command]) => command === 'get_local_game_manifest',
).length;
const runLocalCountBeforeCriteria = invoke.mock.calls.filter(
([command]) => command === 'run_limited_local_command',
).length;
submitChat('/criteria');
expect(await screen.findByText(/当前验收标准:/)).not.toBeNull();
const criteriaMessages = screen.getAllByText(/当前验收标准:/);
const criteriaMessage = criteriaMessages[criteriaMessages.length - 1];
expect(criteriaMessage.textContent).toContain(
'ready:美术组 / Asset 规划美术资产(art-asset-plan)',
);
expect(criteriaMessage.textContent).toContain(
'验收:角色、场景、UI 和动画需求已映射到画板或本地资产',
);
expect(criteriaMessage.textContent).toContain(
'产物:assets/manifest.art.json',
);
const criteriaDraftButtons = screen.getAllByRole('button', {
name: '查看任务',
});
fireEvent.click(criteriaDraftButtons[criteriaDraftButtons.length - 1]);
expect(screen.getByLabelText('创作想法')).toHaveProperty('value', '/tasks');
expect(
invoke.mock.calls.filter(
([command]) => command === 'read_local_project_file',
),
).toHaveLength(fileReadCountBeforeCriteria);
expect(
invoke.mock.calls.filter(
([command]) => command === 'get_local_game_manifest',
),
).toHaveLength(manifestReadCountBeforeCriteria);
expect(
invoke.mock.calls.filter(
([command]) => command === 'run_limited_local_command',
),
).toHaveLength(runLocalCountBeforeCriteria);
const fileReadCountBeforeReview = invoke.mock.calls.filter(
([command]) => command === 'read_local_project_file',
).length;
@@ -2513,6 +2556,7 @@ describe('AI 游戏创作 App 界面边界', () => {
expect(await screen.findByText(/下一步建议:/)).not.toBeNull();
expect(screen.getByText(/运行自检并启动本地预览:\/run/)).not.toBeNull();
expect(screen.getByText(/查看 .* 个 ready 任务:\/tasks/)).not.toBeNull();
expect(screen.getByText(/查看当前任务验收标准:\/criteria/)).not.toBeNull();
expect(screen.getByText(/查看美术素材:\/art/)).not.toBeNull();
expect(screen.getByText(/查看发布准备清单:\/publish/)).not.toBeNull();
expect(screen.getByText(/查看试玩状态:\/playtest/)).not.toBeNull();
@@ -8410,6 +8454,7 @@ describe('AI 游戏创作 App 界面边界', () => {
).not.toBeNull();
expect(screen.getByText(/\/brief:生成当前项目简报/)).not.toBeNull();
expect(screen.getByText(/\/risks:查看当前项目风险/)).not.toBeNull();
expect(screen.getByText(/\/criteria:查看当前任务验收标准/)).not.toBeNull();
expect(
screen.getByText(/\/review:查看 Evaluator 评审和返工焦点/),
).not.toBeNull();
@@ -3867,6 +3867,7 @@
- 2026-07-03 调整:主窗口 header 常驻项目摘要只从当前已加载的 manifest / trace 派生任务完成数、ready 数、资产来源分布和最近命令结果;未选择工作区时不显示,不为了摘要额外触发 Tauri 读取或写入,也不把任务、文件、run history 或预览开发面板搬进普通用户窗口。
- 2026-07-03 调整:普通用户通过聊天输入 `/brief` 触发项目简报入口,只基于主窗口当前已加载的 manifest、最近 run trace、预览状态、资产数量和最近命令生成聊天内简报,并提供 `/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 调整:普通用户通过聊天输入 `/review` 查看 Evaluator 评审状态,只基于主窗口当前已加载的最近 run trace 派生通过 / 需返工状态、返工焦点、返工路线和最近评审步骤,并提供 `/read .agent/findings.md``/agent-resume ` 草稿;该入口不得直接读取评审文件、不得触发 Tauri 读写,也不得新增普通用户评审面板。
- 2026-07-03 调整:普通用户通过聊天输入 `/context` 查看生成上下文来源,只基于当前 manifest 和最近 run trace 列出项目对话、短期记忆、长期记忆、项目黑板、Agent 对话、Agent 私有记忆、manifest、最近 trace 和最近 LLM 输入路径,并提供 `/read``/memory blackboard` 草稿;该入口不得触发 Tauri 读写、不得读取上下文文件,也不得新增普通用户上下文面板。
- 2026-07-03 调整:普通用户通过聊天输入 `/timeline` 查看项目活动时间线,只基于当前 manifest.commandRuns 和最近 run trace 汇总最近命令、日志读取草稿和最近 Agent 步骤,并提供 `/read``/trace``/history` 草稿;该入口不得触发 Tauri 读写、不得读取日志或 trace 文件,也不得新增普通用户时间线面板。
@@ -3880,7 +3881,7 @@
- 2026-07-03 调整:普通用户通过聊天输入 `/art` 查看美术素材,只基于当前 manifest 盘点图片、视频和序列帧素材的数量、来源、画板接入状态和路径,并提供 `/generate-art 首版核心美术素材``/read assets/manifest.art.json` 草稿;该入口不得触发 Tauri 读写、平台生成、画板同步或新增普通用户美术面板。
- 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 调整:主窗口新增常用生成产物读取入口,只把入口 HTML、设计、数值、美术清单、音频清单和发布说明对应的 `/read` 草稿填入聊天输入框;聊天命令 `/artifacts` 只列出同一组固定读取命令并提供首个读取草稿,`/run-artifacts` 只列出最近 trace 里的产物读取命令并提供首个 `/read` 草稿,`/logs` 只列出固定日志读取命令;实际读取仍走聊天侧 `file.read` 权限流,不直接读本地文件。
- 2026-07-03 调整:普通用户通过聊天输入 `/next` 触发下一步建议入口,只基于主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要生成聊天建议,列出 `/tasks``/trace``/review``/context``/timeline``/playtest``/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 和最近命令摘要生成聊天建议,列出 `/tasks``/criteria``/trace``/review``/context``/timeline``/playtest``/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 读写,也不得新增普通用户轮次面板。
File diff suppressed because one or more lines are too long