CtrlK
BlogDocsLog inGet started
Tessl Logo

twmd-maintainer

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.

Invalid
This skill can't be scored yet
Validation errors are blocking scoring. Review and fix them to unlock Quality, Impact and Security scores. See what needs fixing →
SKILL.md
Quality
Evals
Security

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

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

Repository
frank890417/taiwan-md
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.