compare-docs

文档比较技能

此技能用于比较两份文档，找出实质性差异、错误或不一致之处。尤其适用于法律合同、财务报告或修订后的文档版本。

用法

# Compare two specific files
/compare-docs file1.docx file2.docx

# Compare with specific focus
/compare-docs file1.docx file2.docx --focus "financial data"

工作流

1. 输入验证：

   • 确认两个输入文件都存在。
   • 确定文件类型（.docx、.pdf、.md、.txt）。

2. 内容提取：

   • 如果文件是 .docx，使用 pandoc 将其转换为 Markdown，以便清晰地分析文本。

     pandoc -t markdown "file1.docx" -o "file1.md"
     pandoc -t markdown "file2.docx" -o "file2.md"
     

   • 如果文件是 .pdf，使用可用的 PDF 阅读工具。

3. 分析与比较：

   • 阅读提取出的内容。
   • 按章节或逐项键值比较文档。
   • 重点关注：
     • 数字与日期： 检查财务数据、日期、百分比和数量是否存在差异。
     • 关键条款： 找出新增、删除或修改的条款（尤其是在法律或合同语境中）。
     • 定义： 检查定义术语是否有变化。
   • 注意： 除非明确要求，否则忽略细微的格式变化。

4. 生成报告：

   • 创建 Markdown 报告（comparison_report.md），结构如下：
     • 摘要： 简要概述比较结果。
     • 重大差异（高风险）： 数据不匹配、条款缺失、义务冲突。
     • 实质性变更： 含义或范围上的变化。
     • 风格／格式变更：（可选）简要说明不影响含义的布局或措辞变化。
     • 建议： 根据发现提供可执行的建议。

5. 输出格式与交付：

   • 使用 pandoc 将 Markdown 报告转换为专业的 .docx 文档。

     pandoc "comparison_report.md" -o "Comparison_Report.docx"
     

   • 打开文件： 自动打开生成的文档，以便用户立即查看。
     • 在 macOS 上：open "Comparison_Report.docx"
     • 在 Windows 上：start "Comparison_Report.docx"
     • 在 Linux 上：xdg-open "Comparison_Report.docx"
   • 告知用户报告所在位置。

6. 清理：

   • 删除临时中间文件（例如转换生成的 .md 文件），保持工作区整洁。

输出结构示例

比较报告

1. 执行摘要

...

2. 主要差异

项目	文件 A 中的值	文件 B 中的值	影响
收入	$10M	$12M	显著
...	...	...	...

3. 条款详细分析

...