AgoraIO-Extensions / AgoraIO-Extensions/agent-infra

design(web): confirm Platform Pilot prototype with OpenDesign Cloud

Offen
#400 2 Kommentare 0 Reaktionen 1 zugewiesene Person Beansprucht von @LichKing-2234 Auf GitHub ansehen
enhancement needs-triage
Vorherrschende Sprache
TypeScript
Sterne
0
Forks
0
Ø Merge
8 Std. 51 Min.
Gemergte PRs (30 T.)
99

Beschreibung

## Problem

Platform Pilot 已有管理页面实现,#192 即将交付对话体验,但当前交付记录缺少覆盖导航、管理与对话流程的可追溯原型及委托决策与独立验证。工程 Spec 已约定 Tailwind CSS + shadcn/ui,却没有可供实现方共同遵循的页面布局、交互状态和设计确认产物。仅通过功能测试不能证明这些用户体验已经得到确认。

本票落实已确认的交付顺序:通过 OpenDesign Cloud 的 MCP 能力生成 Platform Pilot 原型,由用户授权的 coordinator 决策并经独立 Reviewer 验证可识别版本后,#192 才进入界面实现与验收。#389 依据现有组件库配置进行技术迁移,可独立推进,不依赖本票。

## Scope

- 依据 Agent Platform M1 PRD、当前工程 Spec、#149 的首个 Pilot 范围及 #192 的交互契约,整理覆盖导航、Agent 列表/详情、申请与审批、Owner 配置、文本对话与历史的设计 brief。
- 通过 OpenDesign Cloud 的 MCP 能力生成可浏览的原型;保留 brief、生成来源、可访问的原型链接、可回读设计产物与明确版本。调用失败、产物未回读或仅有文字描述时,不能标记为已生成或已完成。
- 原型遵循已选 Tailwind CSS + shadcn/ui 与 `apps/web/components.json`,明确通用控件对应的 shadcn/ui 组件及必要的布局/样式约束,不另选 UI 组件库。
- 覆盖员工、Owner、管理员的代表性流程,以及 loading、empty、disabled、pending、validation error、permission denied 状态;对话覆盖提交、流式回复、停止、重生成、模型选择、繁忙、断线重连、权限失效、会话不可用和结果/PR 链接。
- 同时交付桌面与移动布局,验证文字、表单、长内容、滚动、导航、键盘焦点和错误反馈。
- 将最终产物版本或内容摘要、页面/状态清单、浏览器验证结果以及coordinator 针对该版本的委托决策记录及独立 Reviewer 验证记录到本票。确认后发生实质交互或范围变化时,受影响部分须重新确认。
- #192 以本票确认后的设计作为 UI 实现依据;其他既有管理页面的视觉改版需另行明确实施范围。本票不隐式扩大 #389 的组件迁移职责。
- 原型只覆盖 Platform 页面。遵循 #387 的独立 Connection Web 结论,Platform 可呈现 Agent Action 配置及连接/授权跳转入口,但不承载个人 Connection、OAuth、Provider 或 Connection 审计管理页面。
- 不实现生产页面、修改后端/数据库或发布产品;首个文本 Pilot 不加入附件、结果文件传输、企微、其他 Runtime 或 PRD Roadmap 功能。仅使用合成数据,原型不含真实会话、账号凭证或内部部署信息。

## Acceptance criteria

- [ ] **AC-1:** brief 和页面/状态清单可回读,明确对齐 Agent Platform PRD、#149、#192 与 #387;没有未经确认的产品扩展。
- [ ] **AC-2:** 存在经 OpenDesign Cloud MCP 生成并成功回读的可浏览原型,生成来源、产物位置和版本可追溯;不能用工具安装、生成请求已发出或文字方案代替原型产物。
- [ ] **AC-3:** Scope 内的代表性导航、管理和对话流程及错误/恢复状态具有可检查的设计,通用控件映射到已约定的 shadcn/ui。
- [ ] **AC-4:** 桌面与移动视口的浏览器检查通过,截图与交互证据对应同一产物版本,没有文字溢出、内容遮挡或不可操作的关键控件。
- [ ] **AC-5:** coordinator 依据用户授权确认同一最终原型版本,独立 Reviewer 验证通过;决策和验证记录与版本/摘要、页面清单和未决事项一并可回读;缺少任一记录时本票保持未完成,不能宣称 #192 的设计前置已通过。
- [ ] **AC-6:** #192 能从本票取得完整设计交接材料;#389 与本票保持无相互 blocker 的并行关系,Connection 管理 Web 和生产功能实现均未被本票吸收。

## Validation

- 逐项核对 brief、原型与 PRD/Pilot/生成契约中允许的用户行为;记录任何仍需产品决定的问题,不把原型自行新增行为作为需求依据。
- 通过 MCP 回读完整设计产物,记录可识别的版本或内容摘要;使用浏览器验证代表性流程、关键状态、桌面/移动布局与可访问性。
- 将 coordinator 委托决策及独立 Reviewer 验证绑定到同一版本;交接时再次回读链接、产物与确认记录,确保没有引用被覆盖后的不同设计。
- 如交付过程涉及仓库文件修改,先落实对应 primary Issue 与工作区隔离,并执行 `AGENTS.md` 要求的适用完整验证;外部原型本身不以仓库 CI 通过作为完成证据。

## Blocked by

None

## 决策授权

2026-09-09 用户明确授权 coordinator 接管 #144 固定工作集并决定范围内产品、设计和技术方案。本票据此采用 coordinator 对具体 artifact 版本的委托设计决策,加独立 Reviewer 的桌面/移动、流程和可访问性验证。该授权不表示用户已查看或确认尚未生成的原型,不替代仓库对 PR 当前 head 要求的 Human Validation 或 CODEOWNER Approve。OpenDesign 产物、版本绑定和真实浏览器验证要求保持。

Beitragsleitfaden

Für dieses Repository ist kein Beitragsleitfaden indexiert

Bewertung

Dieses Issue wurde noch nicht bewertet.

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.