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

增加需求记录与流转规则 #10

New Issue
Closed
opened 2026-08-16 23:06:32 +08:00 by ila · 3 comments
ila commented 2026-08-16 23:06:32 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：开发流程优化
  • 所属 Epic：无
  • 所属 MVP / 版本：无
  • 阶段：已完成

依赖与并行

  • 前置工单：#8、#9
  • 是否允许与前置工单并行：是
  • 原因：#8、#9 的实现和归档已提交并推送，本任务只增量补充需求记录边界，不改变其依赖语义和快捷指令停止位置，可独立验收。

原始需求

  • 来源：当前用户对话
  • 提出时间：2026-08-10
  • 关键原话：“好的，按照你的建议来建工单，做。”
  • 上下文：用户确认采用“工单保存本次需求与变化，Wiki 保存长期结论，docs 只镜像 Wiki”的建议。

要解决什么

当前工单模板会记录目标、方案和验收标准，但没有强制保存需求来源、关键原始表达和需求变化。需求含义通常能够保留，但未来追溯时可能无法判断用户最初目的以及实施期间为什么发生变化。

目标是以最小方式补强需求可追踪性：

  • Gitea 工单保存关键原始需求、确认后的任务需求和需求变化。
  • Wiki 保存长期有效的产品需求、业务规则和系统边界。
  • docs/ 只保存 Wiki 镜像。
  • 不保存完整聊天、Agent 内部推理或敏感信息。

做什么 / 不做什么

  • 做：
    • 单元任务模板增加“原始需求”和“需求变化记录”。
    • 明确只摘录表达用户目的、场景和限制的关键原话。
    • 现有目标、非目标、确认方案和验收标准继续构成正式任务需求。
    • 需求变化记录日期、内容、原因和用户确认。
    • 长期有效结论更新相关 Wiki，再导出本地镜像。
    • Harness 检查模板字段和规则入口。
  • 不做：
    • 不保存或导出完整 Agent 聊天。
    • 不保存 Agent 内部推理过程。
    • 不把 Gitea 工单全文导出到本地。
    • 不新增需求数据库、同步脚本、Skill 或自动抓取聊天功能。
    • 不修改历史工单。

已确认方案

事实来源边界：

内容 事实来源 本地镜像
关键原始需求 Gitea 工单 无
确认后的单次任务需求 Gitea 工单 无
讨论和需求变化 Gitea 工单 无
长期产品需求和业务规则 Gitea Wiki docs/
完成后的任务结果 Wiki 任务归档 docs/task/

文档影响

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

验收标准

  • 模板能记录来源、提出时间和关键原话。
  • 模板能记录需求变化的日期、内容、原因和用户确认。
  • 明确工单保存确认后的单次任务需求和变化。
  • 明确长期有效结论进入 Wiki 并导出 docs/。
  • 明确不保存完整聊天、内部推理和敏感信息。
  • 明确不把 Gitea 工单全文导出本地。
  • Harness 能检测模板字段缺失。
  • 不增加新脚本、Skill、需求数据库或聊天抓取功能。
  • Wiki 先更新、读取确认，再导出镜像。
  • 测试、Harness 和 Wiki 镜像检查通过。
  • 实现与任务归档分别提交并推送。

验证方式

python -m unittest discover -s tests -v
python dev_scripts/check_harness.py --strict
python dev_scripts/sync_wiki_docs.py --check
python -m compileall -q dev_scripts tests
git diff --check

风险和回退

风险：工单复制过多聊天噪声或敏感内容；正式需求与原始原话重复。

控制：只保留关键原话，正式需求继续使用现有结构，禁止完整聊天和敏感信息。回退时恢复本任务提交及 Development-Workflow 的前一 Wiki revision。

