核心定位
majia-guanyuan 是架在观远BI官方全家桶（guancli/guanvis/guanetl/guanwf/guands）之上的实战增益层，专啃官方DSL/命令够不着的硬骨头。V3.0.0重构后，标准查数/建卡/ETL/数据集CRUD一律路由官方；本Skill只留六大深水区：
Part B：ETL治理与写入
- 整库治理判断：8维ETL+4维字段去留决策、循环依赖检测、ODS/DIM/DWD/DWS/APP分层
- 10类BI引擎报错手册：从
<> NULL吞行、CTE中文别名报错到UNION列数不匹配 - SmartETL全链路重写：B-17方法论（CTO张进经验）+ ExecPlan工程管理
- 硬边界实证：guanetl
edit逆向失效（生成空etl.go）、DELETE必须先ds后etl
Part C：自定义图表开发与排障
- HTML/CSS/JS注入、payload_json取数排障、固定卡/overlay、z-index层级管理
- Part C-12：HTML应用化看板生成——绕过标准看板限制，走descriptor patch联动selector与custom chart内部dataView
Part D：v7草稿-发布状态机绕过
- 手撸
/api/page+/api/card被60004卡住 → 银弹是guanvis publish跨状态机 - CSV三态硬规则（
IS NOT NULL AND <> ''）、Spark中文别名限制、ETL update 1012同名文件 - SmartETL节点化静默坑、customChart autoBootstrap、移动端phoneLayout ZIP inject
Part E：SuperApp开放应用反向工程
guancli app create/publish陷阱（不传--app-id变每次新建）- form建表反向工程：脚手架没暴露API，实测
POST /survey-engine/api/form/add - LLM中转三路径解析：
NOT_JSON_RES/ILLEGAL_JSON_RES从error_message抠响应 - 同源fetch credentials绕过、客户端流式模拟、任务池闭环设计
AI-native ADS数据架构方法论
- 治理vs重搭判断矩阵、7字段约束、30+30+40预算分配
- ODS+DWD不动ADS重建的范式
餐饮连锁BI公式实战库
- 60+ SQL/复购/RFM/AC/Comp、DWD宽表范式、39个生产ETL索引
- 财务双源对账、POS归一化、评价pipeline工程模式
显著优点
- 来源可信度极高：每项规则来自真实BI实例跑通记录（workshop513等）、CTO级经验（张进）、30+表批量工程实证
- 硬边界明确：官方工具失效场景（guanetl edit bug、v7状态机死锁）标注清晰，避免踩坑
- 方法论完整：从治理扫描→决策→写入→对账→删除的全生命周期，配套ExecPlan工程管理
- 多Agent兼容：Claude Code/OpenClaw/Codex/Hermes通用
潜在局限
- 版本敏感：官方全家桶更新快（2026-06-04刚公网化），部分边界可能随版本变化
- 实例特化：部分实证来自特定BI版本（8.2.1-hf6）、特定租户配置
- 深度优先：新手建议先熟悉官方全家桶基础命令，再进入本Skill深水区
适合人群
- 观远BI进阶用户：已跑通官方命令，遇到"官方文档没写但线上报错"的工程师
- 数据中台/BI工程师：负责30+表批量迁移、ETL治理、SmartETL链路重构
- 前端+数据 hybrid：需要自定义图表注入、HTML应用看板、SuperApp开发的开发者
- 餐饮连锁行业BI：需要复购/RFM/同店增长等业务口径标准实现的场景
常规风险
- 误删风险：强制要求"逐项明确确认"才能执行DELETE，默认新旧并行不主动建议删除
- 权限风险：INPUT_DATASET用无运行权限的dsId会导致execute空数据但保存不报错
- 状态机风险：v7草稿-发布分离机制下，手撸API易陷入cdId映射死锁，必须用guanvis publish
- 引擎差异：Spark严格类型 vs 老引擎宽松行为（UNION自动补NULL等）可能暴露历史bug