OpenFlare/docs/plan/handover-plan-template.md

AI 接手计划模板

说明：本模板用于在 AI 代理上下文发生截断、压缩（Compaction）或将任务转移给另一个 AI 代理时使用，帮助新接手的 AI 快速恢复 100% 的工作状态。

---

1. 当前任务状态 (Current Status)

• 主线任务描述：用一句话说清楚当前正在解决的核心问题。
• 开发分支/提交：记录当前的工作目录、修改的未暂存文件、或 Git 临时分支名。
• 已完成内容 (Completed)：
  • 功能 A 后端接口及单测
  • 前端面板表单组件

• 进行中内容 (In Progress)：
  • [/] 配置文件渲染与重写模块
• 待处理内容 (To Do)：
  • 边缘节点同步下载与校验落地
  • 发布功能整体连通性验证

2. 核心文件与上下文 (Key Files & Context)

列出与当前开发高度相关的核心文件以及需要注意的特殊背景：

• file:///path/to/core_file.go#L100-L150：此处负责...，修改时需要注意...
• file:///path/to/frontend_component.tsx：用于展现...

3. 待决策与遗留问题 (Outstanding Decisions & Issues)

• 疑问/阻塞点：是否需要支持某某场景？目前是如何兜底处理的？
• 异常与缺陷：单测 ./controller/... 运行时目前有 1 个 Fail，失败原因为...

4. 下一步行动指南 (Next Steps)

新接手 AI 进来后应当立即执行的前 3 步命令或编辑操作：

1. 第一步：执行 go test ./controller/... 确认环境并复现 Fail 异常。
2. 第二步：修改 openflare_server/controller/xxx.go 中的逻辑以修复该 Fail。
3. 第三步：在管理端前端页面调试 xxx 表单的提交是否正常。