design-system

!bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys review_mode,automation,workflow,docs.density,system_overrides

已解析上述配置——请直接使用；--review 会覆盖 review_mode。没有阻止项 → 默认值位于 .claude/docs/config-resolution.md 中。

设计系统

调用此技能时：

1. 解析参数并验证

现在阅读 references/1-parse-arguments.md 并遵循其中的说明——此阶段的步骤位于该文件中，而不是这里。如果在此阶段对话被压缩或恢复，请重新阅读该文件。

2. 收集上下文（阅读阶段）

现在阅读 references/2-gather-context.md 并遵循其中的说明——此阶段的步骤位于该文件中，而不是这里。如果在此阶段对话被压缩或恢复，请重新阅读该文件。

3. 创建文件骨架

现在阅读 references/3-file-skeleton.md 并遵循其中的说明——此阶段的步骤位于该文件中，而不是这里。如果在此阶段对话被压缩或恢复，请重新阅读该文件。

4. 逐节设计

现在阅读 references/4-section-design.md 并遵循其中的说明——此阶段的步骤位于该文件中，而不是这里。如果在此阶段对话被压缩或恢复，请重新阅读该文件。

5. 设计后验证

现在阅读 references/5-post-design.md 并遵循其中的说明——此阶段的步骤位于该文件中，而不是这里。如果在此阶段对话被压缩或恢复，请重新阅读该文件。

6. 专家 Agent 路由

此技能会将任务委派给具备领域专业知识的专家 Agent。主会话负责统筹整体流程；Agent 提供专业内容。

此处的行有意划分得比九个 Category 值更细——负责战斗的专家并不适合负责寻路，两者都属于 Gameplay。分两步确定：先从 systems-index.md 中获取系统的 Category，再选择该类别中与系统实际功能相符的行。每个类别至少有一行，因此不会出现无匹配项的情况。

Category	以下可选行
Gameplay	战斗/伤害/生命值 · AI/寻路/行为 · 动画/角色移动 · 角色系统 · 摄像机/输入/控制
Core	基础/基础设施 · 摄像机/输入/控制
Persistence	基础/基础设施
Economy	经济/战利品/制作
Progression	进度/XP/技能
UI	UI 系统 · 视觉特效（当系统是 HUD 附近的 VFX 时）
Audio	音频系统
Narrative	对话/任务/背景设定
Meta	基础/基础设施（分析、教程流程） · UI 系统（无障碍选项界面）

如果有两行都符合条件，则启动它们的主 Agent 并集，并说明原因。

系统类型	主 Agent	支持 Agent
基础/基础设施（事件总线、保存/加载、场景管理、服务定位器）	systems-designer	gameplay-programmer（可行性）、engine-programmer（引擎集成）
战斗、伤害、生命值	game-designer	systems-designer（公式）、ai-programmer（敌人 AI）、art-director（受击反馈的视觉方向、VFX 意图）
经济、战利品、制作	economy-designer	systems-designer（曲线）、game-designer（循环）
进度、XP、技能	game-designer	systems-designer（曲线）、economy-designer（资源消耗点）
对话、任务、背景设定	game-designer	narrative-director（故事）、writer（内容）、art-director（角色视觉档案、电影化基调）
UI 系统（HUD、菜单）	game-designer	ux-designer（流程）、ui-programmer（可行性）、art-director（视觉风格方向）、technical-artist（渲染/着色器限制）
音频系统	game-designer	audio-director（方向）、sound-designer（规格）
AI、寻路、行为	game-designer	ai-programmer（实现）、systems-designer（评分）
关卡/世界系统	game-designer	level-designer（空间设计）、world-builder（背景设定）
摄像机、输入、控制	game-designer	ux-designer（操作手感）、gameplay-programmer（可行性）
动画、角色移动	game-designer	art-director（动画风格、姿势语言）、technical-artist（骨架/混合限制）、gameplay-programmer（操作手感）
视觉特效、粒子、着色器	game-designer	art-director（VFX 视觉方向）、technical-artist（性能预算、着色器复杂度）、systems-designer（触发器/状态集成）
角色系统（属性、原型）	game-designer	art-director（角色视觉原型）、narrative-director（角色弧线一致性）、systems-designer（属性公式）

