patch-notes

当此技能被调用时：

1. 解析参数：
2. version：要生成补丁说明的发布版本（例如 1.2.0）
3. --style：输出风格 — brief（要点列表）、detailed（含上下文）、full（含开发者评论）。默认：detailed。

1. 从多个来源收集变更数据：
2. 如果存在，读取内部更新日志 production/releases/[version]/changelog.md
3. 运行 git log 查看上一个发布标签与当前标签/HEAD 之间的变更
4. 读取 production/sprints/ 中的 Sprint 回顾以获取上下文
5. 读取 design/balance/ 中的数值平衡变更文档
6. 如果可用，读取 QA 的 Bug 修复记录

1. 将所有变更分类为面向玩家的类别：
2. 新内容：新功能、地图、角色、物品、模式
3. 玩法变更：数值平衡调整、机制变更、进度变更
4. 体验优化 (Quality of Life)：UI 改进、便利功能、无障碍
5. Bug 修复：按系统分组（战斗、UI、联网等）
6. 性能：玩家可能注意到的优化改进
7. 已知问题：透明地告知未解决的问题

1. 将开发者语言翻译为玩家语言：
2. "重构了伤害计算管线" -> "提升了命中检测的准确性"
3. "修复了背包管理器中的空引用" -> "修复了打开背包时的崩溃问题"
4. "减少了战斗循环中的 GC 分配" -> "改善了战斗性能"
5. 移除不影响玩家的纯内部变更
6. 保留数值平衡变更的具体数字（伤害：50 -> 45）

1. 使用适当的风格生成补丁说明：

简要风格

# 补丁 [版本] — [标题]

**新增**
- [功能 1]
- [功能 2]

**变更**
- [数值平衡/机制变更，附变更前 -> 变更后的值]

**修复**
- [Bug 修复 1]
- [Bug 修复 2]

**已知问题**
- [问题 1]

详细风格

# 补丁 [版本] — [标题]
*[日期]*

## 亮点
[1-2 句话总结最令人兴奋的变更]

## 新内容
### [功能名称]
[2-3 句话描述该功能以及玩家应该期待什么]

## 玩法变更
### 数值平衡
| 变更 | 变更前 | 变更后 | 原因 |
| ---- | ---- | ---- | ---- |
| [物品/技能] | [旧值] | [新值] | [简要理由] |

### 机制
- **[变更]**：[变更内容及原因的说明]

## 体验优化
- [改进及上下文]

## Bug 修复
### 战斗
- 修复了 [玩家遇到的问题描述]

### UI
- 修复了 [描述]

### 联网
- 修复了 [描述]

## 性能
- [玩家会注意到的改进]

## 已知问题
- [问题及可用的临时解决方案]

完整风格

包含详细风格的所有内容，加上：

## 开发者寄语
### [主题]
> [开发者对重大变更的洞察 — 为什么这么做、考虑了什么、
> 团队学到了什么。以团队第一人称撰写。]

1. 审查输出，确保：
2. 没有内部术语（用玩家友好的语言替换技术术语）
3. 没有引用内部系统、工单或 Sprint 编号
4. 数值平衡变更包含变更前/后的值
5. Bug 修复描述的是玩家体验，而非技术原因
6. 语气符合游戏的声音风格（根据游戏风格调整正式程度）

1. 保存补丁说明到 production/releases/[version]/patch-notes.md， 如果需要则创建目录。

1. 向用户输出：完整的补丁说明、文件路径、按类别的变更计数，以及被排除的内部变更（供审核）。