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

建立产品需求总览与原型索引规范 #18

New Issue
Closed
opened 2026-08-17 09:53:02 +08:00 by ila · 1 comment
ila commented 2026-08-17 09:53:02 +08:00
Owner
Copy Link
Copy Source

基本信息

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

依赖与并行

  • 前置工单：无
  • 是否允许与未完成工单 #11、#16 并行：是
  • 原因：本任务建立需求导航和模板；#11、#16 的实现已存在且当前状态将被原样索引，不修改其范围或验收结论。

原始需求

  • 来源：用户与 Agent 对话
  • 提出时间：2026-08-17
  • 关键原话或脱敏摘要：“有需要把所有需求集中起来吗，例如文档或原型设计图”“按照你的建议方案建工单,做”
  • 已确认方案：集中需求入口和索引，不复制全部需求正文；文档、工单、原型和验收结果保持各自唯一事实来源并互相链接。

要解决什么

当前需求分别存在于项目档案、业务规则、主题 Wiki、Gitea 工单和任务归档中，缺少一个让负责人、Agent 和初级维护者快速了解“有哪些需求、状态如何、去哪里看详情”的统一入口。

做什么 / 不做什么

做

  • 新增核心 Wiki 页面 Product-Requirements-Overview，并导出本地只读镜像。
  • 登记当前 DevHarness 的长期需求领域、状态、正式详情、实施工单和验收入口。
  • 定义新增需求、状态变化和需求停止时的更新规则。
  • 定义原型、设计图和交互稿的存放、版本、确认状态及与需求的关系。
  • 明确原型不能代替文字业务规则和验收标准。
  • 在 Home、Project-Profile 和 New-Project-Documentation-Setup 增加入口或启用要求。
  • 更新显式 Wiki 映射、Harness 结构检查和单元测试。

不做

  • 不复制完整工单、聊天记录或 Agent 内部推理。
  • 不把所有任务正文合并成大型需求文档。
  • 不为当前没有原型的需求创建空图片、空目录或占位原型。
  • 不引入需求管理系统、原型工具或自动同步框架。
  • 不改变 #11、#16 或其他工单状态。

已确认方案

  1. “产品需求总览”是导航事实来源，不是全部需求正文的第二份副本。
  2. 每项稳定需求或需求领域记录：名称、用户与场景、状态、所属版本/MVP、详细 Wiki、实施工单、原型、验收结果。
  3. 详细长期需求和业务规则继续由对应 Wiki 主题页维护；单次实现和验收继续由 Gitea 工单维护。
  4. 简单图片、HTML 交互稿等版本绑定资产存放于 Git 的 design/ 或 prototypes/；外部原型记录链接、版本/确认日期，重要已确认原型保留可追溯快照。
  5. 原型必须标记草稿、已确认或已废弃；没有原型时明确写“无”，不创建占位文件。
  6. 新项目在形成 MVP、需求超过少量工单或开始原型设计时启用并维护该页。

文档影响

  • 不影响长期文档，原因：
  • 更新项目档案：增加需求总览入口
  • 更新架构与代码地图
  • 更新业务规则与术语
  • 更新常见修改或故障排查
  • 更新其他 Wiki：Home、New-Project-Documentation-Setup、新增 Product-Requirements-Overview

交付文档影响

  • 无交付文档影响，原因：本任务定义内部产品需求导航，不创建客户交付文档。
  • 更新已有交付文档：
  • 新增交付文档：
  • 需要目标岗位或客户代表验证：否；由项目负责人核对入口和规则。

验收标准

  • 存在核心 Wiki 页面“产品需求总览”及本地只读镜像。
  • 当前长期需求按领域建立索引，并链接正式详情和相关工单。
  • 索引包含用户场景、状态、版本/MVP、详情、工单、原型和验收入口。
  • 明确集中索引而不重复复制正文。
  • 明确原型存放、版本、确认状态、快照和验收边界。
  • Home、Project-Profile 和新项目初始化包含相应入口或启用规则。
  • 未创建空原型、额外系统或自动同步框架。
  • Wiki 已回读确认并与核心镜像一致。
  • 严格检查和单元测试通过。
  • 实现提交已推送，任务归档已更新 Wiki。
  • 工单保持待验收，等待用户明确验收。

