OPC/dev_harness
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

增加UI原型确认与文字修改双门禁 #19

New Issue
Closed
opened 2026-08-17 10:14:24 +08:00 by ila · 0 comments
ila commented 2026-08-17 10:14:24 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：单元任务
  • 状态：已完成
  • 所属 Epic：无
  • 所属 MVP / 版本：无

依赖与并行

  • 前置工单：#18
  • 是否允许与前置工单并行：是
  • 原因：#18 的需求总览和原型索引已实现并处于待验收；本任务在其基础上补充编码门禁，不改变 #18 的已确认范围。

原始需求

  • 来源：用户与 Agent 对话
  • 提出时间：2026-08-17
  • 关键原话或脱敏摘要：“简单的改组件名文字或其他文字,不用建工单和制作原型;完整独立需求要先使用Quant-UX或其他工具制作原型设计图,审核通过了,才能写代码”
  • 已确认方案：采用工单门禁和原型门禁分离的条件规则；纯显示文案严格满足豁免条件时不建单、不做原型，完整独立UI需求必须先确认原型，非UI需求以技术设计替代。

要解决什么

当前规则允许部分文档措辞直接修改，也规定UI行为变化必须建单，但没有明确哪些界面文字属于豁免，也没有强制新增页面、独立用户功能或重大交互在正式编码前完成原型确认，容易造成Agent直接写代码后反复返工。

做什么 / 不做什么

做

  • 在 AGENTS.md 增加工单与原型双门禁。
  • 精确定义纯界面显示文案的免工单、免原型条件和最小验证。
  • 新增页面、独立用户功能、重大交互或导航变化必须先用 Quant-UX 或其他合适工具制作原型并获得用户确认。
  • 小范围布局使用标注截图或低保真设计证据；非UI独立需求使用架构、接口、数据或状态设计。
  • 恢复既有确认行为的Bug允许复用原设计或复现证据。
  • 记录原型链接或路径、版本/日期、状态、审核人和覆盖范围。
  • 原型关键变化必须更新并重新确认后才能继续正式编码。
  • 更新 Development-Workflow、Product-Requirements-Overview 和单元任务模板。
  • 更新 Harness 检查、测试和核心 Wiki 镜像。

不做

  • 不强制后端、接口、数据处理任务制作UI原型。
  • 不给每个小样式修改创建完整 Quant-UX 项目。
  • 不把代码组件名、类名、API字段或数据库字段改名纳入文字豁免。
  • 不创建空原型、示例图片、设计目录或新的原型工具集成。
  • 不修改现有产品界面。
  • 不关闭 #11、#16、#18。

已确认方案

  1. 先判断工单门禁，再判断设计证据门禁。
  2. 纯显示文案只有在不改变业务含义、流程、权限、状态、接口、法律/安全/支付/单位、国际化键、布局和可访问性，且不涉及代码标识符时，才免工单和原型。
  3. 新页面、独立用户功能、重大交互或导航变化必须先确认原型和文字需求，再创建或放行正式实现工单，之后才能写生产代码。
  4. 小范围现有UI调整采用最低成本、足以确认的标注截图或低保真设计，不强制完整高保真原型。
  5. 非UI独立需求不制作无意义UI原型，但必须确认架构、接口、数据、状态或流程设计。
  6. 原型草稿可以用于需求讨论；若要写入 Git/Wiki 或需要独立实施，建立设计任务。草稿不得作为生产代码依据。
  7. 原型或文字需求的页面结构、主要流程、状态、权限、异常处理或验收结果变化时，更新证据并重新确认。
  8. 工单模板固定记录修改类型、所需证据、链接/版本、状态、确认人和无需原型原因。

文档影响

  • 不影响长期文档，原因：
  • 更新项目档案或本地开发与验证
  • 更新架构与代码地图
  • 更新业务规则与术语
  • 更新常见修改或故障排查
  • 更新其他 Wiki：Development-Workflow、Product-Requirements-Overview

交付文档影响

  • 无交付文档影响，原因：只调整内部设计与编码门禁。
  • 更新已有交付文档：
  • 新增交付文档：
  • 需要目标岗位或客户代表验证：否；由项目负责人确认规则可执行。

