mcpField
D
Documents

Documents

github.com/danielmiessler文档处理19.6k285 次安装1 天前更新
代码仓库

关于 Documents

Documents 是用于创建、编辑和分析 DOCX、PDF、PPTX 与 XLSX 文件的技能，面向文档处理和办公内容工作流。它通过专门子技能与工作流路由各类任务，并强调格式保留和结果验证。

主要功能

  1. 01处理四类常见办公文件
  2. 02按任务路由专用工作流
  3. 03支持修订和文档转换
  4. 04提取 PDF 文本与表格
  5. 05验证格式、公式与输出

适用场景

  1. 01创建带修订标记的 Word 文档
  2. 02合并 PDF 或提取其中表格
  3. 03制作并检查 PowerPoint 演示文稿
  4. 04分析 Excel 数据并建立公式

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/danielmiessler/lifeos --skill documents

安装后在 Claude Code 中输入/documents确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

Docx/
LICENSE.txt
docx-js.md
ooxml.md
Docx/Ooxml/Scripts/
validate.py
unpack.py
pack.py
Docx/Scripts/
__init__.py
utilities.py
document.py
Pdf/
LICENSE.txt
forms.md
reference.md
Pdf/Scripts/
check_bounding_boxes.py
check_bounding_boxes_test.py
check_fillable_fields.py
convert_pdf_to_images.py
create_validation_image.py
fill_pdf_form_with_annotations.py
extract_form_field_info.py
fill_fillable_fields.py
Pptx/
LICENSE.txt
ooxml.md
Pptx/Ooxml/Scripts/
pack.py
unpack.py
validate.py
Pptx/Scripts/
rearrange.py
thumbnail.py
replace.py
html2pptx.js
Workflows/
ConsultingReport.md

详细介绍

自定义

执行前，请检查以下位置是否有用户自定义设置： ~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/Documents/

如果此目录存在，请加载并应用其中的任何 PREFERENCES.md、配置或资源。这些内容优先于默认行为。如果目录不存在，则使用技能默认设置。

🚨 强制要求：语音通知（任何操作前必须执行）

调用此技能时，必须先发送此通知，然后才能进行任何其他操作。

  1. 发送语音通知：

    curl -s -X POST http://localhost:8888/notify \
  -H "Content-Type: application/json" \
  -d '{"message": "Running the WORKFLOWNAME workflow in the Documents skill to ACTION"}' \
  > /dev/null 2>&1 &

  2. 输出文本通知：

    Running the **WorkflowName** workflow in the **Documents** skill to ACTION...

此步骤不可跳过。调用技能后，请立即执行此 curl 命令。

文档技能

🎯 加载完整 PAI 上下文

使用此技能开始任何任务前，请加载完整的 PAI 上下文：

read ~/.claude/PAI/SKILL.md

何时激活此技能

Word 文档（DOCX）
  • 用户希望创建、编辑或分析 Word 文档
  • 用户提到“修订”、“红线标注”或“文档审阅”
  • 用户需要将文档转换为其他格式
  • 用户希望处理文档结构、批注或格式
PDF 文件
  • 用户希望创建、合并、拆分或处理 PDF
  • 用户提到“从 PDF 提取文本”、“PDF 表格”或“填写 PDF 表单”
  • 用户需要将 PDF 转换为其他格式，或从其他格式转换为 PDF
  • 用户希望添加水印、密码或提取图像
PowerPoint 演示文稿（PPTX）
  • 用户希望创建或编辑演示文稿
  • 用户提到“幻灯片”、“演示文稿模板”或“演讲者备注”
  • 用户需要将演示文稿转换为其他格式
  • 用户希望处理幻灯片布局或设计元素
Excel 电子表格（XLSX）
  • 用户希望创建或编辑电子表格
  • 用户提到“公式”、“财务模型”或“数据分析”
  • 用户需要处理 Excel 表格、图表或数据透视表
  • 用户希望将电子表格转换为其他格式，或从其他格式转换为电子表格

工作流路由

