可交付的 AI agent 能力包，一次编写、多 harness 复用。 Production-grade skill packs for modern AI coding agents.
English version · Install guide · Changelog · Contributing
ZimaBlueAI Agent Skills 是一组为现代 AI agent 设计的声明式能力包，在 Claude Code 与 OpenAI Codex CLI 上都能装。agent 在用户说出特定意图时按需加载，完成一次结构化交付。 不是开发库，不是 npm 包——是给 agent 用的能力声明。
一份源码，两个 harness。 每个 skill 直接放在仓库根，packaging/build.py 生成两边的安装包：
<skill-name>/ ★ 唯一源，改这里
├── SKILL.md 触发条件 + 工作流
├── references/ 参考资料
├── templates/ 产出物模板
├── scripts/ 可选工具脚本
└── samples/ 可打开的样例产出
│
│ python packaging/build.py
▼
dist/claude/*.zip → 解到 ~/ 得到 .claude/skills/<name>/ + .claude/agents/*.md
dist/codex/*.zip → 解到 ~/ 得到 .codex/skills/<name>/ + .codex/agents/*.toml
两个 harness 的产物只有两处不同，都由 packaging/harness.toml 声明：安装根目录
（.claude/ vs .codex/），以及三个老 skill 在 Codex 侧的短 description（Codex 对
frontmatter 的解析偏好短句，去掉了 markdown 粗体与中文触发词长串）。skill 正文、references、
templates、scripts、samples 全部一字不差——不再有"两个目录各自演化"的可能。
v0.4.0 起覆盖从董事会简报到对外讲演视频再到真正可编辑 PPT的全链路；Claude Code 与 OpenAI Codex CLI 双 harness 并发布。v0.7 新增自有设计合奏引擎 zima-design（三引擎收编 + 五轴多样性协议 + 四风格 demo 画廊），并为全线生成类 skills 内联反 AI slop 硬闸。最新一版给 zima-html-ppt 补上了工程治理层，并把 produce-cinematic-video 整理为带隐私、费用、权利和发布闸门的 ZimaBlueAI 可恢复影视生产技能。所有 skill 相互独立，按需取用。
| Skill | 一句话 | 输出 | 包大小 |
|---|---|---|---|
| biz-decision-stack | 8 subagents · 投资人 → CEO → 架构 → MRD → 交付 → 验收 → 评审 + 路由器（v4）决策链 | 8 份终端风 HTML + 编辑级 PPTX（黑底 + 酸黄 + 等宽 + 零动效） | ≈226 KB |
| viz-deck | 5 模产出 + 六项 v4 增强（演讲者模式 / 三变体预览 / 长文转 deck / 学术模板 / Bento / 反思循环） | HTML / 可编辑 PPTX（每元素可点） / MP4 / GIF / PDF（深空蓝紫青） | ≈432 KB |
| viz-charts | 7 类视觉表达 · Mermaid · ECharts · SVG 组件 · 3D 知识图谱 · SVG 环形/Circos KG（可交互）· Motion 视频 · Native PPTX 图表 | 内嵌 HTML / 离线 SVG / 交互 SVG KG / MP4 / 数据绑定 PPTX 图表 | ≈453 KB |
| zima-html-ppt | ZimaBlueAI 现场讲演 deck · 暖纸编辑风 + 演讲者模式（S 键弹提词器 / 逐字稿 / 计时 / 议程）· 母版 D1/D2/D3 · v2 工程治理层：方案先行 deck-plan + deck.json ↔ HTML 双向构建反解 + 七道闸门 + missing evidence 纪律 |
单文件 HTML 幻灯片（暖纸 + 深青 + 金赭 + 三色条）· deck.json 文档源 · JSON 闸门报告 | ≈101 KB · 校验/构建需 Python 3 |
| produce-cinematic-video | ZimaBlueAI 可恢复影视生产技能：策划研究 → 7 个专业工位 → 生成/剪辑/声音 → QC/营销评估；远程上传、费用和声音克隆分别过闸 | 策划、剧本、分镜、角色包、工程看板、成片与 stems、QC/评估报告 | ≈330 KB · Python 3 + 完整 FFmpeg；模型按需 |
| web-shader-extractor（移植 · 非 ZimaBlue 套件） | 网页 WebGL/WebGPU/Canvas 着色器动效抠取与本地证据匹配复现（Recon Kernel 状态机 + 6 铁律）· 移植自 lixiaolin94/skills（MIT） | 抠取/复现项目 + 4 个自包含 demo（含 logo 矢量化生灭折叠 3D 用例） | ≈603 KB · 零必需依赖 |
| gzh-design 🆕（移植 · 非 ZimaBlue 套件） | 微信公众号文章排版：Markdown/docx/PDF/纯文本 → 粘贴不掉格式的公众号 HTML（6 套主题 + 主题生成器 + 双关卡校验 + 一键复制预览）· 移植自 isjiamu/gzh-design-skill（AGPL-3.0，甲木 × 摸鱼小李） | 干净正文 HTML + 带「复制到公众号」按钮的预览页 | ≈221 KB · 零必需依赖 |
| zima-design 🆕 | 设计合奏引擎：原创路由协议编排三个内置引擎——anti-slop（21 宏结构 × 20 主题 × 57 条 slop-test 关卡，源自 nutlope/hallmark）+ motion（动画决策框架 / 弹簧物理 / 性能铁律，源自 emilkowalski/skills）+ database（84 风格 / 192 配色 / 74 字体搭配 / 98 UX 准则 / 22 技术栈可检索，源自 ui-ux-pro-max），联动 impeccable / huashu-design / taste-engine · 五轴多样性协议保证每次交付不重样 | 带「设计签名 + 六轴自评」双盖章的页面 / audit 报告 / 选型建议 + demo 三件套 | ≈3.6 MB · database 检索需 Python 3 |
做完的 deck 改不动，等于没做完。v1 只管出片——改一版就得让人重读八百行单文件，没有事实源，
对不对全靠交付前人眼扫一遍。v2 借 joeseesun/qiaomu-bento-ppt
（MIT · 向阳乔木）的工作流骨架与闸门思路补上治理层——只借纪律，没借它内置的 600 KB bento 外壳，
视觉与演讲者模式仍是 ZimaBlue Editorial 自有（署名见 zima-html-ppt/NOTICE.md）。
| 能力 | 说明 |
|---|---|
| 事实源 + 双向构建 | 产物末尾内嵌 <script id="zima-doc"> 存原始 deck.json。改稿 = extract → 改 JSON → build，不用重读 HTML；extract(build(x)) == x 逐字节相等，有回归用例守着 |
| 身份保持 | deckId 新建只铸一次，改稿 --identity-source 对不上直接拒绝构建；默认写 sibling 文件，源 HTML 一个字节不动 |
| 七道闸门 | Route / Structure / Identity / Shell / Quality / Browser / Rollback。结构闸门 38 项 error + 14 项 warning，判据不是"这条重要"，是"这条漏了台上会发生什么" |
| 证据纪律 | 报告默认挂着 missing evidence: browser visual review——人没真开浏览器看过，就不许写"已验证" |
| 方案先行 | 意图卡 → 1a 说服 / 2b 决策 / 3c 训战三方向选择卡 → 逐页计划表，含视觉所有者一列：一条信息只由标题/图表/卡片/正文/逐字稿其中一层负责，屏幕上的字和嘴里念的话不许是同一句 |
| 31 项回归 | 15 项闸门（好稿放行 / 坏稿逐类拦截 / 反解一致）+ 16 项路由边界（含 10 条该让给姊妹技能的） |
新纪律当场就兑现了：按新写的浏览器验收清单实跑，查出三个从母版 D1/D2/D3 起就在的渲染缺陷——
对比条组件因为 <i> 默认 display:inline 从来没显示过（整根 0×0）、页脚右侧被右下角翻页控件压住、
桌面端仍能横拖 25px。三个都已修，第一个还被写进 shell 闸门签名，防止再漏。
技能自带 examples/ 一份走完整链路的示范交付（方案稿 + deck.json + 14 页产物 + 闸门报告），
题材就是这次升级本身，每个数字都可回溯到代码计数或测试输出。
新增自有 skill zima-design——把三种互补的设计智能合奏起来：结构与主题多样性（anti-slop 引擎：21 宏结构轮换 + 57 slop-test 关卡 + audit/redesign 动词）、动效与手感（motion 引擎：频率门 → 目的 → 缓动 → 时长的决策框架，"该不该动"先于"怎么动"）、数据化选型（database 引擎：84 风格 / 192 配色 / 98 UX 准则本地检索）。一份原创路由协议决定谁主导谁辅助，五轴多样性协议（宏结构 × 主题 × 动效人格 × 卡片物理 × 密度节奏）强制连续交付不共享同一套模板骨架——治「AI 味模板脸」的合奏方案。三引擎均逐字节收编自 MIT 开源项目（溯源见 zima-design/NOTICE.md），外部联动 impeccable / huashu-design / taste-engine。附 demo 三件套：反面教材（12 处 slop 特征标本）→ 审计报告（24 项抽查 17 FAIL）→ 重设计对照。
同时全线升级本仓库生成类 skills：viz-deck / viz-charts / biz-html-viz / zima-html-ppt 的 SKILL.md 均内联「反 AI slop 硬闸」——六大纪律
（交付前六轴自评 / 禁编造指标 / 色值字体令牌锁定 / 禁手绘假 chrome / 320–768px 响应式硬底线 /
标题禁斜体），装有 zima-design 时自动桥接全量 57 关卡。
曾经的独立 skill taste-engine（三档 dial DESIGN_VARIANCE / MOTION_INTENSITY /
VISUAL_DENSITY + 反 slop 预检 + 选材文案规则）已整目录并入 zima-design 的 taste 引擎，
不再单独发布；溯源见 zima-design/NOTICE.md。它带来的两种纯 SVG、可交互知识图谱
（环形 Context Graph / Circos 弦图）已并入 viz-charts 的七类视觉表达，
见 viz-charts/references/svg-kg-guide.md。
v0.5 曾在 OpenClaw / Hermes 两个 IM-gateway 上做过「频道交付层」（viz-channel / gzh-channel，
在飞书群里对话式生成并把成品发回会话）。现已移除：这两个 harness 可以直接装本仓库的
Claude / Codex 包，再维护一层薄桥接只是重复。历史实现见 git 记录。
读了一篇《26 个 PPT 生成 Skill 系统梳理》后，把开源 PPT skill 生态里真正能补的精挑出 7 项整合进现有三个 skill。所有 v0.3 工作流完全保留，全为增量。
- ✨ viz-deck · Speaker Mode（抄 html-ppt-skill 3.8k★）：按 S 弹出独立演讲者窗口，4 张磁吸卡片（当前页 / 下一页 / 提词器 / 计时器），BroadcastChannel 双窗同步。三档 LAYOUT 预设（GRID / PROMPTER / DUO）
- ✨ viz-deck · Show-Don't-Tell 三变体预览（抄 frontend-slides 17.5k★）：用户输入含混时，从 20 哲学里取 3 个对比明显的方向并生 3 张 hero 缩略让用户挑（5 个场景预设：investor-pitch / product-launch / tech-deepdive / academic / default）
- ✨ viz-deck · Doc→Deck 转换器（抄 odin-slides 147★ + colloquium 190★）：把
.md/.docx/.pdf（经 pandoc 预处理）直接转为pptx-deck-spec.json，自动识别章节、表格转 KPI、引用块转 pullquote - ✨ viz-deck · Academic Talk 模板（抄 academic-pptx-skill 387★）：模式 1 第 4 个子模板，强制 action title（"市场翻倍" 而非"市场分析"）+ 引用规范 + Anticipated Q&A + Limitations
- ✨ viz-deck · Bento Grid 布局（抄 apple-bento-grid 171★）：HTML 单页 + pptx-deck 第 9 个 layout
bento-grid，3 列响应式 + 不等宽磁贴 + 三色 accent + Hero halo - ✨ viz-deck · Reflective Loop（抄 PPTAgent 4.4k★）：生成完 spec 后自动跑页面级 5 维评分，低于阈值的页列入 redo-prompts.txt，输出含雷达 + 表格的反思报告
- ✨ biz-decision-stack · Template Router（抄 mckinsey-pptx 426★）：第 9 个 subagent，对用户含混输入打分 8 模板 + 写辩护文进 HTML 注释头，每个选择都有理由
- ✨ ppt-master 软桥接：通过
hugohe3/ppt-master的 python-pptx + SVG→DrawingML 管线，所有 skill 现在都能输出每个元素都可点的真编辑 PPTX——不是图片嵌入，是原生 OOXML shapes - ✨ viz-deck 模式 5 · pptx-deck：JSON spec → SVG-per-slide → ppt-master →
.pptx，8 个 layout（cover/agenda/section/bullets/two-column/kpi-grid/pullquote/closing），三主题（deep-space / terminal / deck-light） - ✨ TTS 旁白嵌入：edge-tts 免费 + ElevenLabs / MiniMax / Qwen / CosyVoice 付费克隆；PowerPoint File→Export→Video 自动同步旁白+动画导出 MP4
- ✨ biz-decision-stack 决策报告 PPTX：8 个终端风 layout（verdict-cover / kpi-roster / decision-matrix / roadmap-phases / risks-grid / retro-3col / action-list / summary-stack），零动效保留扫读哲学
- ✨ viz-charts 原生数据绑定图表：ECharts spec →
.pptx含<c:chart>对象，stakeholder 在 PowerPoint 里右键 "Edit Data" 即可改数 - ✨ 三个 skill 均新增 v3 sample PPTX
- ✨ viz-deck 从 1 模扩展到 4 模（高保真原型 / 幻灯片 / 动画 MP4 / 原阶段报告）
- ✨ 20 设计哲学 + 5 维专家评审 整合到 viz-deck
- ✨ HTML → MP4 / 60fps / GIF 工具链（huashu-design 桥接）
- ✨ biz-decision-stack 第 7 subagent
design-critic+design-critique.html
详见 CHANGELOG。
v0.2 引入第一个软桥接 alchaincyf/huashu-design（动画 / 视频 / 设计哲学 / 评审）；v0.3 加入第二个软桥接 hugohe3/ppt-master（python-pptx + SVG→DrawingML，真正可编辑的原生 PPTX）。
v0.2 · huashu-design（Node + Playwright + ffmpeg）：
- viz-deck 模式 2-4（prototype / slide-deck / motion-stage）使用 MP4/PPTX 导出、设备外壳、动画引擎、20 哲学、5 维评审
- biz-decision-stack 只用其 5 维评审标准（决策报告坚持零动效，不引入 motion/BGM/设备外壳）
- viz-charts motion 模式直接调用
render-video.js
v0.3 · ppt-master（Python + python-pptx + svglib + edge-tts）：
- viz-deck 模式 5（pptx-deck）：JSON spec → SVG → 真 DrawingML PPTX，可嵌入 TTS 旁白
- biz-decision-stack：8 个决策 layout 的终端风可编辑 PPTX
- viz-charts：ECharts spec → 数据绑定的原生
<c:chart>对象
桥接都是软依赖：未安装时 v1 / v2 能力完全不受影响。两个上游均按各自的许可证发布（ppt-master MIT；huashu-design 个人免费，商用独立授权）——详见各自 LICENSE。
┌──────────────────────────┐ ┌────────────────────────────┐
│ huashu-design (v0.2) │ │ ppt-master (v0.3) │
│ - MP4 / 60fps / GIF │ │ - python-pptx │
│ - HTML→PPTX (text-only) │ │ - SVG→DrawingML (clickable)│
│ - 20 design philosophies │ │ - master/template inherit │
│ - 5-dim critique std │ │ - TTS narration embed │
│ - iOS/Android frames │ │ - native data-bound charts │
└────────────┬─────────────┘ └──────────────┬─────────────┘
│ │
┌─────────────┼──────────────┐ ┌──────────────┼─────────────┐
▼ ▼ ▼ ▼ ▼ ▼
┌─────────────┐ ┌──────────────┐ ┌──────────────────┐ ┌─────────────┐
│ viz-charts │ │ viz-deck │ │ biz-decision- │ │ shared │
│ (motion + │ │ (modes 2-4 + │ │ stack │ │ install │
│ pptx chart)│ │ mode 5) │ │ (critique+pptx) │ │ │
└─────────────┘ └──────────────┘ └──────────────────┘ └─────────────┘
git clone --depth=1 https://github.com/ZimaBlueAI/skills.git
cd skills
python packaging/build.py # 从 skills/ 单源生成 dist/claude/ 与 dist/codex/
bash packaging/install.sh # 自动探测 ~/.claude / ~/.codex 并装进去安装器的常用开关：
bash packaging/install.sh --harness claude # 只装 Claude Code
bash packaging/install.sh --harness both # 两个都装
bash packaging/install.sh --skill viz-deck # 只装一个包
bash packaging/install.sh --project /path/to/repo # 装到项目而非 $HOME
bash packaging/install.sh --dry-run # 只打印，不动手Windows 用 .\packaging\install.ps1，参数同名（-Harness / -Skill / -Project / -DryRun）。
不想跑脚本就手解：unzip -o dist/claude/viz-deck.zip -d ~/（或解到项目根，与 .git 同级）。
dist/是产物，由skills/生成。要改内容请改skills/<name>/再重跑 build， 不要直接改dist/里的东西——下次构建会被覆盖。
详细的项目级 vs 全局、桥接安装等见 docs/install-guide.md；
Codex 侧的补充说明见 docs/install-guide-codex.md。
git clone --depth=1 https://github.com/alchaincyf/huashu-design.git ~/.claude/skills/huashu-design
cd ~/.claude/skills/huashu-design
# Node 运行时（playwright + sharp + pptxgenjs + pdf-lib）
cat > package.json <<'JSON'
{
"name": "huashu-design-runtime",
"version": "1.0.0",
"private": true,
"dependencies": {
"playwright": "^1.48.0",
"sharp": "^0.33.5",
"pptxgenjs": "^3.12.0",
"pdf-lib": "^1.17.1"
}
}
JSON
npm install && npx playwright install chromium
# ffmpeg 必须在 PATH（用于 MP4 编码与 60fps 插帧）
ffmpeg -version || echo "请先安装 ffmpeg"git clone --depth=1 https://github.com/hugohe3/ppt-master.git ~/.claude/skills/ppt-master
cd ~/.claude/skills/ppt-master
# 隔离的 Python 3.10+ venv，避免污染系统 Python
python -m venv .venv
# Windows
.venv/Scripts/pip install python-pptx edge-tts svglib reportlab Pillow numpy
# macOS/Linux
# .venv/bin/pip install python-pptx edge-tts svglib reportlab Pillow numpy
# 验证
.venv/Scripts/python -c "import pptx, edge_tts; print('ok')" # Windows
# .venv/bin/python -c "import pptx, edge_tts; print('ok')" # macOS/Linux两个桥接都不装也行——v1 能力（HTML 报告 / 静态图表 / 决策链）完全不受影响。装了 huashu 解锁 v2（4 模产出 / 20 哲学 / 5 维评审 / MP4），再装 ppt-master 解锁 v3（每个元素可点的原生 DrawingML PPTX / TTS 旁白 / 母版继承 / 数据绑定图表）。
> /skills
应能看到 biz-html-viz · viz-deck · viz-charts 三项。装了 huashu 多一项 huashu-design；装了 ppt-master 不会单独显示（作为 skill 内部 runtime 调用）。
| 你说 | 自动路由到 |
|---|---|
| "给瑞林做一份董事会简报" | 01-board-advisor + biz-html-viz · board-brief |
| "走一遍全流程" / "all hands" | 00-all-hands-orchestrator（按顺序跑 6 个角色 + 评审） |
| "给 Mingjing 做阶段报告 deck" | viz-deck · stage-report（模式 1） |
| "做个 iOS 高保真原型" | viz-deck · prototype（模式 2） |
| "做个演讲幻灯片" + "导出 PPTX" | viz-deck · slide-mode（模式 3） + huashu export_deck_pptx.mjs |
| "做成 MP4" / "60fps 视频" / "解说视频" | viz-deck · motion-mode（模式 4） + huashu render-video.js |
| "做个真正可编辑的 PPT" / "PowerPoint 里能改的" | viz-deck · pptx-deck（模式 5） + ppt-master（v3 新增） |
| "决策报告做成 PPT" | biz-html-viz + ppt-master 终端风 PPTX（v3 新增） |
| "图表数据要能在 PPT 里改" | viz-charts + ppt-master 原生 chart（v3 新增） |
| "评一下这份" / "5 维评审" | 07-design-critic 或 viz-deck · review-5dim.mjs |
| "做个架构图" / "加张折线图" | viz-charts（按数据形态自动选 Mermaid/ECharts） |
| "项目代码 3D KG" | viz-charts · code-kg.mjs + templates/kg3d/code-graph.html |
每个 skill 的 samples/ 目录都提供了真实可视化产出——直接打开就能看。完整清单在每个 skill 的 samples/SAMPLES.md，下表是亮点：
| 类别 | 样例 | 一句话 |
|---|---|---|
| biz-decision-stack · 4 个决策 PPTX | decision-board-brief-sample.pptx · decision-retro-report-sample.pptx · decision-tech-roadmap-sample.pptx · decision-sprint-dev-sample.pptx |
终端风可编辑：董事会简报 · 季度复盘 · 四季度技术路线 · 周冲刺。每片含 15-55 个独立可点 shape。详见 SAMPLES.md |
| viz-deck · 3 个 deck（模式 5） | editable-deck-sample.pptx · product-launch-deck-sample.pptx · all-layouts-showcase-sample.pptx |
深空风董事会更新（9 页）· deck-light 风产品发布（10 页）· 8 个 layout 全展示（8 页）。详见 SAMPLES.md |
| viz-charts · 4 个原生数据图表 | native-chart-sample.pptx · chart-trend-line-sample.pptx · chart-market-share-doughnut-sample.pptx · chart-critique-radar-sample.pptx |
column · line · doughnut · radar 四种。PowerPoint 里右键 "Edit Data" 即可改底层数据。详见 SAMPLES.md |
| Skill | 样例 | 看什么 |
|---|---|---|
| biz-decision-stack | design-critique-sample.html |
终端风 5 维评审 · ECharts 雷达 · Keep/Fix/Quick-Wins |
| viz-deck | motion-stage-sample.html + .mp4 |
讲演风 motion stage 源 HTML + 1920×1080 录屏 |
| viz-deck | design-critique-sample.html |
讲演风 5 维评审（深空配色） |
| viz-charts | trend-motion-sample.html + .mp4 |
ECharts 多 series reveal 动效 + 录屏 |
| viz-charts | demo-3d-code-kg.html · demo-3d-doc-kg.html |
3D 代码/文档知识图谱（80/92 节点，可交互） |
| viz-charts | demo-terminal.html · demo-deck.html |
双主题全组件演示 |
不是单个 HTML，是输出契约的四件套实例——照着这四个文件，就知道一份合格交付长什么样：
| 文件 | 看什么 |
|---|---|
2026-07-27-zima-html-ppt-v2-deck.html |
双击就能讲的 14 页暖纸编辑风 deck（23 分钟配额）。按 S 弹演讲者提词器，F 全屏。5 种版式全用上，11/12 种块型（html 逃生口刻意不用）。第 10 页两根条形——上面停在 0、下面填满——讲的正是本次修好的那个 bug，动效本身就是论据 |
zima-html-ppt-v2-deck-plan.md |
方案稿：意图卡 · 三方向选择 · 逐页计划（含视觉所有者列）· 素材来源 · 三项仍未验的 missing evidence |
zima-html-ppt-v2.deck.json |
文档源。改这里再 build，不碰 HTML |
reports/deck-validation.json |
闸门报告：零 error 零 warning，五道机器闸门全 pass |
样例现在只有一份：
skills/<name>/samples/（zima-html-ppt 为examples/），两个 harness 的包都从这里打进去。
- 思考方式与产出能力解耦 subagent 决定"以什么身份思考"，skill 决定"用什么形态产出"。换 harness 时各自迁移，不互相绑死。
- HTML 优先于 Markdown 决策类产出（董事会简报、CEO 决策、复盘）走 HTML——结构化稳定、可签字、可归档、可打印。Markdown 只用于日志/注解。
- 视觉系统先行
每个 skill 在动手前先定 design system（配色 / 字体 / 间距 / 禁令清单）。
references/design-system*.md是权威定义，templates 只是落地。 - 少而精 biz-decision-stack 的 8 份报告共用 1 个 HTML 渲染 skill，不是 8 个独立 skill。一个 skill 干一件事，复用最大化。
- 声明式 > 命令式 skill 是 Markdown 描述 + 模板 + 可选脚本，不是一堆代码。harness 怎么调用，由 harness 自己决定。
- 可移植性是头等公民 skill 的核心 prompt 必须能不重写就迁移到至少 3 个 harness（Claude Code / Codex / OpenClaw）。
- 桥接 > 嵌入 v0.2 起，所有跨技术栈的资产（视频/音频/外壳）走软依赖桥接而非嵌入自己。版本不漂移、许可证不交叉、包体不膨胀。
skills/ ← 仓库根
├── biz-html-viz/ ★ 决策链 8 模板 + 决策 PPTX（配 9 个 subagent）
├── viz-deck/ ★ 五模产出 + design-system-deck.md + research-playbook.md
├── viz-charts/ ★ 七类视觉表达 + 4 个 demo-*.html 演示页
├── zima-html-ppt/ ★ 现场讲演 deck + 七道闸门 + examples/ 示范交付
├── zima-design/ ★ 设计合奏引擎（三引擎收编 + 五轴多样性协议）
├── gzh-design/ ★ 微信公众号排版
├── produce-cinematic-video/ ★ 可恢复影视生产技能（7 个专业工位 + 安全闸门）
├── web-shader-extractor/ ★ 网页着色器动效抠取与复现
│ 每个 skill 内部：SKILL.md · references/ · templates/ · scripts/ · samples/
│ 带顶层 SKILL.md 的根目录 = 一个 skill，build 时自动发现
│
├── packaging/ 打包与安装（harness 差异只存在于此）
│ ├── build.py 根下 skill → dist/claude/*.zip + dist/codex/*.zip
│ ├── harness.toml 安装根目录映射 + Codex 侧 description 变体
│ ├── agents/claude-md/ 9 个 subagent（Claude Code 的 .md 格式）
│ ├── agents/codex-toml/ 9 个 subagent（Codex CLI 的 .toml 格式）
│ └── install.sh / install.ps1 双 harness 安装器
│
├── dist/ 生成物，不要手改
│ ├── claude/*.zip 解到 ~/ → .claude/skills/ + .claude/agents/
│ └── codex/*.zip 解到 ~/ → .codex/skills/ + .codex/agents/
│
├── docs/ install-guide.md · install-guide-codex.md · codex-notes.md
├── LICENSE · NOTICE · README.md · README_en.md · CHANGELOG.md · CONTRIBUTING.md
└── _trash/ 归档区（历史目录移入，不硬删）
改一处，两边都对。 过去
claude-code-skills/与codex-skills/两套目录各自演化， 结果是三个 skill 的源码只存在于 claude 侧的 zip 里（读不到、diff 不了）， 而gzh-design/produce-cinematic-video已经悄悄分叉。现在每个 skill 只有一份源。
| 角色 | 用哪个组合 | 为什么 |
|---|---|---|
| 创业团队 CEO | biz-decision-stack 全套 + viz-deck (stage-report) + ppt-master | 内部决策链 HTML + 对外讲演 deck + 给董事会的可编辑 PPT |
| 产品经理 | biz-decision-stack (PM 双模) + viz-deck (prototype) + viz-deck (pptx-deck) | MRD 文档化 + 高保真原型给开发 + PRD 评审 PPT 给业务方 |
| 首席架构师 | biz-decision-stack (architect) + viz-deck (architecture-deep) + viz-charts | 内部 ADR + 客户技术方案 + 3D 代码 KG |
| 投资人 / FA | viz-deck (competitive-landscape) + viz-charts + viz-charts (native chart pptx) | 竞品调研可视化 + 数据动效路演 + LP 月报数据 PPT |
| 设计 / 品牌方 | viz-deck (5 模产出) + huashu-design + ppt-master | 一套工具覆盖原型 / 幻灯 / 视频 / 评审 / 可交付 PPT |
| 工程 lead | biz-decision-stack (dev-test) + viz-charts (3D KG) | 状态汇报 + 项目结构可视化 |
| 内训讲师 / 布道师 | zima-html-ppt + viz-charts | 上台讲的单文件 HTML deck，按 S 有提词器和逐字稿；课件要按班次改，走 deck.json 反解，不用重读 HTML |
| 导演 / 剪辑 / 内容团队 | produce-cinematic-video | 从同题研究、剧本和分镜到生成、声音、QC 与评估；工程可恢复，远程上传和费用有明确批准边界 |
| 阶段 | 内容 | 状态 |
|---|---|---|
| v0.1 | claude-code-skills 三件套首发 | ✅ 已发布 |
| v0.2 | 4 模产出 · 20 哲学 · 5 维评审 · huashu-design 桥接 · samples | ✅ 已发布 |
| v0.3 | ppt-master 软桥接 · viz-deck 模式 5 pptx-deck · 决策 PPTX · 数据绑定原生 chart · TTS 旁白嵌入 · codex-skills 双 harness 首发 | ✅ 已发布 |
| v0.4 | 26-skill 取长补短 · Speaker Mode · 三变体预览 · Doc→Deck · 学术模板 · Bento Grid · Reflective Loop · Template Router | ✅ 已发布 |
| v0.5 | OpenClaw / Hermes 频道交付层 · viz-channel |
⛔ 已移除（两个 harness 可直接装本仓库的包，薄桥接属重复维护） |
| v0.6 | taste-engine 口味层（三档 dial + 反 slop + 选材/文案）· viz-charts 交互 SVG 环形/Circos 知识图谱 · zima-html-ppt 现场讲演 deck（暖纸编辑风 + 演讲者模式） |
✅ 已发布 |
| v0.7 | zima-design 设计合奏引擎（三引擎收编 + 五轴多样性协议）· 全线生成类 skills 内联反 AI slop 硬闸 |
✅ 已发布（当前） |
| Unreleased | produce-cinematic-video 发布净化与可恢复影视全流程（用户级 .env.local + TUI · 图像/视频/TTS/音源分离 · 看板/历史版本 · 权利/费用/隐私闸门）· zima-html-ppt v2 工程治理层 · 双 harness 单一源构建 · 频道交付层下线 |
🟢 已合入 main，待发版 |
| v0.8 | viz-charts narrative chart explainer（TTS 解说图表视频）+ 频道适配器扩展（企业微信 / Slack / Telegram） | 🟡 规划中 |
| v0.9 | octarus-skills 移植 + 三 harness 一致性测试 | ⚪ 规划中 |
| v1.0 | 5 harness 全覆盖 + skill registry（skills.json 索引） |
⚪ 规划中 |
欢迎 issue 与 PR。在动手之前请先读 CONTRIBUTING.md。
特别欢迎以下贡献：
- 新 harness 移植：给
packaging/harness.toml加一个 harness 条目即可，skill 源不用动 - 新 skill 提案：先开 issue 讨论范围，符合"声明式 / 可移植 / 少而精"再实现
- 更多视觉 reference：超出现有 design-system 之外的真实业务样本
- 样例丰富化：为现有 skill 提供更多行业语境的 samples（医疗 / 金融 / 教育 / 政务）
本项目以 Apache License 2.0 发布。Copyright © 2026 ZimaBlueAI。
站在巨人肩膀上。以下项目以理念、运行时或工具链的方式让本仓库成为可能：
理念与方法论
- garrytan/gstack — 多角色编排思路
- Lum1104/Understand-Anything — 知识图谱式可视化
- Thariq 关于 HTML for Claude Code 的早期论述 — 决策类内容 HTML 优先
v2 桥接依赖（动画 / 视频 / 设计哲学 / 评审）
- alchaincyf/huashu-design — 视频/快速 PPTX 导出工具链、20 设计哲学、5 维评审标准
v3 桥接依赖（真正可编辑 PPTX / TTS 旁白 / 母版继承 / 数据绑定图表）
- hugohe3/ppt-master — MIT · python-pptx + SVG→DrawingML 管线、edge-tts 旁白、母版导入、原生 chart 渲染
运行时（CDN 或 npm/pip 加载，不打包进本仓库）
- Node 侧：Mermaid · Apache ECharts · three.js · 3d-force-graph · Playwright · ffmpeg · pptxgenjs · pdf-lib
- Python 侧（v3 新增）：python-pptx · edge-tts · svglib · reportlab · Pillow · NumPy
各项目保留其上游许可证，详见 NOTICE。
- GitHub: https://github.com/ZimaBlueAI/skills
- Issues: https://github.com/ZimaBlueAI/skills/issues
- 安全问题: 见 CONTRIBUTING.md
Made by ZimaBlueAI · 2026