验证方式

  • python dev_scripts/check_harness.py --strict
  • python -m unittest discover -s tests -v
  • python dev_scripts/sync_wiki_docs.py --check
  • 人工检查：从需求总览分别定位长期规则、实施工单、原型状态和验收入口。
  • git diff --check
  • git status --short --branch

风险和回退

  • 风险：总览复制太多内容形成双事实源；通过只保存摘要和链接控制。
  • 风险：原型草稿被当作正式需求；强制状态、版本和确认日期。
  • 风险：每个小缺陷都进入总览导致膨胀；只索引长期需求或需求领域。
  • 回退：删除新增页面、入口、映射和结构检查；不影响现有工单或主题文档。

实施结果与证据

  • Product-Requirements-Overview revision：560f97d976efa8699bc63fff50f469aac56e9367。
  • Home revision：a2600f79f1d4ca4c1c7699ee05835ea19be61dee。
  • Project-Profile revision：ad8b8d6e893e426fdfd6c11ee9d5ff7e1dfb5f80。
  • New-Project-Documentation-Setup revision：8c70a393a0537b94091224d00363fc61edadb1b6。
  • 任务归档：Task-18-产品需求总览与原型索引。
  • 任务归档 revision：1cbe1a3283410940746135d408c32de1f02ada46。
  • 提交：2e09b48、8e04c6b、85e6ef4，已推送至 origin/main。
  • 严格检查：通过；单元测试：35项全部通过；核心镜像：14个页面一致。
  • 人工检查：可从总览定位需求详情、实施工单、原型状态和验收入口。
  • 未验证：当前 DevHarness 没有实际产品界面，未验证真实原型文件或外部原型平台链接。
  • 按 #14 规则，任务归档只更新 Wiki，未自动导出到 docs/task/。
