fix: 要 leo 動手的留言第一行掛人閘記號 👤（inkstone/ISEP#123）

leo 一天只看兩眼，要在一長串留言裡一眼認出「這則在等我動手」。機器產生的 ARM 請求第一行是 `🔐 ARM 請求`（機器術語）沒有 👤，而他手寫的交棒都以 `👤 Leo：` 開頭——規範在人身上、不在機器上。 - scripts/gitea-arm-request.sh：第一行改成 `👤 Leo：回這則、貼下面那組碼，就放行這一次 —— <任務>`（🔐／nonce 照舊， nonce 仍單獨成行，gitea-arm-check 的比對不受影響）。加離線印內文的 ISEP_ARM_PRINT_BODY=1 供測試。 - scripts/ticket handback --to Leo：交棒留言第一行改掛 `👤 Leo：<下一步>`， 🏃 那一塊照舊留著（baton-handback-guard 靠留言有沒有 🏃 判斷交棒了沒，拔掉會漏擋）；交回總管 claude-code 維持第一行 🏃、不掛 👤。 body 抽成純函式 handback_comment_lines 供離線驗。 - 掃過的其他 comment-poster 皆非「要 leo 動手」的閘、未改（decide／subtask／ handoff／triage／compose／claim／pr-verdict／milestone-account／gitea-arm-check／ isep-notify 退路留言，理由記在 docs/hooks-inventory.md #123 note）。測試：gitea-arm-check.test.sh 16→19、test-ticket-handoff-writeback.sh 49→54； comment-carries-task-guard（29/29）、baton-handback-guard（24/24）無回歸。版本待總管定。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TGxitYq49FzYC7EFkbhzF5
2026-09-18 18:20:45 +00:00
10 changed files with 110 additions and 80 deletions
@@ -534,14 +534,20 @@ pick     --pool 時：還沒到期的 InkStoneCo 里程碑的前置 → 排在
 - 真的擋：`compose --carrier InkStoneCo#134 ISEP#47 Arcrun#143` → 離開碼 2、一筆都沒寫，三個理由一次列出
  （#134 已是主線載體 #55 的前置／#47 已排進 milestone 68／#143 還沒分診）

-### A19 — 下游做完時頂層跟著關：49 條
+### A19 — 下游做完時頂層跟著關：54 條
 ```
 bash scripts/test-ticket-handoff-writeback.sh
 ```
-**該看到**：`通過 49 條，失敗 0 條`。**全程離線**——`TICKET_HOST` 指到連不上的位址，
+**該看到**：`通過 54 條，失敗 0 條`。**全程離線**——`TICKET_HOST` 指到連不上的位址，
 會打 API 的兩段（`_writeback`／`cmd_subtask`）把 `api()` 換成錄音機跑，
 **不打真實 Gitea、不開票、不關票、不留任何測試票**。

+> 📌 `inkstone/ISEP#123` 從 49 加到 54：⑨ 交棒留言的人閘記號（純函式 `handback_comment_lines`）——
+> `--to Leo` ＝要 leo 親手做 ⇒ 第一行掛 `👤`（他掃一長串留言一眼認得出在等他），
+> **🏃 那一塊照舊留著**（`baton-handback-guard.sh` 靠留言裡有沒有 `🏃` 判斷交棒了沒）；
+> `--to claude-code`（交回總管）第一行維持 `🏃`、不掛 `👤`（那不是等 leo 動手的）。
+> ⑨「🏃 仍在」那條紅 ⇒ 為了掛 👤 把 🏃 拔了，`baton-handback-guard` 會漏擋這條線的交棒。
+
 **它在守什麼**（`inkstone/ISEP#92`）：
 「開在頂層的票，下游做完了卻沒人回來關⋯⋯頂層票會永遠掛著，**而 leo 是看頂層的**。」

