From 586ca4d5a2d768219ddeea455623297b34402d5d Mon Sep 17 00:00:00 2001
From: root <root@v2202604268673447256.ultrasrv.de>
Date: Fri, 17 Apr 2026 17:35:24 +0800
Subject: [PATCH] docs(handoff): add session checklist template

---
 docs/README.md           |  16 +++-
 docs/接手检查清单模板.md | 163 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 177 insertions(+), 2 deletions(-)
 create mode 100644 docs/接手检查清单模板.md

diff --git a/docs/README.md b/docs/README.md
index c6a96b9..241bef0 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -32,9 +32,21 @@
 3. 需要多人 / 多 Codex 协作边界
 4. 需要正式服接手时的详细步骤
 
+### 3. 新会话接手检查清单
+
+如果是新的 Codex 会话、人工值班、跨机器继续跟进，建议再配合使用：
+
+- [接手检查清单模板.md](/www/wwwroot/diff-maccms/SEONexus/docs/接手检查清单模板.md)
+
+适用场景：
+
+1. 新会话快速对齐当前状态
+2. 多人 / 多 Codex 协作时避免漏项
+3. 用最短格式记录“当前结论、当前证据、下一步”
+
 ## 历史 / 专项文档
 
-### 3. 老模板回灌执行文档
+### 4. 老模板回灌执行文档
 
 - [1269-SEONexus-老模板第一阶段回灌执行文档.md](/www/wwwroot/diff-maccms/SEONexus/docs/1269-SEONexus-老模板第一阶段回灌执行文档.md)
 
@@ -44,7 +56,7 @@
 2. 对照历史回灌动作
 3. 排查旧版本与新版本差异
 
-### 4. Admin2 Spider Workbench 生产排障记录
+### 5. Admin2 Spider Workbench 生产排障记录
 
 - [2026-04-16-admin2-spider-workbench-production-fix.md](/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-16-admin2-spider-workbench-production-fix.md)
 
diff --git a/docs/接手检查清单模板.md b/docs/接手检查清单模板.md
new file mode 100644
index 0000000..35f9fed
--- /dev/null
+++ b/docs/接手检查清单模板.md
@@ -0,0 +1,163 @@
+# 接手检查清单模板
+
+这份模板给新的 Codex 会话或人工接手时使用。
+
+目标不是写长报告，而是用最短结构把“当前状态、当前证据、当前边界”说清楚。
+
+建议使用方式：
+
+1. 先看 [README.md](/www/wwwroot/diff-maccms/SEONexus/docs/README.md)
+2. 再看 [2026-04-17-spider-nginx-运维摘要.md](/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-17-spider-nginx-运维摘要.md)
+3. 再按本模板填一次当前接手状态
+
+---
+
+## 1. 基础信息
+
+- 接手时间：
+- 接手机器：
+- 当前项目根目录：
+- 当前目标：
+- 当前负责范围：
+
+示例：
+
+- 接手时间：`2026-04-17 21:10 +08:00`
+- 接手机器：`cluster-e-video`
+- 当前项目根目录：`/www/wwwroot/diff-maccms/SEONexus`
+- 当前目标：`复核 sogou 最新窗口是否继续恢复`
+- 当前负责范围：`蜘蛛日志分析 + 文档更新，不改业务代码`
+
+## 2. 当前先读了哪些文档
+
+- [ ] [README.md](/www/wwwroot/diff-maccms/SEONexus/docs/README.md)
+- [ ] [2026-04-17-spider-nginx-运维摘要.md](/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-17-spider-nginx-运维摘要.md)
+- [ ] [1270-SEONexus-Codex多版本协作交接总文档.md](/www/wwwroot/diff-maccms/SEONexus/docs/1270-SEONexus-Codex多版本协作交接总文档.md)
+- [ ] 其它专项文档：
+
+## 3. 当前主结论
+
+只写 3 到 5 条，不写长篇解释。
+
+1. 
+2. 
+3. 
+4. 
+5. 
+
+## 4. 当前仍未确认的点
+
+这里只写“还没确认”的问题，不写已经确认的。
+
+1. 
+2. 
+3. 
+
+## 5. 当前复测证据
+
+每条只保留最关键的 URL、UA、返回结果。
+
+### 5.1 普通访问
+
+1. URL：
+   - 状态：
+   - 关键头部：
+
+2. URL：
+   - 状态：
+   - 关键头部：
+
+### 5.2 蜘蛛 UA
+
+1. UA：
+   - URL：
+   - 状态：
+   - `X-Managed-Spider`：
+
+2. UA：
+   - URL：
+   - 状态：
+   - `X-Managed-Spider`：
+
+## 6. 当前是否涉及旧路径残留
+
+- [ ] 是
+- [ ] 否
+
+如果是，写清楚：
+
+1. 旧路径：
+2. 当前真实路径：
+3. 结论：
+
+## 7. 当前是否涉及前端缓存误判
+
+- [ ] 是
+- [ ] 否
+
+如果是，写清楚：
+
+1. 普通访问结果：
+2. `?__nocache=1` 结果：
+3. 结论：
+
+## 8. 当前是否改了文件
+
+- [ ] 没改文件，只分析
+- [ ] 改了文档
+- [ ] 改了 nginx 模板
+- [ ] 改了代码
+
+涉及文件：
+
+1. 
+2. 
+3. 
+
+## 9. 当前是否已提交 / 推送
+
+- [ ] 未提交
+- [ ] 已提交未推送
+- [ ] 已推送到 `origin2/dev`
+
+如果已提交：
+
+- commit：
+- message：
+
+## 10. 下一位接手者的第一步
+
+只写“下一步最该做的一件事”。
+
+示例：
+
+- 继续观察下一轮蜘蛛日志，确认 `sogou 200` 是否继续上升。
+- 对 `bytespider` 再做一轮 robots / home 复测。
+- 回到正式服核对某站当前真实路由是否变化。
+
+填写：
+
+- 下一步：
+
+---
+
+## 极简汇报模板
+
+如果要在聊天里快速汇报，可直接按下面格式：
+
+```md
+接手时间：
+当前目标：
+当前主结论：
+1.
+2.
+3.
+
+当前复测证据：
+1.
+2.
+
+是否改文件：
+是否已提交：
+下一步：
+```