44 lines
1.9 KiB
Markdown
44 lines
1.9 KiB
Markdown
# 需求分析
|
||
|
||
开始时间：2026-05-03-18-27-21
|
||
|
||
## 原始需求
|
||
|
||
用户要求新建一个完整的代码编纂工作流。后续只要提出项目修改相关需求，都需要按照该工作流执行：
|
||
|
||
- 每次执行前记录开始时间。
|
||
- 阅读或创建 `工程分析/` 文件夹，并维护工程整体分析。
|
||
- 每次需求写入 `工程分析/需求分析-时间戳.md`。
|
||
- 每次实现方案写入 `工程分析/实现方案-时间戳.md`，写完后必须经过用户二次人工审核确认。
|
||
- 每次测试方案写入 `工程分析/测试方案-时间戳.md`，写完后必须经过用户二次人工审核确认。
|
||
- 最终执行前阅读 `工程分析/经验记录.md`，执行后以四段式记录关键问题及解决方案。
|
||
- 最终执行后使用 Gitea 备份 commit，提交信息包含时间戳和简要描述，并提醒用户备份完成。
|
||
- 重新部署本项目。
|
||
|
||
## 目标
|
||
|
||
建立仓库内可持续遵守的修改工作流，让后续项目修改具备需求记录、方案审查、测试审查、经验沉淀、文档备份和重新部署闭环。
|
||
|
||
## 影响范围
|
||
|
||
- 新增仓库根目录 `AGENTS.md`，作为后续 Codex/工程协作的优先工作流入口。
|
||
- 新增并维护 `工程分析/` 目录。
|
||
- 不修改本次业务代码。
|
||
- 不把 Gitea 密码写入仓库文件。
|
||
|
||
## 约束
|
||
|
||
- 文档文件使用本次开始时间戳 `2026-05-03-18-27-21`。
|
||
- Gitea 凭据只能用于备份操作，不得持久化到仓库。
|
||
- 后续涉及业务代码修改时，必须等待用户审核确认实现方案和测试方案。
|
||
|
||
## 风险点
|
||
|
||
- 若未来执行者未阅读 `AGENTS.md`，可能绕过工作流。
|
||
- 若把凭据写入文档或提交信息，会造成安全风险。
|
||
- 若部署方式变化但未更新工程整体分析，后续重新部署可能失败。
|
||
|
||
## 待确认事项
|
||
|
||
本次按用户指令直接建立工作流；后续任何业务代码修改都需要先等待用户确认实现方案和测试方案。
|