@topmindspace/tms-skills 0.1.1 → 0.1.3

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

@@ -20,6 +20,10 @@
   N12 模型 theme 与 data-theme 矛盾
   N13 模型 mode 与 data-mode 矛盾
   N14 内部锚点断裂（链接目标 id 不存在）
+  L4  截断迹象（列表项省略号砍义）
+  L5  溢出未拆页
+  L6  混排缺对齐（ALIGN_RHYTHM）
+  N18 配图页缺 caption/图注（IMAGE_CAPTION）
 
 用法: python scripts/negative_tests.py
 """
@@ -62,6 +66,25 @@ def expect_fail(name: str, path: Path, keyword: str) -> bool:
     return ok
 
 
+
+def expect_layout_qa_fail(name: str, path: Path, keyword: str) -> bool:
+    """Run validate_report --strict --layout-qa and require FAIL containing keyword."""
+    r = subprocess.run(
+        [PY, str(ROOT / 'scripts' / 'validate_report.py'), str(path),
+         '--strict', '--layout-qa'],
+        capture_output=True, text=True, encoding='utf-8', errors='replace')
+    out = (r.stdout or '') + (r.stderr or '')
+    hit = [ln for ln in out.splitlines()
+           if keyword in ln and ('[FAIL]' in ln or 'FAIL' in ln)]
+    ok = r.returncode != 0 and bool(hit)
+    print(f'  [{"OK" if ok else "FAIL"}] {name}')
+    if hit:
+        print(f'        抓到: {hit[0].strip()[:120]}')
+    elif not ok:
+        print(f'        layout-qa 未触发（期望含「{keyword}」）')
+    return ok
+
+
 def main() -> int:
     base = ROOT / 'assets' / 'examples' / '2026-09-09-research-mckinsey.html'
     if not base.exists():
@@ -154,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:
@@ -163,7 +195,111 @@ def main() -> int:
         p.write_text(content, encoding='utf-8')
         ok = expect_fail(name, p, keyword) and ok
 
-    ok = _pptx_notes_case() and ok
+
+    # ── Batch 2 · layout-qa 专用负例 ─────────────────────────────────────
+    # L1 管线产物缺 data-skel：先造带 skel 的页，再撕掉其中一页的标记
+    import tempfile
+    scaf = OUT / 'L1-scaffold.html'
+    subprocess.run(
+        [PY, str(ROOT / 'scripts' / 'scaffold_report.py'),
+         '--mode', 'presentation', '--style', 'business-blue', '--theme', 'light',
+         '--title', 'LayoutQA Neg', '--sections', '5', '--out', str(scaf)],
+        capture_output=True, text=True)
+    if scaf.exists() and 'data-skel="' in scaf.read_text(encoding='utf-8'):
+        t_l1 = scaf.read_text(encoding='utf-8')
+        # 撕掉第一个内容页的 data-skel
+        t_l1b = re.sub(r'(id="s1") data-skel="P\d+"', r'\1', t_l1, count=1)
+        p_l1 = OUT / 'L1-missing-skel.html'
+        p_l1.write_text(t_l1b, encoding='utf-8')
+        ok = expect_layout_qa_fail('L1 缺 data-skel', p_l1, 'LAYOUT_QA_MISSING_SKEL') and ok
+        # L2 连续 3 页同一 skel
+        t_l2 = t_l1
+        # force s1,s2,s3 all P4
+        t_l2 = re.sub(r'(id="s1"[^>]*data-skel=")P\d+"', r'\1P4"', t_l2, count=1)
+        t_l2 = re.sub(r'(id="s2"[^>]*data-skel=")P\d+"', r'\1P4"', t_l2, count=1)
+        t_l2 = re.sub(r'(id="s3"[^>]*data-skel=")P\d+"', r'\1P4"', t_l2, count=1)
+        # also rewrite if attribute order is data-skel before id
+        t_l2 = re.sub(r'(data-skel=")P\d+(" data-page-type="[^"]+" id="s1")', r'\1P4\2', t_l2)
+        t_l2 = re.sub(r'(data-skel=")P\d+("([^>]*) id="s1")', r'\1P4\2', t_l2)
+        # simpler: replace first three data-skel values
+        def _force_p4(src, n=3):
+            out, c = [], 0
+            for part in re.split(r'(data-skel="P\d+")', src):
+                if part.startswith('data-skel="') and c < n:
+                    out.append('data-skel="P4"'); c += 1
+                else:
+                    out.append(part)
+            return ''.join(out)
+        t_l2 = _force_p4(t_l1, 3)
+        p_l2 = OUT / 'L2-skel-streak.html'
+        p_l2.write_text(t_l2, encoding='utf-8')
+        ok = expect_layout_qa_fail('L2 连续同 skel', p_l2, 'LAYOUT_QA_SKEL_STREAK') and ok
+        # L3 极偏 donut in REPORT_MODEL
+        t_l3 = t_l1
+        if 'window.REPORT_MODEL' in t_l3:
+            # inject a skewed donut section into model JSON
+            inj = (
+                '{"type":"donut","title":"极偏环",'
+                '"chart":{"type":"donut","labels":["A","B"],"values":[0.5,99.5]}},'
+            )
+            t_l3 = re.sub(r'("sections"\s*:\s*\[)', r'\1' + inj, t_l3, count=1)
+            p_l3 = OUT / 'L3-skew-donut.html'
+            p_l3.write_text(t_l3, encoding='utf-8')
+            ok = expect_layout_qa_fail('L3 极偏 donut', p_l3, 'LAYOUT_QA_SKEW_DONUT') and ok
+
+        # L4 截断迹象：列表项以省略号砍义
+        t_l4 = t_l1
+        inj4 = '<div class="card"><ul><li class="card__li">这项证据其实很长但被故意截断了…</li></ul></div>'
+        t_l4 = re.sub(r'(id="s1"[^>]*>)', lambda m: m.group(1) + inj4, t_l4, count=1)
+        p_l4 = OUT / 'L4-truncation.html'
+        p_l4.write_text(t_l4, encoding='utf-8')
+        ok = expect_layout_qa_fail('L4 截断迹象', p_l4, 'LAYOUT_QA_TRUNCATION') and ok
+
+        # L5 溢出未拆页：塞入超长正文使页高估算爆掉且无续页信号
+        t_l5 = t_l1
+        wall = '论证要点' + ('详细证据与口径说明，必须完整保留不得删减。' * 40)
+        t_l5 = re.sub(
+            r'(id="s1"[^>]*>)',
+            lambda m: m.group(1) + '<div class="card"><p>' + wall + '</p></div>'
+                 + '<div class="card"><p>' + wall + '</p></div>'
+                 + '<div class="card"><p>' + wall + '</p></div>',
+            t_l5, count=1)
+        p_l5 = OUT / 'L5-overflow-nosplit.html'
+        p_l5.write_text(t_l5, encoding='utf-8')
+        ok = expect_layout_qa_fail('L5 溢出未拆页', p_l5, 'LAYOUT_QA_OVERFLOW_NO_SPLIT') and ok
+
+        # L6 混排缺对齐：图+卡同页但无对齐类
+        t_l6 = t_l1
+        inj6 = (
+            '<div class="grid g-2">'
+            '<div class="fig"><svg class="chart" data-chart="bar" style="height:200px"></svg></div>'
+            '<div class="card"><ul><li>证据甲</li><li>证据乙</li></ul></div>'
+            '</div>'
+        )
+        t_l6 = re.sub(r'(id="s1"[^>]*>)', lambda m: m.group(1) + inj6, t_l6, count=1)
+        # 撕掉 s1 段内对齐类，确保 ALIGN_RHYTHM 能抓住
+        def _strip_align_s1(src: str) -> str:
+            m = re.search(r'(<section[^>]*id="s1"[^>]*>)([\s\S]*?)(</section>)', src)
+            if not m:
+                # attribute order may be data-skel before id
+                m = re.search(r'(<section[^>]*id="s1"[^>]*>)([\s\S]*?)(</section>)', src)
+            if not m:
+                return src
+            body = m.group(2)
+            body = re.sub(r'\ba-start\b', '', body)
+            body = re.sub(r'\ba-c\b', '', body)
+            body = re.sub(r'\ba-end\b', '', body)
+            body = body.replace('align-items:start', '').replace('align-items: center', '')
+            return src[:m.start()] + m.group(1) + body + m.group(3) + src[m.end():]
+        t_l6 = _strip_align_s1(t_l6)
+        p_l6 = OUT / 'L6-align-rhythm.html'
+        p_l6.write_text(t_l6, encoding='utf-8')
+        ok = expect_layout_qa_fail('L6 混排缺对齐', p_l6, 'LAYOUT_QA_ALIGN_RHYTHM') and ok
+
+    else:
+        print('  [SKIP] layout-qa 负例（scaffold 未产出 data-skel）')
+
+        ok = _pptx_notes_case() and ok
     ok = _chart_data_case() and ok
     ok = _title_pattern_case() and ok
     ok = _font_scale_case() and ok

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

@@ -17,14 +17,14 @@
     README.md                      人类视角的简介 / 安装 / 开发 / 打包
     package.json                   Node 依赖声明（pptxgenjs）与常用命令
     assets/templates/              三份模式模板 + engine.css / ui.js（公共片段注入源）
-    assets/examples/               9 份示例 HTML + 9 份 REPORT_MODEL（复制起点 · 覆盖全部 9 风格）
+    assets/examples/               3 份黄金样张 HTML + model（每模式 1；风格见 style-gallery）
     assets/pptx-export.js          PPTX 预览运行时（注入源）
     assets/style-gallery.html      风格 × 模式 × 亮暗主题交互画廊
     assets/theme-overview*.png     3 张主题参考图（整体 + research + architecture；演示态与整体图相同）
-    references/*.md                15 篇规范（playbook.md = 唯一常读入口 L1；其余 L2 按需加载）
+    references/*.md                规范全文（Batch3 起 ≥20 篇；playbook.md = L1；其余 L2 按需）
     scripts/                         生成 / 校验 / 回归 / 维护工具（py + js + json 单源）
     scripts/extract_snippet.py       L2 节级片段抽取（减少整读大规范）
-    scripts/layout_slots.json        页型布局 IR（高频页型语义槽位）
+    # layoutSlots 已并入 layout-constants.json（Batch 3）
 
 ────────────────────────────────────────────────────────────────────────
 不进包（构建产物 / 本地状态 / 缓存，与 .gitignore 口径一致）
@@ -42,7 +42,7 @@
 ────────────────────────────────────────────────────────────────────────
     · SKILL.md frontmatter 含 name / description；name 与分发包目录名一致；
       description 为单行双引号字符串且 ≤ 1024 字符（平台截断阈值）
-    · references（含 layout-grammar）、3 份模式模板 + engine.css / ui.js、9 组示例、3 张参考图齐全
+    · references（含 layout-grammar）、3 份模式模板 + engine.css / ui.js、3 组黄金样张、3 张参考图齐全
     · 关键脚本齐全（单源注入 / 审计 / 示例重建 / 回归 / 双校验器 / 精导 / 打包）
 """
 import fnmatch
