mcpField

aham-ppt

github.com/li599198347-svgDocuments114 installs
Repository

About aham-ppt

aham-ppt is a skill for producing PowerPoint presentations using the Aham UI Office track. It guides material analysis, argument structure, slide planning, design, and quality checks, with two visual themes.

Key features

  1. 01Two visual theme options
  2. 02Eight-stage presentation workflow
  3. 03Material and key-point analysis
  4. 04Narrative and slide planning
  5. 05Slide design and quality checks
  6. 06Reusable icons and diagram components

Use cases

  1. 01Building a presentation from source material
  2. 02Choosing a restrained or modern visual style
  3. 03Planning slide narratives and layouts
  4. 04Checking a finished deck against design rules

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/li599198347-svg/aham-ppt --skill aham-ppt

After installing, type/aham-pptin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
CONTRIBUTING.md
LESSONS.md
CHANGELOG.md
LICENSE
README.md
ORIGIN.md
NOTICE.md
assets/
README.md
svg_to_pptx_wrapper.py
assets/components/
components.py
icons.py
themes.py
assets/svg_to_pptx/
LICENSE_NOTE.md
drawingml_context.py
__init__.py
drawingml_converter.py
drawingml_elements.py
drawingml_paths.py
drawingml_styles.py
drawingml_utils.py
pptx_cli.py
pptx_builder.py
pptx_dimensions.py
pptx_slide_xml.py
pptx_discovery.py
docs/
index.html
examples/
build_examples.py
article_figures.py
build_pages.py

Details

From the project README

Aham PPT 技能 — Aham UI v6.1 · Office 轨 · PPT

版本 v2.1（双档主题 + 工具链修复）。本版新增：A 克制档 / B 现代专业档（默认 B）、 启动选档步骤、转换器字宽修复、线性图标库与关系图组件库、强调色语义 QC、内容方法论。 详见 references/theme-tiers.md、references/enhancements.md、CHANGELOG.md。

Step 1 · 加载规范（优先级顺序）

优先级 1（主路径）：

view references/brand-spec/brand.md
view references/brand-spec/track-rules.md

重点提取 PPT 相关内容：Action Title 规则、版式、色值、字体（Office 轨 · PPT 子模型，见 aham-ui-office.md）。

优先级 2（PPT 专项规范）：

view references/designer-rules.md
view references/phase-01.md  ← 规范加载阶段
（按执行阶段依次读取对应 phase-XX.md）

优先级 3（降级兜底）： 使用本文件末尾「降级基线」。

加载 pptx 文档生成技能：

view /mnt/skills/public/pptx/SKILL.md

v2.1 新增规范（务必加载）：

view references/theme-tiers.md     ← 双档主题：A 克制 / B 现代专业（默认）
view references/enhancements.md    ← 字宽修复 / 强调色语义 QC / 图标组件 / 方法论

图标与组件资产位于 assets/components/：icons.py（~40 线性图标 + icon_circle/num_badge/num_ring）、 components.py（泳道/蓝图/箭头/KPI/状态/设备屏/占位框）、themes.py（A/B 封面/目录/章节/页眉模板）。

Step 1.5 · 选择视觉档（默认 B · 现代专业档）

加载规范后、解析材料前，向用户确认一次视觉档（回车默认 B）：

这份 PPT 用哪种视觉档？
  A 克制档     —— 纯白极简，适合高层正式汇报、严谨决策
  B 现代专业档 —— 图标 + 关系图 + 设计化封面/目录/章节（默认，适合多数客户方案）
直接回车 = B。

记录 theme = A | B。两档共用同一套内容与组件，只切换主题层（封面/目录/章节模板 + 页眉皮肤）； 两档都坚持单一品牌主色 + 中性灰，不引入多色体系（多色实测"AI 感/营销感"偏重）。 phase-05（版式）/ phase-07（出片）按 theme 取用 themes.py 对应模板。详见 references/theme-tiers.md。

Step 2 · 八阶段执行

按 references/phase-01.md ~ phase-08.md 中的详细指引执行，此处仅列阶段名称：

  1. 规范加载（本 Step 1）
  2. 材料解析与关键信息提取
  3. 核心论点提炼（麦肯锡金字塔结构）
  4. 叙事骨架搭建（Ghost Deck）
  5. 大纲与版式规划
  6. 样稿确认（与用户对齐）
  7. 逐页设计输出
  8. 质检交付（QC 清单）

降级基线（无法读取外部规范时）

⚠️ 未找到外部规范，使用内嵌基线（Aham UI v6.1 · Office 轨 · PPT）。

PPT 核心规则（北极星：极简克制的桌面 AI 气质 · 冷色的纸 · 蓝是点缀）：

  • 底永远纯白 #FFFFFF；三层灰 #FFFFFF/#F3F3F3/#E7E7E7；墨四级 #262626/#6E6E6E/#9B9B9B/#C4C4C4。禁纯黑 #000。
  • 蓝 #336EE8 只点缀（品牌点/主操作/选中/推荐/单个高亮数据点/封面短线）；无顶部蓝条、绝不铺底。
  • Action Title：每页完整结论句、无衬线 bold #262626（无蓝竖线、无衬线）。
  • 字体：单一无衬线 Inter, 'PingFang SC', 'Microsoft YaHei', sans-serif（禁衬线）；数字一律 mono 'JetBrains Mono', Consolas, monospace。
  • 卡片无边框无阴影；分块靠留白 + #E7E7E7 细横线；选中=扁平灰非蓝。
  • 表格只横线、无竖线、无整行底色；数字右对齐 mono；表头/合计加粗。状态 = 6px 点 + 文字（禁红黄绿灯/pill）。
  • 图表灰阶 #9B9B9B/#C8C8C8 + 一个 #336EE8 高亮；无 3D/阴影/渐变/饼图。
  • 标题字号：内容 24pt、封面 32–40pt（左对齐）、正文 14–16pt、大数字 mono 44–60pt。
  • 禁用：纯黑#000 / 渐变 / 3D / 投影 / 衬线 / 第二装饰彩色 / emoji / 饼图 / 表格竖线 / 蓝铺底 / 红黄绿灯。
  • 禁用词：赋能·颠覆·生态·闭环·最佳实践·全链路·一站式·显著·大幅。
  • 数字格式：货币 ¥1,200,000；百分比 37.5%；日期 YYYY-MM-DD；数字用等宽 mono。
  • 每页一个核心结论，表格优于文字堆砌。

Comments

Markdown supported