Skill 从入门到精通——第四章 Anthropic 官方Skill解析—pdf Skill 解析

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

pdf/
├── SKILL.md                           # 主编排提示词
├── reference.md                       # 高级功能与按需参考文档
├── forms.md                           # 专门的表单填写工作流指南
├── LICENSE.txt                        # 专有许可证
└── scripts/
    ├── check_fillable_fields.py       # 探测PDF 是否包含表单字段？
    ├── extract_form_field_info.py     # 提取原生可填写字段元数据
    ├── fill_fillable_fields.py        # 填写原生字段并验证
    ├── extract_form_structure.py      # 从不可填写 PDF 中提取文本/线条/复选框
    ├── check_bounding_boxes.py        # 填写前验证字段坐标
    ├── fill_pdf_form_with_annotations.py  # 为不可填写 PDF 添加 FreeText 注释
    ├── convert_pdf_to_images.py       # PDF → PNG，用于视觉分析
    └── create_validation_image.py     # 在图像上叠加边界框以进行视觉验证

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

用户请求涉及 PDF
│
├─▶ 读取/提取
│   ├─ 纯文本 → pdftotext (poppler) / pdfplumber / pypdf
│   ├─ 表格 → pdfplumber (page.extract_tables)
│   ├─ 图片 → pdfimages (poppler) / pypdfium2 渲染
│   └─ 扫描件 → pdf2image → pytesseract OCR
│
├─▶ 文档操作（合并/拆分/旋转/加密）
│   ├─ Python 环境 → pypdf (PdfReader / PdfWriter)
│   └─ 命令行环境 → qpdf / pdftk
│
├─▶ 创建新 PDF
│   ├─ 简单绘图 → reportlab Canvas
│   └─ 复杂排版 → reportlab Platypus (SimpleDocTemplate)
│
├─▶ 表单填写（forms.md 强制流程）
│   ├─ Step 0: 检测是否有 fillable fields
│   │   └─ check_fillable_fields.py → get_fields() 判空
│   │
│   ├─▶ 有 fillable fields
│   │   ├─ extract_form_field_info.py → field_info.json
│   │   ├─ convert_pdf_to_images.py → 可视化分析
│   │   ├─ 人工构建 field_values.json
│   │   └─ fill_fillable_fields.py → 输出填充 PDF
│   │
│   └─▶ 无 fillable fields
│       ├─ Step 1: extract_form_structure.py → form_structure.json
│       ├─ 判断结构是否可用
│       │   ├─▶ 可用 → Approach A: 结构基坐标（pdf_width/pdf_height）
│       │   └─▶ 不可用 → Approach B: 视觉估算（image_width/image_height）
│       ├─ 可选: Hybrid（结构+视觉混合，需坐标转换）
│       ├─ Step 2: check_bounding_boxes.py 验证
│       ├─ Step 3: fill_pdf_form_with_annotations.py 填充
│       └─ Step 4: convert_pdf_to_images.py 验证输出
│
└─▶ 高级需求（渲染/JS 环境/优化）
    └─ reference.md → pypdfium2 / pdf-lib / pdfjs-dist / qpdf 高级特性

1
2
3
4
5
6

import pdfplumber

with pdfplumber.open("document.pdf") as pdf:
    for page in pdf.pages:
        text = page.extract_text()
        tables = page.extract_tables()

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# Step 1: 探测
python scripts/check_fillable_fields.py form.pdf
# → "This PDF has fillable form fields"

# Step 2: 提取字段元数据
python scripts/extract_form_field_info.py form.pdf field_info.json

# Step 3: 视觉确认（可选但推荐）
python scripts/convert_pdf_to_images.py form.pdf images/

# Step 4: 构造 field_values.json
# [{"field_id": "name", "page": 1, "value": "Smith"}, ...]

# Step 5: 填充并校验
python scripts/fill_fillable_fields.py form.pdf field_values.json filled.pdf

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# Step 1: 结构提取
python scripts/extract_form_structure.py form.pdf form_structure.json

# Step 2: 分析结构，计算字段坐标，构造 fields.json
# 使用 pdf_width / pdf_height 信号

# Step 3: 校验
python scripts/check_bounding_boxes.py fields.json

# Step 4: 填充
python scripts/fill_pdf_form_with_annotations.py form.pdf fields.json filled.pdf

# Step 5: 验证输出
python scripts/convert_pdf_to_images.py filled.pdf verify/

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# Step 1: 转图像
python scripts/convert_pdf_to_images.py form.pdf images/

# Step 2: 粗略估算字段位置 → 裁剪局部区域（Zoom Refinement）
# magick page_1.png -crop 300x80+50+120 +repage crop.png

# Step 3: 精确标定像素坐标，构造 fields.json
# 使用 image_width / image_height 信号

# Step 4-6: 同 Approach A（校验 → 填充 → 验证）

1

解析 ibm-1q-26-earnings-press-release.pdf  提取核心总结，并保存为新的pdf文件