@topmindspace/tms-skills 0.1.7 → 0.1.9

package/CHANGELOG.md

@@ -1,3 +1,33 @@
+## 0.1.9 — 2026-09-26
+
+### Docs · banner · theme overview · live showcase
+
+- **主题总览大图**：根 README + `top-ppt-html/README.md` 嵌入三张 Gate 0 `theme-overview*.png`（演示 / 研究 / 架构），保留风格封面与 showcase 样张画廊。
+- **Slim banner**：`docs/assets/tms-skills-banner.png` 裁为 **1280×360**；README 展示宽约 960。
+- **Badge 行**：对齐 topmind 风格（Release / npm / CI / License）。
+- **Live 链接**：指向 `https://topmindspace.github.io/tms-skills/`（落地页 / showcase.html / style-gallery.html）。
+- **Pages 源**：`docs/index.html` + `docs/showcase.html` + `docs/style-gallery.html` + `docs/site-assets/`（启用 GitHub Pages → Deploy from branch `main` / `/docs` 即可上线同路径 URL）。
+- 模板 / runtime：经 `sync_runtime.py` 校验，无「甲板」；`REPORT_MODEL` 与引擎 SHA 一致。
+- 版本对齐 **0.1.9**（根 + 技能 package/lock / SKILL metadata / README / PUBLISHING）。
+
+### 红线未动
+反截断、图表多样性地板、Mode A craft、runtime SHA 同版本门禁、中文「演示文稿」术语、整仓 npm 发版。
+
+## 0.1.8 — 2026-09-26
+
+### Showcase · docs · release polish
+
+- **产品 Showcase**：新增 Mode A 样张 `top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html`（+ model）——介绍 TopMind / tms-skills / top-ppt-html（三模式·风格主题·质量门禁·Fast Mode）；`validate_report --strict` 与 `smoke_pptx` **0/0**。
+- **截图**：刷新 `theme-overview*.png`；新增 `docs/showcase/`（showcase 全页 + 三黄金样张关键页）与精简 `top-ppt-html/assets/showcase/`（进技能包，供 README）。
+- **README 吸引力**：根 README + 技能 README 增加 banner、风格/模式画廊、showcase 链接与安装钉版本 **0.1.8**。
+- **Banner**：`docs/assets/tms-skills-banner.png`。
+- **打包**：`package_skill` 纳入 `assets/showcase/*`；examples 最小数量仍 ≥3（黄金样张 + 可选 showcase）。
+- **文档清理**：用户向 README 对齐当前产品面；PUBLISHING 版本线 → 0.1.8；`build_examples` 说明允许 showcase 并存。
+- 版本对齐 **0.1.8**（根 + 技能 package/lock / SKILL metadata / README）。
+
+### 红线未动
+反截断、图表多样性地板、Mode A craft、runtime SHA 同版本门禁、中文「演示文稿」术语、整仓 npm 发版。
+
 ## 0.1.7 — 2026-09-26
 
 ### top-ppt-html · defect opt (D8/D9/D11/D13)

package/README.md

@@ -1,117 +1,124 @@
 # tms-skills
 
