arch3rPro/digestpilot

Release Watch

概述

當使用者詢問受監控的軟體、框架、工具或程式庫是否有新版本，以及這些版本是否值得升級時，使用此技能。

將此工作流程與公開趨勢探索分開。GitHub 發布是升級監控訊號，而非趨勢雷達的輸入。

工作流程選擇

• 對於受監控軟體的版本更新，使用此技能。
• 對於公開生態系統趨勢卡片，使用 public-trend-radar。
• 對於一般的訂閱 RSS 每日新聞，使用 rss-ai-digest。
• 對於來源品質與註冊表維護，使用 rss-source-curator。
• 對於基於證據的深入研究綜合分析，使用 subscription-research-agent。

執行命令

範例使用 subscription-research 作為相容性命令。在運行命令之前，請先解析執行命令：

• 當 DIGESTPILOT_BACKEND_URL 可用時，產品操作（如發布監控重新整理或基於 WebUI 的升級監控）可先使用後端任務 API，然後讀取產生的工作區輸出。
• 如果後端 API 不可用，請繼續使用以下本地執行命令備用方案。請勿在通用代理環境中要求 WebUI、雲端或託管服務。
• 當環境提供自訂執行命令時，使用 DIGESTPILOT_RUNTIME_CMD。
• 當 digestpilot-runtime 在 PATH 中可用時使用它。
• 當 PATH 上只有舊的相容性命令可用時，使用 subscription-research。
• 如果是從儲存庫簽出且沒有連結命令，請將 subscription-research 替換為 node packages/research-cli/dist/src/cli.js。
• 從儲存庫根目錄運行 node scripts/doctor.mjs 以診斷本地執行環境設定。
• 如果沒有可用的執行命令，但此儲存庫或外掛套件包含執行原始碼，請運行 node scripts/bootstrap-runtime.mjs，然後重試該命令。

核心命令

準備監控清單：

{
  "repos": [
    {
      "id": "vercel/ai",
      "importance": "high",
      "current_version": "v5.1.0",
      "used_capabilities": ["streaming", "tool-calling"]
    }
  ]
}

擷取即時 GitHub 發布並呈現升級卡片：

subscription-research release watch \
  --watchlist release-watchlist.json \
  --state release-seen.json \
  --mark-seen \
  --format markdown \
  --output release-watch.md

預設情況下，執行環境會為每個受監控的儲存庫擷取最近的 GitHub 發布。當需要更高的 GitHub API 限制時，請設定 GITHUB_TOKEN，或傳遞 --github-token-env NAME 以讀取不同的令牌變數。

對於離線測試或匯出的資料，請傳遞預先準備好的 GitHub 發布 JSON：

subscription-research release watch \
  --watchlist release-watchlist.json \
  --github-releases github-releases.json \
  --state release-seen.json \
  --format markdown

預先準備好的發布 JSON 使用以下格式：

{
  "repositories": [
    {
      "repo": "vercel/ai",
      "releases": [
        {
          "tag_name": "v5.1.1",
          "name": "v5.1.1",
          "html_url": "https://github.com/vercel/ai/releases/tag/v5.1.1",
          "published_at": "2026-06-12T00:00:00Z",
          "body": "Release notes..."
        }
      ]
    }
  ]
}

輸出指引

Release Watch 的輸出應為升級佇列，而非趨勢清單。

使用以下優先級：

• upgrade-now：影響受監控功能的安全性修復或緊急修復。
• review：破壞性變更、重大更新或影響受監控功能的更新。
• watch：預發布版本或影響不明確的更新。
• ignore：僅限維護或文件說明的發布。

Markdown 輸出應專注於可操作的發布。JSON 則保留所有卡片（包括被忽略的發布），用於自動化處理。

當監控清單中包含 current_version 時，Release Watch 會新增 version_delta、upgrade_action 和當前版本上下文。使用此資訊來區分修補程式升級、次要升級和重大遷移審查。

邊界

請勿自動修改使用者依賴項、建立升級 PR 或發布通知。產生可供審查的升級卡片，讓使用者決定下一步行動。