SuperAPI AI 工具集

docx-typst

办公与效率

查看项目

更新于 10-15 21:37

技能介绍

用途:仓库保存 Typst 源码,协作者用 Word 编辑,本技能负责在两者之间双向搬运文档并协调返回的修改。核心事实是 typ → docx → typ 一次往返后达到不动点,因此管道输出本身即合法 Typst,可提交为规范形式,协作者返回文件的协调可简化为 git merge-file。

主要能力:build.py 将 typ 转为 docx(支持 --reference-doc 样式并写入来源标记);canonicalize.py 从 docx 引导生成 body.typ 与 media/,--check 做门禁,--lint 守护 body/main 拆分;reconcile.py 对返回文件与仓库源做三方合并;comments.py 从 docx 或 Drive 提取批注(含锚文本、解决状态与线程);provenance.py 读写来源标记;expand_citations.py 将 #cite(...) 与 @label 冻结为字面正文;make_redline.py 把协作者未跟踪的修改重建为真正的修订。

使用方式:脚本位于 ${CLAUDE_SKILL_DIR}/scripts/,各自独立并支持 --help。必须用 uv run --script <path> 运行,而非 uv run python3,因为多个脚本在 PEP 723 头中声明 lxml,后者会忽略该头并报 ModuleNotFoundError。main.typ 放 #import/#let/#show/#set 并 #include "body.typ",body.typ 为纯标记,pandoc 只读 body.typ。

适用场景:Word 稿件与 Typst 仓库互转、协作者返回文件合并、批注提取、修订重建、Bluebook 引注渲染。

限制:不得让 pandoc 指向 main.typ;不要用 --allow-styling 清除 lint;不要手工编辑返回的 .docx 当作已协调;不要整体删除合并冲突一侧;提交合并前须读 .merged.typ.diff;不要发送基于未提交源码构建的 .docx;--from-docx 必须指定 --media-dir;自定义引注函数会导致 pandoc 失败;合并目标文件不能含实时 #cite;堆叠脚注中 #cite 需写成 #cite(<a>)#[;] #cite(<b>);不要手改生成的 cite-data.typ;不要给 hayagriva 打补丁;新恢复的 body 中 Word 目录需删除并用 #outline() 替代。markdown → docx 由 law-review-docx 与 law-econ-docx 负责,本技能不重叠。