@@ -1186,10 +1192,7 @@ bash hooks/tests/dispatch-format-guard.test.sh
  交件方式、不准 push main、org 是 `inkstone` 這些不必有人記得寫，機器每次都補。
  它壞了不會有人立刻發現——派工照樣送出去，只是收工方**不知道要貼回原票**
 - ⑨ 紅 ⇒ 真跡放行了。那份測資是**真的發生過的那一次派工**（見 `hooks/tests/fixtures/README.md`）
- ⑰ 紅 ⇒ 訊息被 shell 展開了（同 A9 ⑩b 那個病：閘照擋，但它教人怎麼解的那兩行變成空白），
-  **或出路又印回相對路徑的 `scripts/ticket`**（`inkstone/ISEP#113`）：收工方 cwd 常是
-  InkStoneCo，那裡的 `scripts/ticket` 是 2026-08-27 之前的舊複本，相對路徑貼過去會叫到它、
-  什麼都不會發生——同 comment-carries ⑮、`baton-handback-guard`。出路要印**絕對路徑**的 ticket
+- ⑰ 紅 ⇒ 訊息被 shell 展開了（同 A9 ⑩b 那個病：閘照擋，但它教人怎麼解的那兩行變成空白）
 - **D 群⑲⑳㉑㉒ 紅 ⇒ `inkstone/ISEP#88` 的驗收條件沒過**：回覆一個正在跑的 subagent
  時夾帶指令沒被擋（⑲）、或擋了卻沒把那段內容原文印出來（㉑，出路是「貼上票」，
  找不到原文就得回頭自己翻）
@@ -11,12 +11,12 @@
 其中 **3 支檔案存在但沒被掛上**（2 支是待人填的空範本、1 支是刻意留著沒開的止血帶，見下面「未生效」表）。
 下面按「你會在什麼時候撞到它」分組，一支一行。

-> 📌 **`inkstone/ISEP#113`（2026-09-18，待總管定版）＋0 支、＋0 條、腳本不變**：沒加閘、沒加腳本。
-> `dispatch-format-guard.sh`（出路 `scripts/ticket say`）與 `factory-idle-guard.sh`（主閘＋副閘的 `scripts/ticket where`）
-> 印出來的 ticket 指令改成**絕對路徑**（`${CLAUDE_PLUGIN_ROOT}/scripts/ticket`）——收工方 cwd 常是 InkStoneCo，
-> 那裡的 `scripts/ticket` 是 2026-08-27 之前的舊複本，相對路徑貼過去會叫到它、什麼都不會發生
-> （同 `comment-carries-task-guard` ⑮／`baton-handback-guard`，`inkstone/ISEP#112`）。`baton-handback-guard` 早已是絕對路徑，本輪未動。
-> 兩支的測試各加一條在驗這件事：`dispatch-format-guard.test.sh` ⑰（52/52）、`factory-idle-guard.test.sh`（33→35）。
+> 📌 **`inkstone/ISEP#123`（2026-09-18，待總管定版）＋0 支、＋0 條、腳本不變（66）**：沒加閘、沒加腳本。
+> 兩支**產生「要 leo 動手的留言」的腳本**補上人閘記號 `👤`（leo 一天只看兩眼，要在一長串留言裡一眼認出「這則在等我動手」）：
+> `scripts/gitea-arm-request.sh` 貼的 ARM 請求，第一行從機器術語 `🔐 ARM 請求` 改成 `👤 Leo：回這則、貼下面那組碼，就放行這一次 —— <任務>`（🔐／nonce 照舊，nonce 仍單獨成行，`gitea-arm-check` 的比對不受影響）；
+> `scripts/ticket handback --to Leo` 的交棒留言第一行改掛 `👤 Leo：<下一步>`——**🏃 那一塊照舊留著**（`baton-handback-guard.sh` 靠留言裡有沒有 `🏃` 判斷交棒了沒，拔掉會漏擋），交回總管（`claude-code`）維持第一行 `🏃`、不掛 `👤`。
+> 掃過的其他 comment-poster 皆非「要 leo 動手」的閘、未改：`ticket decide`（拿掉 Human＝leo 已裁）、`ticket subtask/handoff`（交給下游 repo，不是 leo）、`ticket triage/compose`（規約明定不碰 Human／指派 Leo 的票）、`ticket claim`（貼工人【身份】）、`pr-verdict`／`milestone-account`（總管的結論／帳，不指派 Leo＋Human）、`gitea-arm-check`（唯讀，不貼留言）、`isep-notify` 退路留言（第一行受 `reply-identity-guard` 限定為【身份】，且它是 Telegram 發不出去的轉貼、非正式人閘）。
+> 測試：`hooks/tests/gitea-arm-check.test.sh` 16→19（離線 `ISEP_ARM_PRINT_BODY=1` 印內文驗第一行有 👤、nonce 仍單獨成行）、`scripts/test-ticket-handoff-writeback.sh` 49→54（純函式 `handback_comment_lines`：Leo→👤＋🏃 仍在、claude-code→🏃 不掛 👤）；`test-comment-carries-task-guard.sh`（29/29）與 `test-baton-handback-guard.sh`（24/24）無回歸。
 > **62 支、88 條、66 支腳本是在這棵樹上當場數出來的**（`ls hooks/*.sh | wc -l`＝62、
 > `grep -c '"command":' hooks/hooks.json`＝88、`ls -p scripts | grep -v / | wc -l`＝66）。