@@ -87,6 +87,7 @@ INCLUDE = [
     'references/*',
     'scripts/*',
     'evals/*',
+    'agents/*',
 ]
 
 # 出包规则（命中即跳过；与 .gitignore 口径一致）
@@ -118,37 +119,45 @@ REQUIRED = [
     'assets/templates/ui.js',
     'references/playbook.md',
     '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',
     'references/infographics.md', 'references/icons.md', 'references/pptx-export.md',
     'references/high-fidelity.md', 'references/failure-modes.md',
-    'references/tech-design.md', 'references/industry-benchmark.md',
+    'references/tech-design.md',
     'scripts/env_probe.py', 'scripts/audit_docs.py', 'scripts/audit_skill.py',
     'scripts/scaffold_report.py',
+    'scripts/render_from_model.py',
+    'scripts/recommend_layout.py',
     'scripts/sync_runtime.py', 'scripts/audit_styles.py', 'scripts/build_examples.py',
     'scripts/regression.py', 'scripts/validate_report.py', 'scripts/validate_pptx.py',
     'scripts/extract_model.py', 'scripts/build_pptx.js', 'scripts/gen_channel_a.js',
     'scripts/cross_verify.py', 'scripts/prepare_images.py', 'scripts/probe_image_export.py',
     'scripts/render_compare.py', 'scripts/capture_theme_overview.js', 'scripts/package_skill.py',
-    'scripts/layout-constants.json', 'scripts/model-schema.json', 'scripts/layout_slots.json',
+    'scripts/layout-constants.json', 'scripts/model-schema.json',
     'scripts/lib_layout_regions.js', 'scripts/extract_snippet.py', 'scripts/quality_gate.py',
     'scripts/checks_html.py', 'scripts/section-file-map.json',
     'scripts/measure_height.py', 'scripts/audit_css.py', 'scripts/negative_tests.py',
     'references/components-atoms.md', 'references/layouts-research.md',
     'references/layouts-architecture.md', 'references/layouts-combo.md',
     'references/charts-basic.md', 'references/charts-extended.md', 'references/charts-discipline.md',
-    'references/design-system-engine.md',
     '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': 9,
-    'assets/examples/*.model.json': 9,
-    'references/*.md': 15,
+    'assets/examples/*.html': 3,  # Batch3 每模式 1 份黄金样张
+    'assets/examples/*.model.json': 3,
+    'references/*.md': 25,  # + page-type-matrix + chart-decision-tree；≥25 防误删
 }
 
 
