用途:将法律评论(Law Review)类 Markdown 草稿构建为格式规范的 .docx,是该项目指定的唯一正确构建方式,不应手写 pandoc/soffice 命令。
主要能力:脚本 build_docx.py 会从 .planning/ACTIVE_WORKFLOW.md 或 PRECIS.md 识别标题与作者;按章节顺序(引言→各部分→结论→附录)合并 drafts/Draft.md;剥离 YAML frontmatter 并为脚注标签加前缀以避免跨节冲突;解析 <!-- include: PATH --> 哨兵内联外部文件(路径须为绝对路径或 ~ 展开,缺失时输出可见 <!-- MISSING: ... --> 占位);以 --reference-doc 指向法律评论模板运行 pandoc;可选运行 docx-repair 修复脚注。模板定义 Title、Heading 1-3、Body Text、First Paragraph、Footnote Text 等样式。图片以 PNG 引用并保留同名 .svg,构建后按内容哈希匹配并附加 svgBlip,使 Word 2016+ 渲染矢量图。
使用方式:uv run python3 ${CLAUDE_SKILL_DIR}/scripts/build_docx.py PROJECT_DIR [--output PATH] [--fix-footnotes]。无 Skill 工具的子代理可直接运行该脚本。导出后报告输出路径、章节数、脚注数与大致字数。另有 check_widows.py 与 fix_widows.py 处理排版孤行,建议先 --dry-run。
限制与注意:不要从 Markdown 直接引用裸 .svg,也不要用 LibreOffice 将 SVG 转 EMF;验证图片应统计渲染后 PDF(pdfimages -list manuscript.pdf | tail -n +3 | wc -l),而非 DOCX 中的 media 条目。Word 渲染依赖 cmux 与系统权限配置,可用 $DOC_RENDER_NO_CMUX=1 回退。脚注中 pandoc-citeproc 的括号包裹问题由 fix_footnotes.py 后处理。标题页间距等细节见 references/title-page-spacing.md。具体收费、平台支持等信息暂未提供。