@topmindspace/tms-skills 0.1.2 → 0.1.3

package/CHANGELOG.md

@@ -1,4 +1,25 @@
-## Unreleased
+## 0.1.3 — 2026-09-24
+
+### top-ppt-html · QA close-out + docs
+
+- **P2-4 playbook 拆表**：意图→页型穷举 → `references/page-type-matrix.md`；图表决策表+七种误用 → `references/chart-decision-tree.md`。playbook 保留 Mode 契约 / V1–V4 / 组合 / **图表多样性摘要** / **反截断** / 路径·命令·L2 路由（体积 22KB→~17KB）。
+- **版本对齐**：根 README / 技能 README / PUBLISHING / `metadata.version` / 双 `package.json` → **0.1.3**（消除残留 0.1.0 横幅）。
+- **IMAGE_CAPTION**：配图页亦认 so-what/lead/figcaption；新增 WARN `IMAGE_NEAR_EMPTY`（近图过空）。
+- **P2-2/P2-3**：不引入 Claude-only `when_to_use`、不写跨端风险 `allowed-tools`（`skills-ref validate` 已通过开放标准字段；扩展字段留给宿主实验）。
+- **P2-5**：可选 `npx skills-ref@0.1.5 validate ./top-ppt-html`（不作为发布硬依赖；主门禁仍 `audit_skill`）。
+- **docs**：根 README 安装表/钉版本/`@0.1.3`；技能 README 改为人类维护指南并指向 SKILL；package REQUIRED + MIN refs ≥25。
+
+### Installer
+
+- `@topmindspace/tms-skills` → **0.1.3**（整仓同 tag）。
+
+### 此前 Unreleased（agent-compat，随 0.1.3 一并发布）
+
+- **P0-1 Trigger eval**：`evals/trigger-queries.json` + `scripts/check_triggers.py`；`package_skill.py --check` 门禁。
+- **P0-2 Mode A 读预算诚实**：L0+L1=2；Mode A/Fast 可加 L1.5（`default-surface` + `presentation-craft`）。
+- **P0-3 反过读**：禁止整读清单 + 强制 `extract_snippet.py`。
+- **P1 Frontmatter / 安装路径 / Fast 最小大纲 / 插画 brief**：license·compatibility·metadata；Cursor/Codex 路径；`illustration-layout.md`；`agents/openai.yaml`。
+
 
 ## 0.1.2 — 2026-09-24
 

package/README.md

@@ -8,9 +8,9 @@
 
 | 技能 | 版本 | 做什么 |
 |------|------|--------|
-| [`top-ppt-html`](./top-ppt-html/) | 0.1.0 | 报告 / 演示 / 信息架构图：单文件 HTML + 版式保真的可编辑 16:9 PPTX |
+| [`top-ppt-html`](./top-ppt-html/) | 0.1.3 | 报告 / 演示 / 信息架构图：单文件 HTML + 版式保真的可编辑 16:9 PPTX |
 
-安装器包 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 亦为 **0.1.0**（与技能版本各自独立演进）。
+安装器包 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 亦为 **0.1.3**（整仓发版：安装器与当前技能同 tag；未来多技能仍可各自演进，默认随仓库 release）。
 
 更多技能以仓库根目录下的技能目录加入（每个目录含 `SKILL.md`）。
 
@@ -30,7 +30,7 @@
 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.0 install top-ppt-html   # 钉版本
+npx @topmindspace/tms-skills@0.1.3 install top-ppt-html   # 钉版本
 ```
 
 ### GitHub 直装
@@ -48,6 +48,16 @@ node tms-skills/bin/tms-skills.js install top-ppt-html
 
 安装器把根目录下的技能目录 `<id>/`（含 `SKILL.md`）复制到目标目录；智能体通过 frontmatter（`name` + `description`）发现技能。
 
+默认探测顺序（`resolveDefaultTarget`）：项目级 `./.agents` → `./.claude` → `./.cursor` → `./.codex` → `./.mimocode`；再用户级 `~/.claude` → `~/.agents` → `~/.cursor` → `~/.codex`；都没有则落 `./.agents/skills`。也可用 `--to` 显式指定。
+
+| 宿主 | 项目级 | 用户级 |
+|------|--------|--------|
+| 通用 / Codex | `.agents/skills` | `~/.agents/skills` |
+| Claude Code | `.claude/skills` | `~/.claude/skills` |
+| Cursor | `.cursor/skills`（兼读 `.agents`） | `~/.cursor/skills` |
+| Codex 兼容 | `.codex/skills` | `~/.codex/skills` |
+| 本仓库另含 | `.mimocode/skills` | — |
+
 > **排错**：不要 `npm install <skill-id>`（技能 id 不是独立 npm 包）。「找不到包」→ 换 GitHub 直装，或 `--registry https://registry.npmjs.org/`。
 
 ### 可选依赖（仅 PPTX 精导）

package/bin/tms-skills.js