@@ -252,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/quality_gate.py

@@ -4,6 +4,7 @@
 
 用法:
     python scripts/quality_gate.py report.html
+    # Mode A / presentation 自动对 validate_report 附加 --layout-qa
     python scripts/quality_gate.py report.html --pptx report.pptx --model report.model.json
     python scripts/quality_gate.py report.html --trace trace.json --json
     python scripts/quality_gate.py report.html --require-rubric 60
@@ -241,10 +242,17 @@ def main() -> int:
     print(f'交付质量门禁 · {html.name}')
     print('-' * 60)
 
-    # ① HTML strict
-    rc, out, el = run([sys.executable, str(ROOT / 'scripts' / 'validate_report.py'), str(html), '--strict'])
+    # ① HTML strict（Mode A / presentation 自动附带 --layout-qa）
+    head_snip = html.read_text(encoding='utf-8')[:2500]
+    mode_m = re.search(r'data-mode="([^"]+)"', head_snip)
+    mode = mode_m.group(1) if mode_m else 'presentation'
+    vcmd = [sys.executable, str(ROOT / 'scripts' / 'validate_report.py'), str(html), '--strict']
+    if mode == 'presentation':
+        vcmd.append('--layout-qa')
+    rc, out, el = run(vcmd)
+    gate_name = 'validate_report --strict' + (' --layout-qa' if mode == 'presentation' else '')
     tail = [ln for ln in out.splitlines() if ln.startswith('PASS ') or ln.startswith('结论')]
-    gate('validate_report --strict', rc == 0, tail[-1] if tail else f'exit {rc}', el)
+    gate(gate_name, rc == 0, tail[-1] if tail else f'exit {rc}', el)
 
     # ② PPTX strict（可选）
     if args.pptx: