核心定位
majia-guanyuan 是架在观远官方全家桶(guancli/guanvis/guanetl/guanwf/guands)之上的实战增益层Agent Skill,专攻官方DSL/命令覆盖不到的硬骨头场景。V3.0.0重构后退役自造HTTP客户端,标准查数/建卡/ETL/数据集CRUD一律路由官方,本skill只保留官方够不着的业务实战与引擎级踩坑。
五大核心模块
Part B:ETL治理与写入
- 整库治理扫描(60+张ETL实战经验,8维去留判断+4维字段审计)
- 10类BI引擎报错修复手册(含
<> NULL吞行、CTE中文别名、UNION列数不匹配等) - SmartETL全链路重写方法论(CTO张进经验,含ExecPlan工作法)
- guanetl
edit失效时的实测绕过路径(V3.0.4新增)
Part C:自定义图表开发与排障
- HTML/CSS/JS注入排障、固定卡片/overlay、z-index层级管理
payload_json取数排障与截断处理- Part C-12:HTML应用化看板生成(descriptor patch联selector到custom chart内部dataView)
Part D:V7 Page/Card发布流水线
- 草稿-发布状态机绕过(
60004错误处理) - CSV三态硬规则(
会员ID IS NOT NULL算出100%假指标修复) - Spark中文别名限制、ETL update
1012同名文件处理 - 移动端phoneLayout ZIP inject(V2.1.10)
Part E:SuperApp开放应用开发
form_xxx建表反向工程(脚手架未暴露API的实测路径)- BI中转LLM报
NOT_JSON_RES/ILLEGAL_JSON_RES三路径解析 - 原生fetch credentials绕过unwrap、流式打字效果实现
方法论与行业库
- AI-native ADS数据架构方法论:治理vs重搭判断、7字段约束、30+30+40预算分配
- 餐饮连锁BI公式实战库:60+SQL/复购/RFM/AC/Comp/DWD宽表范式/39个生产ETL索引
显著优点
- 全链路实测驱动:每个API路径、payload字段、报错码均来自真实跑通的请求
- 硬边界清晰标注:明确区分"路由给官方"vs"必须走本skill"的场景
- 工程化管理:ExecPlan工作法支持跨多日30+表重构追踪
- 安全闸机制:删除操作需逐项用户确认+下游引用验证+对账通过
潜在局限
- 环境绑定:针对观远BI 8.x版本,部分行为随版本迭代可能变化
- 实例差异:实测发现
guanetl edit在某些实例存在逆向失效问题 - 前置依赖:需配合官方全家桶使用,非独立全栈方案
适合人群
- 观远BI深度用户(已熟悉基础操作,需突破官方DSL边界)
- 数据中台工程师(ETL治理、字段审计、循环依赖拆解)
- 前端开发者(自定义图表注入、HTML应用看板、SuperApp开发)
- 餐饮/零售连锁行业BI实施(业务公式口径对齐)
常规风险
- 写操作风险:未经确认执行DELETE可能误删下游依赖
- 版本漂移:官方skill升级可能导致行为变化,需关注CHANGELOG
- 认证失效:cookie/session认证过期需重新
guancli auth login