[F16] 全站终验收官:机械门控全绿 + 十维评分重算并附证据
- Dominant language
- TypeScript
- Stars
- 0
- Forks
- 0
- Avg merge
- 1h 7m
- Merged PRs (30d)
- 969
Description
## 交付契约(user_visible_behavior)
全量跑通 lint-design.sh(含新增 U9 第三方组件规则、扩展后 U7a 图片规则)、check-token-contrast.mjs 对比度门控、axe-core 全站扫描(chat/profile/org-admin/canvas)、F05/F06 的键盘走查自动化用例,均无回归;./init.sh 基础验证与 pnpm harness doctor 三条检查通过;对照《十分制评估》十维评分逐维重算并贴证据;未闭合缺口如实记录为下一阶段待办,不虚报达标。
## Story
[requirements/10-final-verification-sweep.md](https://github.com/boardx/workspacex/blob/main/phases/phase-12-uiux-foundation/requirements/10-final-verification-sweep.md) — 章节 `R3`
## 验证(完成的唯一标准:每条命令退出码 0)
- [ ] `pnpm --filter web run lint:design`
- [ ] `pnpm --filter web run contrast`
- [ ] `pnpm --filter web exec playwright test -c playwright.config.ts -g 'axe full-site'`
- [ ] `pnpm --filter web exec playwright test -c playwright.config.ts -g 'keyboard'`
证据落盘:`phases/phase-12-uiux-foundation/sprints/sprint-01/evidence/F16.verify.log`
## 实现指引(notes)
依据等级:[Backlog](IT-10;本阶段收官治理性 feature)。R8:本身不产出新可见 UI(除验证中发现的小修复),一般不需新签核,但需确认阶段级 design-coherence.md(一致性复核)已完成。R2:依赖前 9 个需求(F01-F15)全部 passing 后触发。R7:终验分数必须有可复现证据链,不凭印象打分;R4-E2 分数未达 10 分如实报告差距而非调整标准凑分。verification 覆盖 lint-design/contrast/axe/键盘走查四类机械门控;init.sh 与 harness doctor 由收尾流程另行执行并写入 evidence。
## 设计参照
(无 UI 或沿用现有界面)
## 前置依赖
- `F01` — 已就绪
- `F02` — 已就绪
- `F03` — 已就绪
- `F04` — 已就绪
- `F05` — 已就绪
- `F06` — 已就绪
- `F07` — 已就绪
- `F08` — 已就绪
- `F09` — 已就绪
- `F10` — 已就绪
- `F11` — 已就绪
- `F12` — 已就绪
- `F13` — 已就绪
- `F14` — ⚠ 未就绪(not_started),就绪前不要开工
- `F15` — 已就绪
## 元数据
| phase | sprint | 能力平面 | 优先级 | wave | area |
|---|---|---|---|---|---|
| 12 | 01 | - | Pundefined | - | governance |
## 开工流程(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 F16 --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/F16.verify.log`;然后 `pnpm harness verify --sprint 12/01 --feature F16` 门控转 passing——**不允许手改 status**。
6. 提交:分支 `worker/-12-f16-`,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 by running ./init.sh and checking F14 status, then read requirements/10-final-verification-sweep.md, the phase contracts, and sprint-01/session-handoff.md. Run the four listed pnpm verification commands and record results in phases/phase-12-uiux-foundation/sprints/sprint-01/evidence/F16.verify.log. Done means every command exits 0, scoring evidence is reproducible, and harness verification passes without overstating gaps.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- playwright, typescript
- Domain
- accessibility, testing
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100