SuperAPI AI 工具集

changelog

写作与研究

查看项目

更新于 10-15 23:57

技能介绍

用途:为 nurb.dev 的 changelog 页面撰写版本更新条目。该页面是单一静态文件 site/changelog.html,每个已发布版本对应一个 <article class="release">,最新在前,没有构建步骤和数据文件,HTML 本身就是数据。

主要能力:以 release 为单位,从版本合并的 PR 中筛选出用户能注意到的变化,按能力而非 PR 分组,起草面向普通爱好者(而非程序员)的文案,并插入页面。

使用方式:先用 grep -m1 'id="v' site/changelog.html 找最新版本作为水位线,再用 gh release list --limit 20 和 gh release view vX.Y.Z --json publishedAt,body 找出缺失版本;必要时用 gh pr view N 阅读 PR。筛选标准是用户不读代码也能察觉差异,CI、测试、重构、仓库文档等内部改动不写。文案用第二人称、句首大写、纯英文,不出现 Python、模块名、build123d、OCCT 等术语,标签为 new、improved、fixed。插入时复制相邻条目的标记结构,日期用 release 的 publishedAt。验证时用 python3 -m http.server 7878 -d site 起服务并截图检查,另用 git diff 与 grep 检查破折号和重复版本号。

限制:不重写或删除已发布条目;未要求时改动保持未提交;若某版本全是内部改动则不写条目并说明。