前言¶

在观远 BI 的日常工作中，查数、建卡、ETL、数据集 CRUD 等标准操作通常依赖官方全家桶（guancli 查数 / guanvis 建卡发布截图 / guanetl ETL / guanwf 数据流 / guands 数据源）。这些命令覆盖了大部分基础场景，但面对业务实战与引擎级踩坑时，往往会遇到官方 DSL/命令未覆盖的硬骨头。比如 ETL 整库治理判断、BI 引擎报错排查、自定义图表注入、移动端 phoneLayout ZIP 注入、SuperApp 开放应用反向工程等。本 Skill 旨在架在官方全家桶之上，专攻这些场景，提供实战增益与问题定位能力。

是什么¶

@supermajia/majia-guanyuan 是观远 BI（Guandata）实战增益层 Agent Skill，由用户 user_15292d5a 发布于 SkillHub，分类为 data-analysis。它建立在官方全家桶之上，将标准查数、建卡、ETL、数据集 CRUD 路由给官方命令，自身专注业务实战与引擎级踩坑，包括 Part B ETL 整库治理判断、10 类 BI 引擎报错手册、SmartETL 全链路重写/ExecPlan、自定义图表 HTML/CSS/JS 注入排障、固定卡/overlay、HTML 应用化看板、v7 草稿-发布状态机绕过、SmartETL 节点化静默坑、移动端 phoneLayout ZIP 注入、SuperApp 开放应用反向工程（form 建表 / survey-engine/api/form/add + LLM 中转 ILLEGAL_JSON_RES 三路径解析 + 原生 fetch credentials 绕 unwrap）、AI-native ADS 数据架构方法论（治理 vs 重搭 / 7 字段约束 / 30+30+40 预算）、餐饮连锁 BI 公式实战库（60+ SQL/复购/RFM/AC/Comp/DWD 宽表范式/39 ETL 索引）等。

核心能力¶

• Part B ETL 整库治理判断：对 ETL 全库进行治理判断，识别潜在问题。
• BI 引擎报错手册：覆盖 10 类常见 BI 引擎报错，提供排查思路。
• SmartETL 全链路重写/ExecPlan：对 SmartETL 进行全链路重写与执行计划分析。
• 自定义图表 HTML/CSS/JS 注入排障：支持固定卡/overlay 的自定义图表注入，解决样式与交互问题。
• HTML 应用化看板：通过 descriptor patch 将 selector 联到 custom chart 内部 dataView，实现 HTML 看板应用化。
• v7 草稿-发布状态机绕过：绕过 v7 草稿-发布状态机的限制，提升发布效率。
• SmartETL 节点化静默坑：识别并解决 SmartETL 节点化过程中的静默问题。
• 移动端 phoneLayout ZIP 注入：支持移动端 phoneLayout ZIP 注入，解决移动端布局问题。
• SuperApp 开放应用反向工程：通过 form 建表 / survey-engine/api/form/add 接口，结合 LLM 中转 ILLEGAL_JSON_RES 三路径解析与原生 fetch credentials 绕 unwrap，实现 SuperApp 开放应用的反向工程。
• AI-native ADS 数据架构方法论：提供治理 vs 重搭的对比，以及 7 字段约束、30+30+40 预算等数据架构方法论。
• 餐饮连锁 BI 公式实战库：包含 60+ SQL/复购/RFM/AC/Comp/DWD 宽表范式/39 ETL 索引的实战公式库。

安装与启用¶

安装命令：

npm install -g @supermajia/majia-guanyuan

启用方式：

• 在 Claude Code 中，将此 Skill 添加到当前会话的可用 Skill 列表中。
• 在 Codex CLI / OpenClaw / Hermes 等通用环境配置中，通过 Skill 名称或路径引用该 Skill。

典型用法¶

• 使用 ETL 整库治理判断：在 ETL 任务中调用 Part B 能力，对整库进行治理判断，输出潜在问题清单。
• 查阅 BI 引擎报错手册：遇到 BI 引擎报错时，根据报错类型匹配 10 类报错手册，获取排查建议。
• 自定义图表注入：在自定义图表场景下，通过 HTML/CSS/JS 注入排障，解决样式与交互异常。
• SuperApp 反向工程：在 SuperApp 开放应用场景，通过 form 建表与 survey-engine/api/form/add 接口，结合 LLM 中转与 credentials 绕过，实现应用数据结构与功能的反向工程。

适用场景与注意¶

• 适用场景：需要深入解决观远 BI 引擎级问题、自定义图表与 HTML 看板开发、SuperApp 开放应用构建、ETL 治理判断、移动端布局优化、AI-native ADS 数据架构规划、餐饮连锁 BI 公式库使用的开发者。
• 注意事项：本 Skill 依赖官方全家桶（guancli / guanvis / guanetl / guanwf / guands），需确保这些官方命令可用；部分功能涉及引擎底层，使用时需理解业务上下文与风险。

结尾¶

@supermajia/majia-guanyuan 为观远 BI 开发者提供了从业务实战到引擎级踩坑的增益层，覆盖 ETL 治理、报错手册、自定义图表、HTML 看板、SuperApp 反向工程、AI-native ADS 架构与餐饮连锁 BI 公式库等场景。官方地址：https://api.skillhub.cn/user_15292d5a/yjkj-guanyuan-majia