用途
mck-ppt-design 用于从零创建专业、咨询级的 PowerPoint 演示文稿,采用 McKinsey 风格设计。它通过 MckEngine(python-pptx 封装)驱动生成,作者为 likaku,版本 2.3.3-harness-v2。当用户需要制作演示文稿时使用。
主要能力
- 五阶段生成流程:S1 需求定义 → S2 结构设计 → S3 内容填充 → S4 渲染+QA → S5 交付。
- 门禁机制:S2 为 AI 自评门禁;S3 与 S4 必须机读化,执行 gate_check_s3.py 和 gate_check.py 脚本并读取 JSON 结果。
- 知识路由:每个阶段按需读取对应文件,避免全量加载,如 brand-guide.md、engine-api.md、layout-matrix.yaml、guard-rails.md 等。
- Fast Track:满足总页数 ≤ 5、无数据图表、用户明确表达快速/马上要/简单时,可跳过 S2/S3 门禁,但仍必须完成 S1 与 S4 QA 门禁及 S5 交付。
- 断点恢复:通过检查项目目录下 brief.md、outline.json、content.json、gate_s3.json、gate_result.json、.pptx 等文件判断当前阶段。
- Self-Refinement:每次修正 pattern-level 问题后,将经验写入 experiences/ 对应文件(overflow.md、chart-limits.md、layout-pitfalls.md、cjk-issues.md)。
使用方式
需安装依赖:pip install python-pptx lxml。所需工具为 Read、Write、Bash。引擎路径固定:sys.path.insert(0, os.path.expanduser('~/.workbuddy/skills/mck-ppt-design'))。
MckEngine 快速模板:
import sys, os sys.path.insert(0, os.path.expanduser('~/.workbuddy/skills/mck-ppt-design')) from mck_ppt import MckEngine from mck_ppt.constants import *
eng = MckEngine(total_slides=12) eng.cover(title='标题', subtitle='副标题', author='作者', date='2026年') eng.toc(items=[('1', '章节一', '一句话描述'), ('2', '章节二', '一句话描述')])
... 内容页 ...
eng.closing(title='谢谢', message='期待进一步交流') eng.save('output/deck.pptx') # 自动 full_cleanup
S3 门禁命令: python ~/.workbuddy/skills/mck-ppt-design/references/scripts/gate_check_s3.py <项目目录>/content.json <项目目录> 读取 <项目目录>/gate_s3.json,仅当 "passed": true 时进入 S4。
S4 门禁命令: python ~/.workbuddy/skills/mck-ppt-design/references/scripts/gate_check.py <pptx路径> <项目目录> 读取 <项目目录>/gate_result.json,仅当 "passed": true 时进入 S5。
HARD RULES 要求:每次生成必须走五阶段流程;TaskCreate 驱动进度;门禁必须机读化;Self-Refinement 必做;引擎路径固定。
适用场景
- 需要制作咨询风格、McKinsey 风格演示文稿的用户。
- 有明确受众、目标、时长与关键信息的汇报或说服场景。
- 需要结构化、可追溯生成流程的演示文稿项目。
限制
- 必须安装 python-pptx 和 lxml。
- S3 与 S4 门禁必须运行脚本读取 JSON,不得口头判断通过。
- 反模式包括:口头宣布门禁通过、S3 门禁仅靠脑内预检、将 engine_bug 分类作为软话逃生口。
- 未提供具体收费、价格、平台支持范围等信息。