boardx / boardx/workspacex

[F14] chat 主屏截图级保真度评审达标(≥9)并落盘

Open
#1,876 0 comments 0 reactions 0 assignees View on GitHub
area:fidelity-review sprint:12-01
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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.