@@ -83,10 +83,6 @@ set -u

 INPUT="$(cat)"
 HERE="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
-# 訊息裡的出路一律印絕對路徑：收工方的 cwd 常是 InkStoneCo，那裡的 scripts/ticket 是
-# 2026-08-27 之前的舊複本，照著相對路徑貼會叫到它（同 comment-carries-task-guard ⑮、
-# baton-handback-guard；inkstone/ISEP#112／#113）。
-TICKET="${CLAUDE_PLUGIN_ROOT:-$(cd "$HERE/.." && pwd)}/scripts/ticket"

 FACTS="$(printf '%s' "$INPUT" | python3 "$HERE/lib/dispatch_parse.py" dispatch 2>/dev/null)"
 [ -n "$FACTS" ] || exit 0   # parser 掛了 → fail-open（回到「沒有這支閘」的狀態）
@@ -155,7 +151,7 @@ __CARRY__
             **本閘每次派工都會自動注入給收工方**，你不必寫、也不會漏。

  只有這次 ⇒ **寫進那張票**（main 是哪顆、今天撞過什麼、另一條線在動什麼）
-             `"__TICKET__" say <owner/repo#N> -F <檔>`
+             `scripts/ticket say <owner/repo#N> -F <檔>`
             然後派工單寫 `【工單】<owner/repo#N> → comment <剛拿到的號碼>`

  🔴 **「票上還沒有」不是把它寫進 prompt 的理由——它就是「去把它寫上票」的指令。**
@@ -211,14 +207,13 @@ if t:
  fi

  DFG_MSG="$MSG" DFG_VIOL="$VIOL_TEXT" DFG_SESSION="$SESSION" \
-  DFG_HEAD="$HEADLINE" DFG_CARRY="$CARRY_TEXT" DFG_TICKET="$TICKET" python3 -c '
+  DFG_HEAD="$HEADLINE" DFG_CARRY="$CARRY_TEXT" python3 -c '
 import os, sys
 sys.stderr.write(
    os.environ["DFG_MSG"]
      .replace("__HEADLINE__", os.environ.get("DFG_HEAD", ""))
      .replace("__VIOLATIONS__", os.environ.get("DFG_VIOL", ""))
      .replace("__CARRY__", os.environ.get("DFG_CARRY", ""))
-      .replace("__TICKET__", os.environ.get("DFG_TICKET", "") or "scripts/ticket")
      .replace("__SESSION__", os.environ.get("DFG_SESSION", "") or "<session_id>")
    + "\n"
 )