验收标准

  • 纯显示文案的免工单、免原型条件明确且不包含代码标识符改名。
  • 新页面、独立用户功能、重大交互和导航变化必须先确认原型再写正式代码。
  • 小范围UI、非UI需求和恢复既有行为的Bug具有合适的替代设计证据。
  • 原型证据包含链接/路径、版本/日期、状态、确认人和覆盖范围。
  • 原型关键变化需要重新确认。
  • 工单模板包含“设计与原型门禁”字段。
  • AGENTS、开发工作流和产品需求总览规则一致。
  • 未创建空原型、设计目录或工具集成。
  • Wiki 已回读确认并与核心镜像一致。
  • 严格检查和单元测试通过。
  • 实现提交已推送，任务归档已更新 Wiki。
  • 工单保持待验收，等待用户明确验收。

验证方式

  • python dev_scripts/check_harness.py --strict
  • python -m unittest discover -s tests -v
  • python dev_scripts/sync_wiki_docs.py --check
  • 人工代入：纯显示文案、新独立页面、后端接口、恢复既有行为Bug四种场景。
  • git diff --check
  • git status --short --branch

风险和回退

  • 风险：把所有文字修改都当作豁免；通过业务语义、安全、国际化、布局和标识符排除条件限制。
  • 风险：所有任务都被迫制作高保真原型；按UI不确定性选择最低成本证据。
  • 风险：原型替代技术和验收规则；明确文字需求与技术设计仍需确认。
  • 回退：移除双门禁章节和工单字段，恢复原UI建单规则；不影响产品代码或数据。

实施与验证证据

  • 实现提交：6435579；最终镜像提交：38103e2，均已推送到 origin/main。
  • Development-Workflow revision：3fa437209777476101dc709444c4fe7a0015b76a。
  • Product-Requirements-Overview revision：27456313cad2c28e311d7581a472f76d920b67fe。
  • Task-19 归档 revision：21c2ad17b679d113594f8cfd86a6e54a8588ec13；按 #14 规则仅保留在线 Wiki，不自动导出本地任务归档。
  • 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 原型。

当前状态：已完成。工单保持开启，等待用户明确验收。

验收关闭记录

  • 用户确认：通过验收 #19
  • 验收日期：2026-08-17
  • Product-Requirements-Overview revision：1cf7515c3dd9d98f633cdb7fad27113c11449e5b
  • Task-19 最终归档 revision：14ef61e0a06ea97d45823c7a1ecbc48b918756ca
  • 验收归档镜像提交：b1f5001
  • 父工单：无，无需同步 MVP 或 Epic
