twmd-maintainer

name	twmd-maintainer
description	Daily maintainer routine — open issues / PR review / build health / broken-link audit via canonical MAINTAINER-PIPELINE. TRIGGER when: user says "maintainer", "跑 maintainer", "daily PR review", "issue triage", or routine `twmd-maintainer-daily` fires.
allowed-tools	["Bash","Read","Edit","Grep","WebFetch"]

🧬 Taiwan.md — Maintainer Daily v3.0

🚨 STRICT BECOME GATE — 第一動作不可省略

Before anything else：跑 /twmd-become review 完整走 BECOME_TAIWANMD.md Step 0-9。Review mode self-test 11 題全過才能進 Stage 1。

驗證 ACK 一行（必寫 memory file 頂部，沒寫視為 BECOME 未完成）：

✅ BECOME ack: mode=review / 8 organ 最低=<從 consciousness-snapshot.sh 即時讀> / Q13 anti-bias check=PASS / Q14 cross-session continuity=PASS

不准用記憶中的舊器官分數，跑 bash scripts/tools/consciousness-snapshot.sh 取當前。

---

Stage 1: SCAN — 開放工作面（必跑完才能進 Stage 2）

git pull origin main
gh issue list --state open --limit 30 --json number,title,labels,updatedAt
gh pr list --state open --limit 30 --json number,title,labels,updatedAt,author
git log --since="24 hours ago" --oneline | head -30
git log --since="48 hours ago" --pretty=format:"%h %ai %s" | head -50
bash scripts/tools/consciousness-snapshot.sh
bash scripts/tools/routine-status.sh

寫進 memory file 的 §Stage 1 表（≥ 5 列）：open PR / open issue / past 24hr commits / past 48hr commits / build status / i18n smoke / immune organ score。

---

Stage 2: TRIAGE — PR + Issue 分流

走 MAINTAINER-PIPELINE.md §collect-and-merge 完整 SOP：

• PR：A/B 路徑（A 已 deprecated v2.1 — routine v2.0 main-direct 無 routine PR；B contributor PR 走 5 層免疫審核）
• Issue 重複回應檢查（Step 2.4 前置 gate）：對 last-active issue 跑 gh issue view N --json comments -q '.comments[-1]'，避免維護者連續自答
• 🔴 紅旗 check（Step 2.3.1 ground-truth check）— 命中即 abort + LESSONS append

---

Stage 3: ACT — 真實 backlog 才動，empty cycle 警示鐵律

鐵律（2026-05-28 新增）— 空場 cycle ≥ 3 次連續 = 結構性訊號，不是 healthy 自我合理化：

• 連續 ≥ 3 cycle empty queue → 不准只記「healthy empty」走人。必須寫 LESSONS-INBOX entry「maintainer schedule 撞期早晨 chain」並 escalate observer：
  • Maintainer-am 08:30 跑時 morning chain (06:00-08:00) 已清完所有可動 backlog
  • vc=7 不是「organism 健康」是 schedule 不對齊真實 contributor PR submission window
• 不要再用「default-action 反向第 4 種 performative work」自我合理化第 N 次空場

鐵律（2026-08-11 哲宇 directive）— issue 的 default 是修好，不是分類好：

「maintainer 不只要回覆 issue，而是要協助回應、判斷、評估、研究、落檔，然後執行相關的修正與自我進化或是網站更新，這樣才有意義。」

• cycle 結束時 issue 只是被分類得更整齊 = 這個 cycle 沒有產出。加 label / 補交叉參照 / 寫 handoff 都不算解決
• 每則 issue 跑五步：判斷（重現得出來嗎）→ 評估（根因在哪一層）→ 研究（追上游）→ 落檔（寫下判斷與否定的路）→ 執行（真的改掉）
• 追上游優先於逐則修：≥ 2 則指向同一表面時，先問「這幾則是不是同一個地方破的？那裡為什麼沒有東西在守？」。修根因 + 補閘門 + 連帶 close 症狀 issue，勝過打 N 個補丁
• 修完必做兩件：(a) 補上讓它無法安靜復發的閘門 (b) 真的驗證——UI 改動就開瀏覽器看一眼，資料改動就對一次 ground truth。改完不看 = 只做了一半
• 「評估後決定不修」是合法的，但要寫明為什麼；沉默地沒修不算
• 邊界不變：§自主權邊界 命中 → reserve；改 zh SSOT 內容 → 走 REWRITE；對回報者本人說話 → 人類 gate

完整 SOP：MAINTAINER-PIPELINE §1c + §Step 3.6

真實有 backlog 時 act 範圍：

• B 路徑 contributor PR 5 層免疫 → merge or close + comment per feedback_reply_to_contributors
• broken-link audit gated ratio ≥ gate（閾值 canonical：verify-internal-links.sh THRESHOLD_PERCENT，現 7%，step-down 7→4→2）→ deterministic 修直接跑；需 intent inference 的 case 升級派工（per 2026-06-09 教訓）。es/fr REPORT-ONLY
• build red → diagnose + heal commit

---

Stage 4: WRAP — Quality gate + Handoff

Gate	檢驗
open issues 都有 status label / assignee	✅/❌
open PRs ≤ 5d age 都有 review comment	✅/❌
broken-link gated ratio < gate（script canonical 現 7%；DNA #52+#66）	✅/❌
build green	✅/❌
BECOME ACK 一行記憶體頂	✅/❌
連續空場 ≥ 3 cycle 有 LESSONS entry	✅/❌
有 fresh issue 的 cycle，至少一件被修掉或明確寫出為什麼不修	✅/❌

Handoff 三態（必寫 memory file）：

• [ ] pending — 跨 session 未動
• ⏳ blocked — 等外部 / 等觀察者
• [x] retired by

/twmd-finale chain → memory + commit + push main-direct。

---

報告格式（routine 模式必跑）

🧬 Maintainer cycle report — YYYY-MM-DD HH:MM
✅/❌ open issues: N (stale > 5d list)
✅/❌ open PRs: N (stale > 5d list + review status)
✅/❌ broken-link gated ratio: X% (< script gate pass; es/fr report-only 另列)
✅/❌ build status: green/red
✅/❌ 連續空場 cycle vc=N (≥ 3 = warning)
⚠️ 異常 / 需觀察者決策事項

---

鐵律

• DNA #35：sub-agent 跑期間禁 git reset --hard
• Routine v2.0 main-direct：routine 直接 commit + push origin main 不開 PR；A 路徑 collect-and-merge 廢棄
• Reply to contributors：close / handle issue/PR 必 reply 感謝 + 解釋 + 用 contributor 的語言（per feedback_reply_to_contributors）
• Bias 1 reverse：對哲宇預設加分要過 MANIFESTO §自主權邊界 過濾，不是無條件執行

完整 SOP：MAINTAINER-PIPELINE.md