From b7ae22a32f1342c45bdf1397325ada0ba3d47b1b Mon Sep 17 00:00:00 2001 From: ila <2+ila@noreply.git.ilapage.cn> Date: Mon, 17 Aug 2026 10:20:35 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=AE=8C=E6=88=90=E4=BB=BB=E5=8A=A1=20?= =?UTF-8?q?#19=20=E5=BD=92=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...E%E6%94%B9%E5%8F%8C%E9%97%A8%E7%A6%81.-.md | 54 ++++++++++++++----- 1 file changed, 40 insertions(+), 14 deletions(-) diff --git a/Task-19-UI%E5%8E%9F%E5%9E%8B%E7%A1%AE%E8%AE%A4%E4%B8%8E%E6%96%87%E5%AD%97%E4%BF%AE%E6%94%B9%E5%8F%8C%E9%97%A8%E7%A6%81.-.md b/Task-19-UI%E5%8E%9F%E5%9E%8B%E7%A1%AE%E8%AE%A4%E4%B8%8E%E6%96%87%E5%AD%97%E4%BF%AE%E6%94%B9%E5%8F%8C%E9%97%A8%E7%A6%81.-.md index 2c2a8f3..eeb2a39 100644 --- a/Task-19-UI%E5%8E%9F%E5%9E%8B%E7%A1%AE%E8%AE%A4%E4%B8%8E%E6%96%87%E5%AD%97%E4%BF%AE%E6%94%B9%E5%8F%8C%E9%97%A8%E7%A6%81.-.md +++ b/Task-19-UI%E5%8E%9F%E5%9E%8B%E7%A1%AE%E8%AE%A4%E4%B8%8E%E6%96%87%E5%AD%97%E4%BF%AE%E6%94%B9%E5%8F%8C%E9%97%A8%E7%A6%81.-.md @@ -1,42 +1,68 @@ # 19 UI原型确认与文字修改双门禁 -- 类型：需求 / 缺陷 / 重构 -- 所属 Epic：# -- 所属 MVP / 版本：# -- 状态：待验收 / 已完成 +- 类型：流程文档 +- 状态：待验收 - 日期：2026-08-17 - Gitea 工单：https://git.ilapage.cn/OPC/dev_harness/issues/19 - Wiki 页面：Task-19-UI原型确认与文字修改双门禁 -- Wiki revision：见本地镜像头 +- 本地镜像：按 #14 规则不自动导出 ## 背景与目标 - +把界面决策前置，减少 Agent 在正式代码上的反复修改和 Token 消耗；同时避免给后端任务、小范围调整和纯显示文案制作无意义的高保真原型。 ## 最终方案 - +- 建立“是否需要工单”和“需要什么设计证据”两个独立门禁。 +- 纯显示文案只有同时满足语义、流程、权限、状态、接口、高风险文字、国际化、程序标识符、布局和可访问性等全部豁免条件时，才免工单、免原型。 +- 代码组件名、类名、变量、国际化键、API 字段和数据库字段不属于显示文案。 +- 新页面、独立用户功能、重大交互或导航变化必须先用 Quant-UX 或其他合适工具制作原型，并经用户确认后才能编写生产代码。 +- 小范围 UI 使用标注截图或低保真图；新组件记录状态和边界；非 UI 需求使用架构、API、数据、状态或流程设计。 +- 恢复既有确认行为的 Bug 可以复用原设计、截图、复现步骤或已有验收证据。 +- 原型关键变化必须更新并重新确认。 +- 工单模板固定记录修改类型、证据、版本、状态、确认人和覆盖范围。 ## 修改文件 -- `<文件>`：<改动说明> +- `AGENTS.md`：增加显示文案豁免和设计证据门禁。 +- `.gitea/issue_template/task.md`：增加“设计与原型门禁”字段。 +- `docs/01-workflow.md`：导出双门禁执行流程。 +- `docs/09-product-requirements-overview.md`：导出原型门禁、记录要求和判断表。 +- `dev_scripts/check_harness.py`：检查 Agent 规则、工单字段和 Wiki 章节。 +- `tests/test_harness_docs.py`：增加双门禁测试。 ## 验收结果 | 验收标准 | 结果 | |---|---| -| | 通过 / 未通过 | +| 显示文案豁免条件明确 | 通过 | +| 完整独立 UI 需求先确认原型再编码 | 通过 | +| 小范围 UI、非 UI 和恢复 Bug 有替代证据 | 通过 | +| 原型证据字段完整 | 通过 | +| 关键变化要求重新确认 | 通过 | +| 工单模板包含设计与原型门禁 | 通过 | +| AGENTS、工作流和需求总览一致 | 通过 | +| 未创建空原型或工具集成 | 通过 | +| 工单保持待验收 | 通过 | ## 测试 -- 执行命令：`<命令>` -- 结果： -- **未验证部分**： +- `python dev_scripts/check_harness.py --strict`：通过。 +- `python -m unittest discover -s tests -v`：37项全部通过。 +- `python dev_scripts/sync_wiki_docs.py --check`：14个核心页面全部一致。 +- `git diff --check`：通过。 +- 人工场景：纯显示文案、新独立页面、后端接口和恢复既有行为 Bug 均有明确门禁和停止条件。 +- **未验证部分**：本任务只更新流程规则，没有实际 UI 需求，因此未创建或审核 Quant-UX 原型。 + +## Wiki 证据 + +- Development-Workflow revision：`3fa437209777476101dc709444c4fe7a0015b76a` +- Product-Requirements-Overview revision：`27456313cad2c28e311d7581a472f76d920b67fe` ## 遗留问题 - +无。#11、#16、#18 仍按各自工单保持待验收。 ## 相关提交 -- `<提交哈希>` <提交说明> +- `6435579` docs: require confirmed prototypes for major UI work (#19) \ No newline at end of file