pdf

Files (12)

• README.md
• SKILL.md
• design.md · design/
• cover.py · scripts/
• fill_inspect.py · scripts/
• fill_write.py · scripts/
• make.sh · scripts/
• merge.py · scripts/
• palette.py · scripts/
• reformat_parse.py · scripts/
• render_body.py · scripts/
• render_cover.js · scripts/

SKILL.md (first lines)

---
name: pdf
description: >
  当 PDF 的视觉质量和设计感很重要时，使用此 skill。
  CREATE（从零生成）："制作一个 PDF"、"生成一份报告"、"写一份建议书"、
  "创建一份简历"、"精美的 PDF"、"专业文档"、"封面"、
  "精致的 PDF"、"客户就绪文档"。
  FILL（填写表单域）："填写表单"、"填写这个 PDF"、
  "完成表单字段"、"将值写入 PDF"、"这个 PDF 有哪些字段"。
  REFORMAT（对已有文档应用设计）："重新格式化此文档"、"应用我们的风格"、
  "将此 Markdown/文本转换为 PDF"、"让这个文档看起来好看"、"重新设计此 PDF 的样式"。
  此 skill 使用基于 token 的设计系统：颜色、排版和间距根据文档类型派生并贯穿每一页。输出为打印就绪格式。
  优先使用此 skill 当外观很重要时，而不仅仅是需要 PDF 输出时。
license: MIT
metadata:
  version: "1.0"
  category: document-generation
---

# minimax-pdf

三项任务，一个 skill。

## 在执行任何 CREATE 或 REFORMAT 工作之前，必须阅读 `design/design.md`

---

## 路由表

| 用户意图 | 路由 | 使用的脚本 |
|---|---|---|
| 从零生成一个新 PDF | **CREATE** | `palette.py` → `cover.py` → `render_cover.js` → `render_body.py` → `merge.py` |
| 填写/完成已有 PDF 中的表单字段 | **FILL** | `fill_inspect.py` → `fill_write.py` |
| 重新格式化/重新设计已有文档 | **REFORMAT** | `reformat_parse.py` → 完整的 CREATE 管道 |

**规则：** 当在 CREATE 和 REFORMAT 之间犹豫时，询问用户是否已有文档作为起点。如有 → REFORMAT。如无 → CREATE。

---

## 路由 A: CREATE

完整管道 — 内容 → 设计 token → 封面 → 正文 → 合并 PDF。

```bash
bash scripts/make.sh run \
  --title "Q3 策略评审" --type proposal \
  --author "策略团队" --date "2025 年 10 月" \
  --accent "#2D5F8A" \
  --content content.json --out report.pdf
```

**文档类型：** `report` · `proposal` · `resume` · `portfolio` · `academic` · `general` · `minimal` · `stripe` · `diagonal` · `frame` · `editorial` · `magazine` · `darkroom` · `terminal` · `poster`

| 类型 | 封面模式 | 视觉标识 |
|---|---|---|
| `report` | `fullbleed` | 深色背景，点阵网格，Playfair Display |
| `proposal` | `split` | 左侧面板 + 右侧几何，Syne |
| `resume` | `typographic` | 超大首词，DM Serif Display |
| `portfolio` | `atmospheric` | 近黑色，径向发光，Fraunces |
| `academic` | `typographic` | 浅色背景，经典衬线体，EB Garamond |
| `general` | `fullbleed` | 深灰蓝，Outfit |
| `minimal` | `minimal` | 白色 + 单条 8px 强调线，Cormorant Garamond |
| `stripe` | `stripe` | 3 条粗水平色带，Barlow Condensed |
| `diagonal` | `diagonal` | SVG 斜切，深/浅两半，Montserrat |
| `frame` | `frame` | 内嵌边框，角饰，Cormorant |
| `editorial` | `editorial` | 幽灵字母，全大写标题，Bebas Neue |
| `magazine` | `magazine` | 暖米色背景，居中堆叠，主图，Playfair Display |
| `darkroom` | `darkroom` | 深蓝背景，居中堆叠，灰度图像，Playfair Display |
| `terminal` | `terminal` | 近黑色，网格线，等宽字体，霓虹绿 |
| `poster` | `poster` | 白色背景，粗侧边栏，超大标题，Barlow Condensed |