@@ -70,12 +70,17 @@ function readSkillMeta(skillId) {
 }
 
 function resolveDefaultTarget() {
+  const home = process.env.HOME || process.env.USERPROFILE || '';
   const candidates = [
     path.join(process.cwd(), '.agents', 'skills'),
     path.join(process.cwd(), '.claude', 'skills'),
+    path.join(process.cwd(), '.cursor', 'skills'),
+    path.join(process.cwd(), '.codex', 'skills'),
     path.join(process.cwd(), '.mimocode', 'skills'),
-    path.join(process.env.HOME || process.env.USERPROFILE || '', '.claude', 'skills'),
-    path.join(process.env.HOME || process.env.USERPROFILE || '', '.agents', 'skills'),
+    path.join(home, '.claude', 'skills'),
+    path.join(home, '.agents', 'skills'),
+    path.join(home, '.cursor', 'skills'),
+    path.join(home, '.codex', 'skills'),
   ];
   for (const dir of candidates) {
     if (dir && fs.existsSync(path.dirname(dir))) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topmindspace/tms-skills",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "TopMindspace 智能体技能 monorepo — 通过 npm / GitHub npx 安装技能（top-ppt-html 等）。",
   "license": "MIT",
   "author": "TopMindspace",

package/top-ppt-html/README.md

@@ -3,26 +3,21 @@
 **让 idea 飞，好想法被看见。** 一套面向 AI 智能体的商务报告生成技能：把想法、调研、分析、架构方案，变成**专业级的 HTML 报告 + 版式保真的可编辑 PPTX**。
 
 - 技能标识：`top-ppt-html`（安装/打包目录名与此一致）；品牌名：**TopPPT HTML**
-- 版本：**v0.1.0** · 完整规范见 `SKILL.md`（智能体入口）+ `references/playbook.md`（唯一常读入口）+ `references/layout-grammar.md`（排版）+ 其余按需 L2
+- 版本：**v0.1.3**（与 `@topmindspace/tms-skills@0.1.3` 同 tag）
+- **智能体入口**：`SKILL.md` → `references/playbook.md`（L1）→ L2 按需
+- **人类维护者**：本 README（安装 / 命令 / 目录）；勿把本文件当生成规范
 
-## 一、技能简介
+## 一、技能简介（人类速览）
 
 | 维度 | 能力 |
 |------|------|
-| 产出物 ① | **单文件 HTML 报告**：零外链、可翻页（方向键整屏翻页）、**每页一屏的稳定页高**、亮暗双主题（记忆按文件隔离）、header 自带工具栏（主题/9 风格实时切换/PPTX WYSIWYG 预览/可复制 AI 提示词/全屏 F/收起工具栏 B） |
-| 产出物 ② | **16:9 可编辑 PPTX**：全原生形状/文本框/表格（默认 `pictures=0`；模型显式声明 `section.image` 时按声明数导出素材图片，六版式 full/half/bleed/grid/compare/wall 与 HTML 同比例；无素材时出**原生配图占位框**——可编辑、`pictures` 不增），三模式独立排版比例尺 + **29 种页型**，带数据的图表为**原生数据图表**（双击"编辑数据"），非原生图表**附数据表**（备注/页内表格），口径自动写入演讲者备注，按所选主题导出亮色版或深色版 |
-| 三种模式 | A 演示汇报（大字每屏一主张，8–15 页）/ B 研究报告（咨询密排：行动标题 + Exhibit 编号 + 双三栏 + 密表 + 矩阵，12–25 页）/ C 信息架构图（图为王：全幅分层带/泳道/管线，1–3 张图成篇） |
-| 9 套风格 | 商务蓝（默认）/ 优雅黑白 / 麦肯锡 / 品牌红 / 暖沙金 / 墨绿 / 石墨深灰（深色优先）/ 靛紫 / 光谱彩色——与模式、主题正交组合；**每套风格各有自己的编码色板 c1–c5**（`styleDataColors` 单源，双引擎消费），多系列图表在任何风格下都可辨。**刻意不再扩张**：新增门槛（新色族 + 新语汇 + 场景缺口）见 `references/styles.md` §10 |
-| 复杂信息图 | 桑基 / 树图 / 箱线 / 关系网络 / 马赛克 / 流带 六类专属页型：曲线采样点 ≥16（流带 ≥24）、双边界分别追踪、禁预设形状替代；每页一图，数据表可追溯 |
-| 强调带 | 收尾/CTA 用 `band--accent`（软强调）、金句用 `band--accent--solid`（实底）——**浅色模式不再出现深色收尾页**；`band--deep` 仅显式反相页（≤1 处、不作末页） |
-| 待核实标注 | `.tbd` 内联标色 + `.tbd-legend`/`.flagbar` 说明——无法核实的数字/判断用**强调色**标出，提示用户二次修改（PPTX 同源 + 演讲者备注） |
-| 素材图片 | **六版式**：full 版心全宽 3:1 / half 左图右注 4:3 / bleed 通栏出血 21:9 / grid 多图网格 4:3（2·3·4·6 张）/ compare 双图 A/B / wall Logo 墙；比例由 `imageSpec` 单源锁定（HTML 用 `.media--r*` 类、PPTX 用同一比例算高度并居中）——**两通道比例一致**；`src` 仅 data: 内联或相对路径；PPTX 声明式放行 |
-| 配图占位 | 无素材时不省略图也不塞无关图：`.media--ph`（虚线框 + 斜纹 + 图标 + 尺寸提示）+ 模型 `image.placeholder` → PPTX 出**原生圆角矩形占位框**（可编辑、`pictures` 不增），交付前替换 `src` 即可；预览模态会把图位替换成真实图片 |
-| 用户图片准备 | `scripts/prepare_images.py <图片\|目录> --layout full\|half\|grid…`：读尺寸/格式/体积 → 按版式建议尺寸缩放压缩（有 Pillow 时）→ 自动选 data: 内联或相对路径 → 产出可粘贴的 `.media` HTML 片段与 `image` 模型对象 |
-| 36 种图表 | 环形 / 多段环形 / 饼图 / 柱状 / 堆叠 / 100% 堆叠条 / 折线 / 双折线 / 面积 / 横向条形 / 双向条形 / 雷达 / 仪表盘 / 玫瑰 / 瀑布 / 漏斗 / 甘特 / 散点 / 气泡 / 矩形树图 / 马赛克 / 进度条组 / 迷你趋势线 / 桑基 / 斜率 / 哑铃 / 棒棒糖 / 点图 / 子弹图 / 华夫 / 箱线 / 帕累托 / 径向条 / 流图 / K 线 / 关系网络（全内联 SVG，随主题与风格变色；**16 类走 PPTX 原生图表，其余形状还原 + 数据表**） |
-| 按需深度模式 | 命中「高保真/1:1/精确还原/正式交付」或含复杂信息图时自动升级：`--deep` 把连续文本流与空间锚点纳入 strict，`--emit-manifest` 产出锚点/容器/数据表/图表通道/图片资产登记，`render_compare.py` 准备渲染对照材料（缺依赖自动跳过） |
-| 质量闭环 | `validate_report.py`（HTML strict 全 PASS，含强调带约束/待核实标注/素材图片与配图占位/图表数据表策略）+ `validate_pptx.py --strict`（0 错误 0 警告，含容器级溢出/表格语义字号与密度/未声明图片硬拦/图片版式·裁切·多图数量·相对路径文件存在性）+ WCAG 对比度与单源完整性审计 + 双通道回归双裁判 + 素材图片导出探针 |
-| 设计标准 | Material Design 3 对齐（克制执行）；研究模式对齐咨询机构实践 |
+| 产出 | 单文件 HTML（可翻页、亮暗双主题、header 工具栏）+ 16:9 可编辑 PPTX（精导通道） |
+| 三模式 | A 演示 · B 研究 · C 架构（页型/字号/密度契约见 `playbook.md` §一） |
+| 风格 | 9 套（`styles.md`）；编码色板 c1–c5 随风格 |
+| 图表 | 核图 8 默认 + registry 全量；多样性 / 反截断 / Mode A 工艺见 playbook + `presentation-craft.md` |
+| 质量 | `validate_report --strict`（A 隐含 layout-qa）· `validate_pptx --strict` · `quality_gate --deliver` |
+
+生成规范、页型/图表穷举、铁律 **不在本文件**——智能体读 `SKILL.md` / playbook；选型大表见 `page-type-matrix.md` / `chart-decision-tree.md`。
 
 **核心架构**：HTML 与 PPTX 出自同一内容模型 `window.REPORT_MODEL`（唯一事实源）；页面只预览不导出，PPTX 由智能体走「精导通道」生成（extract → build → strict 校验）。阈值与几何全部单源化：`scripts/layout-constants.json`（常量）+ `scripts/model-schema.json`（页型 DSL）。
 
@@ -48,6 +43,16 @@ node tms-skills/bin/tms-skills.js install top-ppt-html
 
 > **GitHub 更新不会自动进 npm。** 日常可钉 npm 版本；要最新技能用 GitHub 直装，或等 maintainer 打 tag 发版。
 >
+
+### 触发词回归（维护者）
+
+```bash
+python3 scripts/check_triggers.py          # keyword/heuristic vs SKILL description
+# 扩展：编辑 evals/trigger-queries.json（how_to_extend）
+```
+
+`package_skill.py --check` 会自动跑 trigger coverage。
+
 > 「找不到这个包」→ 换 GitHub 直装，或 `--registry https://registry.npmjs.org/`（镜像索引可能滞后）。不要 `npm install top-ppt-html`（技能 id 不是独立 npm 包）。
 
 也可将本目录（或 GitHub Release 附件 `top-ppt-html.zip` 解压结果）复制到智能体技能目录，目录名保持 `top-ppt-html`。技能识别面为 `SKILL.md`（frontmatter 的 `name` / `description` 即触发描述）。
@@ -106,9 +111,12 @@ top-ppt-html/
 │  ├─ infographics.md           #   铁律与边界（逻辑入口）；代码已拆分见下两行          │
 │  ├─ infographics-stats.md     #   统计图形族 §1–§6 / §71–§77                        │
 │  ├─ infographics-structure.md #   结构图形族 §78–§82                                │
+│  ├─ page-type-matrix.md     #   L2 意图→页型穷举（playbook §三 速记）                 │
+│  ├─ chart-decision-tree.md  #   L2 图表决策表+误用（playbook §五 摘要）               │
+│  ├─ illustration-layout.md  #   L2 插画/配图 brief                                   │
 │  └─ …（modes / styles / design-system / content-rules / icons / default-surface /     │
-│        outline-design / pptx-export / high-fidelity /                               │
-│        failure-modes / tech-design；归档见 docs/archive/refs/）                         │
+│        outline-design / pptx-export / high-fidelity / failure-modes / tech-design；  │
+│        归档见 docs/archive/refs/）                                                   │
 ├─ evals/                       # Eval 框架（结果/过程/风格/效率四类目标）    │
 │  ├─ prompts.csv               #   14 条 prompt（显式/隐式/上下文/负对照）   │
 │  ├─ rubric.schema.json        #   风格目标结构化评分契约                    │
@@ -145,18 +153,23 @@ python scripts/package_skill.py --check
 python scripts/audit_skill.py && python scripts/audit_docs.py
 python scripts/audit_styles.py && python scripts/audit_css.py
 python scripts/negative_tests.py
+python scripts/check_triggers.py
+# 可选第三方：npx --yes skills-ref@0.1.5 validate .
 ```
 
 ## 目录要点
 
 | 路径 | 用途 |
 |------|------|
-| `SKILL.md` | L0 路由（≤13KB） |
-| `references/playbook.md` | L1 决策层 |
-| `references/default-surface.md` | Mode A 主读：12 页型 + 核图 8 + V1–V4；主力骨架 P1–P4+P6/P10 |
+| `SKILL.md` | L0 路由（≤13KB）；智能体唯一入口 |
+| `references/playbook.md` | L1 决策层（Mode / 路径 / V1–V4 / 组合 / 多样性摘要 / 命令 / 路由） |
+| `references/page-type-matrix.md` | L2 页型穷举表 |
+| `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/style-gallery.html` | 9 风格 × 模式 × 亮暗 |
-| `docs/archive/` | 历史规范 / 旧示例 / 全量 build_examples |
+| `evals/trigger-queries.json` | description 触发正/负例；`check_triggers.py` |
+| `docs/archive/` | 历史规范 / 旧示例 |
 
 风格画廊与主题参考图：`assets/theme-overview*.png`（Gate 0）。完整规范索引见 playbook §十。
 

package/top-ppt-html/SKILL.md

@@ -1,8 +1,12 @@
 ---
 name: top-ppt-html
-description: "TopPPT HTML：报告 / 演示 / 信息架构图生成器。单文件零外链 HTML（可翻页、亮暗双主题）+ 版式保真的原生可编辑 16:9 PPTX。三模式（A 演示·每屏一主张 / B 研究·咨询密排 / C 架构·图为王）× 9 风格；布局骨架 P1–P12；内容只填 REPORT_MODEL，render_from_model 回填正文；strict 0/0 才交付。Use when 用户要做报告、演示、汇报、PPT、slides、deck、路演，或写研究报告、分析报告、咨询报告、白皮书、调研、评测、对标、经营分析、复盘、项目汇报、商务/HTML/网页报告，或做架构图、拓扑图、流程图、泳道图、方案图，或把材料/数据做成可视化报告，或导出 HTML/PPT/PPTX（保真、可编辑、高保真、1:1），或优化排版、版式、配色、密度、图文布局，或要快速模式/fast/直接生成/一键出稿/少问一句。Do NOT use for 纯代码工程、非报告类网页或应用开发、视频/图片生成、直接改写已有 Word/PPT 源文件本身。"
+description: "Use when 用户要做报告、演示、汇报、PPT、slides、deck、路演，或写研究报告、分析报告、咨询报告、白皮书、调研、评测、对标、经营分析、复盘、项目汇报、商务/HTML/网页报告，或做架构图、拓扑图、流程图、泳道图、方案图，或把材料做成可视化报告并导出 HTML/PPT/PPTX，或优化排版/版式/配色/图文布局，或要快速模式/fast/直接生成/一键出稿/少问一句。TopPPT HTML：零外链可翻页 HTML（亮暗双主题）+ 版式保真可编辑 16:9 PPTX；三模式（A 演示·每屏一主张 / B 研究·咨询密排 / C 架构·图为王）× 9 风格。Do NOT use for 纯代码工程、非报告类网页或应用开发、视频/图片生成、直接改写已有 Word/PPT 源文件本身。"
+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.3"
+  author: TopMindspace
 ---
-
 # TopPPT HTML
 
 **让 idea 飞，好想法被看见。** 一套技能、三种模式、两种交付：**单文件 HTML 报告**（可翻页、可演示、header 自带工具栏）+ **版式保真的原生可编辑 PPTX**（智能体精导唯一交付通道）。两者同源于一个内容模型 `REPORT_MODEL`。设计对齐 Material Design 3，执行克制（Google/Apple 风）；研究模式对齐咨询机构（McKinsey/BCG）的密度与论证结构，但**克制优先**——不加多余的页头标签、页脚信息与装饰。
@@ -32,7 +36,7 @@ description: "TopPPT HTML：报告 / 演示 / 信息架构图生成器。单文
 | 篇幅 | A=10 / B=12 / C=6 | |
 | format | html only（用户要 PPT→html+pptx） | |
 
-流程：一行宣布「Fast 选用：…」→ 走 playbook §二轻量命令链（骨架→模型单写→回填→strict→`quality_gate --deliver`；可选 pptx）。路径永远轻量；回复末可附 `assets/style-gallery.html`。开场须声明「已跳过参考图」。**标准模式**仍强制 Gate 0 + 六项。
+流程：一行宣布「Fast 选用：…」→ **最小大纲**（`outline-design.md`「轻量最小集」）→ playbook §二轻量链（骨架→模型单写→回填→strict→`quality_gate --deliver`；可选 pptx）。路径轻量；末可附 `assets/style-gallery.html`。开场声明「已跳过参考图」。**标准模式**仍强制 Gate 0 + 六项。
 
 ## 唯一入口流程
 
@@ -42,7 +46,7 @@ description: "TopPPT HTML：报告 / 演示 / 信息架构图生成器。单文
       （命令链见 playbook §二/§九；PPTX 见 pptx-export）
 ```
 
-**预算（硬）**：交互轮次 **≤3**；默认必读仅 2 份——本文件 + L1 决策层 `references/playbook.md`；L2 深度文件命中才读、读一份用一份、不预读。
+**预算（硬）**：交互轮次 **≤3**；**L0+L1 共 2 份**（本文件 + `playbook.md`）。**Mode A/Fast**可加 L1.5：`default-surface.md`+`presentation-craft.md`（非违约）。其余 L2 命中才读、不预读。
 
 ## 六项问询（标准模式 · 一次问完 · 唯一一次形式参数确认）
 
@@ -61,7 +65,7 @@ description: "TopPPT HTML：报告 / 演示 / 信息架构图生成器。单文
 
 | 路径 | 何时 | 多做什么 |
 |------|------|---------|
-| **轻量**（默认） | 页数不多、材料单一完整、关键判断已敲定 | 仅 1 张规划卡，直接生成 |
+| **轻量**（默认） | 页数不多、材料单一完整、关键判断已敲定 | 最小大纲→1 张规划卡（`outline-design.md`「轻量最小集」） |
 | **完整** | 长篇、材料量大且杂、含未敲定关键判断、用户要看框架 | 证据盘点 → 故事线 → 主张树 → 逐页规划卡 → 大纲确认（1 轮） |
 
 两条路径的**精确判定条件与完整步骤以 `references/playbook.md` §二为准**。完整路径确认只做一次，用户说"调整"只改指定处；确认后不再有内容层面的反复确认。
@@ -85,16 +89,16 @@ description: "TopPPT HTML：报告 / 演示 / 信息架构图生成器。单文
 **L2 一览**（命中条件与逐任务只读清单的**详表以 playbook §十为准**，此处仅索引）：
 
 - 模式契约与锁定版式 → `references/modes.md` · 完整路径七步 → `references/outline-design.md`
-- **A/Fast 主读 → `references/default-surface.md`** + **`presentation-craft.md`** · 骨架分层见 `layout-grammar.md` §七
-- 组件/版式**代码** → `components.md` · 图表门面 `charts.md`（纪律+核图；extended 按需取节）· 信息图 → `infographics.md`
+- **A/Fast L1.5 → `default-surface.md` + `presentation-craft.md`** · 骨架 `layout-grammar.md` §七 · 插画 `illustration-layout.md`
+- 组件/版式**代码** → `components.md` · 页型表 `page-type-matrix.md` · 图表门面 `charts.md` + 决策树 `chart-decision-tree.md`（extended 按需）· 信息图 → `infographics.md`
 - 配色/主题/字阶 → `styles.md` + `design-system.md` · 写作 → `content-rules.md` · 图标语义 → `icons.md`
 - PPTX 精导 → `references/pptx-export.md` · 深度高保真 → `references/high-fidelity.md` · 修复顺序 → `references/failure-modes.md` · 技能维护 → `references/tech-design.md`
 
-**操作方式**：定模式/页型/组合/图 → 只读 `playbook.md`；取代码 → `extract_snippet.py`；**禁止整读** `layouts-combo.md` / `charts-basic.md` 等大文件；**同一阶段不重复读同一文件**。
+**操作方式**：定模式/页型/组合/图 → 只读 `playbook.md`；取代码 → **必须** `extract_snippet.py`。**禁止整读**：`layouts-combo` / `components-atoms` / `charts-basic` / `charts-extended` / `content-rules` 全文 / `pptx-export` / 模式模板 HTML（走 scaffold）。详表 playbook §十。同阶段不重读。
 
 ## 铁律（12 条 · 交付硬门禁）
 
-> 门禁语义；阈值见 playbook / layout 常量 JSON。排版读 `layout-grammar.md`。**motion=none**（无炫技转场；见 `presentation-craft.md`）。
+> 门禁语义；阈值见 playbook / layout 常量 JSON。排版读 `layout-grammar.md`。**motion=none**（无炫技转场；`presentation-craft.md`）。
 
 1. **单文件零外链**——无 CDN/外部字体/外部图片，图形一律内联 SVG；`<img src>` 仅 `data:` 或相对路径且必带 `alt`（单图 ≤1.5MB、全篇 ≤8MB）；无素材图不留空不省略，用配图占位（`components.md` §11c-3）。
 2. **模式先定后写**——从对应模式模板起步；`data-mode` = `REPORT_MODEL.mode`，页面无模式切换；MD3 映射；PPTX 字号走三模式独立比例尺。

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

@@ -0,0 +1,5 @@
+# Codex / ChatGPT Skills UI metadata (optional)
+display_name: "TopPPT HTML"
+short_description: "Reports, decks, and architecture diagrams as single-file HTML + editable 16:9 PPTX."
+default_prompt: "Generate a professional presentation or research report as HTML (and optional PPTX)."
+allow_implicit_invocation: true

package/top-ppt-html/evals/trigger-queries.json

@@ -0,0 +1,181 @@
+{
+  "version": 1,
+  "skill": "top-ppt-html",
+  "description": "Keyword/heuristic trigger coverage against SKILL.md frontmatter description. Not an LLM eval — CI gates regressions when trigger keywords drift.",
+  "how_to_extend": [
+    "Add a positive query that should select this skill (报告/路演/PPT/HTML/调研…).",
+    "Add a negative query that must NOT select it (coding/video/edit-existing-pptx…).",
+    "Each entry: {id, query, expect: 'hit'|'miss', notes?}",
+    "Runner: python3 scripts/check_triggers.py — matches query tokens against description keywords extracted from SKILL.md.",
+    "Wire: package_skill.py --check invokes check_triggers; also npm run check."
+  ],
+  "positive": [
+    {
+      "id": "P01",
+      "query": "帮我做一份季度经营分析报告",
+      "expect": "hit"
+    },
+    {
+      "id": "P02",
+      "query": "明天路演用的融资 PPT，10页左右",
+      "expect": "hit"
+    },
+    {
+      "id": "P03",
+      "query": "生成一份可翻页的 HTML 演示文稿",
+      "expect": "hit"
+    },
+    {
+      "id": "P04",
+      "query": "把调研材料做成 slides deck",
+      "expect": "hit"
+    },
+    {
+      "id": "P05",
+      "query": "写一份麦肯锡风格的对标分析研究报告",
+      "expect": "hit"
+    },
+    {
+      "id": "P06",
+      "query": "项目复盘汇报 PPTX，要能编辑",
+      "expect": "hit"
+    },
+    {
+      "id": "P07",
+      "query": "画一张系统架构拓扑图，图为王",
+      "expect": "hit"
+    },
+    {
+      "id": "P08",
+      "query": "泳道流程图 + 方案说明页",
+      "expect": "hit"
+    },
+    {
+      "id": "P09",
+      "query": "白皮书大纲做成网页报告",
+      "expect": "hit"
+    },
+    {
+      "id": "P10",
+      "query": "评测报告可视化，导出 HTML 和 PPT",
+      "expect": "hit"
+    },
+    {
+      "id": "P11",
+      "query": "商务汇报用的一页一主张演示",
+      "expect": "hit"
+    },
+    {
+      "id": "P12",
+      "query": "快速模式一键出稿，少问一句",
+      "expect": "hit"
+    },
+    {
+      "id": "P13",
+      "query": "fast mode generate a pitch deck",
+      "expect": "hit"
+    },
+    {
+      "id": "P14",
+      "query": "咨询报告：发现、证据、so-what",
+      "expect": "hit"
+    },
+    {
+      "id": "P15",
+      "query": "优化这份报告的排版版式和配色密度",
+      "expect": "hit"
+    },
+    {
+      "id": "P16",
+      "query": "把数据做成可视化经营分析 deck",
+      "expect": "hit"
+    },
+    {
+      "id": "P17",
+      "query": "发布会演讲 PPT，亮暗双主题",
+      "expect": "hit"
+    },
+    {
+      "id": "P18",
+      "query": "行业调研 + 对标分析 HTML 报告",
+      "expect": "hit"
+    },
+    {
+      "id": "P19",
+      "query": "直接生成项目汇报 slides",
+      "expect": "hit"
+    },
+    {
+      "id": "P20",
+      "query": "高保真 1:1 导出可编辑 PPTX",
+      "expect": "hit"
+    },
+    {
+      "id": "P21",
+      "query": "做个信息架构图和分层带",
+      "expect": "hit"
+    },
+    {
+      "id": "P22",
+      "query": "董事会汇报材料，正式演示风格",
+      "expect": "hit"
+    }
+  ],
+  "negative": [
+    {
+      "id": "N01",
+      "query": "帮我写一个 React 组件库并跑单测",
+      "expect": "miss"
+    },
+    {
+      "id": "N02",
+      "query": "debug 这段 Python 报错",
+      "expect": "miss"
+    },
+    {
+      "id": "N03",
+      "query": "生成一段产品宣传视频脚本并渲染成 mp4",
+      "expect": "miss"
+    },
+    {
+      "id": "N04",
+      "query": "用 Midjourney 生成一张产品海报图",
+      "expect": "miss"
+    },
+    {
+      "id": "N05",
+      "query": "直接改这个已有的 pptx 里第三页的字号",
+      "expect": "miss"
+    },
+    {
+      "id": "N06",
+      "query": "打开 Word 文档把第二段改成被动语态",
+      "expect": "miss"
+    },
+    {
+      "id": "N07",
+      "query": "搭建一个电商官网前端，不要报告",
+      "expect": "miss"
+    },
+    {
+      "id": "N08",
+      "query": "给我写 SQL 迁移脚本",
+      "expect": "miss"
+    },
+    {
+      "id": "N09",
+      "query": "配置 nginx 反向代理",
+      "expect": "miss"
+    },
+    {
+      "id": "N10",
+      "query": "把这段代码 refactor 成 TypeScript",
+      "expect": "miss"
+    },
+    {
+      "id": "N11",
+      "query": "剪辑这段会议录像加字幕",
+      "expect": "miss"
+    }
+  ]
+}

package/top-ppt-html/package.json

@@ -1,6 +1,6 @@
 {
   "name": "top-ppt-html",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "private": true,
   "description": "TopPPT HTML：报告 / 演示 / 信息架构图技能。单文件 HTML + 版式保真的可编辑 PPTX；布局骨架 P1–P12；模型单写；strict 0/0 交付。",
   "license": "MIT",
@@ -24,7 +24,8 @@
     "regression": "python3 scripts/regression.py",
     "negative": "python3 scripts/negative_tests.py",
     "package": "python3 scripts/package_skill.py",
-    "check": "python3 scripts/package_skill.py --check"
+    "check": "python3 scripts/package_skill.py --check",
+    "triggers": "python3 scripts/check_triggers.py"
   },
   "dependencies": {
     "pptxgenjs": "^4.0.0"

package/top-ppt-html/references/chart-decision-tree.md

@@ -0,0 +1,42 @@
+# 图表选型决策树（L2）
+
+> **何时读**：选图 / 分析意图→图型；常读入口仍是 `playbook.md` §五（核图 8 + 多样性摘要）。读完即停。
+> 完整登记与代码 → `extract_snippet.py --chart <类型>`；误用纪律 → `charts.md`（先 `charts-discipline`，核图 8，extended 按需）。
+
+## 决策表
+
+| 分析意图（读者要得出的结论） | 首选 | 次选 | 禁用 / 改判条件 |
+|---------------------------|------|------|----------------|
+| 谁大谁小 | `hbar` | `lollipop` / `bar` | 类别 >8 → Top7 + 附录 |
+| 随时间怎么变 | `line` | `area` / `dualline` | 时间点 >8 不标点值 |
+| 占比是多少 | `donut` | `pie` / `multidonut` | 扇区 >5 → 合并"其他"或 `treemap` |
+| 每 1% 的直觉 | `waffle` | `donut` | 类别 >3 改 `marimekko` |
+| 结构在变形 | `streamgraph` | `stackline` | 系列 >6 合并 |
+| 总量 × 构成双编码 | `marimekko` | `treemap` | 列 >6 / 段 >4 → 拆 |
+| 份额悬殊（头部集中） | `treemap` | `donut` | 叶 >16 → 合并小项 |
+| 从 A 到 B 是谁贡献的 | `waterfall` | `pareto` | 段 >6 → 合并 |
+| 主要矛盾是哪几个 | `pareto` | `waterfall` | 类别 >7 → 合并 |
+| 转化/流失在哪一环 | `funnel` | `sankey` | 层 >5 → 改 `hbar` |
+| 多对多的流向 | `sankey` | `network` | 节点 >12 / 流带 >24 → 拆页 |
+| 谁和谁相连 | `network` | `diagram` | 节点 >18 / 边 >30 → 拆页 |
+| 两期谁升谁降 | `slope` | `dumbbell` | 系列 >6 → 取 Top 6 |
+| 单指标前后对比（多对象） | `dumbbell` | `vsbar` | 行 >6 → 拆页 |
+| 实际 vs 目标（含区间） | `bulletchart` | `bullet` | 行 >6 → 拆页 |
+| 达成率（多指标同心） | `radialbar` | `gauge` | 环 >5 → 改 `bullet` |
+| 一个值够不够 | `gauge` | `radialbar` | 单值叙事，勿与图并存 |
+| 分布不是均值 | `boxplot` | `dotplot` | 组 >8 → 拆页 |
+| 双维定位 + 第三维权重 | `bubble` | `scatter` | 气泡 >8 → 标注关键项 |
+| 六维能力画像 | `radar` | `rose` | 维度 >6 → 拆两组 |
+| 区间波动（开高低收） | `candlestick` | `line` | 蜡烛 >12 → 聚合 |
+| 多项目完成度 | `progress` | `bullet` | 行 >6 → 拆页 |
+| 迷你趋势（卡内） | `sparkline` | — | 只用于指标卡，不与大图并存 |
+
+## 七种最常见的误用（出现即改判）
+
+1. 用 `bar` 表达占比 → 改 `donut`/`stackline`/`waffle`。
+2. 用 `donut` 表达 8 个类别 → 合并或改 `treemap`。
+3. 用 `line` 表达类别对比（无时间轴）→ 改 `hbar`。
+4. 用 `table` 表达趋势 → 改 `line`/`area`。
+5. 用均值型图表表达分布 → 改 `boxplot`/`dotplot`。
+6. 同一页放两张同型图 → 改 `split`/`halftable` 并让两图**编码不同维度**。
+7. 多系列图用单色明度阶梯（分不清） → 用 `f-c1~c5` 编码色板（见 playbook §八）。

package/top-ppt-html/references/default-surface.md

@@ -1,6 +1,6 @@
 # 默认生成面（L1.5 · Mode A 主读 · ≤6KB）
 
-> **Mode A / Fast 演示的首要读面**（正式场合 · 大气演讲）。完整决策见 `playbook.md`；工艺清单见 `presentation-craft.md`；代码用 `extract_snippet.py`。  
+> **Mode A / Fast 演示的首要读面**（正式场合 · 大气演讲）。完整决策见 `playbook.md`；工艺清单见 `presentation-craft.md`；插画/配图见 `illustration-layout.md`；代码用 `extract_snippet.py`。  
 > Mode B/C 能力保留——**需要时**再读 modes / layouts-*；勿把密排/架构默认反向污染 A。
 
 ## A 默认三件套
@@ -59,3 +59,4 @@ scaffold_report → 只填 REPORT_MODEL → render_from_model --inplace
 ## 长文与密度（Mode A）
 
 一屏一主张；证据用卡/列表或跟进页。**禁止**为稀疏 demo 感删实质。溢出顺序：重构 → 拆页 → 换 V/栅格 → 有限 fontShrink。详见 `presentation-craft.md`「长文与信息承载」。
+配图/插画页：caption+so-what、安全边距、勿与大图双重心——`illustration-layout.md`。

package/top-ppt-html/references/illustration-layout.md

@@ -0,0 +1,39 @@
+# 插画 / 非数据配图 brief（L2 · ≤4KB）
+
+> **何时读**：页含情绪图 / 产品图 / 截图 / 示意图 / `image.placeholder`；或 Mode A 需要 full-bleed 照片+主张叠字。  
+> **何时不读**：纯数据图表选型（走 playbook §五 / `charts.md`）。  
+> **取码**：`extract_snippet.py --task image-layout`（`components.md` §11c）；勿整读 `components-atoms.md`。
+
+## 配图 vs 数据图（互斥优先）
+
+| 意图 | 用什么 | 不要 |
+|------|--------|------|
+| 趋势 / 构成 / 对比 / 排名 | 数据图（核图 8 优先） | 用照片代替数据 |
+| 氛围 / 品牌 / 产品外观 / UI 截图 | `<img>` / `.media` / `image.placeholder` | 硬画假图表 |
+| 无素材但仍需图位 | `image.placeholder` + `.media--ph` | 留空或塞无关图 |
+
+**一页一主视觉**：同页不要「大照片 + 大图表」双重心（FAIL 级审美风险）；icon 可点缀，chart 占主位时照片改小或拆页。
+
+## 版式与安全边距
+
+- **安全边距**：距版心边缘 ≥ 24px（演示投影更宽松）；文字不得压在图片关键焦点上。
+- **图文共存**：半幅图（half）→ 图左/上 + 注右/下；注含 **caption（图注）+ so-what（含义一句）**。
+- **不重叠**：标题 / 标签 / 图例不得与照片主体或 icon 碰撞；必要叠字用半透明底或高对比条。
+- **icon + chart**：icon 在注释列或卡眉，不进 SVG 绘图区；每屏 icon 仍 3–8。
+
+## Mode A · full-bleed 照片 + 主张叠字
+
+1. 仅用于封面 / 章节幕 / 金句休止 / 收尾 —— **不做证据页**。  
+2. 主张句叠在照片暗侧或统一遮罩条上；对比度满足 WCAG（正文感 ≥4.5:1）。  
+3. `layout: bleed` + 安全区内 claim；勿在 bleed 页再塞密表/多卡。  
+4. 必须有 **caption 或来源/版权**（可沉 `.fig__cap` / footnote）；证据含义用跟进页，不塞进 bleed。
+
+## 清单（写模型前 10 秒）
+
+- [ ] 这页是数据图还是插画？二者勿抢主位  
+- [ ] 有 caption + so-what（或明确「氛围休止页无需 so-what」）  
+- [ ] 无文字压焦点、无标签重叠、边距够  
+- [ ] 无素材 → placeholder，不留空洞  
+- [ ] 校验：`validate_report` 对缺 caption/so-what 的配图页 WARN  
+
+> 详细几何与六版式（full/half/bleed/grid/compare/wall）→ `extract_snippet.py --task image-layout`。

package/top-ppt-html/references/outline-design.md

@@ -20,6 +20,30 @@
 之后才进入生成（SKILL.md 工作流），规划即填写 REPORT_MODEL 的直接输入
 ```
 
+## 〇、轻量最小集（Fast / 轻量路径 · 非七步）
+
+> **不强迫完整七步**，但禁止「零大纲直接 scaffold」。路演/汇报材料杂时尤其需要这一屏。
+
+写在内部笔记（≤1 屏）即可：
+
+1. **核心主张一句话**（≤30 字；含判断/数字更好）。
+2. **页清单**（每行三列）：`claim`（本页主张） / `pageType` / `chart`（无图写 `—` 或 `image`/`placeholder`）。
+
+示例：
+
+```
+主张：Q3 增长靠转化而非流量，优先修结账漏斗
+1. 议程 | agenda | —
+2. 转化率跌 4pt | kpi | —
+3. 漏斗三段对比 | bar | funnel
+4. 竞品截图+含义 | image | —
+5. 行动三项 | points | —
+```
+
+之后进入 playbook §二轻量命令链。完整路径仍走下方七步法。
+
+---
+
 > **为什么前置证据表与故事线脑暴**：直接从材料跳到单版大纲，等于用第一条想到的叙事结构绑架全部材料——证据冲突会被静默抹平、弱枝论点会混进主张树。**先摊开证据、再发散故事线、最后收敛**，是咨询材料的标准做法。
 
 ### ① 意图解析（问自己四个问题，写进内部笔记，不进报告）

package/top-ppt-html/references/page-type-matrix.md

@@ -0,0 +1,35 @@
+# 页型选型矩阵（L2）
+
+> **何时读**：选页型 / 意图→页型映射；常读入口仍是 `playbook.md`。读完即停。
+> 自动选型：`python scripts/recommend_layout.py --mode A --intent "…" --json`
+> 穷举表（内容形态 → 版式 → PPTX 页型）见 `components.md` §46；密度档 `components.md` §46b；组合见 playbook §四。
+
+| 我要表达 | 首选页型 | 次选 | 关键约束 |
+|---------|---------|------|---------|
+| 要点式并列主张（默认页） | `points` | `cards` | 每卡宜 3–5 条；更多拆卡/跟进页，勿截断条目 |
+| 现状基线 / 指标快照 | `metrics` | `kpi` | 4–6 个；单数压场用 `kpi` |
+| 单个核心数字压场 | `kpi` | `metrics` | hero 一数一结论 |
+| 多维对标清单 | `table` | `halftable` | ≤8 行（research ≤16） |
+| 时间趋势 / 爬坡 | `bar`（chart.type=line/area/dualline） | `exhibit` | 时间点 >8 改折线 |
+| 构成占比 | `donut`（pie/multidonut/waffle） | `halftable` / **V3 KPI** | 扇区 ≤5，最小扇区 ≥8%；**极偏（min<5% 或 max/min>20）禁 donut→V3** |
+| 排名 / 大小对比 | `bar`（chart.type=hbar/lollipop/pareto） | `table` | 类别 >8 取 Top 7 + 附录 |
+| 现状 vs 目标 | `bullet` / `comparison` | `bar`（vsbar/bulletchart） | 目标线与实际条同量纲 |
+| 两期升降（谁升谁降） | `bar`（slope/dumbbell） | `table` | 两端都要标数值 |
+| 双维分布 / 优先级 | `bar`（scatter/bubble） | `matrix` | 气泡半径 ∝ √值 |
+| 分布 / 离散度 | `boxplot` | `bar`（dotplot） | 组数 ≤8；箱线四件齐备 |
+| 增减归因（A→B） | `bar`（waterfall） | `table` | 每段标变化量 + 合计收口 |
+| 转化 / 筛选漏斗 | `bar`（funnel） | `sankey` | 层数 ≤5 |
+| 计划排期（并行） | `bar`（gantt） | `timeline` | 里程碑叙事用 `timeline`，勿混 |
+| 里程碑 / 路线叙事 | `timeline` | `steps` | 3–5 个，每个 ≤2 行 |
+| 步骤 / 实施节奏 | `steps` | `timeline` | 3–6 步；高亮步 ≤2 处 |
+| 二维强度对标 | `heatmap` | `matrix` | 行列 ≤5×5；只用强调色明度阶梯 |
+| 定位 / 优先级 / 象限 | `matrix` | `bar`（scatter） | ≤3×3 |
+| 层级递进 / 价值阶梯 | `pyramid` | `diagram` | 3–5 层；强调层 ≤1 |
+| 关键判断 / 金句休止 | `quote` | `points` | 全文 1–2 处，多了廉价 |
+| 完整论述（发现→证据→含义） | `twocol`（research R1） | `threecol` | 段 ≤200 字；标题必须结论句 |
+| 数据证据页（主力） | `exhibit`（R2） | `split` | 全篇 Exhibit 连续编号 |
+| 三栏并列论点 | `threecol`（R6） | `cards` | 每栏 ≤150 字 |
+| 系统分层架构 | `diagram` | `bar`（chart.type=network） | 节点 ≤24；层 ≤4 |
+| 流程 / 职责协作 | `lane` | `diagram` | 每行 ≤6 步；正交折线优先 |
+| 素材图片（实拍/截图） | `image` | `split` | 六版式；无图用 `image.placeholder` |
+| 待核实项收口 | `flags` 字段 | `table` | 标色必须配说明 |

package/top-ppt-html/references/playbook.md

@@ -35,6 +35,7 @@
 **密度选错的症状**：A 出现双栏小字墙（投影看不清）→ 拆页/换形态；A 为「疏朗」删证据/so-what → **反模式**，按 content-rules §四-c 恢复；B 大面积留白 → 合页或补证据；C 成段正文 → 转图注。
 **节奏**：禁止连续 3 页同密度档；同一版式不连用超过 2 页；research 每 3–4 页插一个低密度页（指标带/金句/大数）。
 **反截断**：溢出顺序 = 重构承载 → 拆页/分章 → 换布局 → 有限 fontShrink；禁静默截断（见 `presentation-craft.md`）。
+**插画页**：情绪/产品/占位图 ≠ 数据图；安全边距、图文不叠、icon+chart 共存、Mode A full-bleed+主张叠字规则见 `illustration-layout.md`。
 
 ---
 
@@ -42,10 +43,10 @@
 
 **轻量路径**（默认）——同时满足：≤12 页 · 材料单一完整 · 无未敲定关键判断 · 用户没要求看框架。
 ```
-Gate 0 参考图 → 六项问询（1 轮）→ 1 张规划卡 → scaffold_report.py
+Gate 0 参考图 → 六项问询（1 轮）→ 最小大纲（outline-design「轻量最小集」）→ 1 张规划卡 → scaffold_report.py
   → **只填 REPORT_MODEL** → render_from_model.py --inplace → validate_report.py --strict → 交付
 ```
-（Fast Mode 跳过 Gate 0/六项，其余同链；**禁止**手改 HTML 正文与模型双写。）
+（Fast Mode 跳过 Gate 0/六项，仍须最小大纲；其余同链；**禁止**手改 HTML 正文与模型双写。）
 
 **完整路径**（任一命中）——研究 ≥20 页 / 演示 ≥12 页 / 材料量大且杂 / 含未敲定关键判断 / 用户要看框架。
 ```
@@ -53,7 +54,7 @@ Gate 0 参考图 → 六项问询（1 轮）→ 证据表 → 故事线脑暴
   → scaffold_report.py → **只填 REPORT_MODEL** → render_from_model.py --inplace → validate_report.py --strict → 交付
 ```
 
-**预算（硬）**：交互轮次 ≤3；必读文件 = `SKILL.md` + 本文件（≤2 份）；L2 深度文件按需且单份读完即停。
+**预算（硬）**：交互轮次 ≤3；常读面仅入口两份（`SKILL.md` + 本手册）。正式演示 / Fast 演示路径额外允许工艺双件为 L1.5（`default-surface` 与 `presentation-craft`），不记作超读。深度 L2 命中再开、读完即停。
 
 ---
 
@@ -61,37 +62,9 @@ Gate 0 参考图 → 六项问询（1 轮）→ 证据表 → 故事线脑暴
 
 > 自动选型：`python scripts/recommend_layout.py --mode A --intent "路演" --pages 10 --json`（或 `--from-model report.model.json`）→ `{pageType,skel,chart,rationale}`；Mode A 交付 `--strict` 已含 layout-qa。
 
-> 穷举表（内容形态 → 版式 → PPTX 页型）见 `components.md` §46；密度档适配见 `components.md` §46b；组合见下节 §四。
-
-| 我要表达 | 首选页型 | 次选 | 关键约束 |
-|---------|---------|------|---------|
-| 要点式并列主张（默认页） | `points` | `cards` | 每卡宜 3–5 条；更多拆卡/跟进页，勿截断条目 |
-| 现状基线 / 指标快照 | `metrics` | `kpi` | 4–6 个；单数压场用 `kpi` |
-| 单个核心数字压场 | `kpi` | `metrics` | hero 一数一结论 |
-| 多维对标清单 | `table` | `halftable` | ≤8 行（research ≤16） |
-| 时间趋势 / 爬坡 | `bar`（chart.type=line/area/dualline） | `exhibit` | 时间点 >8 改折线 |
-| 构成占比 | `donut`（pie/multidonut/waffle） | `halftable` / **V3 KPI** | 扇区 ≤5，最小扇区 ≥8%；**极偏（min<5% 或 max/min>20）禁 donut→V3** |
-| 排名 / 大小对比 | `bar`（chart.type=hbar/lollipop/pareto） | `table` | 类别 >8 取 Top 7 + 附录 |
-| 现状 vs 目标 | `bullet` / `comparison` | `bar`（vsbar/bulletchart） | 目标线与实际条同量纲 |
-| 两期升降（谁升谁降） | `bar`（slope/dumbbell） | `table` | 两端都要标数值 |
-| 双维分布 / 优先级 | `bar`（scatter/bubble） | `matrix` | 气泡半径 ∝ √值 |
-| 分布 / 离散度 | `boxplot` | `bar`（dotplot） | 组数 ≤8；箱线四件齐备 |
-| 增减归因（A→B） | `bar`（waterfall） | `table` | 每段标变化量 + 合计收口 |
-| 转化 / 筛选漏斗 | `bar`（funnel） | `sankey` | 层数 ≤5 |
-| 计划排期（并行） | `bar`（gantt） | `timeline` | 里程碑叙事用 `timeline`，勿混 |
-| 里程碑 / 路线叙事 | `timeline` | `steps` | 3–5 个，每个 ≤2 行 |
-| 步骤 / 实施节奏 | `steps` | `timeline` | 3–6 步；高亮步 ≤2 处 |
-| 二维强度对标 | `heatmap` | `matrix` | 行列 ≤5×5；只用强调色明度阶梯 |
-| 定位 / 优先级 / 象限 | `matrix` | `bar`（scatter） | ≤3×3 |
-| 层级递进 / 价值阶梯 | `pyramid` | `diagram` | 3–5 层；强调层 ≤1 |
-| 关键判断 / 金句休止 | `quote` | `points` | 全文 1–2 处，多了廉价 |
-| 完整论述（发现→证据→含义） | `twocol`（research R1） | `threecol` | 段 ≤200 字；标题必须结论句 |
-| 数据证据页（主力） | `exhibit`（R2） | `split` | 全篇 Exhibit 连续编号 |
-| 三栏并列论点 | `threecol`（R6） | `cards` | 每栏 ≤150 字 |
-| 系统分层架构 | `diagram` | `bar`（chart.type=network） | 节点 ≤24；层 ≤4 |
-| 流程 / 职责协作 | `lane` | `diagram` | 每行 ≤6 步；正交折线优先 |
-| 素材图片（实拍/截图） | `image` | `split` | 六版式；无图用 `image.placeholder` |
-| 待核实项收口 | `flags` 字段 | `table` | 标色必须配说明 |
+> **穷举意图→页型表** → L2 `page-type-matrix.md`（命中才读）。`components.md` §46 / §46b；组合见 §四。
+
+**速记（默认面）**：要点→`points`/`cards` · 指标→`metrics`/`kpi` · 证据图→`exhibit`/`split` · 对标表→`table`/`halftable` · 趋势→`bar`+line/area · 占比→`donut`（极偏→**V3**）· 架构→`diagram`/`lane` · 图文演讲→§三-b V1–V4。
 
 ---
 
@@ -154,48 +127,11 @@ Gate 0 参考图 → 六项问询（1 轮）→ 证据表 → 故事线脑暴
 
 > **默认面（8 核心图）**：`bar` · `hbar` · `line` · `donut` · `progress` · `area` · `stack` · `dualline`
 > （= `layoutSystem.defaultCharts`）。完整登记与代码 → `extract_snippet.py --chart <类型>`；误用纪律 → `charts.md`（先 `charts-discipline`，核图 8，extended 按需）。
-> 下表仍保留决策提示；**生成默认只从 8 核心里选**，扩展图仅在意图明确命中时用。
-
-
-> 穷举代码见 `charts.md` §16–§31、§35、§52–§70；误用反例与多样性纪律见 `charts.md` §66（facade：纪律→核图→extended）。
-> **默认生成面（P1 收敛）**：优先 `bar / hbar / line / donut / progress / area / stack / dualline`。
-> **高级图型**（waterfall/gantt/funnel/slope/… 与 6 类信息图）按需选用，不进默认轮换。
-> **纪律**：全篇不同 `data-chart` 类型 ≥ `min(模式上限, ⌈图表页数 × 0.6⌉)`（上限：research 6 / presentation 4 / architecture 3）；**相邻图表页不得同型**。多样性 **preferCoreFirst**：先拉开核图 8；advanced 计入 minTypes（不罚）但只在意图命中时用，**禁止预读** `charts-extended.md`；**禁**为凑下限硬上冷门图、简单图全幅、极偏 donut/pie。
-
-| 分析意图（读者要得出的结论） | 首选 | 次选 | 禁用 / 改判条件 |
-|---------------------------|------|------|----------------|
-| 谁大谁小 | `hbar` | `lollipop` / `bar` | 类别 >8 → Top7 + 附录 |
-| 随时间怎么变 | `line` | `area` / `dualline` | 时间点 >8 不标点值 |
-| 占比是多少 | `donut` | `pie` / `multidonut` | 扇区 >5 → 合并"其他"或 `treemap` |
-| 每 1% 的直觉 | `waffle` | `donut` | 类别 >3 改 `marimekko` |
-| 结构在变形 | `streamgraph` | `stackline` | 系列 >6 合并 |
-| 总量 × 构成双编码 | `marimekko` | `treemap` | 列 >6 / 段 >4 → 拆 |
-| 份额悬殊（头部集中） | `treemap` | `donut` | 叶 >16 → 合并小项 |
-| 从 A 到 B 是谁贡献的 | `waterfall` | `pareto` | 段 >6 → 合并 |
-| 主要矛盾是哪几个 | `pareto` | `waterfall` | 类别 >7 → 合并 |
-| 转化/流失在哪一环 | `funnel` | `sankey` | 层 >5 → 改 `hbar` |
-| 多对多的流向 | `sankey` | `network` | 节点 >12 / 流带 >24 → 拆页 |
-| 谁和谁相连 | `network` | `diagram` | 节点 >18 / 边 >30 → 拆页 |
-| 两期谁升谁降 | `slope` | `dumbbell` | 系列 >6 → 取 Top 6 |
-| 单指标前后对比（多对象） | `dumbbell` | `vsbar` | 行 >6 → 拆页 |
-| 实际 vs 目标（含区间） | `bulletchart` | `bullet` | 行 >6 → 拆页 |
-| 达成率（多指标同心） | `radialbar` | `gauge` | 环 >5 → 改 `bullet` |
-| 一个值够不够 | `gauge` | `radialbar` | 单值叙事，勿与图并存 |
-| 分布不是均值 | `boxplot` | `dotplot` | 组 >8 → 拆页 |
-| 双维定位 + 第三维权重 | `bubble` | `scatter` | 气泡 >8 → 标注关键项 |
-| 六维能力画像 | `radar` | `rose` | 维度 >6 → 拆两组 |
-| 区间波动（开高低收） | `candlestick` | `line` | 蜡烛 >12 → 聚合 |
-| 多项目完成度 | `progress` | `bullet` | 行 >6 → 拆页 |
-| 迷你趋势（卡内） | `sparkline` | — | 只用于指标卡，不与大图并存 |
-
-**七种最常见的误用（出现即改判）**：
-1. 用 `bar` 表达占比 → 改 `donut`/`stackline`/`waffle`。
-2. 用 `donut` 表达 8 个类别 → 合并或改 `treemap`。
-3. 用 `line` 表达类别对比（无时间轴）→ 改 `hbar`。
-4. 用 `table` 表达趋势 → 改 `line`/`area`。
-5. 用均值型图表表达分布 → 改 `boxplot`/`dotplot`。
-6. 同一页放两张同型图 → 改 `split`/`halftable` 并让两图**编码不同维度**。
-7. 多系列图用单色明度阶梯（分不清） → 用 `f-c1~c5` 编码色板（见 §八）。
+> **扩展决策表 + 七种误用** → L2 `chart-decision-tree.md`（命中才读）。**生成默认只从 8 核心里选**，扩展图仅意图明确命中。
+
+**多样性（硬摘要 · 保留）**：全篇不同 `data-chart` ≥ `min(模式上限, ⌈图表页数 × 0.6⌉)`（上限 research 6 / presentation **4** / architecture 3）；**相邻图表页不得同型**。**preferCoreFirst**：先拉开核图 8；advanced 计入 `minTypes`（不罚）但禁预读 `charts-extended.md`；**禁**为凑下限硬上冷门图、简单图全幅、极偏 donut/pie。
+
+**速记**：谁大谁小→`hbar` · 时间→`line`/`area` · 占比→`donut`（扇区>5/极偏改判）· 归因→`waterfall` · 转化→`funnel` · 流向→`sankey`。
 
 ---
 
@@ -261,24 +197,26 @@ python scripts/validate_pptx.py 2026-09-15-主题.pptx --strict --model=….mode
 
 ## 十、L2 节级路由（按任务只读这些，读完即停）
 
-> 默认生成面：`default-surface.md`（12 页型 + 8 图 + V1–V4）。Mode A 工艺清单：`presentation-craft.md`。
-> **不要整读** `components.md` / `charts.md` 背后的物理拆分大文件。需要代码时优先：
-> `python scripts/extract_snippet.py --list` · `--task <名>` · `--chart <类型>` · `--page-type <页型>` · `--file components.md --section 46`（逻辑名自动路由）
+> 常读仍为入口两份；演示路径可加 **L1.5 工艺双件**：`default-surface.md` + `presentation-craft.md`。
+> 默认生成面：`default-surface.md`（12 页型 + 8 图 + V1–V4）。Mode A 工艺：`presentation-craft.md`。插画：`illustration-layout.md`。
+>
+> **禁止整读（强制走 `extract_snippet.py`）**：`layouts-combo.md` · `components-atoms.md` · `charts-basic.md` · `charts-extended.md` · `content-rules.md` 全文 · `pptx-export.md` · 模式模板 HTML（`assets/templates/*.html`，走 `scaffold_report.py`）。
+> 取码：`python scripts/extract_snippet.py --list` · `--task <名>` · `--chart <类型>` · `--page-type <页型>` · `--file components.md --section 46`（逻辑名自动路由）
 
 | 任务 | 只读 |
 |------|------|
-| research 证据页 / Exhibit / 密表 | `components.md` §36d/§46/§46c · 本文件 §三/§四 · `extract_snippet.py --task research-evidence` |
-| 正式演示 / Mode A 工艺 | `default-surface.md` · `presentation-craft.md` · 本文件 §三-b/§五 |
+| research 证据页 / Exhibit / 密表 | `components.md` §36d/§46/§46c · 本文件 §三/§四 · `page-type-matrix.md` · `extract_snippet.py --task research-evidence` |
+| 正式演示 / Mode A 工艺 | `default-surface.md` · `presentation-craft.md` · 本文件 §三-b/§五 · `page-type-matrix.md` |
 | 演示组合版式 | `components.md` §39–§42/§46/§46b/§46c · `--task presentation-combo` |
 | 架构 / 泳道 / 分层 | `components.md` §37–§38b · `infographics.md` §78–§80 · `--task architecture-diagram` |
-| 选图 / 取图表代码 | 本文件 §五 · `--chart <类型>` · 误用见 `charts.md` §66 |
+| 选图 / 取图表代码 | 本文件 §五 · `chart-decision-tree.md` · `--chart <类型>` · 误用见 `charts.md` §66 |
 | 密度 / 字数 / 去 AI 味 | `content-rules.md` §一/§四 · 本文件 §六 · `--task content-rules` |
-| 素材图片 / 占位 | `components.md` §11c · `--task image-layout` |
+| 素材图片 / 占位 / 插画页 | `illustration-layout.md` · `components.md` §11c · `--task image-layout` |
 | PPTX 精导字段 | `pptx-export.md` · 本文件 §九 · `--task pptx-export` |
 | 高保真 / 锚点 | `high-fidelity.md` · `--task high-fidelity` |
 | 配色 / 风格 | `styles.md` · `design-system.md` §1a–§1b/§9 · `--task style-theme` |
 | 图标 / 语义速查 | `icons.md` · `--task icons` |
 | 起骨架用节奏包 | `scaffold_report.py --list-types` → `--preset consulting` 等 |
 
-**纪律**：L0+L1 是默认全部所需；上表命中才开 L2；**读完即执行，不预读下一份**。页型语义槽位见 `layout-constants.json` → `layoutSlots`（双通道同源 IR）。
+**纪律**：L0+L1 是默认全部所需（Mode A/Fast 可加 L1.5）；上表命中才开 L2；**读完即执行，不预读下一份**；大文件**禁止整读**，一律 `extract_snippet.py`。页型语义槽位见 `layout-constants.json` → `layoutSlots`（双通道同源 IR）。
 **维护者**：改常量/schema/引擎后必跑 `sync_runtime.py` → `audit_styles.py` → `audit_docs.py` → `audit_skill.py` → `build_examples.py` → `regression.py`。

package/top-ppt-html/references/presentation-craft.md

@@ -46,6 +46,14 @@ quality_gate.py … --deliver   # 同口径
 - [ ] `motion = none`；翻页靠内容节奏  
 
 
+## 插画页（非数据配图）
+
+- 情绪/产品/占位图与数据图**勿同页抢主位**；规则见 `illustration-layout.md`。
+- **安全边距** ≥24px；文字不压照片焦点；标签/图例不重叠。
+- **icon + chart**：icon 在注释列，不进绘图区。
+- **full-bleed + 主张叠字**（Mode A）：仅封面/章节幕/金句/收尾；遮罩保对比度；必有 caption/来源；证据另页。
+- 配图页写 **caption + so-what**（氛围休止页可免 so-what）；校验对缺项 WARN。
+
 ## 长文与信息承载（anti-truncation）
 
 > **硬原则**：大量文字**不得**为了「看起来像稀疏 demo 甲板」而被故意压缩或删除。留白是设计；**删掉证据 / so-what / 口径不是设计**。

package/top-ppt-html/references/tech-design.md

@@ -136,3 +136,9 @@
 | `evals/*` | Eval 框架：`prompts.csv`（14 条，含负对照）+ `rubric.schema.json`（风格目标评分契约）+ `run_evals.py`（结果/过程/风格/效率四类目标） |
 | `assets/templates/*` | 三模式模板 + 公共引擎/UI（标记块由 `sync_runtime.py` 注入） |
 | `assets/examples/*` | 示例矩阵（含信息图页型与原生图表技巧） |
+
+## 附：第三方校验与实验 frontmatter
+
+- **主门禁**：`audit_skill.py` / `package_skill.py --check`（体积、披露、Gate0、触发覆盖）。
+- **可选**：`npx --yes skills-ref@0.1.5 validate .`（Agent Skills 开放标准；本技能已通过）。**不**作为 CI 硬依赖。
+- **不启用**：Claude-only `when_to_use`（会破坏严格 allowlist）；跨端 `allowed-tools`（宿主语法分叉）——需要时由宿主侧实验，不进本仓库 frontmatter。

package/top-ppt-html/scripts/audit_docs.py

@@ -139,7 +139,7 @@ def main() -> int:
     # ⑤ 篇数与必需文件
     n_ref = len(list(REF.glob('*.md')))
     sk = (ROOT / 'SKILL.md').read_text(encoding='utf-8')
-    d = re.search(r'^description:\s*"(.*)"\s*$', sk, re.M | re.S)
+    d = re.search(r'^description:\s*"(.*)"\s*$', sk, re.M)
     dlen = len(d.group(1)) if d else -1
     nm = re.search(r'^name:\s*(\S+)\s*$', sk, re.M)
     missing = [r for r in REQUIRED if not (ROOT / r).exists()]

package/top-ppt-html/scripts/audit_skill.py

@@ -13,7 +13,7 @@
 
 审计项（任一不过 → 退出码 1）:
   ① 体积预算   —— SKILL.md / 常读入口 playbook.md / 单份 reference / 模式模板 的上限
-  ② 元数据     —— frontmatter name 与技能名一致；description ≤ DESC_HARD，且 ≤ DESC_SOFT（触发精度）
+  ② 元数据     —— frontmatter name 与技能名一致；description ≤ DESC_HARD/SOFT；可选 license/compatibility/metadata（开放标准）
   ③ 披露分层   —— SKILL.md 必须声明 L0/L1/L2 三档，且 L1（常读入口）恰好 1 份
   ④ 交互门禁   —— SKILL.md 必须含「Gate 0 参考图先行」，且其出现位置在「六项问询」之前；若声明 Fast Mode，须同时有豁免句且标准路径仍为硬门禁
   ⑤ 效率预算   —— SKILL.md 必须显式声明交互轮次上限与必读文件数上限
@@ -139,7 +139,7 @@ def main() -> int:
         f'最大 {kb(max((p.stat().st_size for p in TPL.glob("*.html")), default=0))} / 上限 {kb(BUDGET["template"])}')
 
     # ② 元数据
-    d = re.search(r'^description:\s*"(.*)"\s*$', sk, re.M | re.S)
+    d = re.search(r'^description:\s*"(.*)"\s*$', sk, re.M)
     dlen = len(d.group(1)) if d else -1
     nm = re.search(r'^name:\s*(\S+)\s*$', sk, re.M)
     chk('② name 一致', bool(nm) and nm.group(1) == NAME,
@@ -149,9 +149,37 @@ def main() -> int:
     chk('② description 软上限（触发精度）', 0 < dlen <= BUDGET['desc_soft'],
         f'{dlen} / 建议 ≤ {BUDGET["desc_soft"]}')
 
+    # ②b 开放标准可选 frontmatter（允许额外键；校验存在与粗约束）
+    lic = re.search(r'^license:\s*(.+)$', sk, re.M)
+    chk('② license', bool(lic) and 'MIT' in (lic.group(1) if lic else ''),
+        '缺 license: MIT（开放标准可选，本技能应对齐 package.json）',
+        'license=MIT')
+    compat = re.search(r'^compatibility:\s*"(.*)"\s*$', sk, re.M | re.S)
+    clen = len(compat.group(1)) if compat else -1
+    chk('② compatibility', 0 < clen <= 500,
+        f'compatibility 缺失或超 500 字符（{clen}）',
+        f'{clen} 字符')
+    meta_ver = re.search(r'^\s+version:\s*"?([\w.\-]+)"?\s*$', sk, re.M)
+    meta_author = re.search(r'^\s+author:\s*(\S+)\s*$', sk, re.M)
+    pkg_ver = ''
+    try:
+        import json as _json
+        pkg_ver = str(_json.loads((ROOT / 'package.json').read_text(encoding='utf-8')).get('version') or '')
+    except Exception:
+        pass
+    chk('② metadata.version', bool(meta_ver) and (not pkg_ver or meta_ver.group(1) == pkg_ver),
+        f'metadata.version 缺失或与 package.json 不一致（fm={meta_ver.group(1) if meta_ver else None} pkg={pkg_ver})',
+        f'{meta_ver.group(1) if meta_ver else "?"}')
+    chk('② metadata.author', bool(meta_author),
+        '缺 metadata.author',
+        meta_author.group(1) if meta_author else '')
+
     # ③ 渐进式披露分层（机器可读标记：L0=… · L1=… · L2=…）
-    m_l1 = re.search(r'L1\s*=\s*`?([^`\s·|]+)`?', sk)
-    has_l0 = bool(re.search(r'L0\s*=', sk))
+    # Prefer machine-readable disclosure marker `L1=references/...`（忽略正文「L0+L1 共 2」等）
+    m_l1 = re.search(r'L1\s*=\s*`?(references/[a-z0-9\-./]+\.md)`?', sk)
+    if not m_l1:
+        m_l1 = re.search(r'L1\s*=\s*`?([^`\s·|]+)`?', sk)
+    has_l0 = bool(re.search(r'L0\s*=\s*`?SKILL', sk)) or bool(re.search(r'`L0=SKILL', sk))
     has_l2 = bool(re.search(r'L2\s*=', sk))
     l1_files = [f.strip() for f in re.split(r'[,、]', m_l1.group(1)) if f.strip()] if m_l1 else []
     chk('③ 披露分层 L0/L1/L2', has_l0 and has_l2 and len(l1_files) == BUDGET['l1_files'],

package/top-ppt-html/scripts/check_triggers.py

@@ -0,0 +1,153 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""TopPPT HTML · description trigger coverage (keyword/heuristic, no LLM).
+
+Gates regressions when SKILL.md description drifts away from eval queries.
+See evals/trigger-queries.json → how_to_extend.
+
+Usage:
+    python3 scripts/check_triggers.py
+    python3 scripts/check_triggers.py --json
+"""
+from __future__ import annotations
+
+import json
+import re
+import sys
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent.parent
+SKILL = ROOT / 'SKILL.md'
+QUERIES = ROOT / 'evals' / 'trigger-queries.json'
+
+# Tokens that, if present in a query AND in description (or Do-NOT zone for negatives),
+# count toward a hit. Multi-char CJK / ASCII keywords preferred over single chars.
+POS_KEYWORDS = [
+    '报告', '演示', '汇报', '路演', '调研', '白皮书', '评测', '对标', '经营分析', '复盘',
+    'PPT', 'PPTX', 'pptx', 'slides', 'deck', 'HTML', '网页报告',
+    '架构图', '拓扑', '流程图', '泳道', '方案图',
+    '排版', '版式', '配色', '图文',
+    '快速模式', 'fast', '一键出稿', '直接生成', '少问一句',
+    '可视化', '高保真', '可编辑',
+    '咨询报告', '分析报告', '研究报告', '项目汇报', '商务',
+]
+
+# Negative-zone cues in description (Do NOT …) — if a miss-query matches these
+# boundary phrases more than positive product cues, treat as correctly excluded.
+NEG_BOUNDARY = [
+    '纯代码', '代码工程', '非报告类', '视频', '图片生成',
+    'Word', '源文件', '应用开发', 'coding', 'Do NOT',
+]
+
+# Extra strong negative query cues (if query has these AND lacks report cues → expect miss)
+NEG_QUERY_CUES = [
+    'react', '组件', '单测', 'debug', 'python 报错', '视频', 'mp4', 'midjourney',
+    '海报图', '已有的 pptx', '已有 pptx', 'word 文档', '电商官网', 'sql',
+    'nginx', 'refactor', 'typescript', '剪辑', '录像', '字幕', '迁移脚本',
+]
+
+
+def load_description() -> str:
+    txt = SKILL.read_text(encoding='utf-8')
+    m = re.search(r'^description:\s*"(.*)"\s*$', txt, re.M)
+    if not m:
+        raise SystemExit('SKILL.md missing description frontmatter')
+    return m.group(1)
+
+
+def tokenize_hits(query: str, desc: str) -> list[str]:
+    q_low = query.lower()
+    d_low = desc.lower()
+    hits = []
+    for kw in POS_KEYWORDS:
+        if kw.lower() in q_low and kw.lower() in d_low:
+            hits.append(kw)
+    return hits
+
+
+def looks_negative_query(query: str) -> bool:
+    q = query.lower()
+    return any(c in q for c in NEG_QUERY_CUES)
+
+
+def boundary_covered(desc: str) -> bool:
+    return sum(1 for b in NEG_BOUNDARY if b.lower() in desc.lower()) >= 2
+
+
+def evaluate(desc: str, data: dict) -> tuple[list[dict], int, int]:
+    rows = []
+    fails = 0
+    for bucket, default_expect in (('positive', 'hit'), ('negative', 'miss')):
+        for item in data.get(bucket, []):
+            q = item['query']
+            expect = item.get('expect', default_expect)
+            hits = tokenize_hits(q, desc)
+            if expect == 'hit':
+                ok = len(hits) >= 1
+                detail = f'keywords={hits}' if ok else 'no shared trigger keyword with description'
+            else:
+                # miss: either no positive keyword overlap, OR query is clearly
+                # out-of-scope and description has Do-NOT boundaries.
+                ok = (len(hits) == 0) or (
+                    looks_negative_query(q) and boundary_covered(desc) and len(hits) <= 1
+                )
+                # Stricter: if query is a known out-of-scope cue, require miss even
+                # when a weak overlapping token exists (e.g. "pptx" in "改已有 pptx").
+                if looks_negative_query(q) and boundary_covered(desc):
+                    ok = True
+                detail = (
+                    f'miss-ok boundary; weak_hits={hits}' if ok
+                    else f'unexpected trigger overlap={hits}'
+                )
+            rows.append({
+                'id': item.get('id'),
+                'expect': expect,
+                'ok': ok,
+                'query': q,
+                'detail': detail,
+            })
+            if not ok:
+                fails += 1
+    return rows, fails, len(rows)
+
+
+def main() -> int:
+    as_json = '--json' in sys.argv
+    if not QUERIES.exists():
+        print(f'MISSING {QUERIES}')
+        return 1
+    data = json.loads(QUERIES.read_text(encoding='utf-8'))
+    desc = load_description()
+    rows, fails, total = evaluate(desc, data)
+    n_pos = sum(1 for r in rows if r['expect'] == 'hit')
+    n_neg = sum(1 for r in rows if r['expect'] == 'miss')
+    if as_json:
+        print(json.dumps({
+            'total': total, 'fails': fails,
+            'positive': n_pos, 'negative': n_neg,
+            'description_chars': len(desc),
+            'rows': rows,
+        }, ensure_ascii=False, indent=2))
+    else:
+        print(f'trigger coverage · {total - fails}/{total}  '
+              f'(+{n_pos} / −{n_neg}) · description {len(desc)} chars')
+        for r in rows:
+            mark = 'OK' if r['ok'] else 'FAIL'
+            print(f'  [{mark}] {r["id"]} expect={r["expect"]}  {r["detail"]}')
+            if not r['ok']:
+                print(f'         Q: {r["query"]}')
+        if fails:
+            print(f'\nFAILED {fails} query(ies). Extend keywords in SKILL description '
+                  f'or adjust evals/trigger-queries.json (see how_to_extend).')
+        else:
+            print('\nAll trigger heuristics passed.')
+    return 1 if fails else 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())

package/top-ppt-html/scripts/negative_tests.py

@@ -23,6 +23,7 @@
   L4  截断迹象（列表项省略号砍义）
   L5  溢出未拆页
   L6  混排缺对齐（ALIGN_RHYTHM）
+  N18 配图页缺 caption/图注（IMAGE_CAPTION）
 
 用法: python scripts/negative_tests.py
 """
@@ -176,6 +177,15 @@ def main() -> int:
             '"footnote": "<strong>x</strong> ', 1)
     cases.append(('N17 模型夹带标签', t17, 'HTML_TAG_IN_TEXT'))
 
+    # N18 配图页缺 caption（有 <img>/media 无图注类）
+    t18 = txt.replace(
+        '</body>',
+        '<section class="band" data-page-type="image">'
+        '<div class="media media--full">'
+        '<img src="data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7" alt="注入无图注">'
+        '</div></section></body>', 1)
+    cases.append(('N18 配图缺 caption', t18, 'IMAGE_CAPTION'))
+
     ok = True
     for name, content, keyword in cases:
         if content == txt:

package/top-ppt-html/scripts/package_skill.py

@@ -87,6 +87,7 @@ INCLUDE = [
     'references/*',
     'scripts/*',
     'evals/*',
+    'agents/*',
 ]
 
 # 出包规则（命中即跳过；与 .gitignore 口径一致）
@@ -120,6 +121,9 @@ REQUIRED = [
     'references/layout-grammar.md',
     'references/default-surface.md',
     'references/presentation-craft.md',
+    'references/illustration-layout.md',
+    'references/page-type-matrix.md',
+    'references/chart-decision-tree.md',
     'references/modes.md', 'references/outline-design.md', 'references/design-system.md',
     'references/styles.md', 'references/content-rules.md', 'references/components.md',
     'references/charts.md',
@@ -145,13 +149,15 @@ REQUIRED = [
     'references/infographics-stats.md', 'references/infographics-structure.md',
     'evals/prompts.csv', 'evals/run_evals.py', 'evals/rubric.schema.json',
     'evals/trace.example.json',
+    'evals/trigger-queries.json',
+    'scripts/check_triggers.py',
 ]
 
 # 必须达到最小数量的集合（名称含日期，故按数量校验）
 MIN_COUNTS = {
     'assets/examples/*.html': 3,  # Batch3 每模式 1 份黄金样张
     'assets/examples/*.model.json': 3,
-    'references/*.md': 22,  # craft 轮后含 default-surface + presentation-craft；≥22 防误删
+    'references/*.md': 25,  # + page-type-matrix + chart-decision-tree；≥25 防误删
 }
 
 
@@ -255,6 +261,16 @@ def main():
         return 1
     print('  校验通过：必需文件齐全 · frontmatter 合规 · 无临时/缓存路径')
 
+    # P0-1 trigger heuristic gate（廉价、无 LLM）
+    trig = ROOT / 'scripts' / 'check_triggers.py'
+    if trig.exists():
+        import subprocess
+        r = subprocess.run([sys.executable, str(trig)], cwd=str(ROOT))
+        if r.returncode != 0:
+            print('  ✗ trigger coverage 失败（evals/trigger-queries.json）')
+            return 1
+        print('  ✓ trigger coverage 通过')
+
     if check_only:
         print('\n(--check 模式：仅校验，不打包)')
         return 0

package/top-ppt-html/scripts/validate_report.py

@@ -1215,6 +1215,33 @@ def _check_media(txt, chk, model):
         chk("模型配图占位 ↔ 正文 .media--ph 对应", False,
             f"{n_ph} 页模型声明 image.placeholder 但正文无 .media--ph", level="WARN")
 
+    # 配图页 caption / so-what（廉价 WARN）；近邻主张/导语亦可
+    bands = re.split(r'(?=<section\b)', txt)
+    miss_cap = []
+    near_empty = []
+    for i, b in enumerate(bands):
+        if not re.search(r'class="[^"]*\bmedia\b|<img\b|class="[^"]*media--', b):
+            continue
+        if len(b) < 80:
+            continue
+        has_cap = bool(re.search(
+            r'class="[^"]*(?:fig__cap|media__cap|media__ph|caption|exhibit__src|footnote|so-what|lead)', b)
+            or re.search(r'<figcaption\b|class="[^"]*\bsoWhat\b', b))
+        if not has_cap:
+            miss_cap.append(f'band[{i}]')
+        # 近图过空：有 media 但正文文本极少且无要点/指标（WARN）
+        textish = re.sub(r'<script[\s\S]*?</script>|<style[\s\S]*?</style>|<[^>]+>', ' ', b)
+        textish = re.sub(r'\s+', ' ', textish).strip()
+        has_points = bool(re.search(r'class="[^"]*(?:points|bullets|kpi|metrics|card)', b))
+        if len(textish) < 40 and not has_points and not re.search(r'media--ph', b):
+            near_empty.append(f'band[{i}]')
+    chk("配图页含 caption/图注（IMAGE_CAPTION）", not miss_cap,
+        f"{len(miss_cap)} 处配图区缺 .fig__cap/.media__cap/.footnote/so-what 等图注" if miss_cap else "",
+        level="WARN")
+    chk("配图页近邻过空（IMAGE_NEAR_EMPTY）", not near_empty,
+        f"{len(near_empty)} 处配图页几乎无注解/要点（补 caption 或要点条）" if near_empty else "",
+        level="WARN")
+
 
 # 失败检查项 → 失败模式 / 处置动作 / 精确取码命令。
 # 目的：校验失败时直接给出「改什么、按什么顺序改、去哪取代码」，