From b10a300a0177ea0955a6f1eaf71e73ddd9ef43df Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Mon, 3 Aug 2026 12:44:59 +0800 Subject: [PATCH] docs(prototype): record independent review and handoff --- .gitignore | 4 ++++ README.md | 4 ++-- docs/current-state.md | 18 ++++++++++-------- docs/design/web-login.html | 1 + docs/design/web-task-create.html | 1 + docs/design/web-task-detail.html | 3 ++- docs/design/web-task-workbench.html | 1 + docs/quality-document.md | 10 ++++++---- docs/tasks/T-005.md | 13 +++++++++++++ docs/tasks/T-006.md | 14 ++++++++++++++ 10 files changed, 54 insertions(+), 15 deletions(-) diff --git a/.gitignore b/.gitignore index a4a31de..97b16e7 100644 --- a/.gitignore +++ b/.gitignore @@ -5,6 +5,10 @@ gitea.env.* !gitea.env.example *.stderr.log +# Local browser-prototype verification artifacts +.playwright-mcp/ +*-wide.png + # Python 本地校验缓存 __pycache__/ *.py[cod] diff --git a/README.md b/README.md index 499f572..66f7f56 100644 --- a/README.md +++ b/README.md @@ -46,8 +46,8 @@ MVP 只做**任务自带商品链接**的情形,分两趟跑完: **Phase 0 · 地基。仓库目前只有文档,尚未开始编码。** -下一步:先并行完成 T-005(网页端 MVP 原型)与 T-006(桌面端 MVP 原型)并由人确认, -再进入 T-001 / T-002 骨架和生产实现。 +下一步:T-005(网页端 MVP 原型)与 T-006(桌面端 MVP 原型)的文件和自动检查已完成, +请先人工确认 6 个 HTML 原型,再进入 T-001 / T-002 骨架和生产实现。 详见 [`docs/current-state.md`](docs/current-state.md)。 **生死线是 M2**:真机能按链接打开商品、精确勾选颜色分类和尺码、**读到该 SKU 单价**。 diff --git a/docs/current-state.md b/docs/current-state.md index 50cb28a..bb7303c 100644 --- a/docs/current-state.md +++ b/docs/current-state.md @@ -22,15 +22,16 @@ - 标准启动路径:`./init.ps1`(Windows)/ `./init.sh`。已存在但会因两端目录未初始化而以 退出码 3 结束并列出待办任务——这是预期行为 - 标准验证路径:目前只有 `python scripts/validate_agent_context.py` 可跑通 -- 当前 blocker:生产 UI 实现需先完成人工确认原型;下一步先落成并并行执行 T-005 / T-006。 +- 当前 blocker:T-005 / T-006 原型已实现并通过自动检查,正在等待人工确认;确认前不开始 + 对应生产 UI。 ## 当前目录要点 | 路径 | 状态 | 说明 | | --- | --- | --- | | `docs/` | 已有 | 项目规范化文档,本次已完整生成 | -| `docs/tasks/` | 已有(空) | 任务文件目录,含 `README.md` 与 `_template.md` | -| `docs/design/` | 已有(仅约定) | 原型目录;下一步生成 `web-*.html` 与 `desk-*.html` | +| `docs/tasks/` | 已有(2 个活动任务) | T-005 / T-006 均为 `DOING`,含 `README.md` 与 `_template.md` | +| `docs/design/` | 已有(6 个原型) | web 登录 / 建单 / 工作台 / 详情,desk 执行 / 设备参数;待人工确认 | | `scripts/` | 已有 | `validate_agent_context.py` | | `web/` | **待建** | Go 后端与管理页面(T-001) | | `desk/` | **待建** | Python 桌面端(T-002) | @@ -41,11 +42,12 @@ 任务状态以 `docs/tasks/` 各任务文件 frontmatter 的 `status` 为准。本节只写项目级摘要: - 已完成:无。 -- 正在进行:无。 -- **下一个可领取任务:T-005(网页端 MVP 交互原型)与 T-006(桌面端 MVP 交互原型)。** - 两者无相互依赖、使用 `web-*` / `desk-*` 文件名前缀且 `write_paths` 不重叠,可并行。 -- 原型使用假数据、不调用真实接口、不驱动真机;经人工确认前任务保持 `DOING`。 -- T-001 / T-002 骨架仍可在原型确认后并行,Phase 2 生产页面必须等待相关真机结论。 +- 正在进行:T-005(网页端 MVP 交互原型)、T-006(桌面端 MVP 交互原型)。两个任务的 + HTML 与自动验证均已完成,因 `needs_human_review: true` 保持 `DOING`。 +- **下一步:人工浏览 6 个原型,确认布局、信息密度、唯一主动作和安全文案。** 明确确认后 + 才能把 T-005 / T-006 改为 `DONE`。 +- 原型使用假数据、不调用真实接口、不驱动真机;T-001 / T-002 骨架可在确认后并行, + Phase 2 生产页面还必须等待相关真机结论。 ## 当前可运行内容 diff --git a/docs/design/web-login.html b/docs/design/web-login.html index c0a31fc..723967a 100644 --- a/docs/design/web-login.html +++ b/docs/design/web-login.html @@ -3,6 +3,7 @@ + 登录 · cmbuyer 原型