Docx comment reply

Skill foryourhealth111-pixel/Vibe-Skills/bundled/skills/docx-comment-reply

VibeSkills is a general-purpose Skill that automatically routes local Skills and intelligently orchestrates harness workflows.

Install

npx -y skills add foryourhealth111-pixel/Vibe-Skills --skill docx-comment-reply

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Reply to comments (批注) in Word .docx/.doc files: extract comment context, draft replies, write threaded replies back, and validate OOXML.

SKILL.md

2.4 KB, as published. Nobody here has run it

Word 批注回复（.docx/.doc）

这个 skill 解决的问题：把 Word 文档里的批注（comments）按“原文锚点上下文”整理出来，生成待回复清单，然后把回复以 threaded replies 的方式写回到新的 .docx 文件里（不改原文件）。

适用场景：专利/论文/合同/内部评审等需要“逐条回复批注”的文档。

输出物（约定）

在当前工作目录的 outputs/ 下生成：

*_批注定位与上下文_*.md：人可读的批注+锚点上下文报告
*_comment_context_*.json：机器可读上下文（用于并行写回复/自动化）
*_replies_todo_*.json：待回复模板（键=comment_id，值=空字符串）
*_批注已回复_*.docx：写回批注回复后的最终交付文件

工作流（推荐）

1) 提取批注上下文

python scripts/extract_comment_context.py --input "path\\to\\file.docx"

如果输入是 .doc，脚本会尝试用 LibreOffice soffice 转成 .docx 后继续。

2) 生成回复（由你/Claude 来写）

打开 outputs\\*_批注定位与上下文_*.md，逐条写回复。
把回复填进 outputs\\*_replies_todo_*.json（保持 JSON 结构不变）。

回复口径（强约束）

直接回答问题（别写“后续补充”但不说补什么）
必须贴合锚点原文（避免泛泛而谈）
不要用“老师您好/您好”类开头；口语化但专业

3) 写回批注回复并生成新 docx

python scripts/apply_comment_replies.py `
  --unpacked "outputs\\<xxx>_unpacked_<timestamp>" `
  --replies "outputs\\<xxx>_replies_todo_<timestamp>.json" `
  --author "YourName" `
  --initials "YN"

4) 校验（必须）

脚本默认会在保存时做 schema + redlining 校验；如需单独验证：

python ..\\docx\\ooxml\\scripts\\validate.py "outputs\\<unpacked_dir>" --original "outputs\\<out>.docx"

并行（XL 可选）

当批注数量较多（例如 ≥20 条）：

先跑提取脚本得到 comment_context.json
以 comment_id 分片给子代理写回复（每个子代理 prompt 末尾加 $vibe）
合并为一个 replies JSON，再执行 apply_comment_replies.py