From ea3912217443b40f0fee66a6dc8e951d06e2c2f9 Mon Sep 17 00:00:00 2001 From: ila Date: Mon, 10 Aug 2026 11:51:12 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=A2=9E=E5=8A=A0=E9=9C=80=E6=B1=82?= =?UTF-8?q?=E8=AE=B0=E5=BD=95=E4=B8=8E=E6=B5=81=E8=BD=AC=E8=A7=84=E5=88=99?= =?UTF-8?q?=20(#10)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Development-Workflow.-.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/Development-Workflow.-.md b/Development-Workflow.-.md index 4a54a08..3383c25 100644 --- a/Development-Workflow.-.md +++ b/Development-Workflow.-.md @@ -123,6 +123,28 @@ python dev_scripts/new_task_archive.py 123 "修复登录超时" 普通内部重构如果入口、行为、配置和验证方式均未改变，可以记录“不影响长期文档”及原因。 +## 需求记录与流转 + +聊天用于分析和确认，不是正式需求的长期事实来源。创建单元任务工单时，Agent 应记录： + +- 原始需求的来源和提出时间； +- 能表达用户目的、使用场景和限制的少量关键原话； +- 整理后的目标、非目标、确认方案、验收标准和文档影响； +- 实施期间影响范围、接口、数据、风险或验收的需求变化，以及变化原因和用户确认。 + +只摘录完成追踪所需的内容，不复制完整聊天，不保存 Agent 内部推理，不写入密码、令牌、个人数据或生产数据。包含敏感信息的原话必须删除敏感部分或改写为脱敏摘要。 + +需求按以下边界流转： + +| 内容 | 事实来源 | 本地镜像 | +|---|---|---| +| 关键原始需求、确认后的单次任务需求 | Gitea 单元任务工单 | 无 | +| 讨论、决定和需求变化 | Gitea 工单正文或评论 | 无 | +| 长期有效的产品需求、业务规则和系统边界 | 对应 Gitea Wiki 主题页 | `docs/` | +| 完成后的实现、验证和遗留问题 | Wiki 任务归档 | `docs/task/` | + +任务产生长期结论时，先更新对应 Wiki 主题页，再导出本地镜像。Gitea 工单全文不导出到仓库，避免形成第二份任务过程记录。 + ## 稳定文档与任务归档 - Home、项目档案、代码地图、业务规则、开发验证、常见修改和故障排查描述项目现在怎样工作。