docs: 增加需求记录与流转规则 (#10)
@@ -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、项目档案、代码地图、业务规则、开发验证、常见修改和故障排查描述项目现在怎样工作。
|
- Home、项目档案、代码地图、业务规则、开发验证、常见修改和故障排查描述项目现在怎样工作。
|
||||||
|
|||||||
Reference in New Issue
Block a user