请求模式路由至
咨询报告、McKinsey 报告、评估报告、专业 PDFWorkflows/ConsultingReport.md
大型 PDF、处理大型 PDF、Gemini PDFWorkflows/ProcessLargePdfGemini3.md
Word 文档、DOCX、创建 docx、编辑 docx、修订、红线标注Docx/SKILL.md
PDF、创建 PDF、合并 PDF、拆分 PDF、从 PDF 提取文本、填写表单Pdf/SKILL.md
演示文稿、PPTX、幻灯片、PowerPoint、演讲者备注Pptx/SKILL.md
电子表格、XLSX、Excel、公式、财务模型、数据分析Xlsx/SKILL.md

文档类型详情

此技能将文档处理归纳为 4 种文档类型和专用工作流：

咨询报告（HTML + Playwright PDF）

参考文档：

  • Workflows/ConsultingReport.md - 完整的咨询报告生成工作流

路由逻辑：

  • “创建咨询报告”、“生成报告 PDF” → ConsultingReport 工作流
  • “制作评估报告”、“战略评估” → ConsultingReport 工作流
  • “McKinsey 风格报告”、“专业报告 PDF” → ConsultingReport 工作流

处理流程： 报告素材 → 结构化 HTML → Playwright PDF

主要功能：

  • 解析包含混合内容（Markdown、TypeScript 数据、图像）的报告目录
  • 专业 CSS 排版（正文使用 Georgia 衬线字体，标题使用 Inter 无衬线字体）
  • 彩色提示框（红色／琥珀色／绿色）和严重程度徽章
  • 自动生成带链接的目录
  • 带分类标记的封面页
  • 带 CONFIDENTIAL 标记和页码的页眉／页脚
  • 图像压缩流程（PNG → JPEG，最大 1200px）
  • 使用 Playwright 生成像素级精准的 A4 格式 PDF

参考实现： /path/to/reference/generate-pdf.mjs 中的 Quorum Cyber 评估报告

Word 文档（DOCX）

参考文档：

  • docx/SKILL.md - 完整的 DOCX 处理指南
  • docx/docx-js.md - 使用 JavaScript 创建新文档
  • docx/ooxml.md - 使用 OOXML 编辑现有文档

路由逻辑：

  • “创建 Word 文档”“新建 docx” → 创建工作流（docx-js）
  • “编辑 Word 文档”“修订”“红线标注” → 编辑工作流（OOXML）
  • “读取 Word 文档”“从 docx 中提取文本” → 读取工作流（pandoc）
  • “文档审阅”“跟踪更改” → 红线标注工作流

支持资源：

  • 脚本：~/.claude/skills/Utilities/Documents/Docx/Scripts/
  • OOXML 工具：~/.claude/skills/Utilities/Documents/Docx/ooxml/
  • 许可证：~/.claude/skills/Utilities/Documents/Docx/LICENSE.txt

主要功能：

  • 使用 docx-js 创建专业文档
  • 使用修订功能编辑（红线标注工作流）
  • 使用 pandoc 提取文本/评论
  • 转换为图像以便目视检查
  • 使用原始 OOXML 实现高级功能
PDF 处理

参考文档：

  • pdf/SKILL.md - 完整的 PDF 处理指南
  • pdf/forms.md - 填写 PDF 表单
  • pdf/reference.md - 高级功能和故障排除

路由逻辑：

  • “创建 PDF” → 创建工作流（reportlab）
  • “合并 PDF”“拆分 PDF” → 操作工作流（pypdf）
  • “从 PDF 中提取文本” → 提取工作流（pdfplumber）
  • “填写 PDF 表单” → 表单工作流（pdf-lib 或 pypdf）
  • “从 PDF 中提取表格” → 表格提取（pdfplumber + pandas）

支持资源：

  • 脚本：~/.claude/skills/Utilities/Documents/Pdf/Scripts/
  • 许可证：~/.claude/skills/Utilities/Documents/Pdf/LICENSE.txt

主要功能：

  • 使用 reportlab 创建 PDF
  • 使用 pdfplumber 提取文本/表格
  • 使用 pypdf 或 qpdf 合并/拆分
  • 以编程方式填写表单
  • 添加水印和密码保护
  • 从 PDF 中提取图像
