[F14] chat 主屏截图级保真度评审达标(≥9)并落盘
- Dominant language
- TypeScript
- Stars
- 0
- Forks
- 0
- Avg merge
- 1h 7m
- Merged PRs (30d)
- 969
Description
## 交付契约(user_visible_behavior)
rev-uiux 角色对 chat 主屏按 chat-main-fidelity-rubric.md 十维做正式截图级评审,每维得分与扣分理由写入 uiux-review-log.jsonl;针对『技术合规但观感局促』的扣分项(卡片内边距/行高/信息密度)做视觉微调;重评直到 chat 达到 ≥9 门槛;数据缺口类维度如实记录为超范围产品缺口,不伪造数据凑分。
## Story
[requirements/09-screenshot-fidelity-review.md](https://github.com/boardx/workspacex/blob/main/phases/phase-12-uiux-foundation/requirements/09-screenshot-fidelity-review.md) — 章节 `R3`
## 验证(完成的唯一标准:每条命令退出码 0)
- [ ] `pnpm --filter api exec vitest run tests/uiux/review-log-chat-threshold.test.ts`
- [ ] `pnpm --filter web exec playwright test -c playwright.chat-shots.config.ts -g 'chat fidelity shots'`
证据落盘:`phases/phase-12-uiux-foundation/sprints/sprint-01/evidence/F14.verify.log`
## 实现指引(notes)
依据等级:[原型](对既有 chat 主屏的评审+微调)+ 评分门槛为人类已裁决收窄值(≥9,见 MEMORY『profile/org系列UIUX验收线放宽到9分』;chat 沿用 chat-main-fidelity-rubric.md)。has_ui:涉可见 UI 微调,需随所属束签核(R8)。R7/R10:评分只由 rev-uiux 角色在真实截图上打,禁止只读源码推断分数;本 feature 需在前序可见改动(F01/F02/F04/F09/F10/F11)落地后进行才有意义评审。R11 拆分:chat 独立(本 feature),profile+org 为 F15,工作量 L 合计 6 点。vitest 断言日志中 chat 记录总分 ≥9(结构性门槛断言,避免依赖主观打分过程);playwright 复用现有 playwright.chat-shots.config.ts 产出截图证据。切分最不确定之一:R4-E1 指出评审可能发现维度对应产品数据缺口无法靠 UI 修复解决(先例 #831/#728 直接移除维度),届时 ≥9 门槛的达成路径可能变为『移除数据不支撑的维度后重算』而非硬修。
## 设计参照
(无 UI 或沿用现有界面)
## 前置依赖
- `F13` — 已就绪
- `F04` — 已就绪
- `F11` — 已就绪
## 元数据
| phase | sprint | 能力平面 | 优先级 | wave | area |
|---|---|---|---|---|---|
| 12 | 01 | - | Pundefined | - | fidelity-review |
## 开工流程(agent 必读)
> 本 issue 是仓库的**只读投影**;权威是 [`phases/phase-12-uiux-foundation/feature_list.json`](https://github.com/boardx/workspacex/blob/main/phases/phase-12-uiux-foundation/feature_list.json)。若两者不一致,以仓库为准。
1. 环境:`./init.sh`(验证失败先修基础状态,别在坏地基上开工)。
2. 认领:`pnpm harness claim --phase 12 --feature F14 --owner <你的-agent-id>`(同一 owner 同时最多一个 in_progress)。
3. 读上下文:[`requirements/`](https://github.com/boardx/workspacex/blob/main/phases/phase-12-uiux-foundation/requirements)(原始需求)、[`contracts/`](https://github.com/boardx/workspacex/blob/main/phases/phase-12-uiux-foundation/contracts)(本 feature 所属契约束:`ui.md` 给组件落点与 data-testid,`usecases.md` 给失败模式,`design-signoff.md` 给签核状态)、[`sprints/sprint-01/session-handoff.md`](https://github.com/boardx/workspacex/blob/main/phases/phase-12-uiux-foundation/sprints/sprint-01/session-handoff.md)(上一轮交接)。
4. 实现:只做本 feature 的最小实现,不顺手重构无关区域;不碰 `active-features.json`(脚本派生只读)。
5. 验证:逐条跑上方 verification,输出留到 `phases/phase-12-uiux-foundation/sprints/sprint-01/evidence/F14.verify.log`;然后 `pnpm harness verify --sprint 12/01 --feature F14` 门控转 passing——**不允许手改 status**。
6. 提交:分支 `worker/-12-f14-`,PR 关联本 issue(`Closes #<本 issue 号>`),收尾更新 progress.md 与 session-handoff.md。
完整硬约束见 [`AGENTS.md`](https://github.com/boardx/workspacex/blob/main/AGENTS.md);多 agent 协作规则见 [`.harness/instructions/multi-agent-coordination.md`](https://github.com/boardx/workspacex/blob/main/.harness/instructions/multi-agent-coordination.md)。
Contributor guide
No contributing guide indexed for this repository
Research direction
Start with phases/phase-12-uiux-foundation/feature_list.json, requirements/09-screenshot-fidelity-review.md section R3, and the contracts, then run ./init.sh. Review the existing chat screenshots and run the listed Vitest and Playwright commands. Done means the ten-dimensional review is recorded in uiux-review-log.jsonl, any supported visual adjustments are included, both commands exit 0, and evidence is saved to F14.verify.log.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- playwright, typescript
- Domain
- design, frontend, testing
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100