-**TopMindspace 智能体技能 monorepo** — 可安装的智能体技能集合，当前包含 **top-ppt-html**（优雅、大气、正式场合演讲/汇报演示文稿）。
+[![Release](https://img.shields.io/github/v/release/topmindspace/tms-skills?style=flat-square&color=blue)](https://github.com/topmindspace/tms-skills/releases)
+[![npm](https://img.shields.io/npm/v/@topmindspace/tms-skills?style=flat-square)](https://www.npmjs.com/package/@topmindspace/tms-skills)
+[![CI](https://img.shields.io/github/actions/workflow/status/topmindspace/tms-skills/ci.yml?style=flat-square&label=CI)](https://github.com/topmindspace/tms-skills/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=flat-square)](LICENSE)
 
-让 idea 飞，好想法被看见。
+**TopMindspace 智能体技能 monorepo** — 把好想法做成可上台的交付。
 
-## 技能一览
-
-| 技能 | 版本 | 做什么 |
-|------|------|--------|
-| [`top-ppt-html`](./top-ppt-html/) | 0.1.7 | 优雅大气的正式场合演讲/汇报演示文稿：单文件 HTML + 版式保真可编辑 16:9 PPTX |
+当前主技能 **[top-ppt-html](./top-ppt-html/)**：优雅、大气的正式场合**演示文稿**（单文件 HTML + 版式保真可编辑 PPTX）。
 
-安装器包 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 亦为 **0.1.7**（整仓发版：安装器与当前技能同 tag；未来多技能仍可各自演进，默认随仓库 release）。
+> 让 idea 飞，好想法被看见。
 
-更多技能以仓库根目录下的技能目录加入（每个目录含 `SKILL.md`）。
+<p align="center">
+  <img src="docs/assets/tms-skills-banner.png" alt="tms-skills — TopMindspace agent skills" width="960" />
+</p>
 
-## 安装
+> **警告**：不要安装 `@topmindspace/tms-skills@^2`（2.0.0–2.1.1 已弃用）。当前线 **0.1.x**（`latest`）。
 
-两条通道，装出来同一套技能。**npm = 钉版本快照**；**GitHub = 跟仓库 HEAD**。
+## 一眼看到工艺
 
+### 主题总览（Gate 0）
 
-> **警告 / Warning**：不要安装 `@topmindspace/tms-skills@^2`。npm 上的 **2.0.0–2.1.1** 已弃用（仓库重置前的过时线）；当前线是 **0.1.x**（`latest` 指向 0.1.x）。请安装 `@topmindspace/tms-skills@0.1.x`。
->
-> Do **not** install `^2`. Versions **2.0.0–2.1.1 are deprecated**; use **0.1.x** (`latest` tracks 0.1.x).
+<p align="center">
+  <img src="top-ppt-html/assets/theme-overview.png" alt="演示模式 · business-blue 主题总览" width="900" /><br/>
+  <sub>演示 · business-blue</sub>
+</p>
 
+<p align="center">
+  <img src="top-ppt-html/assets/theme-overview-research.png" alt="研究模式 · mckinsey 主题总览" width="900" /><br/>
+  <sub>研究 · mckinsey</sub>
+</p>
 
-### npm（推荐）
+<p align="center">
+  <img src="top-ppt-html/assets/theme-overview-architecture.png" alt="架构模式 · graphite-dark 主题总览" width="900" /><br/>
+  <sub>架构 · graphite-dark</sub>
+</p>
 
-```bash
-npx @topmindspace/tms-skills list
-npx @topmindspace/tms-skills install top-ppt-html
-npx @topmindspace/tms-skills install top-ppt-html --to ./.claude/skills
-npx @topmindspace/tms-skills@0.1.7 install top-ppt-html   # 钉版本
-```
+### 风格封面
 
-### GitHub 直装
+| 演示 · business-blue | 研究 · mckinsey | 架构 · graphite-dark |
+|:---:|:---:|:---:|
+| ![bizblue](docs/showcase/presentation-business-blue/bizblue-cover.png) | ![mckinsey](docs/showcase/research-mckinsey/mckinsey-cover.png) | ![graphite](docs/showcase/architecture-graphite-dark/graphite-cover.png) |
 
-```bash
-npx github:topmindspace/tms-skills install top-ppt-html
+### 产品 Showcase 样张（Mode A · ~10 页）
 
-git clone https://github.com/topmindspace/tms-skills.git
-node tms-skills/bin/tms-skills.js install top-ppt-html
-```
+| Cover | 三模式 | 质量门禁 |
+|:---:|:---:|:---:|
+| ![cover](docs/showcase/topmind-showcase/showcase-cover.png) | ![modes](docs/showcase/topmind-showcase/showcase-s4.png) | ![gates](docs/showcase/topmind-showcase/showcase-s6.png) |
 
-### 手工
+**在线体验**
 
-解压 GitHub Release 的 `top-ppt-html.zip` 到技能目录。
+- 落地页：[topmindspace.github.io/tms-skills/](https://topmindspace.github.io/tms-skills/)
+- 完整演示文稿：[showcase.html](https://topmindspace.github.io/tms-skills/showcase.html)
+- 风格画廊：[style-gallery.html](https://topmindspace.github.io/tms-skills/style-gallery.html)
+- 仓库内交互画廊：[top-ppt-html/assets/style-gallery.html](./top-ppt-html/assets/style-gallery.html)
+- 仓库内 Showcase HTML：[top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html](./top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html)
+- 更多截图：[docs/showcase/](./docs/showcase/)
 
-安装器把根目录下的技能目录 `<id>/`（含 `SKILL.md`）复制到目标目录；智能体通过 frontmatter（`name` + `description`）发现技能。
+## 技能一览
 
-默认探测顺序（`resolveDefaultTarget`）：项目级 `./.agents` → `./.claude` → `./.cursor` → `./.codex` → `./.mimocode`；再用户级 `~/.claude` → `~/.agents` → `~/.cursor` → `~/.codex`；都没有则落 `./.agents/skills`。也可用 `--to` 显式指定。
+| 技能 | 版本 | 做什么 |
+|------|------|--------|
+| [`top-ppt-html`](./top-ppt-html/) | **0.1.9** | 正式场合演讲/汇报演示文稿：HTML 可翻页 + 16:9 可编辑 PPTX；三模式 × 九风格；strict 0/0 门禁 |
 
-| 宿主 | 项目级 | 用户级 |
-|------|--------|--------|
-| 通用 / Codex | `.agents/skills` | `~/.agents/skills` |
-| Claude Code | `.claude/skills` | `~/.claude/skills` |
-| Cursor | `.cursor/skills`（兼读 `.agents`） | `~/.cursor/skills` |
-| Codex 兼容 | `.codex/skills` | `~/.codex/skills` |
-| 本仓库另含 | `.mimocode/skills` | — |
+安装器 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 同为 **0.1.9**（整仓同 tag 发版）。
 
-> **排错**：不要 `npm install <skill-id>`（技能 id 不是独立 npm 包）。「找不到包」→ 换 GitHub 直装，或 `--registry https://registry.npmjs.org/`。
+## 安装
 
-### 可选依赖（仅 PPTX 精导）
+**npm = 钉版本快照**；**GitHub = 跟仓库 HEAD**。
 
-HTML 生成零第三方依赖（Python 标准库）。PPTX 导出需要 Node + pptxgenjs：
+```bash
+npx @topmindspace/tms-skills list
+npx @topmindspace/tms-skills install top-ppt-html
+npx @topmindspace/tms-skills install top-ppt-html --to ./.claude/skills
+npx @topmindspace/tms-skills@0.1.9 install top-ppt-html   # 钉版本
+```
 
 ```bash
-cd <install-dir>/top-ppt-html
-npm install
+# 跟 HEAD
+npx github:topmindspace/tms-skills install top-ppt-html
 ```
 
+默认探测：`./.agents` → `./.claude` → `./.cursor` → `./.codex` → `./.mimocode`，再用户级 `~/.claude` 等；也可用 `--to`。不要 `npm install top-ppt-html`（技能 id 不是独立包）。
+
+PPTX 精导需在技能目录 `npm install`（pptxgenjs）。HTML 生成仅 Python 标准库。
+
+## 黄金样张
+
+| 模式 | 文件 |
+|------|------|
+| A 演示 | [`2026-09-09-presentation-business-blue`](./top-ppt-html/assets/examples/2026-09-09-presentation-business-blue.html) |
+| B 研究 | [`2026-09-09-research-mckinsey`](./top-ppt-html/assets/examples/2026-09-09-research-mckinsey.html) |
+| C 架构 | [`2026-09-09-architecture-graphite-dark`](./top-ppt-html/assets/examples/2026-09-09-architecture-graphite-dark.html) |
+| 产品 Showcase | [`2026-09-26-topmind-tms-skills-showcase`](./top-ppt-html/assets/examples/2026-09-26-topmind-tms-skills-showcase.html) |
+
 ## 仓库结构
 
 ```
 tms-skills/
-├─ top-ppt-html/             # 技能（SKILL.md + assets + references + scripts + evals）
+├─ top-ppt-html/             # 技能（SKILL.md + assets + references + scripts）
 ├─ bin/tms-skills.js         # CLI：list / install
-├─ docs/                     # 发布规范 · CI/Release 说明（ci.md）
-├─ scripts/                  # 仓库级工具（隐私扫描）
-├─ .github/workflows/        # CI + Release
+├─ docs/                     # 发布规范 · showcase 截图 · banner
+├─ scripts/                  # 仓库级门禁 / 隐私扫描
 ├─ package.json              # @topmindspace/tms-skills
-├─ LICENSE · CHANGELOG.md · README.md
+└─ LICENSE · CHANGELOG.md · README.md
 ```
 
-## 发布与同步
+## 发布与 CI
 
 | 动作 | GitHub | npm |
 |------|:------:|:---:|
-| push 到 main | 立即可见 | **不变** |
+| push main | 立即可见 | **不变** |
 | tag `vX.Y.Z` | Release + zip | **自动 publish** |
 
-- **push 不会更新 npm**；必须 bump 版本并打 tag。
-- **Release 只保留最近 2 个**（CI 只删旧 Release，**git tags 保留**）；npm 可钉任意历史版本。
-- 安装器与技能 **版本各自独立**；默认 patch/minor，major 仅破坏性变更。
-
-详见 [docs/PUBLISHING.md](./docs/PUBLISHING.md)。
-
-## CI
-
-| 工作流 | 触发 | 做什么 |
-|--------|------|--------|
-| `ci.yml` | push / PR | 打包门禁、审计、隐私扫描、CLI 冒烟 |
-| `release.yml` | tag `v*` | 门禁 → zip → Release → npm publish（已存在则跳过）→ prune Release 留 2（tags 保留） |
-
 ```bash
 npm run check && npm run audit && npm run privacy
+# PPTX 冒烟（含 McKinsey）：bash scripts/ci_skill_gates.sh --with-pptx
 ```
 
-## 开发新技能
-
-1. 根目录建 `<skill-id>/`，`SKILL.md` 的 `name` 与目录一致。
-2. 人类说明写 `README.md`；智能体入口保持 `SKILL.md`。
-3. 发布前 `scripts/package_skill.py --check`。
-4. 登记：根 README、`npm run sync:files`、`CHANGELOG.md`（CI 按发现的技能跑门禁，无需再硬编码）。
+详见 [docs/PUBLISHING.md](./docs/PUBLISHING.md) · [docs/ci.md](./docs/ci.md)。
 
 ## 许可证
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topmindspace/tms-skills",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "TopMindspace 智能体技能 monorepo — 通过 npm / GitHub npx 安装技能（top-ppt-html：优雅大气正式场合演讲/汇报演示文稿等）。",
   "license": "MIT",
   "author": "TopMindspace",

package/top-ppt-html/README.md

@@ -1,14 +1,55 @@
 # TopPPT HTML
 
+[![Release](https://img.shields.io/github/v/release/topmindspace/tms-skills?style=flat-square&color=blue)](https://github.com/topmindspace/tms-skills/releases)
+[![npm](https://img.shields.io/npm/v/@topmindspace/tms-skills?style=flat-square)](https://www.npmjs.com/package/@topmindspace/tms-skills)
+[![CI](https://img.shields.io/github/actions/workflow/status/topmindspace/tms-skills/ci.yml?style=flat-square&label=CI)](https://github.com/topmindspace/tms-skills/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=flat-square)](../LICENSE)
+
 **让 idea 飞，好想法被看见。** 面向**演讲与正式场合**的高品质演示文稿技能：把主张、调研、分析、架构方案，生成为**优雅、美观、大气**的可翻页 HTML + **版式保真可编辑 PPTX**。核心工艺是版式、排版、色彩与内容组织——克制图标/图表配文，而非 gadget 堆砌或咨询 dump 默认。
 
-- 技能标识：`top-ppt-html`（安装/打包目录名与此一致）；品牌名：**TopPPT HTML**
-- 版本：**v0.1.7**（与 `@topmindspace/tms-skills@0.1.7` 同 tag）
+<p align="center">
+  <img src="assets/showcase/showcase-cover.png" alt="TopMind × tms-skills showcase cover" width="720" />
+</p>
+
+- 技能标识：`top-ppt-html`；品牌名：**TopPPT HTML**
+- 版本：**v0.1.9**（与 `@topmindspace/tms-skills@0.1.9` 同 tag）
 - **智能体入口**：`SKILL.md` → `references/playbook.md`（L1）→ L2 按需
 - **人类维护者**：本 README（安装 / 命令 / 目录）；勿把本文件当生成规范
 
-## 一、技能简介（人类速览）
+### 主题总览（Gate 0）
+
+<p align="center">
+  <img src="assets/theme-overview.png" alt="演示模式 · business-blue 主题总览" width="860" /><br/>
+  <sub>演示 · business-blue</sub>
+</p>
+
+<p align="center">
+  <img src="assets/theme-overview-research.png" alt="研究模式 · mckinsey 主题总览" width="860" /><br/>
+  <sub>研究 · mckinsey</sub>
+</p>
+
+<p align="center">
+  <img src="assets/theme-overview-architecture.png" alt="架构模式 · graphite-dark 主题总览" width="860" /><br/>
+  <sub>架构 · graphite-dark</sub>
+</p>
 
+### 风格 × 模式一览
+
+| business-blue · 演示 | mckinsey · 研究 | graphite-dark · 架构 |
+|:---:|:---:|:---:|
+| ![bb](assets/showcase/style-business-blue-cover.png) | ![mk](assets/showcase/style-mckinsey-cover.png) | ![gr](assets/showcase/style-graphite-cover.png) |
+
+| Showcase · HTML+PPTX | 三模式 | 质量门禁 |
+|:---:|:---:|:---:|
+| ![sp](assets/showcase/showcase-split.png) | ![md](assets/showcase/showcase-modes.png) | ![gt](assets/showcase/showcase-gates.png) |
+
+**在线体验** · [落地页](https://topmindspace.github.io/tms-skills/) · [Showcase 演示文稿](https://topmindspace.github.io/tms-skills/showcase.html) · [风格画廊](https://topmindspace.github.io/tms-skills/style-gallery.html)
+
+- 交互画廊（仓库内）：[`assets/style-gallery.html`](./assets/style-gallery.html)
+- 产品 Showcase（仓库内）：[`assets/examples/2026-09-26-topmind-tms-skills-showcase.html`](./assets/examples/2026-09-26-topmind-tms-skills-showcase.html)（Mode A · business-blue · ~10 页）
+- 仓库级大图集：[`docs/showcase/`](../docs/showcase/)（不进技能 zip）
+
+## 一、技能简介（人类速览）
 | 维度 | 能力 |
 |------|------|
 | 产出 | 单文件 HTML（可翻页、亮暗双主题、header 工具栏）+ 16:9 可编辑 PPTX（精导通道） |
@@ -94,10 +135,11 @@ top-ppt-html/
 ├─ assets/                      #                                           │ 且
 │  ├─ templates/                #   三份模式模板（presentation/research/architecture）  │ 入库
 │  │                            #   + engine.css / ui.js（公共引擎/UI，sync_runtime 注入源）
-│  ├─ examples/                 #   3 份黄金样张 + model（每模式 1；风格见 style-gallery）      │
+│  ├─ examples/                 #   3 黄金样张 + showcase（HTML+model）                          │
 │  ├─ pptx-export.js            #   PPTX 预览运行时（含常量/schema 注入块）   │
 │  ├─ style-gallery.html        #   风格 × 模式 × 亮暗主题交互画廊            │
-│  └─ theme-overview*.png       #   3 张主题参考图（整体=演示 / 研究 / 架构）  │
+│  ├─ theme-overview*.png       #   3 张主题参考图（整体=演示 / 研究 / 架构）  │
+│  └─ showcase/                 #   README 用精简截图（完整集见 docs/showcase） │
 ├─ references/                  # 规范（L1 常读 1 篇 + L2 按需；components/charts 已按族拆分）│  ├─ playbook.md               #   ★ L1 唯一常读入口：模式/页型/组合/图表/配色/校验 │
 │  ├─ components.md             #   逻辑索引（§ 路由到下列物理文件）              │
 │  ├─ components-atoms.md       #   §1–§15c 结构组件                              │
@@ -167,7 +209,7 @@ python scripts/check_triggers.py
 | `references/chart-decision-tree.md` | L2 图表决策树 + 七种误用 |
 | `references/default-surface.md` | Mode A L1.5：12 页型 + 核图 8 + V1–V4 |
 | `references/presentation-craft.md` | Mode A L1.5 工艺（反截断 / 大气正式） |
-| `assets/examples/` | 3 份黄金样张（每模式 1） |
+| `assets/examples/` | 3 份黄金样张（每模式 1）+ TopMind showcase |
 | `evals/trigger-queries.json` | description 触发正/负例；`check_triggers.py` |
 | `docs/archive/` | 历史规范 / 旧示例 |
 

package/top-ppt-html/SKILL.md

@@ -4,7 +4,7 @@ description: "Use when 用户要做报告、演示、汇报、PPT、slides、dec
 license: MIT
 compatibility: "Python 3 stdlib for HTML generation; Node >=18 + pptxgenjs for PPTX; optional playwright for browser regression / theme captures."
 metadata:
-  version: "0.1.7"
+  version: "0.1.9"
   author: TopMindspace
 ---
 # TopPPT HTML
@@ -121,7 +121,7 @@ metadata:
 
 ## 版本口径
 
-包 semver（现 0.1.7）≠ 布局 schema 线（layout-constants / model-schema 的 version，现 `0.1`）；patch 不抬 schema。
+包 semver（现 0.1.9）≠ 布局 schema 线（layout-constants / model-schema 的 version，现 `0.1`）；patch 不抬 schema。
 
 ## 环境依赖
 

package/top-ppt-html/agents/openai.yaml

@@ -1,5 +1,5 @@
 # Codex / ChatGPT Skills UI metadata (optional)
 display_name: "TopPPT HTML"
-short_description: "Elegant, atmospheric formal decks for speeches — HTML + editable 16:9 PPTX."
+short_description: "Elegant, atmospheric formal presentations for speeches — HTML + editable 16:9 PPTX."
 default_prompt: "Generate an elegant formal presentation or report as HTML (PPTX on request via B-channel)."
 allow_implicit_invocation: true