用途:在 reports 检出中渲染 digests/<date>.md,聚合该日期每一份报告的 summary、PR、changes to consider 与 errors,并在顶部加上人工撰写的高亮。摘要是磁盘上报告的函数,而非单次研究运行;同日后补研究后重跑会用当日全貌替换旧摘要。全过程保持本地,不发布任何内容。
参数:/provider-research-digest [--date YYYY-MM-DD],--date 为要汇总的日期,默认今天。
用法:第一步同步 reports 检出,记录 RUN_DATE(有 --date 取该值,否则取今天),并选一个仓库外的暂存目录(有会话暂存区就用,否则 mktemp -d -t provider-research-digest)。reports 检出固定为仓库内 ./_reports(已 gitignore);若缺失则 gh repo clone pipecat-ai/provider-watch-reports _reports;若存在且有 remote 则 git -C _reports pull --ff-only,确保看到该日期已发布的全部报告而非陈旧检出。若没有 _reports/reports///<RUN_DATE>.md 则明确报错停止。第二步渲染草稿:uv run python scripts/provider-watch/digest.py --reports _reports --date <RUN_DATE> --out <scratch>/digest-draft.md。阅读草稿,它聚合了当日每个 unit 的 summary、PR、changes to consider 与 errors。第三步撰写高亮:从草稿写出最多 5 条高亮要点到 <scratch>/highlights.md,面向维护者最该先看的内容,如开箱即坏的服务、优先 review 的 PR 与分支、终于有进展的长期空缺、报错的 provider;要依据整个日期而非最近研究过的 unit,没有突出内容就跳过。第四步渲染最终摘要并交接:uv run python scripts/provider-watch/digest.py --reports _reports --date <RUN_DATE> --highlights <scratch>/highlights.md --out _reports/digests/<RUN_DATE>.md。打印摘要路径并以属于调用方而非本技能的下一步收尾:uv run python scripts/provider-watch/publish.py --date <RUN_DATE> --finalize,说明它会发布该日期磁盘上的全部内容(含摘要),推送分支、报告与摘要,并打开或更新 digest issue;只打印命令与说明,绝不运行。
限制与护栏:绝不打印、提交或粘贴环境变量值、Authorization 头或原始 API key;本技能不发布任何内容,绝不 push、绝不打开 PR 或 issue、绝不运行 publish.py,只打印其命令;摘要正文来自 digest.py,只撰写高亮,不得手改渲染出的章节。