Whats New in [Version]【免费下载链接】Claude-Code-Game-StudiosTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.项目地址: https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-StudiosRelease Date: [Date]New Features # 新功能Improvements # 改进Balance Changes # 数值平衡调整Bug Fixes # 缺陷修复Known Issues # 已知问题Technical Notes (Internal Only -- Remove Before Publishing)# 内部技术备注发布前必须删除头部是版本号与发布日期正文五个章节按玩家价值从高到低排列最后以一段致谢 反馈渠道收尾。值得注意的是**模板刻意没有把 Technical Notes 放进发布稿**而是用 (Internal Only -- Remove Before Publishing) 明确标注——这与你看到的所有公开版本变更记录干净、无内部编号的观感一致。 下面逐章节讲解写法规范。 ## 三、六大章节的写作规范与填充方法 ### 3.1 标题区版本号与日期的占位规则 markdown # Whats New in [Version] **Release Date**: [Date][Version]建议使用语义化版本号如v0.4.0与仓库内 release-manager.md 强调的语义化版本管理Semantic Versioning保持一致。该 Agent 的职责范围明确包含 semantic version numbering 与 release branch management版本号冲突同一 tag 对应两个不同变更集会被视为商店提交阻塞项。[Date]填写实际发布日格式建议YYYY-MM-DD。标题用 Whats New in 而非 Changelog for因为模板是给玩家/读者看的有什么新东西细节留给下面的章节。3.2 New Features写体验不写实现模板对这条的约束最严格[Player-friendly description of what they can now do. Focus on the experience, not the implementation. 1-2 sentences.]必须回答玩家现在能做什么而不是我们改了什么代码。长度 1-2 句避免把功能说明写成技术规格书。写法对比❌ 实现视角避免✅ 体验视角采用新增 Dual-Wield 双持武器状态机支持左右手独立输入绑定玩家现在可以同时挥舞两把武器左右手分别攻击组合出全新的连击套路重构输入处理器为事件总线架构手柄按键现在可以完全自定义映射对比模板说明第一列正是technical的写法第二列才是player-friendly。这条约束在整个 CCGS 体系里反复出现——patch-notes.md 技能的任务之一就是stripping internal task IDs and technical jargon in favor of plain language剥离内部任务编号与技术行话换成通俗语言。3.3 Improvements说清对玩家哪里更好- **[Area Improved]**: [How this makes the game better for the player. Be specific.][Area Improved]填写改进的领域如 Load Times、Controller Support、UI。描述必须落点于玩家收益加载时间缩短了 40% 比 优化了资源异步加载 更有价值。3.4 Balance Changes数值变更必须给出前后对比 设计理由这是模板中唯一给出了完整示例的章节写作时请严格照此格式- **[What Changed]**: [Old value] - [New value]. [Brief design reasoning in player terms.]模板自带的示例Healing potions now restore 50 HP (up from 30) -- late-game encounters needed more recovery options.可以拆解出三个必填要素变更对象Healing potions回血药水数值对比50 HP (up from 30)即新值 - 旧值的显式对比设计理由late-game encounters needed more recovery options —— 用玩家能理解的游戏内问题来解释而不是数值曲线调整这种内部话术这也与模板目录下 release-notes.md 中 Balance Adjustments 表格Before/After/Context四列结构互相印证说明数值变更在 CCGS 的发布文档体系里始终要求可对比、可解释。3.5 Bug Fixes写症状不写代码修复- Fixed an issue where [describe the player-visible symptom, not the code fix]模板特别用括号强调描述玩家能看到的症状symptom而非修复手段。例如✅ Fixed an issue where the game crashed when loading saved games from version 1.0❌ Fixed a null-pointer dereference in SaveManager.Deserialize注意第一个示例直接取自 release-notes.md 的 Critical Fixes 示例是仓库内症状化描述的标准范本。3.6 Known Issues症状 临时规避方案- [Issue description in player terms]. [Workaround if one exists.] Were working on a fix.三要素玩家语言的症状描述、可用的临时规避方案如有、正在修复中的承诺。诚实公开已知问题是建立社区信任的基础比让玩家自己撞上 bug 更利于口碑。3.7 收尾区致谢与反馈Thank you for playing! Your feedback helps us improve the game. Report issues at [support link].反馈入口必须给出真实链接支持论坛、工单表单等。致谢可以具体引用社区反馈参考 release-notes.md 的 Thank You 章节建议Reference specific community feedback that influenced changes in this release if applicable。四、Technical Notes内部附件的四个标准区块模板在正文之后留了一段发布前必须删除的内部区域共四个区块4.1 Commits Covered提交范围- Range: [first-hash]..[last-hash] - Total commits: [N]记录本次版本覆盖的 git 提交哈希区间与提交总数。这是追溯审计的关键——任何一次发布的代码范围都能被精确还原。4.2 Internal Changes内部变更记录玩家不可见但团队需要知晓的改动重构、基础设施、工具链等。这正是模板正文刻意排除的内容——正文给玩家看内部变更留在这里。4.3 Deferred Items延期项- [Features or fixes originally planned for this release but moved to next] - Reason: [why deferred] - New target: [version or sprint]对原计划本版本发布、但被推迟的功能/修复必须记录三条信息内容、推迟原因、新目标版本或冲刺。这保证了发布范围的变更全程可追溯也是冲刺复盘retrospective时的重要输入。4.4 为什么必须删除模板用标题后缀(Internal Only -- Remove Before Publishing)做了强约束。对照 patch-notes.md 的技能定义可以看得更清楚/patch-notes 会把 changelog 里internal only的条目如 Refactor input handler to use event bus、Update dependency: Godot 4.6直接过滤掉只保留面向玩家的条目。也就是说内部信息从源头隔离玩家的 Patch Notes 永远接触不到任务编号和技术行话。五、模板在技能体系中的自动化落点/changelog与/patch-notes本模板不是孤立存在的文档它与仓库技能目录中的两个冲刺技能形成完整流水线git 提交历史 冲刺故事 │ ▼ /changelog ──► 生成 docs/CHANGELOG.md开发者向参照本模板 │ ▼ /patch-notes ──► 生成 docs/patch-notes-vX.X.md玩家向参照 release-notes 模板5.1/changelog把 git 历史编译成 Changelogchangelog 技能测试规格仓库内对应技能由 catalog.yaml 登记定义了该技能的行为契约数据源读取自上次 release tag 以来的 git commit 历史并读取冲刺故事sprint story交叉引用任务 ID用故事描述丰富提交内容输出结构按 Features / Fixes / Known Issues 组织条目——与本模板的章节划分一致无 tag 兜底仓库没有版本 tag 时使用全部提交历史作为基线并显式注明 No version tag found — using full commit history; version baseline is unset绝不静默失败无任务 ID 兜底无法匹配任务 ID 的提交按日期归组到 Misc/Other Changes 区块并标注数量不允许任何提交被静默丢弃写入前确认先呈现草稿再询问 May I write todocs/CHANGELOG.md?得到批准后才落盘追加策略若 Changelog 已存在新版本章节前置插入prepend到旧内容之上旧条目原样保留无导演关卡changelog 属于快速编译任务compilation不经过任何 director gate模型层级运行在 Haiku 层级追求低成本的快速编译。5.2/patch-notes把 Changelog 翻译成玩家语言patch-notes 技能测试规格同样登记于 catalog.yaml定义了玩家向公告的生成规则输入依赖必须先有docs/CHANGELOG.md不存在时输出 No changelog found — run /changelog first to generate one判定 BLOCKED过滤规则只保留玩家可见的 Features 与 Bug Fixes内部重构、依赖升级等 internal-only 条目一律排除语言重写剥离任务 ID 与技术行话用平实语言重写plain language模板优先若检测到.claude/docs/templates/下存在 patch notes 模板则用模板结构填充而非自行生成格式语气指导检测design/目录下是否存在 tone guide如 upbeat, encouraging tone; avoid passive voice并将其融入文案社区经理交接输出中建议但不强制Consider sharing draft with community manager before publishing——对应仓库中 community-manager.md 的角色分工。5.3 本模板与二者的衔接点/changelog生成的内容结构与本模板的正文五章节Features / Improvements / Balance / Fixes / Known Issues对齐/patch-notes的输出则更接近 release-notes.md含 Headline、Quality of Life、Coming Next 等面向玩家的章节本模板的Technical Notes内部区块正是/patch-notes过滤逻辑要剔除的那部分信息——模板从结构上保证了内部信息不会泄露到玩家公告。六、与仓库其他发布环节的配合6.1 版本语义与发布分支版本号与发布节奏受 release-manager 管控该 Agent 负责语义化版本号semantic versioning与发布分支管理并会在平台认证失败时输出LAUNCH BLOCKED的阻断结论。撰写 changelog 前确认版本号已通过 release-manager 的核对避免出现同一版本号指向两个不同变更集的商店提交阻塞问题。6.2 变更记录后的发布收尾changelog 技能规格的 Coverage Notes 明确指出/changelog生成之后应当运行/patch-notes产出玩家向版本——这条交接链正是本模板存在的意义。完整的发布收尾还涉及 release-checklist.md 与 launch-checklist.md 等发布检查技能可一并参阅。七、动手实操五分钟填出一份可用 Changelog以下是一份按本模板填充的完整示例含内部区块可直接对照使用# Whats New in v0.4.0 **Release Date**: 2026-09-15 --- ## New Features - **双持武器系统**玩家现在可以同时装备两把武器左右手独立攻击解锁全新的连击组合。 ## Improvements - **加载速度**进入新场景的等待时间缩短约 40%切换关卡更流畅。 ## Balance Changes - **治疗药水**恢复量 30 HP - 50 HP。后期遭遇战需要更强的回复手段否则容错率过低。 ## Bug Fixes - Fixed an issue where the game crashed when loading saved games from version 1.0 - Fixed a controller input delay when multiple gamepads were connected ## Known Issues - 某些低端机型上开启水面反射后帧率下降。可先在设置中关闭水面特效作为临时方案。我们正在优化。 --- ## Technical Notes (Internal Only -- Remove Before Publishing) ### Commits Covered - Range: a1b2c3d..e4f5g6h - Total commits: 12 ### Internal Changes - 输入处理器重构为事件总线架构 - 升级 Godot 4.6 依赖 ### Deferred Items - 成就系统 UI 动效原计划本版本发布 - Reason: 动效品质未达标准 - New target: v0.5.0 --- Thank you for playing! Your feedback helps us improve the game. Report issues at [support link].【免费下载链接】Claude-Code-Game-StudiosTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.项目地址: https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-Studios创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考