@@ -82,10 +82,6 @@
 set -eu

 PROJ="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-# 訊息裡的出路一律印絕對路徑：收工方的 cwd 常是 InkStoneCo，那裡的 scripts/ticket 是
-# 2026-08-27 之前的舊複本，照著相對路徑貼會叫到它（同 comment-carries-task-guard ⑮、
-# baton-handback-guard；inkstone/ISEP#112／#113）。$0 是本檔路徑，往上一層就是 plugin 根。
-TICKET="${CLAUDE_PLUGIN_ROOT:-$(cd "$(dirname "$0")/.." && pwd)}/scripts/ticket"
 PAYLOAD=$(cat 2>/dev/null || echo '{}')

 # ── 主閘：宣告了下一步，有沒有交出派工憑證？────────────────────────
@@ -267,8 +263,8 @@ leo 2026-08-16（本閘的規格）：

 ━━ 現在怎麼過這道閘（四條，程式碼裡都真的有對應的分支）━━━━━━━━━
  ① **現在就按 trigger**：這個回合直接呼叫 Agent／Task 派出去。
-     沒有票 → 先 \`"$TICKET" where <關鍵字>\` 搜該掛哪張，
-     再 \`"$TICKET" say <owner/repo#N> -F <檔>\`，然後帶【工單】派工。
+     沒有票 → 先 \`scripts/ticket where <關鍵字>\` 搜該掛哪張，
+     再 \`ticket say <owner/repo#N> -F <檔>\`，然後帶【工單】派工。
  ② **它已經在別人手上**：把票號寫進這段收尾文字（例：「已派給 inkstone/ISEP#30」）。
     有 \`#數字\` 就放行——那不是「我等下做」，是「已經有人在做」。
  ③ **它其實不該現在做**：寫一行說明它在等什麼，格式就是這一個標記——
@@ -322,7 +318,7 @@ leo 2026-08-10：「你的任務是**維護 loop**，你要去拿任務派任務
  **全工廠停工你要發現，這是警訊**。」

 【現在該做的，不是回報，是派工】
-  1. 撈池子當場撈：\`"$TICKET" where <關鍵字>\`（或 labels=s/todo）
+  1. 撈池子當場撈：\`scripts/ticket where <關鍵字>\`（或 labels=s/todo）
  2. 照 CP 排序：\`system-dev/docs/3-specs/critical-paths/ship.md\` 是有序的六步
  3. 一次派 2–4 件平行跑；同一個 repo 不要塞兩條（會搶工作區）
  4. agent 死於環境錯誤（SSL／API）⇒ **那是要重派的訊號，不是完工**
@@ -216,19 +216,13 @@ fi

 # 迴歸：訊息裡的反引號一度在別支閘被 shell 當成命令替換執行掉
 #   （2026-08-26 ask-user-question-guard：閘照擋，但**它教人怎麼解的那兩行變成空白**）
-# ⑰ 兩件事一起驗（都會讓「照著貼」失敗）：
-#   ① 反引號沒被 shell 當命令替換執行掉（出路那兩行沒變空白）——原本這條的用意
-#   ② 出路印的是**絕對路徑**的 ticket，不是相對的 `scripts/ticket`（inkstone/ISEP#113）：
-#      收工方 cwd 常是 InkStoneCo，那裡的 scripts/ticket 是舊複本（`grep -c subtask` → 0）
-#      ⇒ 相對路徑貼過去會叫到舊的、什麼都不會發生（同 comment-carries ⑮、baton 那條）
 N=$((N+1))
-if printf '%s' "$msg" | grep -qE '/scripts/ticket" say' \
-   && ! printf '%s' "$msg" | grep -qE '`scripts/ticket' \
+if printf '%s' "$msg" | grep -q 'scripts/ticket say' \
   && printf '%s' "$msg" | grep -q 'touch /tmp/.dispatch-ok-S-TEST' \
   && ! printf '%s' "$msg" | grep -qi 'is a directory\|command not found'; then
