核心定位
majia-guanyuan 是架在观远官方全家桶（guancli/guanvis/guanetl/guanwf/guands）之上的实战增益层Agent Skill，专注解决官方命令封装不到的硬骨头：ETL整库治理判断、10类BI引擎报错手册、SmartETL全链路重写、自定义图表HTML/CSS/JS注入排障、v7草稿-发布状态机绕过、SuperApp开放应用反向工程、AI-native ADS数据架构方法论，以及餐饮连锁BI公式实战库。
显著优点
1. 实战沉淀深厚：60+张ETL创建/重构/修复/删除的完整实证记录，30+表批量迁移工程经验，39个生产ETL蒸馏出的DWD宽表范式
2. 官方对齐及时：V3.x起彻底重构为「官方全家桶之上」，标准CRUD一律路由官方，自身专注边界场景，版本跟随官方周更节奏（最新V3.1.1对齐guanskill 0.1.6）
3. 方法论体系完整：从ETL治理8维判断到全链路重写ExecPlan工作法，从HTML应用化看板五层验收到AI-native ADS「治理vs重搭」决策框架
4. 行业场景深耕：餐饮BI公式库覆盖AC/ADS/复购率/RFM/Cohort/财务对账等60+SQL口径，去敏蒸馏自真实履职经验
潜在局限
- 环境锁定：针对观远BI私有实例设计，需
guancli auth login认证，公有云SaaS部分路径可能差异 - 版本敏感：BI引擎行为随版本变化（如v7草稿-发布机制、Spark SQL严格类型），需持续跟随官方changelog
- 学习曲线：Part B/C/D/E各成体系，首次使用需明确「路由层→增益层」分流逻辑
适合人群
- 观远BI重度用户（ETL工程师、BI开发、数据架构师）
- 面临「ETL治理做了一年没出活」「现有BI接AI该治理还是重搭」决策困境的团队
- 需要HTML自定义图表、SuperApp开放应用、移动端phoneLayout等进阶能力的开发者
- 餐饮连锁行业数据中台建设者
常规风险
- 删除操作风险：ETL/数据集删除有严格顺序（先ds后etl），需用户逐项明确确认，默认「新旧并行」而非「直接替换」
- 状态机陷阱：v7 BI草稿-发布分离机制使手撸API易卡
60004错误，必须用guanvis publish跨状态机 - 类型隐坑：CSV散客
会员ID IS NOT NULL算出100%假指标、Spark中文CTE别名报错等需严格遵循「三态硬规则」