name: minimax-pdf
description: "当视觉质量和设计风格对PDF至关重要时，请使用此技能。  \n**创建（从零生成）**：“制作PDF”、“生成报告”、“撰写方案”、“创建简历”、“精美PDF”、“专业文档”、“封面页”、“精致PDF”、“客户就绪文档”。  \n**填写（填写表单字段）**：“填写表单”、“填写此PDF”、“完成表单字段”、“将值写入PDF”、“此PDF有哪些字段”。  \n**重新排版（为现有文档应用设计）**：“重新排版此文档”、“应用我们的样式”、“将此Markdown/文本转换为PDF”、“让此文档看起来好看”、“重新设计此PDF”。  \n本技能采用基于标记的设计体系：颜色、字体排印和间距根据文档类型派生，并贯穿每一页。输出为打印就绪版本。当外观重要时，优先使用此技能，而非仅需任何PDF输出时。"
license: MIT
metadata:
    version: "1.0"
    category: document-generation

minimax-pdf

三项任务。一个技能。

在进行任何 CREATE（新建）或 REFORMAT（重新格式化）工作之前，请先阅读 design/design.md。

---

路由表

规则： 当在 CREATE 和 REFORMAT 之间不确定时，询问用户是否有现有文档作为起点。如果有 → REFORMAT。如果没有 → CREATE。

---

路由 A：CREATE

完整流水线 — 内容 → 设计令牌 → 封面 → 正文 → 合并 PDF。

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

封面附加功能（通过 --abstract、--cover-image 注入令牌）：

• --abstract "文本" — 封面上的摘要文本块（适用于 magazine/darkroom）
• --cover-image "url" — 主图 URL/路径（适用于 magazine、darkroom、poster）

颜色覆盖 — 始终根据文档内容选择：

• --accent "#HEX" — 覆盖强调色；accent_lt 会自动通过向白色变亮派生
• --cover-bg "#HEX" — 覆盖封面背景色

强调色选择指南：

你对强调色拥有创意自主权。根据文档的语义上下文——标题、行业、目的、受众——进行选择，而不是从通用的“安全”选项中选取。强调色出现在章节分隔线、标注条、表格标题和封面上：它承载着文档的视觉身份。

规则： 选择一位有思考的设计师会为该特定文档选取的颜色——而不是类型的默认色。柔和、低饱和的色调效果最佳；避免鲜艳的基色。如有疑问，选择更深、更中性的颜色。

content.json 块类型：

chart / flowchart 模式：

{"type":"chart","chart_type":"bar","labels":["Q1","Q2","Q3","Q4"],
 "datasets":[{"label":"收入","values":[120,145,132,178]}],"caption":"季度结果"}

{"type":"flowchart",
 "nodes":[{"id":"s","label":"开始","shape":"oval"},
          {"id":"p","label":"处理","shape":"rect"},
          {"id":"d","label":"有效？","shape":"diamond"},
          {"id":"e","label":"结束","shape":"oval"}],
 "edges":[{"from":"s","to":"p"},{"from":"p","to":"d"},
          {"from":"d","to":"e","label":"是"},{"from":"d","to":"p","label":"否"}]}

{"type":"bibliography","items":[
  {"id":"1","text":"作者（年份）. 标题. 出版社."}]}

---

路由 B：FILL

在不改变布局或设计的情况下，填写现有 PDF 中的表单字段。

# 第 1 步：检查
python3 scripts/fill_inspect.py --input form.pdf

# 第 2 步：填写
python3 scripts/fill_write.py --input form.pdf --out filled.pdf \
  --values '{"FirstName": "张三", "Agree": "true", "Country": "CN"}'

始终先运行 fill_inspect.py 以获取准确的字段名称。

---

路由 C：REFORMAT

解析现有文档 → content.json → CREATE 流水线。

bash scripts/make.sh reformat \
  --input source.md --title "我的报告" --type report --out output.pdf

支持的输入格式： .md .txt .pdf .json

---

环境

bash scripts/make.sh check   # 验证所有依赖
bash scripts/make.sh fix     # 自动安装缺失的依赖
bash scripts/make.sh demo    # 构建示例 PDF