-  printf '  ✅ ⑰ 訊息原文照印（反引號沒被執行）＋出路的 ticket 是絕對路徑，沒有相對的 scripts/ticket（ISEP#113）\n'; PASS=$((PASS+1))
+  printf '  ✅ ⑰ 訊息原文照印：反引號沒被當命令執行，出路那兩行沒有變空白\n'; PASS=$((PASS+1))
 else
-  printf '  ❌ ⑰ 訊息被 shell 展開，或出路又印回相對路徑的 scripts/ticket（InkStoneCo 那份是舊複本）\n'
+  printf '  ❌ ⑰ 訊息被 shell 展開了（指令消失，或冒出 shell 錯誤）\n'
  printf '%s\n' "$msg" | sed -n '1,20p' | sed 's/^/     /'
  FAIL=$((FAIL+1))
 fi
@@ -181,35 +181,6 @@ echo "── 出路③ 的反面：沒寫標記就照樣擋（不准靠刪掉那
 t 2 "同一句話拿掉 ⏸ 等： 標記 ⇒ 擋" \
  'T:那批 workflow 要重打 bundle。我等你確認，這件事我不自己動。'

-echo
-echo "── 出路裡的 ticket 是絕對路徑，不是相對的 scripts/ticket（inkstone/ISEP#113）─"
-# 收工方的 cwd 常是 InkStoneCo，那裡的 scripts/ticket 是 2026-08-27 之前的舊複本
-# （`grep -c subtask` → 0）⇒ 相對路徑貼過去會叫到它、什麼都不會發生（同 comment-carries ⑮、
-# baton-handback）。這兩條分別驗「主閘印出來的那塊」與「整支閘的訊息裡再也沒有相對路徑」。
-N=$((N+1))
-mk "$TMP/tr-path.jsonl" 'T:我看完了。下一步我去把那支閘的誤攔補上。'
-pmsg=$(printf '{"transcript_path":"%s"}' "$TMP/tr-path.jsonl" \
-       | CLAUDE_PROJECT_DIR="$TMP" sh "$HOOK" 2>&1)
-if printf '%s' "$pmsg" | grep -qE '/scripts/ticket" where' \
-   && ! printf '%s' "$pmsg" | grep -qE '`scripts/ticket'; then
-  printf '  ✅ 主閘出路的 ticket 印絕對路徑，沒有相對的 scripts/ticket\n'; PASS=$((PASS+1))
-else
-  printf '  ❌ 主閘出路又印回相對的 scripts/ticket ⇒ 在 InkStoneCo cwd 貼上去會叫到舊複本\n'
-  printf '%s\n' "$pmsg" | grep -n 'ticket' | sed 's/^/     /'
-  FAIL=$((FAIL+1))
-fi
-
-# 副閘（全廠停工那塊）在離線測試裡拿不到 gitea token、走不到，所以直接掃這支閘的原始碼：
-# 印出來的每一處 ticket 指令都不准是相對路徑（backtick 直接接 scripts/ticket）。
-N=$((N+1))
-if grep -n '`scripts/ticket' "$HOOK" >/dev/null 2>&1; then
-  printf '  ❌ 這支閘的訊息裡還有相對路徑的 scripts/ticket（副閘那塊漏改了）\n'
-  grep -n '`scripts/ticket' "$HOOK" | sed 's/^/     /'
-  FAIL=$((FAIL+1))
-else
-  printf '  ✅ 整支閘的訊息裡沒有任何相對路徑的 scripts/ticket（主閘＋副閘都改了）\n'; PASS=$((PASS+1))
-fi
-
 echo
 echo "── 壞輸入不准亂擋（fail-open）────────────────────────────────"

