用途:这是 .NET 发布说明流水线的增量重跑阶段,适用于里程碑分支集(基础分支加各组件分支)已存在、且已包含草稿 markdown、features.json、评审评论或人工编辑的场景。目标是把现有分支集当作工作基线,而非空白起点。
主要能力:检查同一预览分支或标签是否有更晚的 dotnet/dotnet codeflow 提交;若相关 VMR ref 前移,则在基础分支重新生成 changes.json,否则保留现有文件,专注编辑修正与评论回复。按稳定 id 对比新旧 changes.json,将变更分类为新增、变更、移除或取代、未变。把增量合并进已有 features.json,保留未变条目的 score、score_reason、score_breakdown、breaking_changes、reverted_by/reverts 及人工注释,仅对新增、实质变更或被评审质疑的条目重新评分。
使用方式:先读取基础分支及其 PR、各组件分支及其 PR、基础分支上的 changes.json、features.json、build-metadata.json、各组件分支的 markdown,以及所有 PR 中未解决的评审评论。编辑前将基础分支合并进组件分支以获取最新元数据,只更新本次受影响的组件 markdown,优先整合而非重复,保留仍适用的结构,仅在增量引入全新故事时新增顶层章节。未解决的 PR 评论视为下一次运行的必需输入,需先阅读再改写,用 changes.json、VMR ref、API 验证或最终构建的证据回答事实性问题。
分支约定:changes.json、features.json、build-metadata.json 与 README.md 仅位于基础分支;{component}.md(如 aspnetcore.md、runtime.md)仅位于对应组件分支。
限制:资料未提供具体命令、安装方式、收费或平台信息;不应对未编辑的组件分支做改动,也不应因 changes.json 刷新而整体重写发布说明。