SuperAPI AI 工具集

patch-notes

通用与其它

查看项目

更新于 10-15 21:11

技能介绍

用途:为指定版本生成面向玩家的补丁说明(patch notes),把内部开发语言转成玩家能理解的表达,并确保历史记录确属本游戏。

主要能力:解析版本号与 --style(brief、detailed、full,默认 detailed);读取 production/releases/[version]/changelog.md、docs/CHANGELOG.md、版本间 git log、冲刺回顾、设计平衡文档与 QA 修复记录;检测语气指南和模板;把变更归类为新内容、玩法改动、体验优化、Bug 修复、性能、已知问题;保留平衡数值的改动前后值;输出前剔除纯内部改动。

使用方式:先运行 /changelog [version] 生成内部日志,再运行 /patch-notes [version]。生成前会做来源校验:抽样 git log,将每条提交分类为 Game、框架/维护或 Unclear,只有至少一条 Game 提交才继续;零条时停止并提示指向正确历史。随后向用户展示结果与各类计数,征得同意后写入 docs/patch-notes/[version].md 和 production/releases/[version]/patch-notes.md。

适用场景:游戏项目发布前准备玩家向更新说明,需要在框架仓库中过滤出真正属于游戏的提交。

限制:无变更数据时停止,需先生成内部日志;纯维护提交不进入玩家文案;模型、平台或收费等资料未提供。