文件阅览笔记(File Reading Notes)
Overview
将任意一份文件转化为一份结构化、可归档的「阅览笔记」。笔记固定包含四块内容:
1. 文件元信息表 —— 文件名、发文单位、日期、文号等字段(表格呈现);
2. 全文中心思想 —— 一句话概括 + 展开说明;
3. 逐段(逐节)思想分析 —— 拆解每一段/每一节的主旨、要点及其与中心思想的关系;
4. 具体建议 —— 按「理解研判 / 行动执行 / 风险注意 / 下一步」维度给出可落地建议。
输出同时在对话中展示,并默认导出为 Word(.docx) 文件(文件阅览笔记_〈文件名〉.docx)便于打印、归档与转发。
When to use
- 用户说「帮我读这份文件 / 做份读书笔记 / 给这份通知写个阅览笔记 / 分析一下这份公文」。
- 用户粘贴一段文件正文,或给出 pdf/docx/txt/md/csv 文件路径,并希望得到结构化笔记。
- 触发关键词:文件阅览笔记、读书笔记、文件分析、公文笔记、文件摘要+建议。
Workflow
第 1 步:获取文件全文
按输入形态选择获取方式:
- 粘贴文本:直接使用用户提供的正文。
.txt / .md / .markdown / .csv / .tsv / .json / .log文件:用 Read 工具直接读取。.docx文件:运行scripts/extract_text.py提取:
bash python "技能目录/scripts/extract_text.py" "<文件路径>".pdf文件:优先运行scripts/extract_text.py(尽力而为);若输出明显不完整或为空,
改用 workbuddy-pdf 技能精确提取文本,再将文本交回本流程。- 其他格式:先尝试
scripts/extract_text.py兜底读取;失败则请用户粘贴文本或转换为上述格式。
> 提取到的正文是后续所有分析的唯一依据;若原文含图表、附件,需在笔记「备注」中说明「图/表内容未纳入文本分析」。
第 2 步:抽取元信息并建表
扫描正文(及文件名/用户补充)抽取以下字段,按 references/note_template.md 的表格填充:
文件名、标题、发文单位、日期、文号、文件类型、主送单位、密级、主题词、页数、阅览日期。
无法确认的项填「未标明 / 待补充」,严禁编造文号、日期等事实性字段。
第 3 步:总结全文中心思想
用「一句话概括 + 2–4 句展开」的结构,说明文件解决的问题、提出的主张、面向对象与预期目的。
须用自己的话归纳,不得大段照抄原文。
第 4 步:逐段(逐节)思想分析
按文件的自然段落或逻辑小节拆分(一般公文按「开头背景 → 总体要求 → 分点措施 → 保障监督 → 落款」等节划分)。
每段输出:段落大意(1 句)+ 摘抄原文句(1–2 句原封不动的原文,加引号)+ 关键要点(条目)+ 与中心思想的关系(支撑/背景/措施/保障…)。
覆盖全文主要段落;纯格式性内容(如落款、抄送)可合并简述。
第 5 步:给出具体建议
基于文件内容(而非泛泛而谈),按四个维度分条给出可执行建议:
理解研判 / 行动执行 / 风险注意 / 下一步。
建议尽量具体(如「建议 X 月 X 日前完成台账建立」「需重点核对第 X 条与既有制度的冲突」)。
第 6 步:组装并导出为 Word
严格套用 references/note_template.md 的结构与标题层级,生成完整 Markdown 笔记,再转换为 Word:
- 用 Write 工具将完整笔记写入工作区中间文件:
文件阅览笔记_〈文件名脱敏后〉.md; - 在对话中完整展示笔记;
- 运行
scripts/build_docx.py将 Markdown 转为带排版的 Word(主题蓝配色、表头底纹、页眉页脚页码):
bash python "技能目录/scripts/build_docx.py" "文件阅览笔记_〈文件名〉.md" \ --out "文件阅览笔记_〈文件名〉.docx" \ --title "〈文件标题〉" --date "〈阅览日期〉"
(--title/--date可选:不传时标题自动取笔记首行 H1,页脚页码始终生成。) - 用 present_files 指向生成的
.docx,方便用户打开/下载/打印。
(如用户明确只要 Markdown,可跳过第 3 步直接交付 .md。)
输出规范
- 表格字段缺失用「未标明 / 待补充」,不臆造。
- 中心思想与段落分析用自己的归纳语言,可引用原文关键词但避免成段复制。
- 摘抄原文句必须是文件中原封不动的核心句(加引号),不得改写或拼凑。
- 建议必须具体、可操作,并与本文件内容挂钩。
- 全文使用简体中文;保持模板的五个层级标题不变;默认交付
.docx。
Resources
scripts/extract_text.py—— 仅用标准库从 txt/md/csv/docx/pdf 提取纯文本(详见文件头注释)。scripts/build_docx.py—— 将笔记 Markdown 转换为 .docx(纯标准库,支持标题/表格/列表/加粗,含主题蓝配色、表头底纹、页眉页脚页码;配色常量在文件顶部可调)。references/note_template.md—— 笔记标准输出模板(表格 + 四块内容 + 备注),生成时严格套用。