用途:为拉取请求(PR)生成 CHANGELOG 条目行。当用户要求编写 changelog 条目、填写 PR 的 changelog 部分,或需要根据代码变更生成条目时使用。
格式:CHANGELOG entry: <过去时摘要> 或 CHANGELOG entry: null。
判定规则:若为面向用户的变化(新功能、缺陷修复、UI 变更、用户可感知的行为变更)则写过去时摘要,如 Added...、Fixed...、Updated...、Removed...;否则(重构、测试、CI、内部工具、仅开发侧变更)写 null。
使用步骤:先读取差异 git diff main...HEAD,判断是否有面向用户的变更,有则写简洁的过去时主影响摘要,无则写 null。每个 PR 只写一条,即使有多处变更,也汇总主要面向用户的影响。
校验与绕过:CI 会校验该行存在且非空(.github/scripts/check-template-and-add-labels.ts),该行必须包含 CHANGELOG entry: 后跟非空值(前导空白 CI 可容忍)。添加 no-changelog 标签可跳过该检查。
示例:面向用户时如 CHANGELOG entry: Added dark mode toggle to settings screen、CHANGELOG entry: Fixed token balance not updating after swap、CHANGELOG entry: Updated network selector to show custom networks first、CHANGELOG entry: Removed deprecated fiat on-ramp provider;非面向用户时为 CHANGELOG entry: null。
限制:未提供其他平台支持、收费、价格或效果信息。