docs(handoff): add session checklist template

This commit is contained in:
root
2026-04-17 17:35:24 +08:00
parent f9fc2b658a
commit 586ca4d5a2
2 changed files with 177 additions and 2 deletions

View File

@@ -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)

View File

@@ -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.
是否改文件:
是否已提交:
下一步:
```