---
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`。

本轮确认的核心结论：

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

因此，实施顺序固定为：

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

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

## 下一步

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