SuperAPI AI 工具集

summarize-releases

设计与创作

查看项目

更新于 10-16 07:24

技能介绍

用途:把 NVIDIA Elements 近期的发布整理成带日期的文档页,说明改了什么以及用户为何关心,并留下经过校验的改动供定时智能体提议为拉取请求。

主要能力:从仓库根目录运行收集脚本,默认收集上一个自然月,也可用 --month YYYY-MM 指定月份,--json 输出结构化数据,--include-prereleases 仅在需要预览版时使用。脚本只读取本地 Git 克隆,不调用 GitHub API、不查询 npm、不需要令牌,负责确定文档页路径、URL、标题、覆盖月份、发布日期、布局与收集标签,以及发布标签及其创建日期、各标签的包名与版本、带标签 package.json 版本校验、带标签 CHANGELOG.md 的对应章节、跨包变更日志的重复提交合并、约定式提交元数据与改动文件统计。

使用方式:先检查仓库新鲜度,必要时执行 git fetch --tags origin;若无法拉取,需说明结果仅覆盖本地标签。阅读完整证据包后再起草,对每个可能面向用户的 feat、fix、perf 变更读取完整提交信息与改动文件列表,必要时用 git show --stat --patch <sha> -- 查看差异,并核对公开 API、组件行为、示例、文档与测试。起草前建立覆盖清单,记录用户结果、相关文档链接、是否需要短代码示例、是否单独突出。文档页按证据包给定的 frontmatter 与结构撰写,包含 Highlights 与 Released packages,面向 Elements 用户而非维护者,目标两到三分钟阅读,约 350–600 词正文,配两到五个主题小节。完成后运行 mise exec -- vale <page.filePath>、mise exec -- pnpm exec prettier --check <page.filePath>、mise exec -- pnpm --dir projects/site run build、git diff --check 检查。随后按 summarize-video-releases 生成同月配套视频,完成故事板、审阅、渲染、海报与功能快照及所需 frontmatter。最后准备一段约 80–180 词、可直接粘贴到 Slack 的摘要,标题链接到 page.url。

适用场景:NVIDIA Elements 仓库的月度发布说明整理、文档页与视频同步产出、定时智能体自动提议拉取请求。

限制:收集器只能报告克隆中已有的标签;跳过包版本与标签名不匹配的标签并给出警告;缺失变更日志章节视为证据错误;克隆中不存在的提交需拉取更多历史或披露缺失;无发布标签时不创建页面或空发布拉取请求;不得用未发布提交替代,除非用户明确要求预览;不得编造摘要;不重复创建同月页面;不编辑 What's New 索引;datePublished 发布后固定,仅在真正修订内容时推进 dateModified。