@research-copilot/plugin 1.1.17 → 1.1.19

package/dist/skills/paper-plan/SKILL.md

@@ -0,0 +1,278 @@
+---
+name: "paper-plan"
+description: "Generate a structured paper outline from review conclusions and experiment results. Use when user says \\\"\u5199\u5927\u7eb2\\\", \\\"paper outline\\\", \\\"plan the paper\\\", \\\"\u8bba\u6587\u89c4\u5212\\\", or wants to create a paper plan before writing."
+---
+
+# Paper Plan: From Review Conclusions to Paper Outline
+
+Generate a structured, section-by-section paper outline from: **$ARGUMENTS**
+
+## Constants
+
+- **REVIEWER_MODEL = `gpt-5.5`** — Model used via a secondary Codex agent for outline review. Must be an OpenAI model.
+- **TARGET_VENUE = `ICLR`** — Default venue. User can override (e.g., `/paper-plan "topic" — venue: NeurIPS`). Supported: `ICLR`, `NeurIPS`, `ICML`, `CVPR`, `ACL`, `AAAI`, `ACM`, `IEEE_JOURNAL` (IEEE Transactions / Letters), `IEEE_CONF` (IEEE conferences).
+- **MAX_PAGES** — Page limit. For ML conferences: main body to Conclusion end (excluding references, appendix). ICLR=9, NeurIPS=9, ICML=8, AAAI=7 technical-content pages plus references unless the current AAAI CFP says otherwise. **For IEEE venues: references ARE included in page count.** IEEE journal Transactions ≈ 12-14 pages total, Letters ≈ 4-5 pages total; IEEE conference ≈ 5-8 pages total (including references).
+
+## Inputs
+
+The skill expects one or more of these in the project directory:
+
+1. **NARRATIVE_REPORT.md** or **STORY.md** — research narrative with claims and evidence
+2. **review-stage/AUTO_REVIEW.md** — auto-review loop conclusions *(fall back to `./AUTO_REVIEW.md` if not found)*
+3. **Experiment results** — JSON files in `figures/`, screen logs, tables
+4. **idea-stage/IDEA_REPORT.md** — from idea-discovery pipeline (if applicable) *(fall back to `./IDEA_REPORT.md` if not found)*
+5. **CLAIMS_FROM_RESULTS.md** — structured claim judgment from `/result-to-claim` (preferred if available)
+
+If none exist, ask the user to describe the paper's contribution in 3-5 sentences.
+
+## Orchestra-Guided Writing Overlay
+
+Keep the existing workflow and outputs, but use the shared references below to improve the quality of the story and outline:
+
+- Read `../shared-references/writing-principles.md` when framing the Abstract, Introduction, Related Work, or hero figure
+- Read `../shared-references/venue-checklists.md` before freezing the outline for a specific venue
+- Load these references only when they help; they are support material, not a new workflow phase
+
+## Workflow
+
+### Step 1: Extract Claims and Evidence
+
+**First check for `CLAIMS_FROM_RESULTS.md`** — if it exists, use it as the starting point for claims and merge it with any additional evidence from the narrative documents below.
+
+Read all available narrative documents and extract:
+
+1. **Core claims** (3-5 main contributions)
+2. **Evidence** for each claim (which experiments, which metrics, which figures)
+3. **Known weaknesses** (from reviewer feedback)
+4. **Suggested framing** (from review conclusions)
+
+Build a **Claims-Evidence Matrix**:
+
+```markdown
+| Claim | Evidence | Status | Section |
+|-------|----------|--------|---------|
+| [claim 1] | [exp A, metric B] | Supported | §3.2 |
+| [claim 2] | [exp C] | Partially supported | §4.1 |
+```
+
+### Step 2: Determine Paper Type and Structure
+
+Based on TARGET_VENUE and paper content, classify and select structure.
+
+Before committing to a structure, apply the narrative principle from `../shared-references/writing-principles.md`:
+
+- The paper should tell one coherent technical story
+- By the end of the Introduction, the outline should make the **What**, **Why**, and **So What** explicit
+- Front-load the most important material: title, abstract, introduction, and hero figure
+
+**IMPORTANT**: The section count is FLEXIBLE (5-8 sections). Choose what fits the content best. The templates below are starting points, not rigid constraints.
+
+**Empirical/Diagnostic paper:**
+```
+1. Introduction (1.5 pages)
+2. Related Work (1 page)
+3. Method / Setup (1.5 pages)
+4. Experiments (3 pages)
+5. Analysis / Discussion (1 page)
+6. Conclusion (0.5 pages)
+```
+
+**Theory + Experiments paper:**
+```
+1. Introduction (1.5 pages)
+2. Related Work (1 page)
+3. Preliminaries & Modeling (1.5 pages)
+4. Experiments (1.5 pages)
+5. Theory Part A (1.5 pages)
+6. Theory Part B (1.5 pages)
+7. Conclusion (0.5 pages)
+— Total: 9 pages
+```
+Theory papers often need 7 sections (splitting theory into estimation + optimization, or setup + analysis). The total page budget MUST sum to MAX_PAGES.
+
+Theory papers should:
+- Include **proof sketch** locations (not just theorem statements)
+- Plan a **comparison table** of prior theoretical bounds vs. this paper's bounds
+- Identify which proofs go in appendix vs. main body
+
+**Method paper:**
+```
+1. Introduction (1.5 pages)
+2. Related Work (1 page)
+3. Method (2 pages)
+4. Experiments (2.5 pages)
+5. Ablation / Analysis (1 page)
+6. Conclusion (0.5 pages)
+```
+
+### Step 3: Section-by-Section Planning
+
+For each section, specify:
+
+```markdown
+### §0 Abstract
+- **One-sentence problem**: [what gap this paper addresses]
+- **Approach**: [what we do, in one sentence]
+- **Key result**: [most compelling quantitative finding]
+- **Implication**: [why it matters]
+- **Estimated length**: 150-250 words
+- **Self-contained check**: can a reader understand this without the paper?
+
+### §1 Introduction
+- **Opening hook**: [1-2 sentences that motivate the problem]
+- **Gap**: [what's missing in prior work]
+- **Key questions**: [the research questions this paper answers]
+- **Contributions**: [numbered list, matching Claims-Evidence Matrix]
+- **Hero figure**: [describe what Figure 1 should show — MUST include clear comparison if applicable]
+- **Estimated length**: 1.5 pages
+- **Key citations**: [3-5 papers to cite here]
+
+### §2 Related Work
+- **Subtopics**: [2-4 categories of related work]
+- **Positioning**: [how this paper differs from each category]
+- **Minimum length**: 1 full page (at least 3-4 paragraphs with substantive synthesis)
+- **Must NOT be just a list** — synthesize, compare, and position
+
+### §3 Method / Setup / Preliminaries
+- **Notation**: [key symbols and their meanings]
+- **Problem formulation**: [formal setup]
+- **Method description**: [algorithm, model, or experimental design]
+- **Formal statements**: [theorems, propositions if applicable]
+- **Proof sketch locations**: [which key steps appear here vs. appendix]
+- **Estimated length**: 1.5-2 pages
+
+### §4 Experiments / Main Results
+- **Figures planned**:
+  - Fig 1: [description, type: bar/line/table/architecture, WHAT COMPARISON it shows]
+  - Fig 2: [description]
+  - Table 1: [what it shows, which methods/baselines compared]
+- **Data source**: [which JSON files / experiment results]
+
+### §5 Conclusion
+- **Restatement**: [contributions rephrased, not copy-pasted from intro]
+- **Limitations**: [honest assessment — reviewers value this]
+- **Future work**: [1-2 concrete directions]
+- **Estimated length**: 0.5 pages
+```
+
+### Step 4: Figure Plan
+
+List every figure and table:
+
+```markdown
+## Figure Plan
+
+| ID | Type | Description | Data Source | Priority |
+|----|------|-------------|-------------|----------|
+| Fig 1 | Hero/Architecture | System overview + comparison | manual | HIGH |
+| Fig 2 | Line plot | Training curves comparison | figures/exp_A.json | HIGH |
+| Fig 3 | Bar chart | Ablation results | figures/ablation.json | MEDIUM |
+| Table 1 | Comparison table | Main results vs. baselines | figures/main_results.json | HIGH |
+| Table 2 | Theory comparison | Prior bounds vs. ours | manual | HIGH (theory papers) |
+```
+
+**CRITICAL for Figure 1 / Hero Figure**: Describe in detail what the figure should contain, including:
+- Which methods are being compared
+- What the visual difference should demonstrate
+- Caption draft that clearly states the comparison
+
+### Step 5: Citation Scaffolding
+
+For each section, list required citations:
+
+```markdown
+## Citation Plan
+- §1 Intro: [paper1], [paper2], [paper3] (problem motivation)
+- §2 Related: [paper4]-[paper10] (categorized by subtopic)
+- §3 Method: [paper11] (baseline), [paper12] (technique we build on)
+```
+
+**Citation rules** (from claude-scholar + Imbad0202/academic-research-skills):
+1. NEVER generate BibTeX from memory — always verify via search or existing .bib files
+2. Every citation must be verified: correct authors, year, venue
+3. Flag any citation you're unsure about with `[VERIFY]`
+4. Prefer published versions over arXiv preprints when available
+
+### Step 6: Cross-Review with REVIEWER_MODEL
+
+Send the complete outline to GPT-5.5 xhigh for feedback:
+
+```
+spawn_agent:
+  model: gpt-5.5
+  reasoning_effort: xhigh
+  message: |
+    Review this paper outline for a [VENUE] submission.
+    [full outline including Claims-Evidence Matrix]
+
+    Score 1-10 on:
+    1. Logical flow — does the story build naturally?
+    2. Claim-evidence alignment — every claim backed?
+    3. Missing experiments or analysis
+    4. Positioning relative to prior work
+    5. Page budget feasibility (MAX_PAGES = main body to Conclusion end, excluding refs/appendix)
+
+    For each weakness, suggest the MINIMUM fix.
+    Be specific and actionable — "add X" not "consider more experiments".
+```
+
+Apply feedback before finalizing.
+
+### Step 7: Output
+
+Save the final outline to `PAPER_PLAN.md` in the project root:
+
+```markdown
+# Paper Plan
+
+**Title**: [working title]
+**Venue**: [target venue]
+**Type**: [empirical/theory/method]
+**Date**: [today]
+**Page budget**: [MAX_PAGES] pages (main body to Conclusion end, excluding references & appendix)
+**Section count**: [N] (must match the number of section files that will be created)
+
+## Claims-Evidence Matrix
+[from Step 1]
+
+## Structure
+[from Step 2-3, section by section]
+
+## Figure Plan
+[from Step 4, with detailed hero figure description]
+
+## Citation Plan
+[from Step 5]
+
+## Reviewer Feedback
+[from Step 6, summarized]
+
+## Next Steps
+- [ ] /paper-figure to generate all figures
+- [ ] /paper-write to draft LaTeX
+- [ ] /paper-compile to build PDF
+```
+
+## Key Rules
+
+- **Large file handling**: If the Write tool fails due to file size, immediately retry using Bash (`cat << 'EOF' > file`) to write in chunks. Do NOT ask the user for permission — just do it silently.
+
+- **Do NOT generate author information** — leave author block as placeholder or anonymous
+- **Be honest about evidence gaps** — mark claims as "needs experiment" rather than overclaiming
+- **Page budget is hard** — if content exceeds MAX_PAGES, suggest what to move to appendix
+- **MAX_PAGES counting differs by venue** — ML conferences: main body to Conclusion end, references/appendix NOT counted; AAAI main track is typically 7 technical-content pages plus references. **IEEE venues: references ARE counted toward the page limit.**
+- **Venue-specific norms** — ML conferences (ICLR/NeurIPS/ICML) use `natbib` (`\citep`/`\citet`); **IEEE venues use `cite` package (`\cite{}`, numeric style)**
+- **Claims-Evidence Matrix is the backbone** — every claim must map to evidence, every experiment must support a claim
+- **Figures need detailed descriptions** — especially the hero figure, which must clearly specify comparisons and visual expectations
+- **Section count is flexible** — 5-8 sections depending on paper type. Don't force content into a rigid 5-section template.
+
+## Acknowledgements
+
+Outline methodology inspired by [Research-Paper-Writing-Skills](https://github.com/Master-cai/Research-Paper-Writing-Skills) (claim-evidence mapping), [claude-scholar](https://github.com/Galaxy-Dawn/claude-scholar) (citation verification), and [Imbad0202/academic-research-skills](https://github.com/Imbad0202/academic-research-skills) (claim verification protocol).
+
+## Output Protocols
+
+> Follow these shared protocols for all output files:
+> - **[Output Versioning Protocol](../../shared-references/output-versioning.md)** — write timestamped file first, then copy to fixed name
+> - **[Output Manifest Protocol](../../shared-references/output-manifest.md)** — log every output to MANIFEST.md
+> - **[Output Language Protocol](../../shared-references/output-language.md)** — respect the project's language setting

package/dist/skills/paper-poster/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: paper-poster
+description: "DEPRECATED — superseded by /paper-poster-html. Kept only as a redirect for muscle memory; do not use for new posters."
+argument-hint: [paper-dir-or-pdf]
+allowed-tools: Read
+---
+
+# Paper Poster (DEPRECATED → /paper-poster-html)
+
+This skill is retired. The LaTeX/tcbposter pipeline it described produced posters with
+unbounded color palettes, no real paper figures, and no print-canvas verification, and
+has been replaced by the measurement-gated HTML/CSS pipeline.
+
+**Immediately proceed with `/paper-poster-html`**, passing through all of the user's
+arguments unchanged. Do not attempt the legacy LaTeX flow.
+
+The full legacy implementation remains available in git history
+(`git log -- skills/skills-codex/paper-poster/SKILL.md`) if a venue ever mandates
+LaTeX poster source — none is known to.

package/dist/skills/paper-poster-html/DESIGN_FINAL.md

@@ -0,0 +1,176 @@
+# paper-poster-html — 收敛后的最终设计(codex 3 轮讨论产物)
+
+日期:2026-06-05。讨论 thread:019e96dc-8350-70f0-a595-c1ad15919aa8(gpt-5.5 xhigh)。
+状态:Round 2 全点收敛,本文档为实现规格。
+
+## 0. 定位
+
+- HTML+CSS 是新的默认 poster 路径;旧 `/paper-poster`(LaTeX tcbposter)已退役为
+  重定向 stub(2026-06-07 落库决定,较本规格的 legacy 共存方案更进一步;
+  旧实现仅存于 git history)。
+- posterly(MIT, github.com/Chenruishuo/posterly)的 tools **vendor 进 skill**,不外部依赖
+  不重写;`LICENSES/posterly-MIT.txt` + `NOTICE.md` 注明来源与 ARIS 修改。
+
+## 1. 目录布局
+
+```
+skills/paper-poster-html/
+├── SKILL.md
+├── LICENSES/posterly-MIT.txt
+├── NOTICE.md
+├── templates/
+│   ├── README.md
+│   ├── COMPONENTS.md          # 组件契约目录(Q6)
+│   ├── landscape_4col.html    # fork 自 posterly,de-gradient + token 化
+│   ├── landscape_hero.html
+│   ├── portrait_2col.html
+│   └── tokens/
+│       ├── generic.json       # 默认:slate-blue #2D5F8B + gold #C9A24A
+│       ├── iclr.json … cvpr.json   # opt-in venue 包
+└── scripts/
+    ├── poster_check.py        # vendored(measure/preflight/polish/verify-final)
+    ├── render_preview.py      # vendored(Playwright print render)
+    ├── _posterly/…            # vendored 内部模块
+    ├── style_check.py         # 新:风格硬门(12 条规则)
+    ├── asset_check.py         # 新:真图溯源门
+    ├── run_gates.py           # 新:canonical 顺序跑全门,写 GATE_REPORT.json
+    ├── extract_pdf_figures.py # 新:PDF→contact sheet→候选裁剪
+    └── preprocess_figures.py  # 新:autocrop/转格式/分辨率检查
+```
+
+工作目录输出:
+```
+poster_html/
+├── poster.html / poster.pdf / poster_preview.png
+├── POSTER_STATE.json / GATE_REPORT.json
+├── CLAIM_EVIDENCE.md / FIGURE_MANIFEST.json
+└── assets/{paper_figures,logos,qr,mathjax}/
+```
+
+## 2. 设计 token 纪律
+
+- **默认色卡 = generic(所有 venue)**:accent #2D5F8B 族 + gold #C9A24A 族 + 中性色。
+  venue 色卡 opt-in(`— venue-colors: true`),约束:accent S≤0.55、L∈[0.25,0.45];
+  gold 族固定 H∈[38,48]、S≤0.65、L∈[0.42,0.65];**主 accent 禁紫**(H 250–285),
+  除非 `— allow-purple: true`。venue identity 默认文字 badge。
+- 字号必须走 `--fs-*` token scale(≤9 档,超出 warn)。
+- serif 正文(Charter/Source Serif Pro/Georgia/Times New Roman)+
+  sans 标题(Inter/Aptos/Helvetica Neue/Arial);mono 仅代码(Menlo/Consolas)。
+
+## 3. style_check.py 源门规则(codex 定稿,逐条实现)
+
+| # | 严重度 | 规则 |
+|---|--------|------|
+| 1 | HARD | 颜色字面量只许出现在 token 文件 / `:root` token block;例外:`data-color-exempt="logo"` 的 SVG 内部 |
+| 2 | HARD | 禁 inline `style` 含颜色/字体/字号/布局关键值(豁免同上 + paper asset 内部) |
+| 3 | HARD | 组件 CSS 颜色必须 `var(--…)` |
+| 4 | HARD | 渲染后非中性色相聚类 ≤2(聚类半径 18°,须落在 accent/gold hue ±22°;非中性=alpha≥0.10 且 S≥0.18;豁免 `<img>`、logo、`data-source="paper"`、QR) |
+| 5 | HARD | 禁 `linear-gradient`;`radial-gradient` 仅许 `.poster` 背景且所有 color stop alpha≤0.06 |
+| 6 | HARD | 字体配对:正文 serif 栈、标题/表头 sans 栈 |
+| 7 | HARD | 字体白名单(§2) |
+| 8 | HARD | 字号必须用 `--fs-*` token 或组件 class,禁任意 px 漂移 |
+| 9 | WARN | 字号 token >9 档 |
+| 10 | HARD | 契约属性:论文图必须 `data-source="paper"` + `data-asset-id`;logo 豁免必须显式标注 |
+| 11 | HARD | 禁自造装饰 SVG;inline SVG 仅许 logo / QR fallback / COMPONENTS.md 已收录的结构图 |
+| 12 | WARN | 大面积深色(L<0.18 且 >8% poster 面积)→ 土嗨预警 |
+
+## 4. asset_check.py 真图门
+
+- ≥2 张 `data-source="paper"` 图;每张面积 ≥ poster 1.5%;paper-image 总面积 ≥ body 12%。
+- raster natural size ≥ rendered size 1.5×(目标 2×)。
+- FIGURE_MANIFEST.json 必填:source PDF hash、page、bbox、crop dpi、asset sha256、是否来自论文。
+- 真图获取链:论文源 figures/(SVG/PDF→SVG 转换优先)→ PDF-only 时 PyMuPDF 300–450 DPI
+  渲染 contact sheet → 自动候选 + 人工选 → 用户给 `page,x0,y0,x1,y1` bbox → 不足 2 张硬失败
+  (除非 human checkpoint 显式 waiver)。
+
+## 5. 公式门(半硬)
+
+- `EQN/BROKEN`(MathJax 没渲染出来)= HARD(vendored measure 已有)。
+- `EQN/UNDERSIZED`:.eqn inner box >80px 高且 math bbox 面积 <15% → HARD;
+  <25% 或底部空白 >35% → WARN(final 前必须修复或记录 waiver)。
+
+## 6. MathJax 本地化
+
+Phase 0 下载 tex-svg.js 到 `poster_html/assets/mathjax/`(缓存复用),HTML 引本地路径;
+下载失败 → 询问后 CDN 仅供草稿;final 的 measure 门对 MathJax 失败保持硬失败。
+
+## 7. run_gates.py + GATE_REPORT.json
+
+- canonical order:`preflight → style_check → asset_check → measure → polish`。
+- 默认 accumulate(一次给全修复面),`--fail-fast` 可选。
+- style/asset 保持独立 CLI(vendor diff 干净),run_gates.py 做编排。
+- GATE_REPORT.json schema:schema_version/skill/timestamp/poster_html/canvas{source,width_cm,
+  height_cm,orientation,source_url}/overall/hard_failures/warnings/gates[{name,severity,status,
+  command,summary,artifacts}]。
+- **polish 的 WARN 在 Phase 6 前必须清零或显式 waiver。**
+
+## 8. Workflow phases(SKILL.md 主结构)
+
+| Phase | 内容 | 门 | Checkpoint |
+|-------|------|----|------------|
+| 0 | resume + deps(Playwright 链)+ venue spec 实时调研(WebSearch/WebFetch 官方页,URL+date 入 state) | — | 🚦确认 venue/canvas |
+| 0.5 | 设计问卷(layout/palette/logo/QR/source 一轮 AskUserQuestion) | — | 🚦确认设计输入 |
+| 1 | paper ingest + content plan + claim→evidence 表 | codex fresh xhigh 内容审计 | 🚦全 claim OK 或用户接受 tradeoff |
+| 2 | 真图提取/预处理 | asset_check + FIGURE_MANIFEST | 🚦PDF-only 时人工选裁剪 |
+| 3 | scaffold + token patch | preflight + style_check | — |
+| 4 | 布局硬循环 | preflight+style+asset+measure(spread<5 aim<3;footer gap 30–50;intercard 12–50;fill 95–101%;position≤2px) | — |
+| 5 | 渲染 + Claude 视觉审(rubric §9) | ≤3 issue×≤3 轮;fix 限定词汇表 §10 | — |
+| 6 | codex 终审(fresh xhigh,审 final HTML+PDF 不是 plan;fidelity/overclaim/residue/叙事/gate logs;不直接改文件) | 任何 fix 回 Phase 4/5 | — |
+| 7 | verify-final + 报告 | PDF 1 页/尺寸/≤20MB/无 TODO/无 remote asset | 完成 |
+
+Playwright 降级链:bundled Chromium → `python -m playwright install chromium` →
+`channel="chrome"` → 仍失败则只产 content plan/scaffold,标注 "not print verified",
+不许产出最终 PDF。pdfinfo 缺 → PyMuPDF 读尺寸;pdftoppm/PyMuPDF 至少一个用于 PNG。
+
+## 9. Claude 视觉 rubric(Phase 5)
+
+1–10 分;critical cap:无真图或 <2 张 →≤3;画布坏/裁切/公式不可读 →≤4;
+≥4 个色相家族或重渐变 header →≤4;大空白卡/列 →≤5;捏造视觉 claim →≤3。
+检查项:posterly-showcase gestalt / 单 accent 纪律 / 真图居中可读 / 打印层级
+(title→headline→figures→details)/ 列底对齐无半空卡 / 公式占框 / serif+sans 配对 /
+无渐变 kitsch / 组件一体感 / 60 秒叙事。
+输出格式:`SCORE: N/10`、`CAPS_TRIGGERED`、`TOP_ISSUES(≤3)`、
+`ALLOWED_FIX_TYPE: token|component|rebalance|asset|template/canvas`、`PATCH_LOOP_RISK`。
+校准:旧 poster ≤3 分;posterly showcase ≥9 分。
+
+## 10. Fix 词汇表(反补丁循环核心)
+
+视觉审循环内只允许:
+(a) 改 `:root` token 值;
+(b) 整组件实例的换/删/加(组件集来自 COMPONENTS.md);
+(c) 内容再平衡(卡片跨列移动 / 从论文取材增删文字 / AR 门带宽内调图);
+(d) 画布/模板重选(升级路径);
+(e) 组件 stylesheet 的全局改动(只许引用 token,禁新 hex);
+(f) 预定义 variant 切换(`.figure--wide`、`.card--compact`、`.eqn--large`、`.nowrap` 等,
+   必须已录入 COMPONENTS.md);
+(g) asset fix(重裁剪/换同论文更清晰图/重跑 preprocess)。
+禁止:新 inline style、新 hex、自造装饰 SVG、单元素字号 override。
+**新组件禁止在视觉循环内诞生**——需要新组件 → 停,human checkpoint 录入 COMPONENTS.md,
+从 Phase 3 重跑。
+
+## 11. COMPONENTS.md 契约
+
+每组件:purpose / allowed variants / required data attributes / token usage /
+which gates inspect it / allowed fix operations / anti-patterns。
+首发组件:card、numbered-card、figure-card、hero-figure、eqn、result-table、
+claim-evidence、keybox、takeaways、qr-block、venue-badge、footer。
+
+## 12. 已知失败模式防御(codex round 1 §7)
+
+remote 资源 networkidle 假死→本地化;logo 豁免走私颜色→显式 data-color-exempt;
+低清裁剪→1.5×/2× 检查;截图导致 PDF 爆体积→verify-final 20MB;
+视觉审诱发新组件/新色→fix 词汇表;venue 规格过期→每次实时查+记录 URL/date;
+改写引入新 claim→Phase 6 审 final HTML 不是 content plan。
+
+## 12.5 Round-3 ACK nits(已采纳)
+
+1. style_check 规则 8:`calc(var(--fs-*) * …)` 仅许预定义组件 variant 使用,否则成漏洞。
+2. asset_check 的"paper-image 总面积 ≥ body 12%"对纯理论论文可 waiver——但首个验收案例不许 waiver。
+3. Phase 0 的 venue 调研在 skill 文案里写成泛化的 "official venue page lookup"(跨工具栈映射,codex 镜像兼容)。
+
+## 13. 验收
+
+首个验收案例:为一篇公开的 ICLR 2026 OpenReview 论文(理论+实验混合型)重做 poster:
+画布 185×90cm 横版(ICLR 官方打印服务规格),generic 色卡,
+真图来自 OpenReview PDF,目标执行方视觉 rubric ≥9 + 跨模型终审通过。
+(已达成:全 gate PASS、列底 spread <1px、两轮跨模型终审 PRINT-READY。)

package/dist/skills/paper-poster-html/IMPLEMENTATION_CONVENTIONS.md

@@ -0,0 +1,161 @@
+# paper-poster-html 实现约定(所有实现 agent 必读)
+
+配合 DESIGN_FINAL.md(规格)使用。本文档定死跨文件契约——实现时**逐字遵守**,
+有疑问按本文档,不要自由发挥。
+
+## A. CSS Token 契约(templates + tokens/*.json + style_check 三方共享)
+
+`:root` 中的 token block 必须被注释 `/* ===== DESIGN TOKENS ===== */` 和
+`/* ===== END DESIGN TOKENS ===== */` 包围(style_check 靠这对注释定位 token block)。
+
+颜色 token(只有这些地方允许出现颜色字面量):
+```css
+--accent: #2D5F8B;  --accent-deep: #1F4566;  --accent-light: #E8F1F8;  --accent-soft: #D7E5F0;
+--gold: #C9A24A;    --gold-soft: #FFF7E0;
+--text-primary: #1A1A1A;  --text-secondary: #555555;  --text-muted: #888888;
+--bg-page: #F6F2F0;  --bg-card: #FFFFFF;  --bg-card-tint: #FAFAFB;  --bg-emphasis: var(--accent-light);
+--border-soft: #D8D8D8;  --border-strong: var(--accent);
+```
+
+字号 scale(9 档,模板内所有 font-size 必须引用之一;`calc(var(--fs-N) * k)` 仅许
+COMPONENTS.md 预定义 variant 使用):
+```css
+--fs-1: calc(9 * var(--u));   /* 微标签 */      --fs-2: calc(10 * var(--u));  /* 小 caption */
+--fs-3: calc(11 * var(--u));  /* caption/表格 */ --fs-4: calc(12 * var(--u));  /* 正文 */
+--fs-5: calc(13 * var(--u));  /* 公式/强调 */    --fs-6: calc(15 * var(--u));  /* 副标题 */
+--fs-7: calc(16 * var(--u));  /* 节标题 */       --fs-8: calc(22 * var(--u));  /* banner 数字 */
+--fs-9: calc(32 * var(--u));  /* 主标题 */
+```
+
+单位:`--u: 1.6px`(screen)/ `@media print { :root { --u: 1mm } }`。其余尺寸一律
+`calc(N * var(--u))`,hairline 可用裸 px(≤2px)。
+
+## B. HTML 属性契约
+
+| 属性 | 用途 | 谁检查 |
+|------|------|--------|
+| `data-measure-role="poster|header|banner|body|column|card|hero|footer-strip|footer"` | vendored measure 的定位锚(原契约,勿改) | poster_check measure |
+| `data-source="paper"` + `data-asset-id="<manifest id>"` | 标记来自论文的图 | asset_check + style_check 豁免 |
+| `data-color-exempt="logo"` | logo/印章 SVG 的调色豁免 | style_check |
+| `data-fig-layout="beside-text"` | 图文并排的 AR 门 opt-out(vendored) | poster_check polish |
+
+**模板和最终 poster 中禁止任何 `style=` 属性**(零容忍,style_check 规则 2 实现成这样,
+简单可靠)。例外:`data-color-exempt="logo"` 元素的内部 SVG 标记、`data-source="paper"`
+的 `<img>` 上仅允许 `style="width: NN%"`(AR 调宽)。
+为此模板必须自带 utility classes(替代 posterly 模板里的 inline style):
+```css
+.fs-1 … .fs-9        /* font-size: var(--fs-N) */
+.mt-1 … .mt-6        /* margin-top: calc(N * var(--u)) */
+.mb-1 … .mb-4        /* margin-bottom */
+.w-45 .w-50 … .w-100 /* 图宽 45%…100%,步长 5 */
+.text-secondary .text-muted .nowrap .text-center
+```
+
+## C. CLI 契约(scripts/)
+
+全部 Python 3.10+,只用 stdlib + 已确认可用的 PyMuPDF(fitz)/PIL/playwright(lazy import,
+缺失时给可读错误+降级指引)。每个脚本 `--help` 完整。exit code:0=pass,1=hard fail,2=用法/环境错误。
+
+### style_check.py
+```
+python3 style_check.py POSTER.html [--tokens TOKENS.json] [--json OUT.json]
+                       [--no-render]  # 跳过渲染门(规则4、12 标 SKIPPED)
+```
+实现 DESIGN_FINAL §3 的 12 条规则 + §12.5 nit 1。源门(规则 1-3,5-11)纯静态解析
+(html.parser + 正则提 CSS);渲染门(规则 4、12)用 playwright 取 computed style。
+色相聚类:rgba→HSL;非中性= alpha≥0.10 且 S≥0.18;greedy 聚类半径 18°(色环距离);
+聚类数 ≤2 且每类中心落在 tokens 的 accent/gold hue ±22°(hue_centers 来自 --tokens JSON,
+缺省从 :root 解析 --accent/--gold 算)。
+JSON 输出:`{"gate":"style","status":"PASS|FAIL|WARN","rules":[{"id":1,"severity":"hard","status":"PASS","detail":"..."}]}`
+
+### asset_check.py
+```
+python3 asset_check.py POSTER.html --manifest FIGURE_MANIFEST.json [--json OUT.json]
+                       [--min-paper-figs 2] [--min-fig-area 0.015] [--min-total-area 0.12]
+                       [--waive-total-area]   # 纯理论论文 waiver(DESIGN_FINAL §12.5 nit 2)
+                       [--no-render]          # 面积检查降级为 natural-size 估算
+```
+检查:≥N 张 data-source="paper" 且 manifest 里 from_paper=true;每张渲染面积 ≥ poster 1.5%;
+总面积 ≥ body 12%(可 waive);natural_px ≥ rendered px 1.5×(WARN 在 <2×);
+manifest 必填字段齐全(见 D);文件存在且 sha256 匹配。
+
+### run_gates.py
+```
+python3 run_gates.py POSTER.html [--report GATE_REPORT.json] [--fail-fast]
+                     [--strict-polish] [--tokens TOKENS.json] [--manifest FIGURE_MANIFEST.json]
+                     [--waive-total-area] [--no-render]
+```
+canonical order:preflight → style → asset → measure → polish。默认 accumulate。
+子门以 subprocess 调同目录脚本(sys.executable;poster_check.py 子命令用其 CLI)。
+GATE_REPORT.json 严格按 DESIGN_FINAL §7 schema(canvas 信息从 POSTER_STATE.json 读,
+读不到则从 @page 解析,source 标 "page-rule")。汇总 overall=PASS/FAIL + hard_failures + warnings。
+
+### extract_pdf_figures.py
+```
+python3 extract_pdf_figures.py PAPER.pdf --out DIR [--dpi 350]
+        contact-sheet                      # 整页缩略 contact sheet + 自动候选框
+        crop --page P --bbox x0,y0,x1,y1 --name ID [--caption-hint "..."]
+        auto                               # 自动检测大图块候选(图/表),输出候选列表
+```
+bbox 单位 = PDF points(72dpi 坐标,fitz 默认)。crop 模式渲染该区域至 --dpi,写 PNG 到
+DIR,并 upsert FIGURE_MANIFEST.json(同目录上级)。contact-sheet 写 DIR/contact_sheet_pNN.png。
+
+### preprocess_figures.py
+```
+python3 preprocess_figures.py IMG... [--autocrop] [--pad 6] [--min-px 1200 700] [--manifest M.json]
+```
+PIL autocrop 白边(ImageChops.difference vs 白底,留 --pad px),报告 natural size,
+低于 --min-px 给 WARN;改动后同步更新 manifest 的 natural_px/sha256。
+
+## D. FIGURE_MANIFEST.json schema
+
+```json
+{
+  "schema_version": 1,
+  "source_pdf": {"path": "…", "sha256": "…"},
+  "figures": [
+    {"asset_id": "fig_method", "file": "assets/paper_figures/fig_method.png",
+     "from_paper": true, "page": 3, "bbox": [72.0, 100.0, 520.0, 380.0], "dpi": 350,
+     "sha256": "…", "natural_px": [2178, 1362], "caption_hint": "Figure 2: …"}
+  ]
+}
+```
+
+## E. 模板改造配方(posterly → ARIS fork)
+
+对 3 个模板各做(以上游 posterly 仓库的 templates/*.html 为底):
+1. 文件头注释:保留原说明,追加 "Adapted from posterly (MIT, © 2026 Ruishuo Chen) — see LICENSES/ & NOTICE.md; ARIS modifications: flat de-gradient, --fs token scale, zero-inline-style utilities, data-source/data-color-exempt contracts."
+2. **去渐变**:`.poster::before` 顶条 → 纯色 `var(--accent)`;`.framework-banner`、
+   `.takeaways-strip` 背景 → 纯 `var(--bg-emphasis)`;`.callout.gold` → 纯 `var(--gold)`。
+   `.poster` 的 radial tint(alpha≤0.06)保留。
+3. **token block**:按 §A 注释包围;加 --fs-1..9;所有 font-size 改 var(--fs-N)。
+4. **消灭 inline style**:模板正文里所有 `style="…"` 换成 §B utility classes(在 CSS 段新增)。
+5. **图组件**:`.figure img` 的 TODO 注释里写明契约:`<img src="assets/paper_figures/x.png" data-source="paper" data-asset-id="x" class="w-95">`。
+6. logo 槽注释写明 `data-color-exempt="logo"`。
+7. `data-measure-role` 一律保留。
+8. @page 默认值保留(60×36in / 24×36in),在头注释加"画布重定位:同步改 @page 与 .poster 的
+   width/height(各一处),ICLR 2026 main = 185cm 90cm landscape 示例"。
+9. eqn 组件加 variant `.eqn--large`(font-size: calc(var(--fs-5) * 1.25),预定义 calc 豁免)。
+10. 自检:改完后模板里 grep 不到 `linear-gradient`、`style="`(除 §B 两个例外注释示例)、
+    裸 `#hex`(token block 与 logo SVG 例外)。
+
+## F. tokens/*.json schema
+
+```json
+{"name": "generic",
+ "accent": {"base": "#2D5F8B", "deep": "#1F4566", "light": "#E8F1F8", "soft": "#D7E5F0"},
+ "gold": {"base": "#C9A24A", "soft": "#FFF7E0"},
+ "neutrals": {"text_primary": "#1A1A1A", "text_secondary": "#555555", "text_muted": "#888888",
+              "bg_page": "#F6F2F0", "bg_card": "#FFFFFF", "bg_card_tint": "#FAFAFB",
+              "border_soft": "#D8D8D8"},
+ "hue_centers": {"accent": 210, "gold": 43}}
+```
+venue 包约束:accent S≤0.55、L∈[0.25,0.45]、禁 H 250–285;gold 全包固定 generic 值;
+light/soft 从 base 推(同 hue 低饱和高亮度)。bg_page 可随 accent 微调暖/冷但 ΔE 要小。
+
+## G. 测试基线
+
+上游 posterly 仓库的 examples/hello_world/poster.html 是全门 PASS 的参照(vendored 四门)。
+新脚本写完后:style_check 对 hello_world 允许 FAIL(它有 inline style——posterly 原版风格),
+但对我们改造后的模板(填充前)源门必须 PASS;run_gates 对脚手架预期 measure FAIL(未填充),
+这是正常的(模板=脚手架)。

package/dist/skills/paper-poster-html/LICENSES/posterly-MIT.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ruishuo Chen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.