docrev
一个让 Markdown 与 Word 用户无缝协作的文档版本控制工具。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:docrev。 它的用途是:一个让 Markdown 与 Word 用户无缝协作的文档版本控制工具。 完整的 Skill 内容见:https://321skill.com/skills/docrev/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我需要和几位使用 Word 的教授合作修改一篇论文,如何管理版本?” 它会介绍 docrev,让你用 Markdown 写作并用 `rev build docx` 分享 Word 稿。收到批注后,用 `rev sync` 将意见导回 Markdown,在终端内处理完再重新生成终稿。
介绍
docrev 解决了学术写作和团队协作中常见的格式混乱问题。当你在 Markdown 中撰写文档并与习惯使用 Microsoft Word 的审稿人合作时,来回修改会产生多个版本混乱的 .docx 文件,导致版本失控和格式漂移。
它通过命令行工作流,让你始终以 Markdown 作为单一事实来源。你可以使用 rev build 命令将包含图表、公式和交叉引用的 Markdown 文档编译成 Word 或 PDF 格式进行分享。当收到带有批注和修订的 Word 文件后,使用 rev sync 命令即可将审阅者的所有反馈(评论和修订)同步回你的 Markdown 源文件中。
这个工具非常适合需要撰写技术文档、学术论文、项目报告等内容创作者和学术研究者,尤其是那些希望利用 Git 进行版本控制,但又不得不与使用 Word 的同事或期刊编辑协作的场景。
使用前需要确保系统已安装 Node.js 18+ 和 Pandoc。对于需要复杂排版(如数学公式、交叉引用、特定期刊样式)的 PDF 生成,建议额外安装 LaTeX;对于简单文档,可以在配置中指定非 LaTeX 引擎(如 typst)来生成 PDF。
核心特点
与仅提供 Markdown 到 Word/PDF 转换的工具不同,docrev 的核心在于其双向同步能力,能将 Word 中的审阅意见和修订内容精准导回 Markdown 源文件,并支持在终端内进行回复和接受/拒绝操作,真正实现了以纯文本为中心的协作闭环。
注意事项
不适合需要直接在 Word 中进行复杂排版和样式设计的场景,其核心仍是基于 Markdown 的文档工作流。
常见问题
docrev 能处理 Word 中的所有格式吗?
主要处理文本、评论、修订、图表、公式和交叉引用等核心学术元素,复杂 Word 样式可能无法完美保留。
必须安装 LaTeX 吗?
生成简单 PDF 可不装,用 typst 等引擎;但如需支持数学公式和期刊模板的复杂 PDF,则需 LaTeX。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/docrev/raw/index.md 读取 docrev 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/docrev/raw/index.md(查看排版版本)