文件通读内容总结 Skill
当用户要求“梳理文件 / 通读文件 / 总结文件”或给出某个文档路径并希望做内容提炼、要点梳理、风险提示时使用本技能。
1. 解析输入
- 从用户消息中提取目标文件路径（必须含扩展名的绝对路径）。
- 若用户未给路径，先用一句话向其索要：“请提供要梳理的文件完整路径（支持 docx / pdf / txt / md）”。
- 若给了多个文件，逐个处理，每个文件独立生成一份总结文档。
2. 读取文件文本
根据扩展名选择读取方式：
- .txt / .md：直接用 Read 工具读取全文。
- .doc（Word 97-2003 旧格式）：运行专用脚本（用本技能目录下的 scripts/extract_doc.py），它用 olefile 读取 WordDocument 流并按 FIB 的 fcMin/fcMac 截取正文区间、按 UTF-16-LE 解码，无需 LibreOffice/Word：
<PY> "<SKILL_DIR>/scripts/extract_doc.py" "<文件路径>"
- .docx / .pdf：运行提取脚本，将文本打印到标准输出后读取：
<PY> "<SKILL_DIR>/scripts/extract_text.py" "<文件路径>"
（若 venv 不存在或 python-docx / pdfplumber 缺失，先按第 5 节安装依赖。）
- 其他格式：尝试按 UTF-8 文本读取；失败则告知用户无法解析并停止。
3. 通读并产出结构化总结
以模型通读全文，按下面五部分组织（用原文事实，不编造；拿不准的标注“待确认”）：
- 文件概览：文件性质（合同/通知/报告/制度…）、主题、适用对象、核心目的、生效/签署等关键元信息。
- 主要内容（分层分条目）：按文件原有章节或逻辑层级，用「一级标题 → 二级要点 → 条目」三级结构整理；每条尽量用一句话概括，保留关键数字、期限、金额、主体名称。
- 需重点关注的条款：对权责、义务、违约、费用、期限、终止/解除、保密、知识产权、争议解决等高风险或高价值条款单独列出，并说明“为什么重要”。
- 易忽视的条款：列举容易被跳读但暗藏风险/成本的细节（如自动续约、单方解释权、通知方式、附件效力、兜底条款、定义口径、沉默视为同意等），并提示风险。
- 备注/建议（可选）：对下一步行动或需人工复核事项的提示。
4. 生成 Word 文档
把上面的结构化内容写成 JSON（schema 见 scripts/make_docx.py 头部注释），保存到临时文件，再运行：
<PY> "<SKILL_DIR>/scripts/make_docx.py" "<summary.json路径>"
- JSON 必填字段：source_name（不含扩展名的原文件名）、output_path（生成的 docx 绝对路径）、overview、main_sections、key_clauses、overlooked_clauses。
- output_path 必须设为：原文件所在目录 + source_name + 内容总结.docx（例如原文件 C:/a/合同.docx → C:/a/合同内容总结.docx）。
- main_sections 为数组，每项 { "title": "一、...", "items": [...] }；items 元素可为字符串，或为嵌套 { "title": "...", "items": [...] }（最多再嵌套一层）。
生成成功后，调用 present_files 打开并预览该 docx。
5. 依赖（首次使用前的准备）
本技能依赖托管 Python（WorkBuddy 自带的隔离 Python）。运行前请先确定两处路径：
<SKILL_DIR>：本技能的安装目录，即SKILL.md所在目录（安装后通常位于~/.workbuddy/skills/file-summary/）。脚本均在该目录的scripts/下，调用时请用相对该目录的路径，不要写死绝对路径，以便在不同机器间转发。<PY>：托管 Python 解释器。- 优先：
C:/Users/Administrator/.workbuddy/binaries/python/envs/default/Scripts/python.exe（Windows，venv 版）。 - 若该路径不存在，用 WorkBuddy 管理的
python.exe（位于.../binaries/python/versions/3.13.12/python.exe），先建 venv 再装包。 - 仍不可用则回退为命令
python3（需系统已装 Python 3），并确保依赖已安装。
确保解释器对应的环境装有以下包（pdfplumber 仅 pdf 需要，olefile 仅旧版 .doc 需要）：
<PY> -m pip install python-docx pdfplumber olefile
> 说明（Windows）：venv 的 python 可执行文件位于 envs/default/Scripts/python.exe（envs/default/python.exe 不存在），脚本调用请用 Scripts/ 下那个。若 envs/default 已存在但缺包，直接跑上面的 install 即可。
6. 交付口径
向用户简要汇报：生成了哪个文件、位于何处、全文共梳理出几大板块、重点/易忽视条款各几条。不要复述整篇总结，让用户看文档本身。
