核心定位
majia-guanyuan 是架在观远官方全家桶（guancli/guanvis/guanetl/guanwf/guands）之上的实战增益层Agent Skill。标准查数/建卡/ETL一律路由给官方命令，本Skill专攻官方DSL/命令覆盖不到的硬骨头：ETL整库治理判断、BI引擎10类报错手册、SmartETL全链路重写方法论、自定义图表HTML/CSS/JS注入排障、v7草稿-发布状态机绕过、SuperApp开放应用反向工程（含form建表API破解、LLM中转ILLEGAL_JSON_RES解析）、AI-native ADS数据架构方法论，以及餐饮连锁BI公式实战库（60+SQL/复购/RFM/DWD宽表范式/39个生产ETL）。
显著优点
1. 实战踩坑密度极高：全部来自真实跑通的workshop513实证记录，非文档转述，含guanetl 0.1.12-0.1.13 edit失效绕过方案、B-7.0删除安全闸等经过对抗校验的硬规则
2. 分层架构清晰：路由层→Part B（ETL治理）→Part C（自定义图表）→Part D（v7发布流水线）→Part E（SuperApp）→AI-native方法论→餐饮公式库，触发词精确路由
3. 安全约束严格：B-7.0删除安全闸强制逐项用户确认、ds-first删除顺序经净零回归实测、模糊回复不算确认
4. 版本对齐机制：官方全家桶每周迭代，本Skill有完整SOP（Step 0-5）跟踪npm版本→skill更新→manifest同步
5. 可执行交付物：ExecPlan工作法（B-17.11）、5层视觉验收清单（C-12）、patch_selector_linkage.js工具脚本
潜在缺点与局限
1. 环境锁定：仅验证于Node ≥20、本地私有BI实例，公有云/企业版配置差异未覆盖
2. 版本漂移风险：观远官方迭代极快（周更），guanetl 0.1.14已移除delete命令，历史绕过方案虽保留但可能误导
3. 技能栈门槛：需同时掌握guancli fetch、jq、Spark SQL、BI前端runtime、npm技能生态，纯业务用户上手曲线陡峭
4. 餐饮公式库垂直：60+SQL范式虽全脱敏，但餐饮连锁场景外通用性有限
适合人群
- 观远BI高级用户：已用完官方全家桶标准能力，卡在引擎报错/状态机/自定义图表等硬边界
- 数据架构师：需判断ETL治理vs重搭、设计AI-native ADS、管理30+表跨日工程
- BI工程师：处理SmartETL全链路重写、自定义图表DOM注入、SuperApp逆向工程
- 技术型产品经理：需理解v7草稿发布机制、HTML应用化看板交付标准
常规风险
1. 误删数据：虽有B-7.0安全闸，但page?force=true级联删除不可逆，无guanvis源时按不可逆DELETE对待
2. 类型陷阱：CSV散客会员ID IS NOT NULL算出100%假指标、Spark中文别名PARSE_SYNTAX_ERROR、STRING字段才能<>''等三态硬规则易踩
3. 状态机混淆：v7 draft cdId ≠ published cdId，手撸page+card API全废，必须用guanvis publish绕过
4. 权限残留：INPUT_DATASET用只读权限dsId时保存能过、执行会空数据，难即时发现