SuperAPI AI 工具集

rea-changelog-update

通用与其它

查看项目

更新于 10-16 01:19

技能介绍

用途:在 REA 项目的发布准备阶段生成或重写更新日志和 GitHub 发行说明,并处理贡献者致谢,基于固定 Git 历史进行。

主要能力:先从仓库根 docs/releasing.md 阅读发布权限与检查点要求;通过 node scripts/release-notes.mjs inventory 拉取完整历史与标签,并以 .release-please-manifest.json 中已发布基线标签和分支精确 SHA 为编辑目标,生成贡献清单;再用 record 生成摘要记录。标签格式为 rea-agents-VERSION,沿用拟议版本及其预发布后缀,不改变始终提升次版本号的策略。清单包含侧分支提交、范围内的已关联 PR、提交作者/共同作者以及确认关闭的问题报告者;网络错误会中止生成,已有输出文件不会被覆盖。未解析的身份保留为姓名/邮箱且 user 为 null,不猜测账号。

撰写规则:只重写 CHANGELOG.md 中最新的 ## [VERSION] 段落,保留版本/日期/链接标题,使用单行 Markdown 列表,分 Highlights、Changes、Fixes、⚠ BREAKING CHANGES(适用时)四类;按分析师工作流或用户影响归组,简明描述行为结果;内部清理、测试、CI 和例行文档一般只写入出处文件。每项贡献在公开说明中只致谢一次并附链接,排除 GitHub 机器人及已知代理账号(如 @claude、@cursoragent、@codex),按要求省略 @morluto 自我致谢但保留作者信息。将生成的 record --summary 出处链接原文追加到本次发行末尾;不把完整记录粘贴到公开说明中,不手改生成的致谢。

定稿流程:在修改在线发行 PR 前需获得该 PR 更新授权;先加 rea:release-notes-finalized 标签再编辑分支/正文,已运行的提案需先完成。将清单保存为 docs/releases/VERSION.contributions.json,运行 check 与 render 校验;检查器支持内联 PR 正文(上限 GitHub 的 65,536 字符),超限会失败而非截断。用 gh pr edit --body-file 更新正文并保留 Release Please 页眉/页脚与组件/版本结构;重新获取正文并运行 check --pr-body FILE,审查完整 diff 并等待 CI。

限制:本技能仅准备说明,不授权合并、打标签或发布;最终化标签冻结机器人刷新而非主分支,目标之后的新产品变更需刷新清单;工作流要求清单目标等于已审查合并的首个父提交;已有贡献清单的旧发行沿用原发布路径,不得为修正文本重新打标签或重新发布。