gui-config
Atom Game GUI pipeline 第 4 阶段(按需,可跳过)。编辑 design/tables 下的 Excel 配置源表, 并镜像改动到对应 *_data.lua(模拟导表,零人工中断)。自包含的配置表编辑指引,不依赖外部 edit-excel skill。仅当功能涉及配置数据时使用。控制配置数据漂移。
SKILL.mdskills/gui-config/SKILL.md
GitHubPhase 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:
# ↓ 由 orchestrator(主 agent)执行,不在本 subagent 内跑
python3 "${CLAUDE_PLUGIN_ROOT}/tools/gui_run_state.py" set "${CLAUDE_PROJECT_DIR}" <panelId> gui-config done