用途:在运行 changes/versioning 脚本前准备 React Router 的发布说明,整理待发布的 change 文件,并在发布需要叙事性说明时补充人工 What's Changed 内容。
主要能力与流程:用 git status --short 与 find 检查仓库中待处理的 change 文件;逐个阅读,不直接编辑生成的 changelog 或已发布说明。规范化每个文件:去掉 feat、fix 等语义提交前缀;首行与顶层条目使用现在时或祈使语气,推荐词包括 Add、Fix、Remove、Support、Stabilize、Preserve、Update、Avoid、Prevent、Throw、Warn、Expose;嵌套条目在解释父条目时可保留说明性语气;移除句末句号,因为发布生成器会在首行后追加 PR/commit 链接,若标点属于代码、URL、缩写或版本号则保留;单个条目含多句时拆为简短父条目加嵌套条目。首行保持简洁面向用户,细节与迁移说明放入嵌套条目。
判断是否需要 scripts/changes/whats-changed.md:仅面向新功能、future flag 稳定化、unstable flag、迁移指引、破坏性缺陷修复或需要长文与示例的复杂行为,才添加该文件;普通缺陷修复、依赖清理、内部重构或已足够清晰的条目不需要。若添加,只写正文,发布脚本会在缺失时自动加上 ### What's Changed。
验证:运行 pnpm changes:validate 与 pnpm changes:preview,用 preview 检查生成的根发布说明、PR/commit 链接位置、章节顺序及人工 What's Changed 的放置。若依赖缺失或命令开销过大,需说明跳过内容。
限制:资料未提供该技能的版本、平台、收费或效果信息;不得直接编辑生成 changelog 或已发布说明。