PowerPoint 演示文稿（PPTX）

参考文档：

  • pptx/SKILL.md - 完整的 PPTX 处理指南
  • pptx/html2pptx.md - 从 HTML 创建演示文稿
  • pptx/ooxml.md - 编辑现有演示文稿

路由逻辑：

  • “创建演示文稿”“新建幻灯片” → 创建工作流（html2pptx）
  • “编辑演示文稿”“修改幻灯片” → 编辑工作流（OOXML）
  • “使用演示文稿模板” → 模板工作流
  • “提取幻灯片文本” → 读取工作流（markitdown）
  • “创建缩略图网格” → 缩略图工作流

支持资源：

  • 脚本：~/.claude/skills/Utilities/Documents/Pptx/Scripts/
  • OOXML 工具：~/.claude/skills/Utilities/Documents/Pptx/ooxml/
  • 许可证：~/.claude/skills/Utilities/Documents/Pptx/LICENSE.txt

主要功能：

  • 使用 html2pptx 创建演示文稿（HTML → PPTX）
  • 使用配色方案和版式进行专业设计
  • 使用 OOXML 实现高级功能
  • 使用模板（重新排列、清点、替换）
  • 生成缩略图网格以进行视觉分析
  • 转换为图像以便检查
Excel 电子表格（XLSX）

参考文档：

  • xlsx/SKILL.md - 完整的 XLSX 处理指南
  • xlsx/recalc.py - 公式重新计算脚本

路由逻辑：

  • “创建电子表格”“新建 Excel 文件” → 创建工作流（openpyxl）
  • “编辑电子表格”“修改 Excel” → 编辑工作流（openpyxl）
  • “分析数据”“读取 Excel” → 分析工作流（pandas）
  • “财务模型”“公式” → 财务建模工作流
  • “重新计算公式” → 重新计算工作流（recalc.py）

支持资源：

  • 重新计算脚本：~/.claude/skills/Utilities/Documents/Xlsx/recalc.py
  • 许可证：~/.claude/skills/Utilities/Documents/Xlsx/LICENSE.txt

主要功能：

  • 使用 openpyxl 创建含公式的电子表格
  • 使用 pandas 进行数据分析
  • 按照颜色编码标准进行财务建模
  • 使用 LibreOffice 重新计算公式
  • 错误检测和验证
  • 编辑时保留格式和公式

📋 文档处理原则

DOCX 最佳实践
  1. 修订 - 使用红线审阅工作流进行专业文档审阅
  2. 最小化编辑 - 仅标记实际更改的文本，保留原始 RSID
  3. 批量更改 - 将相关编辑分组（3-10 项），以便高效处理
  4. 验证 - 始终转换为 Markdown，以验证更改是否正确应用
PDF 最佳实践
  1. 库的选择 - 基本操作使用 pypdf，文本/表格处理使用 pdfplumber，创建文档使用 reportlab
  2. 扫描件 OCR - 对扫描文档使用 pytesseract + pdf2image
  3. 填写表单 - 按照 forms.md 以编程方式填写表单
  4. 命令行 - 简单操作使用 qpdf/pdftotext
PPTX 最佳实践
  1. 先设计 - 编码前分析内容并选择合适的颜色/布局
  2. Web 安全字体 - 仅使用 Web 安全字体（Arial、Helvetica、Times 等）
  3. 视觉验证 - 始终生成缩略图，以检查布局问题
  4. 模板分析 - 使用模板前先创建清单，了解其结构
XLSX 最佳实践
  1. 使用公式 - 始终使用 Excel 公式，绝不对计算值进行硬编码
  2. 零错误 - 交付时确保没有公式错误（#REF!、#DIV/0! 等）
  3. 重新计算 - 创建/编辑后运行 recalc.py，以更新公式值
  4. 财务标准 - 遵循颜色编码规范（蓝色表示输入，黑色表示公式，绿色表示链接）

示例

示例 1：创建带修订记录的提案

