diff --git a/server/services/wechat/HANDOFF_PROMPTS.md b/server/services/wechat/HANDOFF_PROMPTS.md
new file mode 100644
index 0000000..785e9a8
--- /dev/null
+++ b/server/services/wechat/HANDOFF_PROMPTS.md
@@ -0,0 +1,57 @@
+# HANDOFF_PROMPTS.md — 接手 prompt（复制粘贴用）
+
+把对应 prompt 贴给对应 agent 即可让它接手。分工见 `AGENTS.md`：
+**claude-run = 脑子（写/改/审代码）**；**hermes = 手（跑需要 root 的设备操作）**。
+
+---
+
+## ① 给 claude-run（在 `~/hermes-wechat/` 里启动后贴）
+
+```
+你接手维护 ~/hermes-wechat/ 的微信自动回复 bot 的代码开发与调试。
+第一件事：完整读 ~/hermes-wechat/AGENTS.md 和 HANDOFF.md（尤其 §零 环境须知）。
+
+你的角色 = 写 / 改 / 审代码。你跑在 proot、身份是 u0_a327：
+- 能直接编辑本目录 *.js、读 auto-reply.log、读改 .whitelist.json；
+- 拿不到 Magisk root，所以查微信 DB / 发测试消息 / logcat 这类要 root 的操作你做不了，
+  把确切的 `su -c '...'` 命令列给我，由我或 hermes 在 Termux 执行。
+
+工作闭环（全程无需 su）：
+  ① 改 ~/hermes-wechat/*.js
+  ② touch ~/hermes-wechat/.restart-request   → keepalive ~15s 内用新代码重启 bot
+  ③ tail ~/hermes-wechat/auto-reply.log       → 看结果
+  ④ 把需要同步回 Mac repo(server/services/wechat/) 的改动列清楚
+
+bot 实跑只依赖 auto-reply.js + android-wechat-tracker-sqlcipher.js + android-wechat-sender.js，
+其余文件不参与运行。唯一 live 日志就是本目录的 auto-reply.log。
+
+若你的 Bash 一启动就报 EACCES '.../.claude/session-env'，按 AGENTS.md 第 3 条让我在 Termux 修。
+
+先读那两份文档，然后告诉我：bot 当前状态 + HANDOFF §七/§八 里你建议先处理的待办。
+```
+
+---
+
+## ② 给 hermes（`hermes chat` 里贴；要它自动连跑加 `--yolo`）
+
+```
+你是这台 Pixel 上微信 bot 的「设备操作执行器」：你在 Termux、能 su，
+claude-run 负责改代码，你负责跑需要 root 的设备操作。
+先读 ~/hermes-wechat/AGENTS.md（末尾「调试设备状态的常用 su 命令」就是你的活）。
+
+常见任务：
+- 重启 bot：su -c 'pkill -f auto-reply.js'（keepalive 自动用新代码重启）
+- 查微信 DB 最近消息：确认 tracker 是否捕获/被过滤（DB 路径 + key 见 AGENTS.md）
+- 发测试 broadcast：验证 A11y 发送链路
+- 看 logcat -s HermesA11y:*：排查 UI 自动化卡在哪一步
+- A11y 被系统关掉时重新启用（命令见 AGENTS.md）
+
+执行 su 命令前先说明意图，执行后把输出回贴给我。claude-run 给你的 su 命令也可直接代跑。
+```
+
+---
+
+## 用法备注
+
+- claude-run 改完代码靠 `touch .restart-request` 自助重启（keepalive 桥，无需 su）；深度调试（DB/发测试/logcat）交给 hermes 或你手动 Termux 执行。
+- 两个 agent 同时只用一种改码入口（claude-run 现场改 vs Mac 改 deploy），别互相覆盖；手机改完尽快同步回 Mac repo。
diff --git a/server/services/wechat/deploy-to-phone.sh b/server/services/wechat/deploy-to-phone.sh
index 90053f9..7ce2604 100755
--- a/server/services/wechat/deploy-to-phone.sh
+++ b/server/services/wechat/deploy-to-phone.sh
@@ -19,7 +19,7 @@ TERMUX_UID="${TERMUX_UID:-u0_a327}"   # Termux app 的 uid（claude-run 也是�
 # 运行时必需：auto-reply.js 只 require 这三个文件，bot 实跑就这些
 RUNTIME="auto-reply.js android-wechat-tracker-sqlcipher.js android-wechat-sender.js"
 # 文档（接手 / 维护必读）。AGENTS.md/CLAUDE.md 是 agent 一次性读的入口
-DOCS="AGENTS.md CLAUDE.md HANDOFF.md README.md SKILL.md"
+DOCS="AGENTS.md CLAUDE.md HANDOFF.md HANDOFF_PROMPTS.md README.md SKILL.md"
 # 守护脚本（改了要手动重启 keepalive，见末尾提示）
 SCRIPTS="keepalive.sh"
 FILES="$RUNTIME $DOCS $SCRIPTS"