SuperAPI AI 工具集

update-release-notes

测试与质量

查看项目

更新于 10-16 08:07

技能介绍

用途:根据当前分支相对 main 的变更,更新 docs/docs/about/release-notes.mdx 中的发布说明。

主要能力:收集分支提交、读取当前未发布版本段落、按提交信息分类变更、分析新命令、格式化条目并插入到未发布版本中,最后回读校验。

使用方式:先运行 git log --grep="Updates release notes" -n 1 --format="%H" 获取最近一次发布说明更新的提交哈希,再用 git log <commit_hash>..HEAD --oneline --no-decorate 查看变更;若分支没有领先 main 的提交则停止。读取 release-notes.mdx 顶部未发布版本段落(形如 ## vX.Y.Z 无链接),若不存在则停止,不新建版本标题。按提交信息分类:Adds '...' command 为新命令,Fixes 为修复,Extends/Enhances 为增强,Migrates 为迁移,其余为其他变更。新命令需提取命令名、工作负载前缀(如 spo→SharePoint、teams→Teams)、文档路径和描述。条目格式:新命令为 - command name - description #issue;变更为过去式动词描述并链接 issue。插入到未发布版本段落,新命令按工作负载加粗分组,变更追加到列表末尾。

适用场景:cli-microsoft365 仓库维护者更新发布说明。

限制:仅处理该仓库的 release-notes.mdx;无未发布版本段落或无新提交时停止;不创建新版本标题;需人工确认链接与格式。