메뉴
Atom Game GUI pipeline 第 5 阶段（唯一验证门）。并行两车道：Type-B 独立 gui-reviewer subagent （Bias Guard，品味判断）+ Type-A orchestrator 机械门（编译/LSP/prefab/生成文件/配置）。汇合成 合并 CRITICAL 集合，产出 GUI_REVIEW.md + 6 态裁决 GUI_VERDICT.json + HUMAN_REVIEW.md。也可单独 用于审查已有 GUI 代码。控制逻辑质量漂移 + 确定性验证。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
Atom Game GUI 开发 pipeline 的第 1 阶段（入口）。当用户要「开发/新增/修改一个 GUI 界面、 panel、面板」或说「跑 gui pipeline / 做 GUI 需求」时使用。先确认用户已提供本次 run 的 panelId 和需求描述，缺少任一项时先向用户询问；随后进入 Claude Code 原生 plan mode： 只读探索资源 + 用已注入的知识库坑点 + 向用户提问澄清需求，写计划并 ExitPlanMode 等人类审批； 审批通过后把计划高度精炼成需求契约 GUI_PLAN.md 落盘，并初始化 pipeline 运行状态。 随后（由 /dev-gui-plugin:run 编排）顺序触发 gui-draft → gui-prefab → gui-config → gui-review → gui-improve → gui-learn。
Atom Game GUI pipeline 第 2 阶段。生成 MVVM 代码（Panel.lua + View.cs + 如需的 ViewModel）。 自包含的 MVVM 指引。在 gui-plan 产出 GUI_PLAN.md 后使用。控制代码 实现漂移（相对需求契约）。
Atom Game GUI pipeline 第 3 阶段。把 View.cs 挂到 Prefab 并绑定 [SerializeField] 引用。 自包含的 Prefab 编辑指引，不依赖外部 edit-prefab skill。在 gui-draft 生成 View.cs 后使用。 控制 Prefab 绑定漂移。
Atom Game GUI pipeline 第 7 阶段（每次修 bug / 做需求完成后自动跑），不面向用户手动调用。 从本次开发提取经验回写**私有知识库** ${CLAUDE_PLUGIN_DATA}/gui-knowledge/：建实例层 bug/fix、 泛化出通用层 component/pattern/lesson、写 edges、独立 reviewer 晋升 proposed→confirmed、 重建 query_pack；promote/demote 时对公共库语义去重（公共库为准）。 两遍式：默认捕获遍；`enrich` 参数触发充实遍填 _TODO_ 段。 用户手动沉淀私有库请用 `/dev-gui-plugin:gui-learn-private` command； 沉淀进**项目公共库**用 `/dev-gui-plugin:gui-learn-public` command。
Atom Game GUI pipeline 第 4 阶段（按需，可跳过）。编辑 design/tables 下的 Excel 配置源表， 并镜像改动到对应 *_data.lua（模拟导表，零人工中断）。自包含的配置表编辑指引，不依赖外部 edit-excel skill。仅当功能涉及配置数据时使用。控制配置数据漂移。
Atom Game GUI pipeline 第 6 阶段。对 gui-review 合并 CRITICAL 集合（Type-A 编译/语法失败 + Type-B CRITICAL）迭代修复（最多 2 轮）：修复 → 重跑 gui-review 两车道（Bias Guard）→ 记录 GUI_IMPROVEMENT_LOG.md。仅当 gui-review 报出合并 CRITICAL 时使用。2 轮后仍有 CRITICAL 则记入 HUMAN_REVIEW.md，不暂停。
SOC 직업 분류 기준
| name | gui-review |
| description | Atom Game GUI pipeline 第 5 阶段（唯一验证门）。并行两车道：Type-B 独立 gui-reviewer subagent （Bias Guard，品味判断）+ Type-A orchestrator 机械门（编译/LSP/prefab/生成文件/配置）。汇合成 合并 CRITICAL 集合，产出 GUI_REVIEW.md + 6 态裁决 GUI_VERDICT.json + HUMAN_REVIEW.md。也可单独 用于审查已有 GUI 代码。控制逻辑质量漂移 + 确定性验证。 |
职责：一个阶段、两条并行车道，汇合成合并 CRITICAL 门。 控制：逻辑质量漂移（Type-B）+ 机器可验证正确性（Type-A）。
基准文档：
${CLAUDE_PLUGIN_ROOT}/shared-references/verification-gates.md与acceptance-gate.md。 本阶段合并了原独立的 gui-verify——Type-B 与机械 Type-A 不再分两个阶段跑两遍 reviewer。 全程无中途 HUMAN_CHECKPOINT：需人确认项统一收口到HUMAN_REVIEW.md，管线继续。
gui-reviewer），不传之前的 thread/context。两条车道都只读同一份 draft 后冻结的产出，谁都不写文件，无竞态。Type-A 由 orchestrator 就地跑
（确定性、低风险，acceptance-gate.md §1 认可执行者自跑 self-check）；Type-B 交独立 subagent。
收集 Phase 2-4 的产出文件路径（Panel.lua / View.cs / ViewModel / 改动的 prefab / Excel↔data）。
Type-B 车道（后台 spawn，不阻塞）：用 Agent 工具
subagent_type: "gui-reviewer"、run_in_background: true spawn，传入：
${CLAUDE_PROJECT_DIR}/.claude/dev-gui-runs/<panelId>/GUI_PLAN.md${CLAUDE_PLUGIN_ROOT}/shared-references/*.md（含 patterns/ 涉及的进阶模式）agents/gui-reviewer.md），产出 GUI_REVIEW.md 到 run 目录。Type-A 车道（等 subagent 期间 orchestrator 自跑，机器可验证）：逐项判
passed | failed | skipped，缺能力判 BLOCKED/NOT_APPLICABLE 记入清单：
./unity/WindowsEditor/Unity.exe -projectPath ./client/ -batchmode -quit ...）；
两路径均不可用 → BLOCKED）.lua 文件；LSP 不可用则 BLOCKED）BLOCKED）*_viewmodel.lua / *ViewModel.cs 的 diff；*_data.lua 例外）
TODO(模拟导出) 标记 → 判 BLOCKED「待工具正式重新导出覆盖」记入清单，
不判 failed、不触发 improvefailedNOT_APPLICABLE）汇合两车道 → 合并 CRITICAL 集合：
{Type-A 编译失败} ∪ {Type-A Lua 语法错误}（编译/语法失败升为 CRITICAL）{Type-B 报出的 CRITICAL}BLOCKED / NOT_APPLICABLE（缺能力/不适用）不进 CRITICAL 集合——否则缺
Unity/Prefab 能力会把管线拖进 improve 死循环，只记 HUMAN_REVIEW.md。GUI_VERDICT.json{
"panel_id": "xxx",
"verdict": "PASS|WARN|FAIL|NOT_APPLICABLE|BLOCKED|ERROR",
"type_a_gates": { "compile": "passed", "lua_syntax": "passed", "...": "..." },
"type_b_gates": { "interaction": "passed", "perf": "passed", "layout": "passed" },
"critical_count": 0,
"summary": "...",
"timestamp": "2026-06-16T..."
}
| Verdict | 含义 | 需人工签字 |
|---|---|---|
| PASS | 全部通过、无 CRITICAL | 否 |
| WARN | 有 MAJOR/MINOR 无 CRITICAL | 否 |
| FAIL | 有未修复 CRITICAL（Type-A 编译/语法失败 或 Type-B CRITICAL） | 是 |
| NOT_APPLICABLE | 某项不适用（如无配置变更） | 否 |
| BLOCKED | 检查条件不满足（Unity 未开、缺 MCP、模拟导出待覆盖） | 是 |
| ERROR | 检查执行出错 | 是 |
「需人工签字」≠ 停顿。FAIL/BLOCKED/ERROR 写进
HUMAN_REVIEW.md，管线继续。
HUMAN_REVIEW.md（最终统一人工检查清单）# Human Review: <panelId>
- [ ] Excel 配置正确性 + 正式 GDE 导表（覆盖模拟写入的 *_data.lua）
- [ ] 运行期效果：打开 panel 截图核对交互与布局
- [ ] 未解决 CRITICAL（如有）：<file:line + 原因>
- [ ] BLOCKED / 降级项：<因环境缺失未能自动验证的项>
accept 本阶段，跳过 gui-improve，直接进入 gui-learn。python3 "${CLAUDE_PLUGIN_ROOT}/tools/gui_run_state.py" set "${CLAUDE_PROJECT_DIR}" <panelId> gui-review done
# 合并 CRITICAL == 0（独立 reviewer + 确定性 Type-A 均通过）→ accept：
python3 "${CLAUDE_PLUGIN_ROOT}/tools/gui_run_state.py" accept "${CLAUDE_PROJECT_DIR}" <panelId> gui-review \
--reviewer gui-reviewer+type-a --verdict-id <run>/GUI_VERDICT.json
# 无 CRITICAL 时同时把 gui-improve 显式跳过：
python3 "${CLAUDE_PLUGIN_ROOT}/tools/gui_run_state.py" set "${CLAUDE_PROJECT_DIR}" <panelId> gui-improve skipped
Type-B（gui-reviewer，品味）：MVVM 一致性 / 生命周期正确性 / 空安全 / 性能反模式 / 代码规范。
Type-A（orchestrator，机械）：C# 编译 / Lua 语法 / Prefab 绑定 / 生成文件导出 / 配置同步。
（Type-B 详见 ${CLAUDE_PLUGIN_ROOT}/agents/gui-reviewer.md。）