接手时先做什么
不要直接根据聊天记忆改代码。先读当前状态、执行计划和最近提交，再决定是否进入需求、验收、部署或 LiteMall 触发路径。
Handoff
AI 接手清单
当项目中途换 Codex、换 AI agent 或换开发者时，先按这页读取上下文、选择执行路径、验证结果并留下交接记录。目标是不重新问一遍，也不越过上线红线。
接手步骤
这四步是后续所有 AI agent 的固定动作，适用于主站建设、需求开发、验收和部署。
第 1 步
读取上下文
先读 HANDOFF、执行计划、运行状态和最近提交，不要直接改代码。
阅读 HANDOFF.md 和 docs/ai-execution-plan.md。
查看 /system 的当前运行状态和下一动作触发条件。
执行 git status --short --branch 和 git log --oneline -8。
确认用户最新一句话是否覆盖旧计划。
第 2 步
选择执行路径
根据触发条件判断是做需求、验收、部署、LiteMall 上线，还是只做文档收口。
有新需求时先走 AI 需求文档生成器。
有产品开发时先选对应产品需求包。
有线上问题或客户反馈时先填写问题排查记录。
有上线动作时先选部署 Runbook。
ICP 未通过时不要公开 LiteMall 链接或切换小程序 HTTPS API。
第 3 步
实现与验证
每次改动都要有可复现验证，不能只靠肉眼说完成。
代码或页面改动运行 npm run lint。
涉及逻辑或数据结构时运行 npm run test:unit。
公开页面改动运行 npm run build。
页面内容改动用本地路由检查确认关键文字存在。
第 4 步
记录交接
提交前更新交接资料，让下一个 AI 不需要翻聊天记录。
更新 HANDOFF.md 里的当前批次、完成内容和下一触发条件。
公开可见变化加入 lib/site-data.js 的 changelogEntries。
新增路线时补 sitemap 或相关入口。
发布或无法部署时填写发布记录，区分本地验证、部署和线上复查。
最终回复包含 commit hash、验证结果和推送/部署命令。
要读取的资料
事实来源
HANDOFF.md
docs/ai-execution-plan.md
app/system/page.jsx
lib/operations-status.js
需求来源
tools/requirement-brief-generator
docs/project-workspace-template.md
docs/product-flows/*.md
lib/product-requirement-packs.js
lib/project-workspace.js
验收来源
docs/acceptance-checklists/*.md
docs/acceptance-record-template.md
lib/acceptance-checklists.js
lib/acceptance-record.js
tests/*.test.mjs
部署来源
docs/deployment-runbooks/*.md
docs/litemall-launch-checklist.md
docs/issue-triage-template.md
docs/release-record-template.md
docs/project-workspace-template.md
lib/deployment-runbooks.js
lib/issue-triage.js
lib/release-record.js
lib/project-workspace.js