通过 Agent 工具委派时：

• 提供：系统名称、游戏概念摘要、相关 GDD 摘录、正在编写的具体章节，以及需要专家解答的问题
• Agent 将分析/提案返回给主会话
• 主会话通过 AskUserQuestion 向用户展示 Agent 的输出
• 用户作出决定；主会话写入文件
• Agent 不会直接写入文件——所有文件写入均由主会话负责

---

7. 恢复与续接

如果会话中断（上下文压缩、崩溃、新会话）：

1. 阅读 production/session-state/active.md——其中记录了当前系统以及已完成的章节
2. 阅读 design/gdd/[system-name].md——有实际内容的章节已完成；标有 [To be designed] 的章节仍需处理。按章节阅读：使用 Grep 工具（内容模式，匹配模式 ^#）查找标题，再通过 offset 和 limit 使用 Read 工具读取对应范围。
3. 从下一个未完成的章节继续——无需重新讨论已完成的章节

因此，增量编写十分重要：每个获批的章节都能在任何中断后保留下来。

---

协作协议

在 collaborative 模式下（默认模式）。 关于 guided 和 autonomous 模式，请参阅 .claude/docs/automation-modes.md 中各模式的规则——以下“绝不”条目描述的是协作模式的要求，并非普遍适用的规则。

此技能在每个步骤中都遵循协作设计原则：

1. 对每个章节执行 提问 -> 选项 -> 决策 -> 草稿 -> 批准
2. 在每个决策点使用 AskUserQuestion（解释 -> 捕获模式）：
   • 阶段 2：“准备好开始了吗？还是需要更多背景信息？”
   • 阶段 3：“可以创建骨架吗？”
   • 阶段 4（每个章节）：设计问题、方案选项、草稿审批
   • 阶段 5：“可以更新实体注册表吗？可以更新系统索引吗？接下来做什么？”——而不是“运行设计审查吗？”：§5c 禁止在此处提供 /design-review，因为审查 Agent 不应继承本次会话的设计历史。阶段 5c 会说明交接事项，但不会提问。
3. 在创建骨架和写入每个章节之前，都要询问：“可以写入 [filepath] 吗？”
4. 增量编写：每个章节获批后立即写入文件
5. 更新会话状态：每次写入章节后都要更新
6. 交叉引用：每个章节都要检查现有 GDD 是否存在冲突
7. 专家路由：复杂章节应征询专家 Agent 的意见，并将意见呈现给用户决策——绝不默默写入

绝不自动生成完整 GDD 并将其作为既成事实呈现。 绝不未经用户批准就编写章节。 绝不在未指出冲突的情况下与现有获批 GDD 相矛盾。 始终说明决策依据（依赖的 GDD、设计支柱、用户选择）。

上下文窗口注意事项

这是一项长期运行的技能。每次写入章节后，检查状态行中的上下文占用率是否达到或超过 70%。如果是，请在回复中附上以下提示：

上下文即将达到上限（≥70%）。 进度已保存——所有获批章节均已写入 design/gdd/[system-name].md。准备好继续时，请开启一个新的 Claude Code 会话并运行 /design-system [system-name]——它会检测哪些章节已完成，并从下一个未完成的章节继续。

---

建议的后续步骤

• 在新会话中运行 /design-review design/gdd/[system-name].md，独立验证已完成的 GDD
• 运行 /consistency-check，确认此 GDD 中的值与其他 GDD 不冲突
• 运行 /map-systems next，转到下一个优先级最高且尚未设计的系统
• 所有 MVP GDD 编写并审查完成后，运行 /gate-check technical-setup