## 基本信息 - 类型：开发流程优化 - 所属 Epic：无 - 所属 MVP / 版本：无 - 阶段：已完成 ## 依赖与并行 - 前置工单：#8、#9 - 是否允许与前置工单并行：是 - 原因：#8、#9 的实现和归档已提交并推送，本任务只增量补充需求记录边界，不改变其依赖语义和快捷指令停止位置，可独立验收。 ## 原始需求 - 来源：当前用户对话 - 提出时间：2026-08-10 - 关键原话：“好的，按照你的建议来建工单，做。” - 上下文：用户确认采用“工单保存本次需求与变化，Wiki 保存长期结论，docs 只镜像 Wiki”的建议。 ## 要解决什么 当前工单模板会记录目标、方案和验收标准，但没有强制保存需求来源、关键原始表达和需求变化。需求含义通常能够保留，但未来追溯时可能无法判断用户最初目的以及实施期间为什么发生变化。 目标是以最小方式补强需求可追踪性： - Gitea 工单保存关键原始需求、确认后的任务需求和需求变化。 - Wiki 保存长期有效的产品需求、业务规则和系统边界。 - `docs/` 只保存 Wiki 镜像。 - 不保存完整聊天、Agent 内部推理或敏感信息。 ## 做什么 / 不做什么 - 做： - 单元任务模板增加“原始需求”和“需求变化记录”。 - 明确只摘录表达用户目的、场景和限制的关键原话。 - 现有目标、非目标、确认方案和验收标准继续构成正式任务需求。 - 需求变化记录日期、内容、原因和用户确认。 - 长期有效结论更新相关 Wiki，再导出本地镜像。 - Harness 检查模板字段和规则入口。 - 不做： - 不保存或导出完整 Agent 聊天。 - 不保存 Agent 内部推理过程。 - 不把 Gitea 工单全文导出到本地。 - 不新增需求数据库、同步脚本、Skill 或自动抓取聊天功能。 - 不修改历史工单。 ## 已确认方案 事实来源边界： | 内容 | 事实来源 | 本地镜像 | |---|---|---| | 关键原始需求 | Gitea 工单 | 无 | | 确认后的单次任务需求 | Gitea 工单 | 无 | | 讨论和需求变化 | Gitea 工单 | 无 | | 长期产品需求和业务规则 | Gitea Wiki | `docs/` | | 完成后的任务结果 | Wiki 任务归档 | `docs/task/` | ## 文档影响 - [ ] 不影响长期文档，原因： - [ ] 更新项目档案或本地开发与验证 - [ ] 更新架构与代码地图 - [x] 更新业务规则与术语 - [ ] 更新常见修改或故障排查 - [x] 更新其他 Wiki 页面：Development-Workflow ## 验收标准 - [x] 模板能记录来源、提出时间和关键原话。 - [x] 模板能记录需求变化的日期、内容、原因和用户确认。 - [x] 明确工单保存确认后的单次任务需求和变化。 - [x] 明确长期有效结论进入 Wiki 并导出 `docs/`。 - [x] 明确不保存完整聊天、内部推理和敏感信息。 - [x] 明确不把 Gitea 工单全文导出本地。 - [x] Harness 能检测模板字段缺失。 - [x] 不增加新脚本、Skill、需求数据库或聊天抓取功能。 - [x] Wiki 先更新、读取确认，再导出镜像。 - [x] 测试、Harness 和 Wiki 镜像检查通过。 - [x] 实现与任务归档分别提交并推送。 ## 验证方式 ```powershell python -m unittest discover -s tests -v python dev_scripts/check_harness.py --strict python dev_scripts/sync_wiki_docs.py --check python -m compileall -q dev_scripts tests git diff --check ``` ## 风险和回退 风险：工单复制过多聊天噪声或敏感内容；正式需求与原始原话重复。 控制：只保留关键原话，正式需求继续使用现有结构，禁止完整聊天和敏感信息。回退时恢复本任务提交及 Development-Workflow 的前一 Wiki revision。
ila closed this issue 2026-08-16 23:06:32 +08:00
ila commented 2026-08-16 23:06:37 +08:00
Author
Owner
Copy Link
Copy Source

实现完成，进入归档阶段

  • 单元任务模板新增“原始需求”：来源、提出时间、关键原话或脱敏摘要。
  • 新增“需求变化记录”：日期、内容、原因、用户确认。
  • 现有目标、非目标、确认方案、验收标准和文档影响继续构成正式任务需求。
  • 明确不复制完整聊天、不保存 Agent 内部推理或敏感信息，不臆造用户原话。
  • 长期产品需求和业务规则进入 Wiki；Gitea 工单全文不导出本地。
  • Wiki 已先更新并读取确认：
    • Development-Workflow：ea3912217443b40f0fee66a6dc8e951d06e2c2f9
    • Business-Rules-and-Glossary：f78f2f92f563ec8dce5e399d4ee2b37896fa98dd
  • Harness 已检查模板、Agent 规则和 Wiki 章节。
  • 未增加脚本、Skill、需求数据库或聊天抓取功能。

实现提交：353bd97

首轮验证：

  • 单元测试：21/21 通过
  • Harness 严格检查：通过
  • Wiki 镜像检查：19/19 一致
  • Python 编译检查：通过
  • git diff --check：通过

下一步创建 Wiki 任务归档。

