| name | gui-config |
| user-invocable | false |
| description | Atom Game GUI pipeline 第 4 阶段（按需，可跳过）。编辑 design/tables 下的 Excel 配置源表， 并镜像改动到对应 *_data.lua（模拟导表，零人工中断）。自包含的配置表编辑指引，不依赖外部 edit-excel skill。仅当功能涉及配置数据时使用。控制配置数据漂移。 |
Phase 4: gui-config — 配置表编辑（按需，可跳过）
职责：自包含的配置表编辑。控制：配置数据漂移（Excel 源表 vs lua data 不同步）。
执行位置与并行：本阶段在 orchestrator 派发的 subagent 中执行，与主 agent 的 gui-prefab（Phase 3）并行。
本 subagent 只做配表编辑，把结果结构化返回给 orchestrator：edited（改了哪些 Excel/*_data.lua）
/ skipped（本需求不涉及配置）/ blocked（缺配表能力，需人工）+ 涉及的降级/TODO 说明。
run_state 由 orchestrator（主 agent）统一记账——本 subagent 不自行写 gui_run_state.py
（会话作用域状态归主 agent，避免 subagent 缺 session env）。
若本需求不涉及配置数据 → 返回 skipped（由 orchestrator 记 set <panelId> gui-config skipped）。
规则（优先工具导表，导出失败才手改镜像；零人工中断）
- 改
design/tables/ 下的 Excel 源表（真正的真相源）。
*_data.lua 优先用工具正式导出：运行时若有可用的导表工具（GDE CLI / excel-config 等）→ 用它导出，不手改。- 导出工具不可用 / 失败 → 才允许手改镜像写入
*_data.lua（降级兜底，模拟导表）：按行定位、同字段同值，
严格对齐 GDE 导出格式，使运行期与后续阶段立即可见新配置；加 -- TODO(模拟导出) 标记并记入 HUMAN_REVIEW.md。
- 区分两类「生成文件」，勿混淆——两者都优先工具导出、导出失败才手改：
*_data.lua（配表导出产物）—— 本阶段在导出失败时手改镜像写入，不是禁区。*_viewmodel.lua / *ViewModel.cs（MVVM 生成）—— 同理优先工具导出，失败才手改（见 mvvm-contract §3）。
工具使用（不硬绑定 MCP）
- 运行时已加载 excel-config / excel-mcp 等 → 用之读写 Excel 源表。
- 未加载 → 在
HUMAN_REVIEW.md 标出「需手工配表」，本阶段降级，管线继续。
Gate
Excel 源表与对应 *_data.lua 改动一致（同字段、同值），运行期可读到新配置。
⚠ 若本次因导出失败而手改镜像了 *_data.lua：它是模拟产物，正式 GDE 导表会覆盖它。
故「确认 Excel 配置正确并正式导表」列入 HUMAN_REVIEW.md（gui-review 末），
绝不在管线中途停顿。（若已用工具正式导出，则无此遗留项。）
编辑完成后 → 把结果返回 orchestrator（edited + 改动文件 + 任何 TODO(模拟导出)/降级说明）。
orchestrator 在主 agent 侧据此记账，并在 gui-prefab 也落定后统一进入 gui-review：
python3 "${CLAUDE_PLUGIN_ROOT}/tools/gui_run_state.py" set "${CLAUDE_PROJECT_DIR}" <panelId> gui-config done
