Codebase Health

Codebase Health

【免费下载链接】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

• TODO count: [N] ([list top 5 if many])
• FIXME count: [N] ([list all -- these are potential blockers])
• HACK count: [N] ([list all -- these need review])

这一板块直接承接 Phase 3 的扫描结果，是整份清单的"体检报告"头部。注意三者的处置优先级不同：FIXME 被明确标注为 potential blockers（潜在阻塞项），HACK 被标注为需要 review，而 TODO 仅在数量巨大时截断展示。 ### 4.2 Build Verification（构建验证） ```markdown ### Build Verification - [ ] Clean build succeeds on all target platforms - [ ] No compiler warnings (zero-warning policy) - [ ] All assets included and loading correctly - [ ] Build size within budget ([target size]) - [ ] Build version number correctly set ([version]) - [ ] Build is reproducible from tagged commit

六个勾选项覆盖了发布构建的硬性要求：全平台干净构建、零警告策略、资产完整加载、体积预算、版本号正确、以及"从打标签的提交可复现构建"——最后一条保证发布产物与源码控制中的记录一一对应，是审计可追溯性的基石。仓库中的独立模板 release-checklist-template.md 在此基础上还补充了两项：Build size within budget: [actual] / [budget]（记录实际值与预算值对照）和No debug/development features enabled in release build（确认发布构建未开启调试功能），可作为手工复核时的强化检查项。

4.3 Quality Gates（质量门）

### Quality Gates - [ ] Zero S1 (Critical) bugs - [ ] Zero S2 (Major) bugs -- or documented exceptions with producer approval - [ ] All critical path features tested and signed off by QA - [ ] Performance within budgets: - [ ] Target FPS met on minimum spec hardware - [ ] Memory usage within budget - [ ] Load times within budget - [ ] No memory leaks over extended play sessions - [ ] No regression from previous build - [ ] Soak test passed (4+ hours continuous play)

质量门是裁决 RELEASE BLOCKED 的最主要来源：S1（Critical）Bug 必须为零；S2（Major）Bug 允许有带 Producer 批准记录的书面例外；关键路径功能需经 QA 签核；性能四要素（帧率、内存、加载时间、长时间会话无内存泄漏）需全部达标；且要求相对上一构建无回归，并通过至少 4 小时的连续游玩浸泡测试（soak test）。模板文件中的 S2 例外采用表格形式记录（Bug ID / Description / Exception Rationale / Approved By），确保"例外"是有据可查的治理决策而非口头放行。

4.4 Content Complete（内容完整性）

### Content Complete - [ ] All placeholder assets replaced with final versions - [ ] All TODO/FIXME in content files resolved or documented - [ ] All player-facing text proofread - [ ] All text localization-ready (no hardcoded strings) - [ ] Audio mix finalized and approved - [ ] Credits complete and accurate

内容板块聚焦"玩家可见的一切"：占位资产全部替换、内容文件中的 TODO/FIXME 全部解决或书面记录、玩家向文本完成校对、文本全部本地化就绪（无硬编码字符串）、音频混音定稿并获得批准、制作人员名单完整准确。

4.5 平台特定要求：PC / Console / Mobile

技能根据 Phase 1 解析出的平台参数，在通用清单后追加对应小节。

PC 平台（10 项）：

### Platform Requirements: PC - [ ] Minimum and recommended specs verified and documented - [ ] Keyboard+mouse controls fully functional - [ ] Controller support tested (Xbox, PlayStation, generic) - [ ] Resolution scaling tested (1080p, 1440p, 4K, ultrawide) - [ ] Windowed, borderless, and fullscreen modes working - [ ] Graphics settings save and load correctly - [ ] Steam/Epic/GOG SDK integrated and tested - [ ] Achievements functional - [ ] Cloud saves functional - [ ] Steam Deck compatibility verified (if targeting)

PC 侧除了常见的分辨率/窗口模式/图形设置检查，还覆盖了分发 SDK（Steam/Epic/GOG）集成、成就与云存档功能，以及 Steam Deck 兼容性验证（仅当目标包含该设备时）。

Console 平台（9 项）：

### Platform Requirements: Console - [ ] TRC/TCR/Lotcheck requirements checklist complete - [ ] Platform-specific controller prompts display correctly - [ ] Suspend/resume works correctly - [ ] User switching handled properly - [ ] Network connectivity loss handled gracefully - [ ] Storage full scenario handled - [ ] Parental controls respected - [ ] Platform-specific achievement/trophy integration tested - [ ] First-party certification submission prepared

主机侧的重心是第一方认证（certification）：TRC（任天堂）/ TCR（索尼）/ Lotcheck（微软）要求核对、平台专属按键提示、挂起/恢复、用户切换、断网、存储已满、家长控制等系统级场景，以及成就/奖杯集成与认证材料提交准备。

Mobile 平台（10 项）：

### Platform Requirements: Mobile - [ ] App store guidelines compliance verified - [ ] All required device permissions justified and documented - [ ] Privacy policy linked and accurate - [ ] Data safety/nutrition labels completed - [ ] Touch controls tested on multiple screen sizes - [ ] Battery usage within acceptable range - [ ] Background behavior correct (pause, resume, terminate) - [ ] Push notification permissions handled correctly - [ ] In-app purchase flow tested (if applicable) - [ ] App size within store limits

移动侧聚焦应用商店合规：商店指南、权限声明、隐私政策、数据安全/营养标签、多尺寸触控适配、耗电、后台行为、推送权限、内购流程与包体大小限制。

4.6 Store / Distribution 与 Launch Readiness（所有平台通用）

### Store / Distribution - [ ] Store page metadata complete and proofread - [ ] Short description - [ ] Long description - [ ] Feature list - [ ] System requirements (PC) - [ ] Screenshots up to date and per-platform resolution requirements met - [ ] Trailers up to date - [ ] Key art and capsule images current - [ ] Age rating obtained and configured: - [ ] ESRB - [ ] PEGI - [ ] Other regional ratings as required - [ ] Legal notices, EULA, and privacy policy in place - [ ] Third-party license attributions complete - [ ] Pricing configured for all regions ### Launch Readiness - [ ] Analytics / telemetry verified and receiving data - [ ] Crash reporting configured and dashboard accessible - [ ] Day-one patch prepared and tested (if needed) - [ ] On-call team schedule set for first 72 hours - [ ] Community launch announcements drafted - [ ] Press/influencer keys prepared for distribution - [ ] Support team briefed on known issues and FAQ - [ ] Rollback plan documented (if critical issues found post-launch)

商店板块覆盖商店页面元数据四件套（短描述/长描述/功能列表/系统需求）、截图分辨率、预告片、主视觉与胶囊图、ESRB/PEGI 等年龄分级、EULA 与隐私政策、第三方许可证归属、多区域定价。上线就绪板块则覆盖遥测与崩溃上报可用性、首日补丁、首个 72 小时值班排班、社区公告、媒体/主播 key、客服简报与回滚预案——最后一项保证即使上线后出现严重问题也有明确的处置路径。

4.7 Go / No-Go 裁决与签核

### Go / No-Go: [READY / NOT READY] **Rationale:** [Summary of readiness assessment. List any blocking items that must be resolved before launch. If NOT READY, list the specific items that need resolution and estimated time to address them.] **Sign-offs Required:** - [ ] QA Lead - [ ] Technical Director - [ ] Producer - [ ] Creative Director

【免费下载链接】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