核心定位
majia-guanyuan 是架设在观远 BI 官方全家桶（guancli/guanvis/guanetl/guanwf/guands）之上的实战增益层 Skill，标准操作一律路由给官方命令，自身专攻三类官方 DSL/命令够不着的硬骨头：
1. ETL 整库治理与引擎级踩坑（Part B）：60+ 张 ETL 实战验证的治理扫描方法论、10 类 BI 引擎报错速查手册、SmartETL 全链路重写/ExecPlan 工程管理、字段使用度双源审计（page+etl）、删除安全闸（B-7.0 硬性四条件）。
2. 自定义图表与 HTML 应用化看板（Part C/C-12）：既有页 HTML/CSS/JS 注入排障、固定卡片/overlay 层级管理、payload_json 取数陷阱、descriptor patch 实现 selector 与 custom chart dataView 联动、五层验收清单（含 guanvis screenshot 视觉验收）。
3. V7 状态机与 SuperApp 反向工程（Part D/E）：草稿-发布状态机绕过、60004/1012/ILLEGAL_JSON_RES 等特定错误修复、form 建表 API 反向工程、移动端 phoneLayout ZIP 注入、AI-native ADS 数据架构方法论（治理 vs 重搭判断、7 字段约束、30+30+40 预算分配）。
显著优点
- 全链路实证：所有 API 路径、payload 字段、报错码均来自真实跑通的 60+ ETL、30+ 表批量迁移、V7 demo 90 天/1200 门店/80K 会员生产验证，非文档推测。
- 安全闸设计：B-7.0 删除前硬性四条件（逐项确认/下游切流/对账通过/分批执行）+
page?force=true级联删页的条件豁免，防止误删生产资源。 - 工程化管理：B-17.11 ExecPlan 工作法将跨多日/30+ 表重构的进度、踩坑记录、决策日志落到自包含文档，解决 BI 项目「上下文丢失」顽疾。
- 视觉设计底线：V3.1.0 吸收 design-taste-skills，建立可执行的反 AI 味红线（禁紫蓝渐变/玻璃拟态/卡片墙）、KPI 展示规范（28-32px+单位+对比基准）、图表真实性硬底线。
- 餐饮垂直深度：V2.1.5 起内置餐饮 BI 公式实战库（RFM/复购率/AC/Comp/DWD 宽表范式/39 ETL 索引），业务口径与工程实现双覆盖。
潜在缺点与局限性
- 环境锁定：主要针对本地私有 BI 实例（v7/v8），SaaS 公有云实例的部分 admin 级操作受限。
- 版本追赶负担：官方全家桶周更节奏快，需持续同步版本号与 breaking change（已建立 Step 0-5 更新 SOP）。
- 前置依赖重：需完整安装官方全家桶并
guancli auth login，纯离线环境无法使用。 - 删除操作不可逆：
force=true级联删页、DELETE /api/data-source/等操作一旦执行无法恢复，虽有多层安全闸但仍需用户审慎确认。
适合人群
- BI 工程师/数据架构师：负责 ETL 治理重构、SmartETL 链路优化、数据分层设计。
- 前端/全栈开发者：需要 hack 观远自定义图表、开发 HTML 应用化看板、SuperApp 开放应用。
- 数据产品经理：需要判断「现有 BI 接 AI」是治理还是重搭，制定 AI-native ADS 提案。
- 餐饮连锁数字化团队：直接复用餐饮 BI 公式库与 ETL 工程范式，避开行业常见口径坑。
常规风险
| 场景 | 风险 | 缓解 |
|:---|:---|:---|
| 批量删除 ETL | 下游看板/ETL 引用未切流导致故障 | B-7.0 强制双源审计 + 用户逐项确认 |
| V7 草稿-发布状态机 | 手撸 API 被 `60004` 卡住、cdId 映射混乱 | 统一走 `guanvis publish` 跨状态机 |
| Spark SQL 中文别名 | `PARSE_SYNTAX_ERROR` | CTE 别名强制英文 + 文档硬规则 |
| CSV 三态判断 | `<> NULL` 算出口径错误（如会员占比 100%） | 强制 `IS NOT NULL AND <> ''` 三态判断 |
| payload_json 截断 | 长字符串被链路截断致 `JSON.parse` 失败 | 拆多列传值，避免整包 JSON |