paper-illustration Skill Architecture

File Budget

.claude/skills/paper-illustration/
├── SKILL.md                                  ~280 行  ~1,800 字  接口层（工作流 + 约束）
├── ARCHITECTURE.md                           ~120 行  ~800 字   架构总览（本文件）
└── references/
    ├── illustration-taxonomy.md              ~210 行  ~1,400 字  6 种图表类型分类 + prompt 模板
    ├── academic-styles.md                    ~185 行  ~1,200 字  5 种会议风格规范
    └── critic-checklist.md                   ~130 行  ~800 字   5 维度 20 项质量检查
                                              ─────────────────
                                              ~925 行  ~6,000 字  总上下文消耗

Progressive Disclosure Architecture

Agent 加载顺序（上下文消耗）
─────────────────────────────────────────────────────────────

第 1 层：SKILL.md（必加载，~1,800 字）
┌──────────────────────────────────────────────────────────┐
│ frontmatter    触发匹配 + 路由规则                         │
│ 输入要求       2 必填 + 8 可选                            │
│ 决策树         figure_type 自动检测                        │
│ 路由表         figure_type → backend 映射                  │
│ 6 步工作流     摘要+指针，不含详细规则                      │
│ 8 条 NEVER     零容忍规则                                  │
│ 失败处理       6 种失败模式                                │
└──────────────┬───────────────────────────────────────────┘
               │ 按需加载（只在对应 Step 触发时读取）
               ▼
第 2 层：references/（按需，~3,400 字）
┌────────────────────────┐ ┌───────────────────┐ ┌──────────────────┐
│ illustration-taxonomy  │ │ academic-styles   │ │ critic-checklist │
│                        │ │                   │ │                  │
│ Step 1 → §1-§6 分类    │ │ Step 3 → 风格参数  │ │ Step 5 → 评估    │
│ Step 1 → §7 自动检测   │ │ Step 4 → 色值/字号 │ │                  │
│ Step 4 → §8 prompt 模板│ │                   │ │                  │
└────────────────────────┘ └───────────────────┘ └──────────────────┘
               │
               ▼
第 3 层：外部依赖（运行时）
┌──────────────────────────────────────────────────────────┐
│ basic-image-gen skill   AI 图像生成                       │
│ matplotlib/seaborn      代码生成（用户本地 Python）        │
│ obsidian CLI            vault 资产管理                    │
└──────────────────────────────────────────────────────────┘

6-Step Workflow x File Dependency Matrix

Step    名称               SKILL.md   taxonomy   styles   checklist   basic-image-gen   vault
────    ────               ────────   ────────   ──────   ─────────   ──────────────    ─────
 1      Retrieve & Classify ✓ 指令    ✓ §1-§7                                          ✓ obsidian read
 2      Plan Blueprint      ✓ 模板
 3      Apply Style         ✓ 约束               ✓ 全文
 4      Generate Figure     ✓ 路由    ✓ §8 prompt ✓ 色值                ✓ conceptual
 5      Critic Evaluation   ✓ 约束                          ✓ 全文
 6      Archive to Vault    ✓ 模板                                                     ✓ obsidian property:set

Step 4 是资源消耗峰值——同时需要 taxonomy（prompt 模板）+ styles（色值字号）+ basic-image-gen（外部 skill）。这是合理的：生成阶段是整个 skill 的核心价值所在。

Content-Forge Pipeline Integration

content-forge 生产线                    paper-illustration 覆盖范围
──────────────────────────────────────────────────────────────

S0 选题入库  ──▶ 01-topics/*.md
                    │
S2 草稿生成  ──▶ write-article
                    │
S4 格式清洗  ──▶ format-markdown
                    │
         ┌─────────────────────────────────────────────┐
         │  S5 视觉资产                                 │
         │                                              │
         │  ┌─ paper-illustration ◀── NEW (学术图表)     │
         │  │    Step 1: 读取源笔记 + 分类 figure_type   │
         │  │    Step 2: Figure Blueprint               │
         │  │    Step 3: 风格参数（NeurIPS/ICML/...）     │
         │  │    Step 4: matplotlib 代码 / AI 图像       │
         │  │    Step 5: Critic 5 维度评估               │
         │  │    Step 6: 存入 05-assets/                 │
         │  │                                           │
         │  ├─ baoyu-cover-image（社媒封面）              │
         │  ├─ baoyu-article-illustrator（博客配图）       │
         │  └─ baoyu-xhs-images（小红书配图）             │
         └─────────────────────────────────────────────┘
                    │
S6 审核     ──▶ /review + /multi-review
                    │
S8 发布     ──▶ post-to-wechat / post-to-x

paper-illustration 与 baoyu-* 系列平级，在 S5（视觉资产）阶段按内容类型路由：学术内容走 paper-illustration，社媒内容走 baoyu-*。

Differentiation Matrix

                     paper-illustration   baoyu-article-illustrator   baoyu-cover-image
                     ─────────────────    ────────────────────────    ─────────────────
目的                  信息性学术图表        装饰性博客配图                社媒封面图
输出                  图片 + 可复现代码     仅图片                      仅图片
受众                  学术审稿人            博客读者                    社媒用户
文字处理              标签/坐标轴/图例      极少装饰文字                 标题文字
可复现性              必须（代码输出）       无需                       无需
后端                  matplotlib + AI       AI only                   AI only
质量检查              20 项 Critic          无结构化检查                无结构化检查
迭代                  ≤3 轮                无                         无

Architecture Scorecard

Dimension	Rating	Notes
Progressive Disclosure	PASS	SKILL.md 摘要+指针，3 个 reference 按需加载
Cross-File Consistency	PASS	图表类型名在 SKILL.md 和 taxonomy.md 完全一致
Single Responsibility	PASS	taxonomy=分类, styles=风格, checklist=评估
Extensibility	PASS	新增会议风格只需扩展 academic-styles.md
Vault Integration	PASS	读取 obsidian read, 归档 property:set + 05-assets/
Quality Assurance	PASS	20 项 Critic checklist, 18/20 pass threshold, ≤3 rounds
Context Efficiency	PASS	总量 ~6,000 字，Step 4 峰值 ~3 源（合理，生成阶段固有复杂度）

8.4 KiB Raw Blame History Unescape Escape