canary-watch

canary-watch 技能概覽

canary-watch 是一個部署後監控技能，用來在發布、合併或相依套件更新之後，檢查實際上線 URL 是否出現回歸問題。當你需要的是一個快速、可重複、能跑在真實環境上的 canary，而不是只靠猜測這次發布安不安全的泛用提示詞時，就該用 canary-watch 技能。

它特別適合工程師、SRE 和產品團隊，用來確認應用程式是否仍能正常載入、關鍵 API 是否有回應，以及重要的 UI／內容訊號是否還在。它要解決的核心工作很單純：在更多使用者受到影響前，及早抓到故障，方便你回滾或進一步調查。

canary-watch 實際會檢查什麼

這個技能聚焦在實用的回歸訊號：HTTP 狀態、主控台錯誤、網路失敗、效能偏移，以及像 h1、nav、footer 或 CTA 這類關鍵頁面元素是否消失。這讓 canary-watch 比一句「網站有沒有活著」更有用，特別是在高風險變更之後。

canary-watch 最適合用在哪裡

canary-watch 很適合用在正式環境或 staging 的 smoke check、上線窗口監控、基準比較，以及修正後驗證。當你已經知道目標 URL，而且想要的是帶有門檻的監控結果，而不是一場大範圍除錯時，它會是很強的選擇。

什麼情況下不建議用 canary-watch

如果你需要深入的根因分析、跨服務 tracing，或長期的可觀測性儀表板，canary-watch 並不是完整解法。它是一個專注於短時程監控與回歸偵測的技能，不是你 logging 或 APM 堆疊的替代品。

如何使用 canary-watch 技能

在工作區中安裝 canary-watch

先依照 repository 提供的安裝指令走 canary-watch 的安裝流程，然後在正式工作前確認你的 agent 環境裡已經能使用這個技能。如果你的平台使用的是不同的 skill manager，也可以把同一個 skill slug canary-watch 對應到那個系統中。

把模糊目標改寫成可用提示詞

canary-watch 的使用方式在你提供 URL、watch mode 和成功邊界時最有效。較弱的輸入是：「幫我檢查我的網站。」較強的輸入是：「部署後先監控 https://app.example.com 30 分鐘，偵測新的 console errors、5xx API 回應，或 nav 與 CTA 元素消失，並與目前 baseline 比對。」

先讀這些檔案

先從 SKILL.md 開始，再查看技能提到的任何相關 repo context。對 canary-watch 來說，最有價值的來源是 SKILL.md 裡的使用方式與 threshold 邏輯，尤其是 watch modes、alert thresholds，以及技能認定哪些情況算是有意義的 regression。通常讀到這裡，就已經足夠調整工作流程，而不必把整個 repo 翻遍。

選對 watch mode

一次性的 smoke test 用 quick check；若要覆蓋上線後一段時間，使用 sustained watch；當你想比較 staging 與 production 時，則用 diff mode。對 canary-watch for Monitoring 而言，mode 比措辭更重要：先定義 interval、duration 和 comparison target，避免讓 agent 自行替你編出一套監控計畫。

canary-watch 技能 FAQ

canary-watch 只適合 production 嗎？

不是。canary-watch 技能也適用於 staging，而且 staging 通常更適合先驗證高風險變更，再推進到 production。關鍵在於你要有一個已部署的 URL，而且它的行為能和已知 baseline 做比較。

canary-watch 和一般提示詞有什麼不同？

一般提示詞也可以要求做檢查，但 canary-watch 的使用方式是圍繞明確的 watch mode、threshold 和 regression signals 來組織。這樣可以降低歧義，當你要決定是否繼續推進或先停下時，結果也會更可執行。

我不需要很專業也能用嗎？

可以。只要你能說出 URL、時間範圍，以及你在意的主要失敗訊號，初學者也能使用 canary-watch。最常見的錯誤是對「什麼算正常」描述得太模糊，最後就會得到雜訊過多或資訊不完整的結果。

它可能會漏掉什麼？

canary-watch 不適合只存在於後端、但不會反映在 HTTP、console、network 或頁面內容訊號中的故障。當你需要歷史趨勢或多服務關聯時，它也無法取代完整的效能或 incident management 工作流程。

如何改善 canary-watch 技能

提供更清楚的 baseline

能大幅提升品質的關鍵，是告訴 canary-watch 什麼叫正常：確切的 URL、預期頁面狀態，以及必須保持健康的關鍵元素或 endpoint。如果你知道 baseline 本來就很吵，也要直接說明；不然這個技能可能會把無害變動誤判成問題。

指定門檻，不只描述症狀

不要只說「感覺變慢了」，而是要用具體限制，例如「LCP 超過 4 秒就標記」、「CLS 高於 0.1 就警告」，或「偵測到新的 5xx 回應就告警」。canary-watch 最強的地方，就是你能給它可量化、可對應發布決策的界線。

第一次執行後再收斂提示詞

如果第一次 canary-watch 的輸出範圍太廣，就把範圍縮小到更少的 endpoint、更少的元素，或更短的監控窗口。如果它漏掉問題，就補上精確的使用者路徑、頁面狀態，或失敗的 API，讓下一次檢查對準正確的表面。

把它當成發布閘門，不只是好奇檢查

最好的 canary-watch 用法，是讓每次執行最後都導向一個決策：繼續 rollout、暫停，還是進一步調查。把每次執行都當作發布檢查點，並把結果回饋到下一次提示詞裡，這個技能就會愈來愈符合你的環境。