## 实现完成，进入归档阶段 - 单元任务模板新增“原始需求”：来源、提出时间、关键原话或脱敏摘要。 - 新增“需求变化记录”：日期、内容、原因、用户确认。 - 现有目标、非目标、确认方案、验收标准和文档影响继续构成正式任务需求。 - 明确不复制完整聊天、不保存 Agent 内部推理或敏感信息，不臆造用户原话。 - 长期产品需求和业务规则进入 Wiki；Gitea 工单全文不导出本地。 - Wiki 已先更新并读取确认： - Development-Workflow：`ea3912217443b40f0fee66a6dc8e951d06e2c2f9` - Business-Rules-and-Glossary：`f78f2f92f563ec8dce5e399d4ee2b37896fa98dd` - Harness 已检查模板、Agent 规则和 Wiki 章节。 - 未增加脚本、Skill、需求数据库或聊天抓取功能。 实现提交：`353bd97` 首轮验证： - 单元测试：21/21 通过 - Harness 严格检查：通过 - Wiki 镜像检查：19/19 一致 - Python 编译检查：通过 - `git diff --check`：通过 下一步创建 Wiki 任务归档。
ila commented 2026-08-16 23:06:37 +08:00
Author
Owner
Copy Link
Copy Source

最终实施与归档证据

  • 状态：待验收（未关闭）
  • 实现提交：353bd97（feat: 增加需求记录规则 (#10)）
  • 归档提交：e9c9fb4（docs: 归档任务 #10）
  • 远端 main：已推送至 e9c9fb4
  • 稳定 Wiki：
    • Development-Workflow：ea3912217443b40f0fee66a6dc8e951d06e2c2f9
    • Business-Rules-and-Glossary：f78f2f92f563ec8dce5e399d4ee2b37896fa98dd
  • Wiki 归档：Task-10-需求记录与流转规则
  • Wiki revision：6451a4bbf1d11f4f398e7a49d8f32237d33237c3
  • 本地只读镜像：docs/task/10-需求记录与流转规则.md

最终验证

  • 单元测试：21/21 通过
  • Harness 严格检查：通过
  • Wiki 镜像检查：20/20 一致
  • Python 编译检查：通过
  • git diff --check：通过
  • 工作区：干净
  • 未验证部分：未实现聊天自动抓取或 Gitea 工单全文导出，这些是已确认的非目标。

请按验收标准检查；收到明确“#10 验收通过”后再关闭工单。

## 最终实施与归档证据 - 状态：待验收（未关闭） - 实现提交：`353bd97`（`feat: 增加需求记录规则 (#10)`） - 归档提交：`e9c9fb4`（`docs: 归档任务 #10`） - 远端 `main`：已推送至 `e9c9fb4` - 稳定 Wiki： - Development-Workflow：`ea3912217443b40f0fee66a6dc8e951d06e2c2f9` - Business-Rules-and-Glossary：`f78f2f92f563ec8dce5e399d4ee2b37896fa98dd` - Wiki 归档：[Task-10-需求记录与流转规则](http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Task-10-%E9%9C%80%E6%B1%82%E8%AE%B0%E5%BD%95%E4%B8%8E%E6%B5%81%E8%BD%AC%E8%A7%84%E5%88%99.-) - Wiki revision：`6451a4bbf1d11f4f398e7a49d8f32237d33237c3` - 本地只读镜像：`docs/task/10-需求记录与流转规则.md` ### 最终验证 - 单元测试：21/21 通过 - Harness 严格检查：通过 - Wiki 镜像检查：20/20 一致 - Python 编译检查：通过 - `git diff --check`：通过 - 工作区：干净 - 未验证部分：未实现聊天自动抓取或 Gitea 工单全文导出，这些是已确认的非目标。 请按验收标准检查；收到明确“#10 验收通过”后再关闭工单。
ila commented 2026-08-16 23:06:38 +08:00
Author
Owner
Copy Link
Copy Source

验收完成

用户已明确确认 #10 验收通过，工单已关闭。

  • 验收归档提交：4e9f2e1（已推送至远端 main）
  • Wiki 归档：任务 #10
  • Wiki revision：d1f9c3198f76216fe8013f9862c26b59f9c179dc
  • 本地只读镜像：docs/task/10-需求记录与流转规则.md
  • 最终验证：21/21 单元测试通过、Harness 严格检查通过、20/20 Wiki 镜像一致
## 验收完成 用户已明确确认 #10 验收通过，工单已关闭。 - 验收归档提交：`4e9f2e1`（已推送至远端 `main`） - Wiki 归档：[任务 #10](http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Task-10-%E9%9C%80%E6%B1%82%E8%AE%B0%E5%BD%95%E4%B8%8E%E6%B5%81%E8%BD%AC%E8%A7%84%E5%88%99.-) - Wiki revision：`d1f9c3198f76216fe8013f9862c26b59f9c179dc` - 本地只读镜像：`docs/task/10-需求记录与流转规则.md` - 最终验证：21/21 单元测试通过、Harness 严格检查通过、20/20 Wiki 镜像一致
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#10