manifest.json

{
  "$schema": "https://json.schemastore.org/skill-manifest",
  "name": "majia-guanyuan",
  "displayName": "观远 BI · 马甲实战版",
  "version": "3.1.8",
  "description": "V3.0.0 (2026-06-04) — ground-up refactor: retired the self-built guandata.py HTTP client and rebuilt this skill as a battle-tested gain-layer on top of the official Guandata skill family, routing standard query/card/ETL/dataset CRUD to guancli/guanvis/guanetl/guanwf/guands (and metric writes to guanmetric) and keeping only what the official DSL/commands can't reach. Tool-agnostic Claude Code / OpenClaw / Codex / Hermes skill for Guandata BI (观远 BI). Current structure — a router layer plus the hard-bone parts + a philosophy-layer doc: 🧭 router layer (standard query/card/ETL/dataset CRUD routed to the official family), ETL governance & write (Part B, incl. SmartETL full-chain rewrite & ExecPlan + 10-category engine error playbook + dual-source field audit), custom chart HTML/CSS/JS injection & debugging on existing pages (Part C-1..11), HTML application-style dashboard generation (Part C-12, SDK subtype + DATA_GRID dataView layer + descriptor-level selector linkage patch), V7 Page/Card publish pipeline (Part D: v7 draft/release state-machine bypass + guanvis one-shot publish + 3-state CSV rules + Spark CTE Chinese-alias gotcha + 6-dashboard end-to-end case study + customChart autoBootstrap + chip toolbar fallback + mobile phoneLayout ZIP-inject path), SuperApp open-app development pipeline (Part E: guancli app create/publish + dataset async preview 3-step + form schema reverse-engineering via /survey-engine/api/form/add + LLM bridge ILLEGAL_JSON_RES triple-path parsing + native fetch credentials to bypass scaffold get unwrap), and AI-native ADS design methodology (philosophy layer: when client wants to add LLM/SuperApp to existing BI, judge governance vs rebuild; ODS/DIM/DWD untouched, ADS layer rebuilt for LLM-native consumption; 7 field constraints: Chinese enums + pre-computed recommendations + composite semantics + TIMESTAMP + strict-value priorities + pre-computed numerics + row-level permission redundancy; budget allocation 30% governance + 30% ADS rebuild + 40% AI apps yields 10x ROI vs pure governance), plus a restaurant-chain BI formula playbook. Prerequisites: install the official family via `npm i -g @guandata/guanskill && guanskill install-skill` (guancli 1.0.43 + guanvis 0.1.33 + guanetl 0.1.21 + guands 0.1.23 + guanwf 0.1.822 + guanmetric 0.1.3, each with its AI skill; guanexport + guanadmin left the family 2026-06-04; guanmetric joined 2026-07-08 taking metric writes out of guancli); authenticate with `guancli auth login` (the whole family shares one profile — this skill no longer reads config.json). Battle-tested with 60+ ETL operations, a 41-card production HTML application dashboard, a 20-table + 17-ETL + 6-HTML-dashboard end-to-end demo, and a 9-dashboard mobile adaptation. The restaurant-chain BI formula playbook (10 markdown files, 60+ SQL snippets + 6 ETL engineering patterns + 39 production ETL catalog index) moved to the standalone repo majia-huiyuan (github.com/maojiebc/majia-huiyuan, 公式库/) on 2026-07-12; references/restaurant-bi-formulas/ here keeps a pointer README only. Progressive disclosure keeps SKILL.md as the router and references/ + templates/ as detailed playbooks. Full version history in CHANGELOG.md. Install via `gh skill`, `git clone` + `node bin/install.js install`, `npx github:maojiebc/majia-guanyuan install`, or ClawHub/OpenClaw.",
  "license": "MIT",
  "author": "maojiebc",
  "authorDisplayName": "超级马甲",
  "contact": {
    "email": "m9224@163.com",
    "github": "https://github.com/maojiebc",
    "clawhub": "https://clawhub.ai/maojiebc"
  },
  "social": {
    "x": "https://x.com/maojiebc",
    "xiaohongshu": "https://xhslink.com/m/4fQMJeHHWKC",
    "wechatOfficialAccount": "超级马甲"
  },
  "homepage": "https://github.com/maojiebc/majia-guanyuan",
  "repository": "https://github.com/maojiebc/majia-guanyuan",
  "entry": "SKILL.md",
  "compatibility": {
    "claude-code": {
      "supported": true,
      "installPath": "~/.claude/skills/majia-guanyuan/",
      "entry": "SKILL.md"
    },
    "openclaw": {
      "supported": true,
      "installPath": "~/.openclaw/skills/majia-guanyuan/",
      "entry": "SKILL.md"
    },
    "codex": {
      "supported": true,
      "installPath": "~/.codex/skills/majia-guanyuan/",
      "entry": "SKILL.md",
      "projectInstructions": "AGENTS.md"
    },
    "hermes": {
      "supported": true,
      "installPath": "<workspace>/skills/majia-guanyuan/",
      "entry": "SKILL.md",
      "resolver": "AGENTS.md"
    }
  },
  "dependencies": {
    "system": [
      "jq",
      "bash"
    ],
    "python": [],
    "node": [
      "@guandata/guanskill"
    ]
  },
  "auth": {
    "_note": "V3.0.0: authentication moved to the official family. Run `guancli auth login` once; the whole family (guancli/guanvis/guanetl/guanwf/guands/guanmetric) shares one profile. This skill no longer reads config.json — the retired guandata.py was the only consumer.",
    "method": "guancli auth login",
    "legacyConfigFile": "config.example.json (schema reference only; no longer read by the skill)"
  },
  "credits": {
    "originalSkills": [
      {
        "name": "guandata-bi",
        "url": "https://clawhub.ai/skills/guandata-bi",
        "role": "Part A inspiration"
      },
      {
        "name": "zhengyuhe123/guandata",
        "url": "https://github.com/zhengyuhe123/guandata",
        "role": "Original GitHub project"
      },
      {
        "name": "guandata70",
        "author": "小小郑3号",
        "role": "Direct predecessor of Part A (Guandata 7.0+ adapter)"
      }
    ],
    "experienceContributors": [
      {
        "name": "Zhang Jin (张进)",
        "role": "CTO @ Guandata. Contributed Part B-17 (SmartETL full-chain rewrite methodology) and Part C (custom chart dev)"
      },
      {
        "name": "OpenAI Codex",
        "role": "Contributed ExecPlan specification used in B-17.11"
      }
    ]
  }
}