User: "Create a consulting proposal doc with redlining"
→ Routes to DOCX workflows
→ Creates document with docx-js
→ Enables tracked changes for review workflow
→ Outputs professional .docx with revision marks

示例 2：以编程方式填写 PDF 表单

User: "Fill out this NDA PDF with my info"
→ Routes to PDF workflows
→ Reads form fields from PDF
→ Fills fields programmatically with pdf-lib
→ Outputs completed, flattened PDF

示例 3：构建财务模型电子表格

User: "Create a revenue projection spreadsheet"
→ Routes to XLSX workflows
→ Creates workbook with openpyxl
→ Adds formulas (never hardcoded values)
→ Runs recalc.py to update calculations

示例 4：生成专业的咨询报告 PDF

User: "Create a consulting report from the assessment data"
→ Routes to ConsultingReport workflow
→ Parses report directory for data files, markdown, diagrams
→ Compresses images (PNG→JPEG, max 1200px)
→ Generates styled HTML with professional typography
→ Converts to PDF via Playwright with headers/footers
→ Outputs McKinsey-quality A4 PDF with TOC, diagrams, color boxes

🔗 与其他技能的集成

提供给：
  • writing 技能 - 为博客文章和新闻简报创建文档
  • business 技能 - 创建咨询提案和财务模型
  • research 技能 - 从研究文档中提取数据
使用：
  • media 技能 - 为文档插图创建图像
  • development 技能 - 构建文档处理自动化工具
  • system 技能 - 命令行工具和脚本

🎯 核心原则

文档创建
  1. 质量优先 - 从一开始就采用专业的格式和结构
  2. 重复使用模板 - 如有现成模板，请充分利用
  3. 验证 - 始终验证输出（目视检查、错误检查）
  4. 自动化 - 对重复性任务使用脚本
文档编辑
  1. 保留意图 - 保持原始格式和结构
  2. 跟踪更改 - 使用规范的工作流进行文档审阅
  3. 批量处理 - 将相关操作分组以提高效率
  4. 预防错误 - 完成前进行验证
文档分析
  1. 选择合适工具 - 根据任务选择合适的库/工具
  2. 数据完整性 - 提取/转换时保留原始数据
  3. 了解格式 - 理解文档结构（OOXML、PDF 结构等）
  4. 性能 - 对大型文档使用高效方法

📚 完整参考文档

Word 文档（DOCX）：

  • 主指南：~/.claude/skills/Utilities/Documents/Docx/SKILL.md
  • 创建参考：~/.claude/skills/Utilities/Documents/Docx/docx-js.md
  • 编辑参考：~/.claude/skills/Utilities/Documents/Docx/ooxml.md

PDF 处理：

  • 主指南：~/.claude/skills/Utilities/Documents/Pdf/SKILL.md
  • 表单指南：~/.claude/skills/Utilities/Documents/Pdf/forms.md
  • 高级参考：~/.claude/skills/Utilities/Documents/Pdf/reference.md

PowerPoint 演示文稿（PPTX）：

  • 主指南：~/.claude/skills/Utilities/Documents/Pptx/SKILL.md
  • 创建参考：~/.claude/skills/Utilities/Documents/Pptx/html2pptx.md
  • 编辑参考：~/.claude/skills/Utilities/Documents/Pptx/ooxml.md

Excel 电子表格（XLSX）：

  • 主指南：~/.claude/skills/Utilities/Documents/Xlsx/SKILL.md
  • 重新计算脚本：~/.claude/skills/Utilities/Documents/Xlsx/recalc.py

概述

documents 技能提供全面的文档处理能力：

  • DOCX - 创建、编辑和分析 Word 文档，并支持修订
  • PDF - 创建、处理和提取 PDF 内容，并支持填写表单
  • PPTX - 创建和编辑演示文稿，并提供专业设计和模板
  • XLSX - 创建和编辑电子表格，并支持公式和财务建模

基于参考资料组织 - 每种文档类型都有完整的指南和工具

自动路由 - 分析用户意图，并启用相应的文档类型工作流

专业品质 - 遵循标准和最佳实践，生成可用于生产环境的文档

评论

支持 Markdown