封面附加项（通过 `--abstract`、`--cover-image` 注入 token）：
- `--abstract "文本"` — 封面上的摘要文本块（magazine/darkroom）
- `--cover-image "url"` — 主图 URL/路径（magazine、darkroom、poster）

**颜色覆盖 — 始终根据文档内容选择：**
- `--accent "#HEX"` — 覆盖强调色；`accent_lt` 自动通过向白色淡化派生
- `--cover-bg "#HEX"` — 覆盖封面背景色

**强调色选择指南：**

你对强调色拥有创作权。从文档的语义上下文——标题、行业、目的、受众——中选取，而非选择通用的"安全"色。强调色出现在节间分隔线、标注栏、表头以及封面上：它承载着文档的视觉标识。

| 上下文 | 建议强调色范围 |
|---|---|
| 法律/合规/金融 | 深海军蓝 `#1C3A5E`，炭灰 `#2E3440`，石板灰 `#3D4C5E` |
| 医疗/健康 | 青绿色 `#2A6B5A`，冷绿 `#3A7D6A` |
| 技术/工程 | 钢蓝 `#2D5F8A`，靛蓝 `#3D4F8A` |
| 环境/可持续 | 森林绿 `#2E5E3A`，橄榄绿 `#4A5E2A` |
| 创意/艺术/文化 | 勃艮第红 `#6B2A35`，梅紫 `#5A2A6B`，陶土色 `#8A3A2A` |
| 学术/研究 | 深青 `#2A5A6B`，图书馆蓝 `#2A4A6B` |
| 企业/中性 | 石板灰 `#3D4A5A`，石墨灰 `#444C56` |
| 奢侈/高级 | 暖黑 `#1A1208`，古铜 `#4A3820` |

**规则：** 选择一位有品味的设计师会为这份特定文档选择的颜色——而不是类型的默认色。柔和、低饱和度的色调效果最好；避免鲜艳的原色。犹豫不决时，选择更暗、更中性的颜色。

**content.json 块类型：**

| 块类型 | 用途 | 关键字段 |
|---|---|---|
| `h1` | 章节标题 + 强调分隔线 | `text` |
| `h2` | 子章节标题 | `text` |
| `h3` | 子子章节（粗体） | `text` |
| `body` | 两端对齐段落；支持 `<b>` `<i>` 标记 | `text` |
| `bullet` | 无序列表项（• 前缀） | `text` |
| `numbered` | 有序列表项 — 计数器在遇到非编号块时自动重置 | `text` |
| `callout` | 带强调左侧色条的高亮见解框 | `text` |
| `table` | 数据表格 — 强调色表头，交替行底色 | `headers`, `rows`, `col_widths`?, `caption`? |
| `image` | 缩放至列宽的嵌入式图片 | `path`/`src`, `caption`? |
| `figure` | 带自动编号 "图 N:" 的图片 | `path`/`src`, `caption`? |
| `code` | 带强调色左边框的等宽代码块 | `text`, `language`? |
| `math` | 显示数学公式 — LaTeX 语法，通过 matplotlib mathtext 渲染 | `text`, `label`?, `caption`? |
| `chart` | 使用 matplotlib 渲染的柱/折/饼图 | `chart_type`, `labels`, `datasets`, `title`?, `x_label`?, `y_label`?, `caption`?, `figure`? |
| `flowchart` | 使用 matplotlib 绘制的流程节点 + 连线图 | `nodes`, `edges`, `caption`?, `figure`? |
| `bibliography` | 带悬挂缩进的编号参考文献列表 | `items` [{id, text}], `title`? |
| `divider` | 强调色全宽分隔线 | — |
| `caption` | 小型弱化标签 | `text` |
| `pagebreak` | 强制分页 | — |
| `spacer` | 垂直空白 | `pt`（默认 12） |

From clark970417-eng/Cyrene-Agent, MIT.

More from clark970417-eng/Cyrene-Agent