doc_id: MTG-202606-002 feature_id: FEAT-202606-006-agent-semantic-interaction type: meeting title: Agent 语义交互与命令治理设计交叉评审记录 status: reviewing owner: 医梦研发团队 created_at: 2026-06-29 updated_at: 2026-07-01 reviewers:

产品负责人
架构负责人
后端负责人
终端负责人
FastGPT 联调负责人 related_docs:
PRD-202606-002
ODS-202606-002
DDS-202606-004
DES-202606-003
API-202606-004
TST-202606-001
ADR-202606-001 related_modules:
emoon-openplatform
emoon-ai-agent
emoon-ai-command
emoon-ai-mcp
emoon-system tags:
设计评审
交叉审查
Agent
FastGPT ---

Agent 语义交互与命令治理设计交叉评审记录

基本信息

项	内容
日期	2026-06-29
评审方式	需求提出人 + Codex 设计讨论 + Claude 交叉审查 + Codex 修订复核
评审范围	需求、概要/详细设计、ADR、接口、OpenAPI、迁移、测试计划、工程规约
记录人	医梦研发团队

评审结论

本轮交叉评审未发现新的阻塞性设计问题。文档已达到提交产品、架构、开发、终端和 FastGPT 联调负责人正式评审的条件，但尚未获得这些角色的批准，所有正式文档继续保持 reviewing，专题继续保持 designing。

本轮确认的核心结论：

卡片不再作为 Agent 流程节点；
MVP 核心运行时概念收敛为 TaskState、ResultSnapshot 和 Command；
SemanticResponse 是薄传输 DTO，最小必填为 turnId + answer；
FastGPT 只获得后端生成的只读 ToolCatalog；
查询参数校验失败最多修复一次，随后转为用户可理解的澄清，不暴露内部 proposal；
MVP 不建设动态展示模板表或 DSL，领域 ViewModel 随代码版本管理；
实施采用阶段零到阶段三门禁，最终单次切换，不维护生产双轨；
当前强制工程规约与历史 Card/Dify 基线已经物理分离。
本专题是批量业务智能体建设的前置能力，完成前不扩展旧链式 Card 模式；
后续智能体先设计目标、TaskState、工具和 Command，最后按需增加可选 Card。

文档评审检查

文档	检查重点	结论
`PRD-202606-002`	目标、非目标、范围、18 条验收标准	原 15 条通过交叉评审；新增 3 条待正式确认
`ODS-202606-002`	模块边界、主链路、外部依赖、风险	通过交叉评审
`DDS-202606-004`	数据、状态机、ToolCatalog、异常、安全、测试	通过交叉评审
`ADR-202606-001`	备选方案、决策、正负后果、迁移原则	通过交叉评审
`API-202606-004`	路径、鉴权、SSE、错误码、幂等	通过交叉评审
OpenAPI v2	5 个路径、最小 SemanticResponse、Schema/$ref	通过自动校验
`DES-202606-003`	分阶段门禁、单次切换、整体回退	通过交叉评审
`TST-202606-001`	35 个用例、回归、安全和阶段零门禁	原 33 个通过交叉评审；新增 2 个待正式确认
`STD-202605-001/002`	当前规则纯 v3、历史基线隔离	通过交叉评审

Claude 反馈处理

反馈	判断	处理
概念过多	合理	核心概念收敛为三个，合并应用服务
SemanticResponse 可能成为瓶颈	合理	降为最小薄 DTO，去除根级风险和展示提示
proposal 交互不清	合理	取消独立协议，工具参数即候选查询条件
应维护 v1/v2 双轨	部分合理	接受分阶段验证，不接受生产双轨；最终单次切换
FastGPT ToolCatalog 缺失	合理	补充来源、过滤、Schema、版本和下发边界
Presentation 模板边界缺失	合理	MVP 改为代码内版本化 ViewModel，不建模板表
工程约束新旧混写	合理	当前 v3 与两份 legacy 文档物理分离

尚需负责人确认

事项	负责人	进入开发前要求	状态
需求范围和非目标	产品/业务负责人	批准 `PRD-202606-002`	open
模块边界和单次切换决策	架构负责人	接受 `ADR-202606-001`	open
数据模型、状态机和异常策略	后端负责人	批准 `DDS-202606-004`	open
SSE、interaction 和命令确认	终端负责人	批准 `API-202606-004`	open
ToolCatalog 实际下发方式	FastGPT 联调负责人	确认阶段零验证方案	open
35 个用例和回归范围	开发/测试负责人	批准 `TST-202606-001`	open

非阻塞实施前提

FastGPT 目标部署版本尚未经过阶段零实测；这是开发门禁，不是文档缺口。
性能阈值需在实际测试环境建立基线后填写；当前只固定“不阻塞文本”的原则。
现有 Card/Dify 代码仍是仓库事实；在最终切换前不得继续扩展，但不在本轮修改。

平台与智能体建设顺序结论

经补充评审，确认本专题不是普通挂号功能优化，而是后续智能体共同依赖的平台协议迁移。如果先建设大量智能体，旧 Card 协议会进入每个 Agent 工作流、后端编排、终端交互和测试，后续迁移成本随智能体数量增长。

因此，实施顺序固定为：

完成本专题中台公共能力；
使用挂号 Agent 完成无 Card 依赖的纵向验收；
达到迁移方案定义的批量智能体建设准入门槛；
再启动后续智能体规模化设计与开发。

Card 在后续智能体中仅作为可选 Presentation：可以提升候选对比、快捷选择和确认摘要的可读性，不得定义流程、保存任务事实、控制状态迁移、承载可信写参数或成为唯一交互通道。

下一步

由上述负责人逐项确认并在本文待办表留痕；
全部确认后，将 ADR、PRD、设计、API 和测试计划更新为 approved；
创建 开发进度.md，只启动阶段零 FastGPT 能力验证；
阶段零未通过时停止，不进入查询链开发。

设计交叉评审记录.md 6.0 KB Bezpośredni odnośnik Historia Czysty