SuperAPI AI 工具集

release-note-writer

写作与研究

查看项目

更新于 10-16 00:32

技能介绍

用途:该技能帮助为 Visual Studio Code 撰写和审阅两类发布说明——Insiders 版(按日期分组,收录最新功能更新)与 Stable 版(按功能区域分节,汇总稳定版重要功能与改进)。它同时包含针对恢复版本(recovery release)的更新说明流程。

主要能力:依据给定模板和示例生成发布说明文件;从 GitHub 拉取指定里程碑下已关闭的 issue 与 PR,为每条 issue 写简洁准确的技术摘要并链接(格式如 #12345: Issue title);维护目录(TOC);对已有 Stable 说明做写作规范审阅并给出改进建议;处理恢复版本说明(更新前沿信息中的下载版本,并在发布日期后添加指向修复 issue 的说明)。

使用方式:输入需提供发布版本号与里程碑名(Insiders 场景),Stable 场景还需提供发布月份和年份,缺失时须向用户询问。文件存放于 /release-notes 目录,命名为 v<version>.md(如 v1_109.md)。Insiders 需复制 vscode-insiders-header.webp 与 vscode-insiders-banner-medium.png 到对应图片目录。获取 issue 的命令为 gh search issues --repo microsoft/vscode --label <label name> --milestone <milestone name> --state closed "closed:>=<latest update date>" -L 100。默认 label 为 feature-request;重复或非计划 issue 应忽略。写作上优先遵循发布说明写作说明,其次为 VS Code 文档写作规范;Insiders 条目倾向使用“Add support for ...”而非“... now supports ...”,并避免使用 now 一词。

适用场景:VS Code 各版本发布说明的起草、更新与审阅,包括 Insiders 与 Stable。

限制:具体模板内容、示例文件与检查清单细节暂未提供;不编造未给出的功能或流程。