Release Watch（发版监控）是做什么的？

概述

当用户询问所关注的软件、框架、工具或仓库是否有新版本以及是否值得升级时，使用此技能。

请将该工作流与公共趋势发现分开。GitHub 发版是升级监控信号，而非趋势雷达输入。

工作流选择

对于所关注软件的版本更新，使用此技能。
对于公共生态趋势卡片，使用 public-trend-radar。
对于普通的订阅RSS每日新闻，使用 rss-ai-digest。
对于源质量和注册表维护，使用 rss-source-curator。
对于基于证据的深度研究综合，使用 subscription-research-agent。

运行时命令

示例中使用 subscription-research 作为兼容命令。在运行命令前，请先解析运行时命令：

当 DIGESTPILOT_BACKEND_URL 可用时，产品操作（例如发版监控刷新或基于 WebUI 的升级监控）可先使用 Backend 任务 API，然后读取生成的 workspace 输出。
如果 Backend API 不可用，则继续使用以下本地运行时命令回退方案。在通用 Agent 环境中，不要要求 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 或发布通知。只生成可评审的升级卡片，让用户决定下一步操作。

Release Watch（发版监控）