## 基本信息 - 类型：单元任务 - 状态：已完成 - 所属 Epic：无 - 所属 MVP / 版本：无 ## 依赖与并行 - 前置工单：无 - 是否允许与未完成工单 #11、#16 并行：是 - 原因：本任务建立需求导航和模板；#11、#16 的实现已存在且当前状态将被原样索引，不修改其范围或验收结论。 ## 原始需求 - 来源：用户与 Agent 对话 - 提出时间：2026-08-17 - 关键原话或脱敏摘要：“有需要把所有需求集中起来吗，例如文档或原型设计图”“按照你的建议方案建工单,做” - 已确认方案：集中需求入口和索引，不复制全部需求正文；文档、工单、原型和验收结果保持各自唯一事实来源并互相链接。 ## 要解决什么 当前需求分别存在于项目档案、业务规则、主题 Wiki、Gitea 工单和任务归档中，缺少一个让负责人、Agent 和初级维护者快速了解“有哪些需求、状态如何、去哪里看详情”的统一入口。 ## 做什么 / 不做什么 ### 做 - 新增核心 Wiki 页面 Product-Requirements-Overview，并导出本地只读镜像。 - 登记当前 DevHarness 的长期需求领域、状态、正式详情、实施工单和验收入口。 - 定义新增需求、状态变化和需求停止时的更新规则。 - 定义原型、设计图和交互稿的存放、版本、确认状态及与需求的关系。 - 明确原型不能代替文字业务规则和验收标准。 - 在 Home、Project-Profile 和 New-Project-Documentation-Setup 增加入口或启用要求。 - 更新显式 Wiki 映射、Harness 结构检查和单元测试。 ### 不做 - 不复制完整工单、聊天记录或 Agent 内部推理。 - 不把所有任务正文合并成大型需求文档。 - 不为当前没有原型的需求创建空图片、空目录或占位原型。 - 不引入需求管理系统、原型工具或自动同步框架。 - 不改变 #11、#16 或其他工单状态。 ## 已确认方案 1. “产品需求总览”是导航事实来源，不是全部需求正文的第二份副本。 2. 每项稳定需求或需求领域记录：名称、用户与场景、状态、所属版本/MVP、详细 Wiki、实施工单、原型、验收结果。 3. 详细长期需求和业务规则继续由对应 Wiki 主题页维护；单次实现和验收继续由 Gitea 工单维护。 4. 简单图片、HTML 交互稿等版本绑定资产存放于 Git 的 `design/` 或 `prototypes/`；外部原型记录链接、版本/确认日期，重要已确认原型保留可追溯快照。 5. 原型必须标记草稿、已确认或已废弃；没有原型时明确写“无”，不创建占位文件。 6. 新项目在形成 MVP、需求超过少量工单或开始原型设计时启用并维护该页。 ## 文档影响 - [ ] 不影响长期文档，原因： - [x] 更新项目档案：增加需求总览入口 - [ ] 更新架构与代码地图 - [ ] 更新业务规则与术语 - [ ] 更新常见修改或故障排查 - [x] 更新其他 Wiki：Home、New-Project-Documentation-Setup、新增 Product-Requirements-Overview ## 交付文档影响 - [x] 无交付文档影响，原因：本任务定义内部产品需求导航，不创建客户交付文档。 - [ ] 更新已有交付文档： - [ ] 新增交付文档： - [x] 需要目标岗位或客户代表验证：否；由项目负责人核对入口和规则。 ## 验收标准 - [x] 存在核心 Wiki 页面“产品需求总览”及本地只读镜像。 - [x] 当前长期需求按领域建立索引，并链接正式详情和相关工单。 - [x] 索引包含用户场景、状态、版本/MVP、详情、工单、原型和验收入口。 - [x] 明确集中索引而不重复复制正文。 - [x] 明确原型存放、版本、确认状态、快照和验收边界。 - [x] Home、Project-Profile 和新项目初始化包含相应入口或启用规则。 - [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` - 人工检查：从需求总览分别定位长期规则、实施工单、原型状态和验收入口。 - `git diff --check` - `git status --short --branch` ## 风险和回退 - 风险：总览复制太多内容形成双事实源；通过只保存摘要和链接控制。 - 风险：原型草稿被当作正式需求；强制状态、版本和确认日期。 - 风险：每个小缺陷都进入总览导致膨胀；只索引长期需求或需求领域。 - 回退：删除新增页面、入口、映射和结构检查；不影响现有工单或主题文档。 ## 实施结果与证据 - Product-Requirements-Overview revision：`560f97d976efa8699bc63fff50f469aac56e9367`。 - Home revision：`a2600f79f1d4ca4c1c7699ee05835ea19be61dee`。 - Project-Profile revision：`ad8b8d6e893e426fdfd6c11ee9d5ff7e1dfb5f80`。 - New-Project-Documentation-Setup revision：`8c70a393a0537b94091224d00363fc61edadb1b6`。 - 任务归档：`Task-18-产品需求总览与原型索引`。 - 任务归档 revision：`1cbe1a3283410940746135d408c32de1f02ada46`。 - 提交：`2e09b48`、`8e04c6b`、`85e6ef4`，已推送至 `origin/main`。 - 严格检查：通过；单元测试：35项全部通过；核心镜像：14个页面一致。 - 人工检查：可从总览定位需求详情、实施工单、原型状态和验收入口。 - 未验证：当前 DevHarness 没有实际产品界面，未验证真实原型文件或外部原型平台链接。 - 按 #14 规则，任务归档只更新 Wiki，未自动导出到 `docs/task/`。
ila commented 2026-08-25 10:24:35 +08:00
Author
Owner
Copy Link
Copy Source

验收结论

  • 验收时间：2026-08-25（Asia/Shanghai）
  • 结论：用户明确表示 #18 验收通过。
  • 长期需求状态：已在 Product-Requirements-Overview 更新为“已交付”，revision e9e0ebafd9189ae911094e615595a5e464e5e59b。
  • 镜像提交：19fb64b，已推送到 origin/main。
  • Wiki 镜像检查：15 个核心页面一致。
  • 父工单：无。
  • 任务快照：未新建、未导出；已有历史快照继续作为兼容证据，单次任务事实以本工单为准。

验收闭环完成，关闭工单。

## 验收结论 - 验收时间：2026-08-25（Asia/Shanghai） - 结论：用户明确表示 #18 验收通过。 - 长期需求状态：已在 Product-Requirements-Overview 更新为“已交付”，revision `e9e0ebafd9189ae911094e615595a5e464e5e59b`。 - 镜像提交：`19fb64b`，已推送到 `origin/main`。 - Wiki 镜像检查：15 个核心页面一致。 - 父工单：无。 - 任务快照：未新建、未导出；已有历史快照继续作为兼容证据，单次任务事实以本工单为准。 验收闭环完成，关闭工单。
ila closed this issue 2026-08-25 10:24:35 +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#18