用途:让已收录的组织数据保持最新,抓取其来源并重新生成 AI 概览。该流程由 Claude Code 通过已安装的 releases CLI 对接生产 API 驱动,分为两部分:抓取(拉取所有活跃来源,无需 AI)与重生成概览(基于更新后的发布集重新生成组织 AI 摘要,属于 AI 工作,走 regenerating-overviews 技能)。当前没有一步完成的“一次刷新”命令,需组合两步。
适用场景:周期性维护(如“更新前 10 个组织”);分析前确保数据新鲜;新组织首次完整抓取与概览生成;抽查某组织数据是否最新。
单组织更新:先运行 releases admin source fetch --org <slug> 抓取活跃来源(跳过 paused);再通过 regenerating-overviews 技能重生成概览,其输入与更新命令为 releases admin overview inputs <slug> --json 与 releases admin overview update <slug> --content-file /tmp/<slug>-overview.md。含 scrape 或 agent 来源的组织在抓取前可先查看 releases admin playbook <slug>。抓取常用参数包括 --max、--concurrency、--dry-run、--stale、--changed、--retry-errors。结果验证可用 releases admin overview get <slug>;若 inputs 返回 selected: [] 则不写概览,通常表示抓取未命中或来源均已暂停。注意 overview get 不返回引用,需从 update 响应确认引用数。
批量更新:可用并行 Claude Code 子代理(每组织一个),或推荐的 update-overviews 动态 Workflow(.claude/workflows/update-overviews.ts),后者封装选择、预抓取、预算受控的生成波次、HTML 反转义、lint、引用偏移重算与运行记录,仅限本地 Claude Code,消耗会话 token,默认 dry-run,需按 scriptPath 启动而非名称。目标选择可由 releases admin overview plan --stale-days 14 --missing --has-activity --json 生成清单,或使用 overview list。分发前可用 overview inputs <slug> --check --json 预检。
限制:无 curl 回退的抓取步骤在 CLI 无法访问 API 的沙箱中可能需跳过;overview update 对引用是全量替换,省略 --citations-file 会清空原有引用;高流量组织的 inputs 负载可能超 Bash 输出上限导致静默截断。