mini-taiwan-pulse: Skill for Claude Code

Weekly Audit — 每週巡檢

目的：專案每週都在長（新圖層、新資料源、新疊圖），但所有守門機制都是事件觸發的—— CI 在 PR 時跑、layer-onboarding 在接線時跑、wrap-up 在 session 結束時跑。 沒有人回答「上線三週後這東西還健康嗎」。這個 skill 就是回答這句話的。

設計依據與完整檢查項清單：docs/proposal/weekly-audit-2026-08-21/README.md

何時觸發 / 何時不要

硬約束（違反即中止）

1. 正式 DB 唯讀：只能 SELECT／describe，查詢帶 LIMIT。 每個 session 開頭下 SET SESSION CHARACTERISTICS AS TRANSACTION READ ONLY; （⚠️ 連線字串的 default_transaction_read_only 對 Supabase pooler 無效，實測過）。 禁止任何寫入——包含為了「測試唯讀鎖有沒有效」而試寫。 特別是 pg_stat_statements_reset()：它會清空 C1 的差分基準且不可逆 （2026-08-21 真的被誤觸過一次，8/11~8/21 的統計因此永久遺失）。 要驗證唯讀鎖，用 SHOW transaction_read_only; 讀狀態，不要真的送 DML。
2. 執行時段無限制：這是個人 GIS 專案的 DB。最重的兩支是 probe_upstream（~70s） 與 collect_supabase（~64s，A7 亂碼掃描佔其中約 60s；不含 A7 只要 3.8s）。 想什麼時候跑就什麼時候跑。 ⚠️ A7 預設是抽樣（小表全掃、大表抽樣），能可靠抓到「系統性解碼壞掉」， 但抓不到「大表裡孤零零幾筆壞」。要窮盡檢查跑 AUDIT_MOJIBAKE_DEEP=1（實測 5 分鐘以上）。
3. 報告不得含密鑰：收集器讀 env 但永不 echo 值。產報告前掃一次， 出現疑似 secret 一律 <REDACTED>。
4. 大檔一律 HEAD 不 GET：站上有 46MB 級的 geojson。
5. 不碰平行 session 的髒檔：本 repo 長期有平行 session。dirty 檔只列不動、 不代為 commit、不 revert。
6. 收集器失敗就標 blocked，不因為沒收到資料就寫「無異常」。 _all.json 的 failed[] 必須反映到報告裡。
7. 必須在主工作樹跑，不要在 git worktree 裡跑（2026-08-21 實測）。 worktree 只有 git 追蹤的檔案——public/ 的 1125 個檔在 worktree 裡只剩 156 個 （PMTiles／大 GeoJSON 全被 gitignore 走 S3），且 ../data-collectors 等 sibling repo 的相對路徑會失效。結果是 A3／A5／D5 給出嚴重偏低的假數字、上游探測整組失效， 而且不會報錯——它會安靜地告訴你「只有 18 個 PMTiles」。 主樹被平行 session 佔用時，寧可等，不要改在 worktree 跑。

流程

Step 0 — 前置

• 確認在 repo root、.env 可讀（不讀內容，只確認存在）。
• 看一眼現在幾點：落在 10:00–20:00 就提醒用戶這會打到正式 DB。
• 讀上一份報告 docs/audit/weekly/（最新的那份）——趨勢比較的基準來自報告本身， 不是 .claude/.cache/（cache 不進版控，換機器就沒了）。