用途:为缺少显式 CHANGELOG-* 标记的 PR 提供分类规则,changelog-draft 代理据此决定是否收录未标记 PR。
主要能力:定义分类 NEW-FEATURE(值得文档或推广的重大用户可见新能力)、IMPROVEMENT(用户可感知的现有功能增强)、BUG-FIX(修复用户可见缺陷或回归)、OZ(Oz/AI 代理能力变更,稳定版每版最多 4 条)、TUI(影响 Warp Agent CLI/无头 TUI 的可见变更)、NONE(显式排除,由 fetch_prs.py 上游处理)。
决策规则:始终排除显式 CHANGELOG-NONE、已知机器人(dependabot、renovate、github-actions、codecov)、仅改 CI 工作流/测试/开发工具、仅改内部文档注释 README、无用户可见行为的依赖升级与重构;始终包含显式 CHANGELOG-* 标记,以及修复崩溃、数据丢失或安全问题的 PR。
TUI 判定:显式 CHANGELOG-TUI 与 CHANGELOG-OZ 为权威条目,可与其他类别共存;TUI 影响独立于常规类别判断,commit_subject 含独立 TUI 标记即视为影响 TUI;稳定版还可参考标题正文及 crates/warp_tui、crates/warpui_core/src/elements/tui 等路径,但不得仅凭路径推断,需确认 CLI 用户可观察到;仅 TUI 的条目只归 TUI,同时影响两者则两处都出现。
渠道规则:稳定版仅收录对所有用户生效的变更,排除 DOGFOOD_FLAGS 或 PREVIEW_FLAGS 门控;预览版收录 PREVIEW_FLAGS 门控,仍排除仅 DOGFOOD_FLAGS;开发版收录所有用户可见变更。涉及 FeatureFlag 时需判断所属列表,RELEASE_FLAGS 或 app/Cargo.toml 默认启用视为已上线,并在输出中设置 feature_flag。
置信度:high 为清晰可见且类别明确;medium 为可能可见但类别或范围模糊;low 为不确定用户是否感知或同时涉及内部与用户代码,需设 needs_review: true。
文案要求:以用户视角写“Added X”“Fixed Y”“Improved Z”,一句话且不超过 120 字符,不引用内部实现、路径或函数名,不以 PR 或编号开头,新功能用主动语态现在时,修复用过去时。