SuperAPI AI 工具集

release-notes

通用与其它

查看项目

更新于 10-15 21:08

技能介绍

用途:把开发活动转成项目经理 30 秒可扫读的发布说明,让 PM、QA 和运维了解改了什么、为什么改、现在好在哪里。只总结已发生的工作,不负责规划、建 issue 或代码审查。

主要能力:支持四种生成模式——按日期或日期范围过滤本地 git 历史并按项目分组;会话摘要,合并会话修改文件、笔记与 diff;功能摘要,把某功能的提交讲成一个 Problem→Change→Impact 故事;版本范围(如 v1.3.0..v1.4.0 或“自上次发布以来”),用 git tag --sort=-version:refname 解析本地标签并记录 <from>..<to>。输出为单个 markdown 文件,按模式套用 assets/release-notes-template.md 或 assets/session-summary-template.md。

写作规则:用日常词汇,避免术语;每条一个想法、一句短句;Problem 写用户遇到的症状,Impact 写具体改善;把工程细节翻译成用户可见效果;逻辑变化时加一句“Simple logic explanation:”。

使用方式:按模式收集证据,日期/功能/版本历史需加载 references/git-collection.md;会话工作用会话笔记、修改文件和相关 diff。禁止运行 git fetch、git pull 或任何修改本地 git 状态的命令。独立工作可自动派发本地子代理,不使用云端代理。文件保存到 <artifacts-root>/specs/release-notes/,文件名如 10-March-2026.md,日期范围如 10-March-2026-to-12-March-2026.md。

限制:不编造功能、收费、价格、平台、效果或步骤;缺失事实明确写暂未提供。不添加 AI 或工具署名。冲突处理时保留现有内容,不覆盖未确认的手工编辑,不删除无关文件。