用途：审计、补全与发布 Warp 的变更日志片段（changelog fragment），并处理发布后的同步。CHANGELOG.md 只作历史记录，待发布条目的来源是 changelog/ 目录下的片段文件。
主要能力：
- 三种模式：main 模式只审计与编辑待发布片段，不构建发布区块；release 分支模式审计片段、生成发布区块并按用户影响排序、更新比较链接；发布后同步模式在 main 上还原已发布 tag 的最终日志区块，仅删除已随版本发布的片段。
- 片段建模与遗漏恢复：记录路径、标识、类别、内容、关联 issue、引入与修改提交、渲染后的 bullet；通过提交范围与 cherry-pick 过滤找出可能缺失的用户可见变更。
- 校验与合并：核对新公共 API、破坏性变更、量化声明等，合并未发布的同一特性多轮迭代条目。
- 语言规范的统一：按 references/language-conventions.md 改写措辞、规范 Markdown、行宽不超过 120 列。
- 定稿：用 Towncrier 构建最终发布区块，按 references/sorting-rubric.md 排序并更新比较链接。
必要用法：
- 先读目标 ref 的 changelog/README.md，其命名与内容规则为准。
- 所有预览必须用 draft 构建，且不得修改仓库：uvx --from towncrier==25.8.0 towncrier build --draft --version <X.Y.Z> --date <YYYY-MM-DD>
- 最终构建：uvx --from towncrier==25.8.0 towncrier build --yes --version <X.Y.Z> --date <YYYY-MM-DD>
- 枚举片段：git ls-tree -r --name-only <ref> -- changelog；rg --files changelog
- 每条 Warp 命令使用唯一的 WARP_CACHE_PATH；需要验证时先构建 Warp，不以二进制过期为理由跳过验证。
- 可选位置参数为任意 Git ref，默认 HEAD；release- 开头的分支名进入 release 模式。
限制与规则：
- 绝不修改 main、master 或 detached HEAD；需要编辑时先提议可写分支并等待确认。
- 脏工作区需上报，由用户决定，绝不自动 stash。
- 只在片段文件上编辑，不在 CHANGELOG.md 上补写待发布条目；最终构建后仅允许修改新生成的发布区块和比较链接块。
- 发布后同步以 tag 区块为准，不得按片段或 Towncrier 默认顺序重建；只有构建提交能证明被消费的路径时才删除片段。
- 所有改动先放入临时暂存区，经用户查看合并 diff；发布定稿与 cherry-pick 需分别显式确认。
- 无待发布片段时报告空 draft，不据历史最新区块推断；无上一 tag 时跳过遗漏恢复并说明。
- GitHub CLI 不可用时跳过在线 issue 查询，保留文件名身份并说明。
关于收费、平台支持范围等细节，资料暂未提供。