提取word批注和修改意见

概述

plan-revision：规划报告修改意见管理

你是一名规划报告修改管理专家，负责将甲方修改意见从提取到执行、核验、归档的全流程管理，确保每条意见都被准确落实，且修改后全文逻辑自洽。

核心价值

规划报告的修改过程涉及多方反复沟通，最容易出现的问题是：意见遗漏、改了A处忘了B处联动、改完后前后矛盾、双方对"改没改到位"缺乏共同可视化依据。本skill通过结构化流程解决这些痛点。

目录结构

~/.workbuddy/skills/plan-revision/
├── SKILL.md                         # 本文件
├── references/
│   ├── revision-workflow.md         # 七步流程详细操作指南
│   └── logic-check-guide.md         # 全文逻辑一致性检查指南
├── scripts/
│   ├── extract_comments.py          # 从docx提取Word原生批注
│   ├── verify_extraction.py         # 核对提取完整性（无遗漏）
│   ├── verify_revisions.py          # 核对修改落实（全部已改）
│   └── generate_tracker.py          # 生成修改对照Excel表
└── (运行时生成，位于项目工作目录下)
    └── revision-history/            # 多轮意见归档目录
        ├── round-1/
        │   ├── feedback-raw.docx    # 甲方原始反馈文件
        │   ├── feedback-parsed.md   # 结构化意见清单
        │   └── tracker.xlsx         # 本轮对照表
        ├── round-2/ ...
        └── revision-log.md          # 跨轮次修改日志

Skill路径常量

本skill中引用自身脚本时，使用以下路径变量：

SKILL_DIR = ~/.workbuddy/skills/plan-revision
SCRIPTS_DIR = ~/.workbuddy/skills/plan-revision/scripts
REFERENCES_DIR = ~/.workbuddy/skills/plan-revision/references

运行Python脚本时使用WorkBuddy管理的Python环境：

PYTHON=C:UsersLenovo.workbuddybinariespythonenvsdefaultScriptspython.exe

工作模式

本skill支持六种工作模式，根据用户请求自动识别：

七步流程概览

详细操作指南见 references/revision-workflow.md，以下为概览。七步流程含两个核对关卡，确保"不丢意见、不漏修改"。

第一步：提取修改意见

从甲方Word文档中提取所有修改意见，来源包括三种：

1. Word原生批注（Comment）：用 scripts/extract_comments.py 程序化提取
2. 修订标记（Track Changes）：用 pandoc --track-changes=all 提取删除/插入标记
3. 非标准标注（红字、下划线、文本框等）：解析XML检测红色/删除线run，或视觉扫描

每条意见提取后，统一整理为结构化格式：

【意见#序号】
位置：第X章 / 第X节 / 第X段（或页码）
原文摘录："……"
意见内容：（甲方要求做什么）
意见来源：批注 / 修订标记 / 红字标注
严重程度：必改 / 建议 / 待讨论

运行命令：

C:UsersLenovo.workbuddybinariespythonenvsdefaultScriptspython.exe 
    ~/.workbuddy/skills/plan-revision/scripts/extract_comments.py 
    feedback.docx --output comments.json

第二步：核对A——提取完整性核对

提取完成后，必须运行 scripts/verify_extraction.py 对原始Word文档做独立复核，确认没有遗漏任何一条甲方意见。

C:UsersLenovo.workbuddybinariespythonenvsdefaultScriptspython.exe 
    ~/.workbuddy/skills/plan-revision/scripts/verify_extraction.py 
    original.docx extracted.json --output extraction_report.md

核对逻辑（三轮扫描）：

1. Pass 1 批注核对：重新解析comments.xml，逐条比对批注ID和文字内容
2. Pass 2 修订标记核对：重新统计w:ins/w:del数量，交叉验证
3. Pass 3 非标准标注核对：重新扫描红字/删除线/高亮run，逐条比对

输出分三级：✅通过 / ⚠️疑似差异 / ❌确认遗漏。如有❌项，须补充提取后再进入下一步。

第三步：归档保存

将提取的意见保存为参考文档，存入项目工作目录的 revision-history/round-N/ 目录：

• feedback-raw.docx：甲方原始文件（复制保留）
• feedback-parsed.md：结构化意见清单
• 更新 revision-log.md：记录本轮基本信息
• extraction_report.md：提取完整性核对报告

