# 需求分析

开始时间：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`，可能绕过工作流。
- 若把凭据写入文档或提交信息，会造成安全风险。
- 若部署方式变化但未更新工程整体分析，后续重新部署可能失败。

## 待确认事项

本次按用户指令直接建立工作流；后续任何业务代码修改都需要先等待用户确认实现方案和测试方案。