用途:标准化新版本文档变更日志(latest.md、preview.md、index.md)的更新流程,输入为自动生成的发布信息。
输入:version(版本字符串,如 v0.28.0、v0.29.0-preview.2)、TIME(发布时间戳,如 2026-02-12T20:33:15Z)、BODY(含 "What's Changed" 和 "Full Changelog" 链接的原始 Markdown 发布说明)。
主要能力与规则:
- 版本判断:含 "nightly" 则停止,不做任何更改;以 .0 结尾走 Path A(新的小版本),否则走 Path B(补丁版本);每个路径再按稳定版或预览版分别处理。
- 时间处理:把 TIME 转换为 yyyy-mm-dd 和 Month dd, yyyy 两种格式。
- 正文处理:将 BODY 存入临时文件;把 "What's Changed" 中的 PR URL 重格式化为以 PR 编号为文本的 Markdown 链接(如 #12345);若存在 "New Contributors" 段则删除;保留 "Full Changelog" 链接。
- 亮点撰写规范:3-5 个要点,每个以粗体标题开头,优先总结新功能,稳定版不提及 experimental 或 in preview 功能,不包含 PR 编号、链接或作者名。
稳定版小版本(A.1):为 index.md 生成简洁公告(含 1-2 个 PR 链接与作者)加到顶部;按 latest_template.md 填充 version、release_date、highlights 与处理后的正文,整体替换 latest.md。预览版小版本(A.2):按 preview_template.md 填充并整体替换 preview.md。
补丁版本:稳定补丁(B.1)更新 latest.md 的主标题为 "# Latest stable release: {{version}}"、发布日期行、把处理后的 "What's Changed" 列表前置到现有列表之前,并仅修改 "Full Changelog" URL 末尾的版本号;预览补丁(B.2)对 preview.md 做同样处理,主标题为 "# Preview release: {{version}}"。
收尾:运行 npm run format 保证一致性,并删除过程中产生的临时文件。
限制与说明:具体模板文件内容、示例样式等来源资料未提供;该技能依赖约定路径下的引用文件与仓库文档结构,适用场景为按发布信息维护变更日志的自动化流程。