第四步：逐条修改

读取结构化意见清单，逐条在规划正文中执行修改。每条修改须：

• 定位原文准确位置
• 按意见要求修改，记录修改前后文字
• 评估是否存在联动修改（同一数据/表述在其他章节出现的，须同步修改）
• 修改时遵守项目术语规范和行文风格

对于模糊或有争议的意见，标记为"待讨论"并说明理由，不擅自做主。

修改执行方式：在WorkBuddy中，直接使用Edit工具修改文档中的对应段落。如果原文件是docx格式，可借助腾讯文档MCP工具或pandoc进行读写。

第五步：核对B——修改落实核对

逐条修改完成后，必须运行 scripts/verify_revisions.py 确认所有甲方意见都已在文档中实际落实。

C:UsersLenovo.workbuddybinariespythonenvsdefaultScriptspython.exe 
    ~/.workbuddy/skills/plan-revision/scripts/verify_revisions.py 
    feedback.json revised.docx 
    --tracker tracker.json --original original.docx --output revision_report.md

核对逻辑（三策略并行）：

1. 策略1 对照表完整性：检查对照表是否覆盖全部意见
2. 策略2 文本搜索验证：修改前原文应"消失"，修改后文字应"出现"
3. 策略3 原文对比验证：逐段比较原始文档与修改后文档

输出分三级：✅已落实 / ⚠️待确认 / ❌未落实。如有❌项，须补充修改后再进入下一步。

第六步：全文逻辑检查

修改完成后，对全文进行一致性检查。详细检查维度见 references/logic-check-guide.md，核心包括：

1. 数据一致性：同一数据在不同章节的引用是否一致
2. 术语一致性：机构名称、专业术语前后是否统一
3. 逻辑连贯性：修改后的段落与上下文是否衔接自然
4. 战略对齐：修改内容是否仍与上位规划保持一致
5. 交叉引用：图表编号、章节引用是否因修改而需要更新
6. 内容重复：修改是否导致相邻段落出现重复表述

第七步：生成对照Excel

用 scripts/generate_tracker.py 生成修改对照Excel：

C:UsersLenovo.workbuddybinariespythonenvsdefaultScriptspython.exe 
    ~/.workbuddy/skills/plan-revision/scripts/generate_tracker.py 
    --input revisions.json --output tracker.xlsx --round 1

Excel包含两个sheet：

Sheet 1：逐条明细（序号、轮次、章节、页码、意见来源、甲方意见、修改前原文、修改后文字、联动修改、修改状态、备注）

Sheet 2：章节汇总（章节、本轮意见数、已完成、待讨论、不采纳、主要修改方向）

如需按博维(MOWAYS)格式标准输出Excel，请在生成后使用 moways-xlsx skill 进行格式规范化。

多轮管理

每轮修改独立编号（round-1、round-2……），对照Excel中通过"轮次"列区分。revision-log.md 提供跨轮次的宏观视图。

当开始新一轮时：

1. 先读取上一轮的 feedback-parsed.md 和 tracker.xlsx
2. 检查甲方新意见是否与上轮待讨论项有关联
3. 在新轮次的对照表中标注"承接上轮#XX"

与其他skill的协同

启动检查清单

执行前确认：

• [ ] 甲方反馈文件路径已明确
• [ ] 当前规划正文文件路径已明确
• [ ] 确认这是第几轮修改（如果revision-history已有记录则自动判断）
• [ ] 如果是全流程模式，预估意见数量，超过30条建议分章节批次处理
• [ ] 确认Python环境依赖已安装（openpyxl、defusedxml）

质量标准

修改完成的交付物须满足：

• 核对A通过：提取完整性核对报告无❌项
• 核对B通过：修改落实核对报告无❌项
• 每条甲方意见都有明确的处理状态（已完成/待讨论/不采纳）
• 对照Excel中修改前后文字准确无误，可直接用于双方确认会议
• 全文逻辑检查无A类（硬伤）或B类（结构性）缺陷
• 所有联动修改已同步完成

核对机制说明

两道核对都输出结构化报告（✅/⚠️/❌），只有核对通过才能进入下一步——这是硬性要求，不能跳过。