企业官网建设流程全解析

Active Session

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

Current Task

实现近战攻击的 hitbox 检测

Progress

• 近战组件接口设计（已写入 design/gdd/systems-index.md）
• 架构决策 ADR-014：采用 ShapeCast 而非 Area3D
• hitbox 检测逻辑实现
• 单元测试与性能基线

Key Decisions

• ADR-014：ShapeCast 方案，原因：避免一帧内的穿透漏检

Files in Progress

• src/gameplay/combat/melee_attack.gd
• tests/playtest/BUG-007.md

Open Questions

• 命中判定是否包含背刺加成？（等待设计确认）

### 状态栏区块：让状态文件被机器"读"出来 当项目处于 **Production、Polish 或 Release 阶段**时，文档要求在 `active.md` 内维护一段结构化注释块，供状态栏脚本解析： ```markdown <!-- STATUS --> Epic: Combat System Feature: Melee Combat Task: Implement hitbox detection <!-- /STATUS -->

文档给出的三条维护规则：

• 三个字段（Epic/Feature/Task）都可选——只填当前适用的层级；
• 切换工作焦点时更新该区块；
• 状态栏会将其渲染为面包屑（breadcrumb）：Combat System > Melee Combat > Hitboxes；
• 没有活跃工作焦点时，删除或清空该区块（避免残留误导）。

这段规范的底层实现位于仓库的 statusline.sh：

• 第 91 行起，脚本仅在stage为 Production/Polish/Release 时读取状态文件；
• 第 97-109 行逐行扫描<!-- STATUS -->到<!-- /STATUS -->之间的内容，用sed 's/^Epic: *//'等命令抽取三个字段的值；
• 第 112-116 行把非空字段按Epic > Feature > Task顺序拼接成面包屑，附带在状态栏尾部输出。

同时 statusline.sh 还展示了另一个与上下文管理相关的自动化：生产阶段（stage）检测。它优先读取production/stage.txt，缺省时依据design/gdd/game-concept.md、systems-index.md、引擎配置、ADR 文件与src/源码数量等产物自动推断阶段——这意味着阶段识别也完全基于磁盘产物而非对话记忆，与会话文件策略一脉相承。

增量文件写入：把 30k 的历史压成 3k 的当前

针对多章节文档（设计文档、架构文档、世界观条目等），文档给出了五步增量写入法：

1. 立即创建带骨架的文件——所有章节标题就位、正文留空；
2. 在对话中逐节讨论——每次只处理一个章节；
3. 每节获批后立即写入文件；
4. 每写完一节就更新会话状态文件；
5. 写完后该节的讨论可以放心被压缩——决策已经在文件里了。

这套方法的价值在文档里被量化得非常清楚：上下文窗口只承载当前章节的讨论（约 3-5k token），而不是整份文档的完整讨论史（约 30-50k token），数量级差距可达 10 倍。这正是 UPGRADING.md 所说的"多阶段文档工作流"被合并进本文档的原因——增量写入就是它在创作场景的规范化表达。

配合使用仓库里的模板与技能，可以在实践中形成完整闭环：从 game-design-document.md 这类模板起步建骨架，用 quick-design 等技能产出章节内容，再按本节流程逐节落盘。

主动压缩：不要等到极限才动手

文档将压缩分成两种姿态——主动（proactive）与被动（reactive），并明确要求前者：

• 在上下文使用率达到约 60-70% 时主动/compact，而不是撞到上限被强制压缩；
• 在不同任务之间使用/clear，或者在连续 2 次以上纠正尝试失败之后使用（清掉失败尝试的干扰上下文）；
• 利用自然压缩点：写完一节写入文件后、提交（commit）之后、完成一个任务之后、开始新话题之前。

文档还给出了聚焦压缩（focused compaction）的范式——把"已落盘"与"进行中"的边界写进压缩指令，让压缩摘要只保留必要部分：

/compact Focus on [当前任务] — sections 1-3 are written to file, working on section 4

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