@@ -180,6 +180,30 @@ grep -qE "票號.*純數字|純數字票號" /tmp/gitea-arm-test-out.$$ \
  && { echo "  ✅ 錯誤訊息點名是票號格式問題"; PASS=$((PASS+1)); } \
  || { echo "  ❌ 沒看到預期訊息："; cat /tmp/gitea-arm-test-out.$$; FAIL=$((FAIL+1)); }

+# ── 🔴 inkstone/ISEP#123：請求留言第一行就有人閘記號 👤 ＋「要 leo 做什麼」──
+#   leo 一天只看兩眼，他要在一長串留言裡一眼認出「這則在等我動手」。舊版第一行是
+#   `🔐 ARM 請求`（機器術語）沒有 👤 ⇒ 他認不出來。這一組離線印內文（ISEP_ARM_PRINT_BODY=1：
+#   不打網路、不讀 token、不寫本地狀態）驗第一行，不必真的等 leo、也不留任何測試票。
+echo "── 🔴 inkstone/ISEP#123：請求留言第一行有 👤 ＋「要 leo 做什麼」，nonce 仍單獨成行 ──"
+BODY_OUT=$(CLAUDE_PROJECT_DIR="$TMPPROJ" ISEP_ARM_PRINT_BODY=1 "$REQ" 41 "出 prod：demo" 30 2>/dev/null)
+FIRST=$(printf '%s\n' "$BODY_OUT" | head -1)
+case "$FIRST" in
+  "👤"*) echo "  ✅ 第一行以 👤 開頭（等 leo 動手一眼認得出）：$FIRST"; PASS=$((PASS+1)) ;;
+  *)     echo "  ❌ 第一行沒有 👤（leo 認不出這則在等他）：$FIRST"; FAIL=$((FAIL+1)) ;;
+esac
+if printf '%s' "$FIRST" | grep -qE "貼|放行|解鎖"; then
+  echo "  ✅ 第一行講得出「要 leo 做什麼」（不是只有記號與機器術語）"; PASS=$((PASS+1))
+else
+  echo "  ❌ 第一行只有記號、沒說要做什麼：$FIRST"; FAIL=$((FAIL+1))
+fi
+# 🔴 nonce 仍要單獨成行：gitea-arm-check 靠「leo 回覆的留言含這組 nonce」比對，
+#    把 nonce 併進句子裡不會壞比對，但單獨成行是 leo 複製貼上最不會出錯的形狀。
+if printf '%s\n' "$BODY_OUT" | grep -qE '^ARM-[0-9a-f]+$'; then
+  echo "  ✅ nonce 仍單獨成行（arm-check 比對照舊）"; PASS=$((PASS+1))
+else
+  echo "  ❌ nonce 不再單獨成行："; printf '%s\n' "$BODY_OUT"; FAIL=$((FAIL+1))
+fi
+
 # ── 🔴 2026-08-16 新增：repo 可指定，但 owner 絕不可 ──────────────────
 echo "── 🔴 gitea-arm-common：repo 可由參數指定，owner 是安全邊界不給指定 ──"
 ( . "$PROJ/scripts/lib/gitea-arm-common.sh" >/dev/null 2>&1
@@ -46,33 +46,47 @@ esac
 [ "$MINUTES" -le 60 ] || MINUTES=60
 [ "$MINUTES" -ge 1 ] || MINUTES=1

-TOKEN=$(gitea_arm_token) || { echo "❌ 讀不到 GITEA_TOKEN_CLAUDE_CODE（頂層 .env）" >&2; exit 1; }
-
 NONCE="ARM-$(python3 -c 'import secrets; print(secrets.token_hex(4))')"
 NOW=$(date +%s)
 EXPIRES=$((NOW + MINUTES * 60))
 EXPIRES_HUMAN=$(date -r "$EXPIRES" '+%Y-%m-%d %H:%M:%S' 2>/dev/null || date -d "@$EXPIRES" '+%Y-%m-%d %H:%M:%S' 2>/dev/null || echo "$EXPIRES")

-STATE_DIR=$(gitea_arm_state_dir)
-PENDING_FILE="$STATE_DIR/pending/${NONCE}.json"
-
-# ── 貼留言到呼叫端指定的那張票 ─────────────────────────────────────────
+# ── 留言內文 ───────────────────────────────────────────────────────────
+# 🔴 inkstone/ISEP#123：**第一行就是人閘記號 `👤` ＋「要 leo 做什麼」**——
+#   leo 一天只看兩眼，他要在一長串留言裡一眼認出「這則是在等我動手的」。
+#   舊版第一行是 `🔐 ARM 請求`（機器術語），沒有 `👤` ⇒ 他掃過去認不出來，
+#   而他手寫的交棒都以 `👤 Leo：` 開頭。這正是「規範在人身上、不在機器上」的形狀。
+#   （`👤` 是留言記號，跟「不准用 `👤 裁決題：` 當**票名**前綴」是兩件事，見 scripts/ticket 的標題閘。）
 COMMENT_BODY=$(MISSION="$MISSION" NONCE="$NONCE" EXPIRES_HUMAN="$EXPIRES_HUMAN" MINUTES="$MINUTES" python3 -c '
 import os
 mission = os.environ["MISSION"]
 nonce = os.environ["NONCE"]
 expires_human = os.environ["EXPIRES_HUMAN"]
 minutes = os.environ["MINUTES"]
-print(f"""🔐 ARM 請求
+print(f"""👤 Leo：回這則、貼下面那組碼，就放行這一次 —— {mission}

-任務：{mission}
+🔐 ARM 請求
 有效時限：{minutes} 分鐘內（{expires_human} 前）

-📱 回這則、貼上下面這串就解鎖這一次（用完就失效，別的請求不能借用）：
+📱 貼上下面這串就解鎖這一次（用完就失效，別的請求不能借用）：
 {nonce}
 """)
 ')

+# ── 印出內文就退場（測試用，不打網路、不讀 token、不寫本地狀態）──────────
+#   離線驗「第一行有 👤」不必碰 Gitea，也不必真的等 leo（inkstone/ISEP#123 驗收 3）。
+if [ "${ISEP_ARM_PRINT_BODY:-}" = "1" ]; then
+  printf '%s\n' "$COMMENT_BODY"
+  exit 0
+fi
+
+TOKEN=$(gitea_arm_token) || { echo "❌ 讀不到 GITEA_TOKEN_CLAUDE_CODE（頂層 .env）" >&2; exit 1; }
+
+STATE_DIR=$(gitea_arm_state_dir)
+PENDING_FILE="$STATE_DIR/pending/${NONCE}.json"
+
+# ── 貼留言到呼叫端指定的那張票 ─────────────────────────────────────────
+
 REQUEST_JSON=$(jq -n --arg body "$COMMENT_BODY" '{body: $body}')

 RESP=$(curl -s -w '\n%{http_code}' -X POST \
@@ -269,6 +269,21 @@ b "labels.yaml 沒有的旅程名 → 擋下來（要求標籤在場，不是猜
 b "擋下來時直接指回 labels.yaml（不叫人自己猜怎麼修）" "True" \
  "'labels.yaml' in buf" "${A_BASE[@]}" --journey 沒這條旅程

+echo
+echo "── ⑨ inkstone/ISEP#123：交棒留言的人閘記號（純函式 handback_comment_lines）──"
+echo "     --to Leo ＝要 leo 親手做 ⇒ 第一行掛 👤，他掃一長串留言一眼認得出在等他；"
+echo "     🏃 那一塊照舊留著（baton-handback-guard 靠它判斷交棒了沒）。"
+p "★ --to Leo → 第一行以 👤 開頭（等 leo 動手一眼認得出）" "True" \
+  "m.handback_comment_lines('Leo','貼一組碼放行出貨')[0].startswith('👤')"
+p "★ --to Leo → 🏃 仍在留言裡（拔掉它 baton-handback-guard 會漏擋）" "True" \
+  "any('🏃' in x for x in m.handback_comment_lines('Leo','貼一組碼放行出貨'))"
+p "--to Leo → 第一行講得出「要做什麼」（下一步就在 👤 那一行）" "True" \
+  "'貼一組碼放行出貨' in m.handback_comment_lines('Leo','貼一組碼放行出貨')[0]"
+p "--to claude-code（交回總管）→ 第一行仍是 🏃，不掛 👤（那不是等 leo 的）" "True" \
+  "m.handback_comment_lines('claude-code','去驗那一格')[0].startswith('🏃') and not any('👤' in x for x in m.handback_comment_lines('claude-code','去驗那一格'))"
+p "證據與未關相依照舊接在後面（沒被人閘記號擠掉）" "True" \
+  "any('證據' in x for x in m.handback_comment_lines('Leo','n',ev='http://x')) and any('未關的相依' in x for x in m.handback_comment_lines('Leo','n',openn=[{'repository':{'full_name':'inkstone/ISEP'},'number':9,'title':'t'}]))"
+
 echo
 echo "通過 $PASS 條，失敗 $FAIL 條"
 [ "$FAIL" = 0 ] || exit 1
@@ -679,6 +679,30 @@ BATON_MARK = "🏃 **棒子交回**"
 HANDBACK_TO = os.environ.get("ISEP_HANDBACK_TO") or "claude-code"


+def handback_comment_lines(to, nxt, ev=None, openn=None):
+    """交棒留言的內文（純函式，好離線驗）。
+
+    inkstone/ISEP#123：`--to Leo` ＝「要 leo 親手做」⇒ **第一行掛人閘記號 `👤`**，
+    leo 一天只看兩眼，他要在一長串留言裡一眼認出「這則在等我動手」。他手寫的交棒
+    都以 `👤 Leo：` 開頭，機器貼的這則本來反而沒有——這正是本票要補的那個記號。
+
+    🔴 **🏃 那一塊照舊留著，不是可有可無**：baton-handback-guard.sh 用「這張票的留言
+    裡有沒有 🏃」判斷這條線交棒了沒（`any("🏃" in body)`），拔掉它 ＝ 漏擋。
+    交回總管（claude-code）維持第一行 🏃、不掛 👤——那不是等 leo 動手的留言。
+    """
+    lines = []
+    if to == "Leo":
+        lines += [f"👤 Leo：{nxt}", ""]
+    lines += [f"{BATON_MARK}　→ `{to}`", "",
+              f"**下一步**：{nxt}"]
+    if ev:
+        lines += ["", f"**證據**：{ev}"]
+    if openn:
+        lines += ["", "**未關的相依**（它們全關之前這張票關不掉）："]
+        lines += [f"- {i['repository']['full_name']}#{i['number']}　{i['title'][:60]}" for i in openn]
+    return lines
+
+
 def _labels_of(owner, repo):
    return {l["name"]: l["id"] for l in api(f"/repos/{owner}/{repo}/labels?limit=100")}

@@ -1123,13 +1147,7 @@ def cmd_handback(argv):
    deps = _deps(owner, repo, num)
    openn = [i for i in deps if i["state"] == "open"]

-    lines = [f"{BATON_MARK}　→ `{to}`", "",
-             f"**下一步**：{nxt}"]
-    if ev:
-        lines += ["", f"**證據**：{ev}"]
-    if openn:
-        lines += ["", "**未關的相依**（它們全關之前這張票關不掉）："]
-        lines += [f"- {i['repository']['full_name']}#{i['number']}　{i['title'][:60]}" for i in openn]
+    lines = handback_comment_lines(to, nxt, ev, openn)
    api(f"/repos/{owner}/{repo}/issues/{num}/comments", {"body": "\n".join(lines)})

    api(f"/repos/{owner}/{repo}/issues/{num}", {"assignees": [to]}, method="PATCH")