核心定位
majia-guanyuan 是架在观远官方全家桶（guancli/guanvis/guanetl/guanwf/guands）之上的实战增益层，标准CRUD操作一律路由官方，本Skill专攻官方DSL够不着的硬骨头：
Part B：ETL治理与写入
- 整库治理扫描：8维ETL判断+4维字段审计，识别循环依赖、状态异常、复杂度超标
- 10类引擎报错手册：从
<> NULL吞行到Spark中文别名报错，覆盖真实生产踩坑记录 - SmartETL全链路重写/ExecPlan：CTO张进方法论，30+表工程化追踪，含B-17.11工作法
- guanetl edit失效绕过：2026-06实测三道墙（空etl.go/输出绑定guard/身份字段base优先）及不可变重建方案
Part C：自定义图表开发与排障
- HTML/CSS/JS注入：runtime契约解析、payload_json取数排障、固定卡片/overlay场景
- C-12 HTML应用化看板：selector→custom chart dataView联动补丁、descriptor patch、12步pack-patch-upload工作流
Part D：V7 Page/Card发布流水线
- 草稿-发布状态机绕过：手撸API被
60004卡住时，走guanvis publish一键跨状态机 - 三态硬规则：CSV散客
会员ID IS NOT NULL算100%假指标、Spark中文别名报错、ETL update 1012同名文件 - SmartETL节点化静默坑：COUNT_DISTINCT多键/JOIN_DATA顺序/FULL_OUTER笛卡尔积
Part E：SuperApp开放应用
- form建表反向工程：脚手架未暴露API，实测
POST /survey-engine/api/form/add - LLM中转三路径解析：NOT_JSON_RES/ILLEGAL_JSON_RES从error_message抠响应
- 原生fetch credentials绕unwrap：脚手架
get吞裸数组的绕过方案
AI-native ADS方法论
- 治理vs重搭判断：7字段约束、30+30+40预算分配、schema AI-friendliness评估
- 与官方路线关系：非操作手册而是范式判断文档
餐饮BI公式实战库（V2.1.5）
- 60+ SQL范式：AC/ADS/复购率/RFM/新老客/用餐时段/留存流失
- DWD宽表范式：10-CTE底座、双源对账、评价pipeline，蒸馏自39个生产ETL
显著优点
1. 全实证驱动：所有API路径、payload字段、报错信息、版本变更均来自真实跑通请求（标注workshop513、2026-06-09等时间戳）
2. 版本对齐机制：与官方全家桶版本强绑定（V3.0.5对齐guancli 1.0.33/guanvis 0.1.24/guanetl 0.1.14），含0.1.14移除delete命令等 breaking change 标注
3. 工程化完整度：从单表debug到30+表重构的ExecPlan工作法，含B-7.0删除安全闸等硬性约束
4. 多Agent兼容：Claude Code/OpenClaw/Codex/Hermes通用，SKILL.md frontmatter标准化
潜在局限
1. 环境锁定：基于观远BI 8.2.1-hf6/V7实例，其他BI平台不适用
2. 版本追赶成本：官方全家桶快速迭代（2026-06月内3次版本跳），需持续同步验证
3. 权限依赖：部分操作（如direct-save）需cookie/session认证，纯token调用401
4. 删除操作收敛：guanetl 0.1.14移除delete后，高风险操作需回BI UI或裸调API
适合人群
- 观远BI重度用户（60+ETL/复杂看板/跨状态机场景）
- 数据中台工程师（ETL治理、字段审计、循环依赖拆解）
- 前端工程师（自定义图表注入、HTML应用化看板）
- SuperApp开发者（开放应用、form建表、LLM中转）
- 餐饮连锁BI从业者（复购率/RFM/AC等业务口径）
常规风险
- 数据误删：B-7.0安全闸要求逐项确认，但并行链路默认终态，用户主动收敛时才删除
- 状态机陷阱：V7草稿/发布cdId不自动映射，手撸API易拼出孤儿卡片
- 类型严格化：Spark新引擎对
<> NULL、UNION列数、中文别名严格报错，老SQL迁移需改造 - 版本漂移：guanetl edit空etl.go等bug未完全修复，需按B-0.5实测绕过执行
与官方全家桶关系
| 场景 | 路由至 |
|------|--------|
| 查数/建卡/截图 | guancli/guanvis |
| 标准ETL新建 | guanetl（但edit改现有ETL失效时回退Part B） |
| 数据流 | guanwf |
| 数据源/数据集CRUD | guands |
| 整库治理/报错排障/状态机绕过/SuperApp反向工程 | **本Skill** |