🧬 Taiwan.md — Maintainer Daily v3.0

SkillDev tools

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.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the 🧬 Taiwan.md — Maintainer Daily v3.0 skill

What this skill tells your AI

The instructions your AI receives, as published by frank890417/taiwan-md in .claude/skills/twmd-maintainer/SKILL.md and read by ahel’s review.

🚨 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

Signals

GitHub stars
1k
Forks
185
Last commit
Sep 2026

ahel review

  • K4blow
    destructive-scoped

Automated review, not a security audit. Ruleset v1+k2.

Advanced
Catalog kind
skill
Gateway key
twmd-maintainer
Source
github.com/frank890417/taiwan-md