核心定位
majia-guanyuan（观远BI·马甲实战版） 是架设在观远官方全家桶（guancli/guanvis/guanetl/guanwf/guands/guanmetric）之上的实战增益层Agent Skill。标准查数、建卡、ETL CRUD等常规操作一律路由给官方命令；本skill专攻官方DSL/命令覆盖不到的业务实战与引擎级踩坑。
五大实战阵地
Part B：ETL治理与写入
- 整库治理扫描：60+张ETL创建/重构/修复/删除的完整方法论
- 10类BI引擎报错手册：从
<> NULL恒false到Spark中文别名PARSE_SYNTAX_ERROR的修复速查 - SmartETL全链路重写/ExecPlan：30+表批量迁移的工程化管理（CTO张进方法论）
- 删除安全闸B-7.0：先ds后etl、逐项确认、新旧并行对账
Part C：自定义图表开发与排障
- HTML/CSS/JS注入、固定卡片/overlay、payload_json取数排障
- Part C-12 HTML应用化看板：descriptor patch打通selector与custom chart内部dataView
- 视觉设计底线V3.1.0：反AI味红线、五层验收、
guanvis screenshot视觉验收
Part D：v7草稿-发布状态机绕过
60004 此操作只能在草稿页面执行的根治方案- CSV散客
会员ID IS NOT NULL算出100%假指标的三态硬规则 - Spark CTE中文别名、SmartETL节点化静默坑
- 移动端phoneLayout ZIP inject唯一可行路径
Part E：SuperApp开放应用反向工程
form_xxx建表反向工程（POST /survey-engine/api/form/add）- BI中转LLM报
ILLEGAL_JSON_RES三路径解析 - 同源fetch credentials绕unwrap、客户端模拟流式打字
AI-native ADS设计方法论+餐饮BI公式库
- 治理vs重搭判断：7字段AI-friendly约束、30+30+40预算分配
- 餐饮连锁实战库：60+SQL公式、RFM/AC/Comp/DWD宽表范式、39个生产ETL索引
显著优点
1. 零重复造轮：与官方skill分层协作，标准操作自动路由
2. 全实证驱动：所有API路径、payload字段、报错码均来自真实BI实例跑通记录
3. 工程化闭环：从治理扫描→写入执行→副本页验收→旧链清理的完整SOP
4. 防御性设计：B-7.0删除安全闸、B-13红线清单、ExecPlan活文档管理
潜在局限
- 需预装官方全家桶
@guandata/guanskill及6组件 - 针对观远BI私有实例，SaaS公有云部分端点可能差异
- 重度依赖
guancli fetch底层API，官方DSL升级需同步对齐
适合人群
- 观远BI重度用户（日均操作ETL/看板/数据集）
- 数据中台工程师（需批量治理、重构、迁移）
- 餐饮/零售连锁行业BI从业者（复购/RFM/同店增长等口径）
- 需绕过官方脚手架限制做深度定制的前端/数据工程师
常规风险
- DELETE操作不可逆：force=true级联删页、先ds后etl顺序错误
- 版本对齐滞后：官方全家桶周更节奏，本地skill需主动
guanskill install-skill - 状态机误解：v7草稿/发布分离，手撸API易踩
60004/cdId映射失败 - 类型严格化：Spark新引擎对
<> NULL、UNION列数、中文别名更严格