mbb-deck

MBB 咨询风汇报 Deck 生成技能（Claude Code Skill）

输入文字素材，输出可直接汇报的 16:9 咨询风演示页（HTML / PPTX 双形态）

这是什么

一套自研的咨询风 deck 生成系统：按标准格式贴入素材，系统走六步工作流，产出深浅不一上咨蓝配色的 16:9 汇报页。

核心设计立场：能机械判定的才是硬规则。几何、字级、文本框行数预算写成硬门并用脚本复核；观感上限由校准范例携带，不假装规则能覆盖审美。

六步工作流

 文字素材
    │
    ▼
 ① 输入表单     触发点选（交付形态 / 篇幅 / 受众）+ 开工简报
 ② Storyline    一句 governing thought + 页序配方，标题连读契约必须过
 ③ 逐页契约     每页 9 字段：page_question / action_title / data_shape …
 ④ 版式路由     data_shape 封闭 12 类，查表判定，不许「看内容猜版式」
 ⑤ 页面实现     proof-object-first，上咨蓝灰设计语法
 ⑥ 交付验收     六道 QA 门 + 机械检查，0 发现才交付
    │
    ▼
 16:9 HTML / PPTX（原生图表）

安装

# 全局安装
git clone https://github.com/Gnomeshgh0714/mbb-deck.git ~/.claude/skills/mbb-deck

# 或项目级安装（在 Claude Code 项目根目录）
git clone https://github.com/Gnomeshgh0714/mbb-deck.git .claude/skills/mbb-deck

使用

三分钟上手

打开 docs/标准调用prompt.md，按板块式模板改关键信息即可。味道长这样：

请根据我给你的内容，用 mbb-deck skill 输出一版 PPT，整体颜色以深浅不一的上咨蓝为主。

第一页：主标题是"<这页的结论句>"；
        左边放"<板块小标题>"，具体内容是<背景或现状>；
        中间第一部分核心内容是<小标题>，具体包括<支撑内容，数字带单位、时间、口径>；
        ……
        本页资料来源：<来源行>。

系统会先弹出点选表单确认交付形态、篇幅与受众，附开工简报，确认后才动手。

交付前机械检查

python3 scripts/check_deck.py <产出.html>    # HTML：边界 / 溢出 / 重叠 / 交互门
python3 scripts/check_pptx.py <产出.pptx>    # PPTX：边界 / 文本溢出估算 / 形状重叠 / 图表数据读回

质量体系（三层）

层	职责	载体
硬规则层	几何 / 字级 / 文本框行数预算	`references/foundation.md`
机械验证层	边界、溢出、重叠、图表数据读回，发现即退回	`scripts/check_deck.py` · `scripts/check_pptx.py`
范例校准层	观感上限	`assets/exemplars/`（公开版不附带范例文件，内部资产；私有部署时放入该目录，见其 README）

三层各司其职：规则保正确性，脚本堵回归，范例定审美。

仓库结构

├── SKILL.md               # 技能入口：六步工作流 + 判定封闭原则
├── references/            # 规则真源：foundation / storyline / page-logic /
│                          # layout-routing / visual-language / qa-gates / open-questions
├── scripts/               # check_deck.py · check_pptx.py（纯标准库）· build_portable.py
├── assets/                # base-deck.html 起步模板 · intake-form.md 输入表单 · exemplars/
├── archive/               # 旧版骨架归档（停止维护，仅作恢复参考）
└── docs/
    ├── 标准调用prompt.md      # 员工调用模板（平台无关）
    ├── 可移植prompt.md        # 单文件系统提示词（约44KB），任何平台直接粘贴
    └── 多平台部署指南.md      # 各平台接法与能力降级对照表

跨平台部署

规则本体平台无关——Claude Code 原生可用，也可用 docs/可移植prompt.md 部署到 OpenAI、WorkBuddy 等任何支持系统提示词的模型 / agent 平台。接法与能力降级对照见 docs/多平台部署指南.md。

规则改动后重新生成可移植版，保持同源：

python3 scripts/build_portable.py docs/可移植prompt.md

路线图

范例资产：扩充 3–4 个带设计决策标注的校准范例
规则补丁：标注默认化、版式节奏、结论容器、图表清单
QA 升级：策展密度软门、构造级观感比对、盲测回归

开发参考

路由机制拆解自四个公开咨询风 skill：zairuilab/consulting-deck、appautomaton/presentation、lampertb/MBBDeckBuilderSkill、farhan85azad/bcg-slide-engine，在此致谢。

License

MIT

Mbb Deck

At a glance

README