docx-comment-reply

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

Best use case

docx-comment-reply is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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

Teams using docx-comment-reply should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/docx-comment-reply/SKILL.md --create-dirs "https://raw.githubusercontent.com/foryourhealth111-pixel/Vibe-Skills/main/bundled/skills/docx-comment-reply/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/docx-comment-reply/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How docx-comment-reply Compares

Feature / Agentdocx-comment-replyStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Word 批注回复(.docx/.doc)

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

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

## 输出物(约定)

在当前工作目录的 `outputs/` 下生成:
- `*_批注定位与上下文_*.md`:人可读的批注+锚点上下文报告
- `*_comment_context_*.json`:机器可读上下文(用于并行写回复/自动化)
- `*_replies_todo_*.json`:待回复模板(键=comment_id,值=空字符串)
- `*_批注已回复_*.docx`:写回批注回复后的最终交付文件

## 工作流(推荐)

### 1) 提取批注上下文

```powershell
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

```powershell
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 校验;如需单独验证:

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

## 并行(XL 可选)

当批注数量较多(例如 ≥20 条):
1. 先跑提取脚本得到 `comment_context.json`
2. 以 comment_id 分片给子代理写回复(每个子代理 prompt 末尾加 `$vibe`)
3. 合并为一个 replies JSON,再执行 `apply_comment_replies.py`

Related Skills

gh-address-comments

1174
from foryourhealth111-pixel/Vibe-Skills

Help address review/issue comments on the open GitHub PR for the current branch using gh CLI; verify gh auth first and prompt the user to authenticate if not logged in.

docx

1174
from foryourhealth111-pixel/Vibe-Skills

Document toolkit (.docx). Create/edit documents, tracked changes, comments, formatting preservation, text extraction, for professional document processing.

zinc-database

1174
from foryourhealth111-pixel/Vibe-Skills

Access ZINC (230M+ purchasable compounds). Search by ZINC ID/SMILES, similarity searches, 3D-ready structures for docking, analog discovery, for virtual screening and drug discovery.

zarr-python

1174
from foryourhealth111-pixel/Vibe-Skills

Chunked N-D arrays for cloud storage. Compressed arrays, parallel I/O, S3/GCS integration, NumPy/Dask/Xarray compatible, for large-scale scientific computing pipelines.

yeet

1174
from foryourhealth111-pixel/Vibe-Skills

Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using the GitHub CLI (`gh`).

xlsx

1174
from foryourhealth111-pixel/Vibe-Skills

Spreadsheet toolkit (.xlsx/.csv). Create/edit with formulas/formatting, analyze data, visualization, recalculate formulas, for spreadsheet processing and analysis.

xan

1174
from foryourhealth111-pixel/Vibe-Skills

High-performance CSV processing with xan CLI for large tabular datasets, streaming transformations, and low-memory pipelines.

writing-plans

1174
from foryourhealth111-pixel/Vibe-Skills

Use when you have a spec or requirements for a multi-step task, before touching code

writing-docs

1174
from foryourhealth111-pixel/Vibe-Skills

Guides for writing and editing Remotion documentation. Use when adding docs pages, editing MDX files in packages/docs, or writing documentation content.

windows-hook-debugging

1174
from foryourhealth111-pixel/Vibe-Skills

Windows环境下Claude Code插件Hook执行错误的诊断与修复。当遇到hook error、cannot execute binary file、.sh regex误匹配、WSL/Git Bash冲突时使用。

weights-and-biases

1174
from foryourhealth111-pixel/Vibe-Skills

Track ML experiments with automatic logging, visualize training in real-time, optimize hyperparameters with sweeps, and manage model registry with W&B - collaborative MLOps platform

webthinker-deep-research

1174
from foryourhealth111-pixel/Vibe-Skills

Deep web research for VCO: multi-hop search+browse+extract with an auditable action trace and a structured report (WebThinker-style).