## 基本信息 - 类型：单元任务 - 状态：已完成 - 所属 Epic：无 - 所属 MVP / 版本：无 ## 依赖与并行 - 前置工单：#18 - 是否允许与前置工单并行：是 - 原因：#18 的需求总览和原型索引已实现并处于待验收；本任务在其基础上补充编码门禁，不改变 #18 的已确认范围。 ## 原始需求 - 来源：用户与 Agent 对话 - 提出时间：2026-08-17 - 关键原话或脱敏摘要：“简单的改组件名文字或其他文字,不用建工单和制作原型;完整独立需求要先使用Quant-UX或其他工具制作原型设计图,审核通过了,才能写代码” - 已确认方案：采用工单门禁和原型门禁分离的条件规则；纯显示文案严格满足豁免条件时不建单、不做原型，完整独立UI需求必须先确认原型，非UI需求以技术设计替代。 ## 要解决什么 当前规则允许部分文档措辞直接修改，也规定UI行为变化必须建单，但没有明确哪些界面文字属于豁免，也没有强制新增页面、独立用户功能或重大交互在正式编码前完成原型确认，容易造成Agent直接写代码后反复返工。 ## 做什么 / 不做什么 ### 做 - 在 AGENTS.md 增加工单与原型双门禁。 - 精确定义纯界面显示文案的免工单、免原型条件和最小验证。 - 新增页面、独立用户功能、重大交互或导航变化必须先用 Quant-UX 或其他合适工具制作原型并获得用户确认。 - 小范围布局使用标注截图或低保真设计证据；非UI独立需求使用架构、接口、数据或状态设计。 - 恢复既有确认行为的Bug允许复用原设计或复现证据。 - 记录原型链接或路径、版本/日期、状态、审核人和覆盖范围。 - 原型关键变化必须更新并重新确认后才能继续正式编码。 - 更新 Development-Workflow、Product-Requirements-Overview 和单元任务模板。 - 更新 Harness 检查、测试和核心 Wiki 镜像。 ### 不做 - 不强制后端、接口、数据处理任务制作UI原型。 - 不给每个小样式修改创建完整 Quant-UX 项目。 - 不把代码组件名、类名、API字段或数据库字段改名纳入文字豁免。 - 不创建空原型、示例图片、设计目录或新的原型工具集成。 - 不修改现有产品界面。 - 不关闭 #11、#16、#18。 ## 已确认方案 1. 先判断工单门禁，再判断设计证据门禁。 2. 纯显示文案只有在不改变业务含义、流程、权限、状态、接口、法律/安全/支付/单位、国际化键、布局和可访问性，且不涉及代码标识符时，才免工单和原型。 3. 新页面、独立用户功能、重大交互或导航变化必须先确认原型和文字需求，再创建或放行正式实现工单，之后才能写生产代码。 4. 小范围现有UI调整采用最低成本、足以确认的标注截图或低保真设计，不强制完整高保真原型。 5. 非UI独立需求不制作无意义UI原型，但必须确认架构、接口、数据、状态或流程设计。 6. 原型草稿可以用于需求讨论；若要写入 Git/Wiki 或需要独立实施，建立设计任务。草稿不得作为生产代码依据。 7. 原型或文字需求的页面结构、主要流程、状态、权限、异常处理或验收结果变化时，更新证据并重新确认。 8. 工单模板固定记录修改类型、所需证据、链接/版本、状态、确认人和无需原型原因。 ## 文档影响 - [ ] 不影响长期文档，原因： - [ ] 更新项目档案或本地开发与验证 - [ ] 更新架构与代码地图 - [ ] 更新业务规则与术语 - [ ] 更新常见修改或故障排查 - [x] 更新其他 Wiki：Development-Workflow、Product-Requirements-Overview ## 交付文档影响 - [x] 无交付文档影响，原因：只调整内部设计与编码门禁。 - [ ] 更新已有交付文档： - [ ] 新增交付文档： - [x] 需要目标岗位或客户代表验证：否；由项目负责人确认规则可执行。 ## 验收标准 - [x] 纯显示文案的免工单、免原型条件明确且不包含代码标识符改名。 - [x] 新页面、独立用户功能、重大交互和导航变化必须先确认原型再写正式代码。 - [x] 小范围UI、非UI需求和恢复既有行为的Bug具有合适的替代设计证据。 - [x] 原型证据包含链接/路径、版本/日期、状态、确认人和覆盖范围。 - [x] 原型关键变化需要重新确认。 - [x] 工单模板包含“设计与原型门禁”字段。 - [x] AGENTS、开发工作流和产品需求总览规则一致。 - [x] 未创建空原型、设计目录或工具集成。 - [x] Wiki 已回读确认并与核心镜像一致。 - [x] 严格检查和单元测试通过。 - [x] 实现提交已推送，任务归档已更新 Wiki。 - [x] 工单保持待验收，等待用户明确验收。 ## 验证方式 - `python dev_scripts/check_harness.py --strict` - `python -m unittest discover -s tests -v` - `python dev_scripts/sync_wiki_docs.py --check` - 人工代入：纯显示文案、新独立页面、后端接口、恢复既有行为Bug四种场景。 - `git diff --check` - `git status --short --branch` ## 风险和回退 - 风险：把所有文字修改都当作豁免；通过业务语义、安全、国际化、布局和标识符排除条件限制。 - 风险：所有任务都被迫制作高保真原型；按UI不确定性选择最低成本证据。 - 风险：原型替代技术和验收规则；明确文字需求与技术设计仍需确认。 - 回退：移除双门禁章节和工单字段，恢复原UI建单规则；不影响产品代码或数据。 ## 实施与验证证据 - 实现提交：`6435579`；最终镜像提交：`38103e2`，均已推送到 `origin/main`。 - Development-Workflow revision：`3fa437209777476101dc709444c4fe7a0015b76a`。 - Product-Requirements-Overview revision：`27456313cad2c28e311d7581a472f76d920b67fe`。 - Task-19 归档 revision：`21c2ad17b679d113594f8cfd86a6e54a8588ec13`；按 #14 规则仅保留在线 Wiki，不自动导出本地任务归档。 - `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 原型。 当前状态：已完成。工单保持开启，等待用户明确验收。 ## 验收关闭记录 - 用户确认：通过验收 #19 - 验收日期：2026-08-17 - Product-Requirements-Overview revision：`1cf7515c3dd9d98f633cdb7fad27113c11449e5b` - Task-19 最终归档 revision：`14ef61e0a06ea97d45823c7a1ecbc48b918756ca` - 验收归档镜像提交：`b1f5001` - 父工单：无，无需同步 MVP 或 Epic
ila closed this issue 2026-08-17 10:33:41 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/dev_harness#19