Claude Code 文档 Skill 第二弹：一句话生成专业 Word 文档，排版目录页眉全自动

1. 为什么我要把 Word 排版交给 Claude Code写周报、写标书、写技术方案最烦的从来不是内容而是排版。目录要手动标记标题再插入域页眉页脚要一页页设表格列宽调半天还是歪的。我试过用模板结果每次改内容格式就崩改完还得重新对一遍页码。Claude Code 的文档 Skill 解决的正是这件事你用一句话描述需求它直接操控 .docx 底层的 XML 结构生成标准文件而不是模拟鼠标去点 Word 菜单。这意味着排版不会跑偏格式不会乱Office、WPS、Google Docs 打开都正常。这篇是文档 Skill 第二弹聚焦 docx 场景。我会给出可复制的 Skill 配置骨架、settings.json 片段再完整演示一次「一句话生成带目录页眉的专业 Word 文档」并校验结果。适合谁经常产出正式文档、又不想学 Word 高级排版的人已经在用 Claude Code 想扩展能力的开发者以及想把文档生成接进自动化流程的团队。前置条件只有两个本地装好 Claude Code以及一个可用的模型接入端点。下面先把这个端点配好再进正题。2. 前置给 Claude Code 接上 TaoToken 端点Claude Code 本身是个 CLI 工具它需要调用模型 API 才能工作。TaoToken 提供兼容 Anthropic 协议的接入地址配置方式就是改环境变量或 settings.json不需要额外装东西。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。注意 API 地址不带任何查询参数直接填这个就行。你需要先去控制台拿一个 API Key。打开 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 登录后在 API Keys 页面创建一个复制出来形如sk-xxxx的字符串。这个 Key 只显示一次建议先存到密码管理器。拿到 Key 之后最省事的验证方式是先在模型对话页跑一句确认端点通不通 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果那边能正常出字说明 Key 和网络都没问题再往下配 Claude Code 就不会卡在鉴权上。注意API Key 属于敏感凭证不要写进会提交到 Git 的文件里。下面配置我会用环境变量引用避免硬编码。3. 可复制配置settings.json 与 Skill 骨架3.1 配置 Claude Code 的模型端点Claude Code 读取~/.claude/settings.json全局或项目根目录.claude/settings.json项目级。推荐项目级方便不同项目用不同配置。内容如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的Key, ANTHROPIC_MODEL: claude-sonnet-4-5 } }三个字段的作用ANTHROPIC_BASE_URL指向 TaoToken 的兼容端点ANTHROPIC_AUTH_TOKEN填你刚创建的 KeyANTHROPIC_MODEL指定默认模型按你账号可用的型号填。如果你不想把 Key 写进文件可以改成从系统环境变量读取settings.json 里只留ANTHROPIC_BASE_URLKey 用export ANTHROPIC_AUTH_TOKENsk-xxx在 shell 里设。配完执行一次自检claude --version claude -p 回复 ok第二条命令会走一次真实请求。如果返回ok说明端点和鉴权都通了。报 401 就是 Key 错了报连接超时先检查ANTHROPIC_BASE_URL有没有多写斜杠或参数。3.2 放置 docx SkillSkill 是 Claude Code 的技能包机制把专业能力打包成可插拔模块。docx Skill 的目录结构长这样放到项目的.claude/skills/docx/下.claude/skills/docx/ ├── SKILL.md # 技能说明Claude Code 启动时读取 ├── scripts/ │ ├── unpack.py # 解包 docx 为 XML │ └── pack.py # 重新打包并校验 └── reference/ └── docx-js.md # docx-js 用法参考SKILL.md是核心它告诉模型这个技能能做什么、什么时候触发、用哪些脚本。一个精简骨架如下--- name: docx description: 创建和编辑 Word 文档支持目录、页眉页脚、表格、图片、修订模式 --- # docx 技能 ## 何时使用 用户要求生成、修改、分析 .docx 文件时。 ## 创建新文档 使用 docx-jsnpm 包编写 JS 脚本生成标准 .docx。 标题层级用 HeadingLevel目录用 TableOfContents 页眉页脚用 Header/Footer页码用 PageNumber。 ## 编辑已有文档 1. 解包python scripts/office/unpack.py input.docx unpacked/ 2. 编辑 unpacked/ 下的 XML 3. 打包python scripts/office/pack.py unpacked/ output.docx ## 读取分析 pandoc --track-changesall input.docx -o output.md把这段存成SKILL.mdClaude Code 启动时会自动扫描.claude/skills/并加载。你不需要记任何命令用自然语言描述需求模型会自己匹配到这个技能。3.3 安装 docx-js 依赖创建新文档走的是 docx-js需要本地有 Node 环境。在项目里初始化npm init -y npm install docxdocx就是 docx-js 的包名。装完确认版本npm list docx看到版本号输出即可。如果后面生成脚本报Cannot find module docx多半是脚本执行目录不对回到项目根目录再跑。4. 实战一句话生成带目录页眉的 Word 文档4.1 发出需求配置就绪后在项目目录启动 Claude Code直接说帮我生成一份《Q3 项目复盘报告》Word 文档要求 1. 封面页含标题、副标题、日期 2. 自动生成目录 3. 页眉显示文档标题页脚显示页码 4. 正文含三级标题、一个 4 行 3 列的进度表格 5. 保存为 report.docx模型会识别到 docx 技能然后生成一个 JS 脚本。核心片段大致是这样const { Document, Packer, Paragraph, TextRun, HeadingLevel, TableOfContents, Header, Footer, PageNumber, Table, TableRow, TableCell, WidthType, AlignmentType } require(docx); const fs require(fs); const doc new Document({ sections: [{ headers: { default: new Header({ children: [new Paragraph({ text: Q3 项目复盘报告 })] }) }, footers: { default: new Footer({ children: [new Paragraph({ alignment: AlignmentType.CENTER, children: [new TextRun({ children: [PageNumber.CURRENT] })] })] }) }, children: [ new Paragraph({ text: Q3 项目复盘报告, heading: HeadingLevel.TITLE }), new Paragraph({ text: 目录, heading: HeadingLevel.HEADING_1 }), new TableOfContents(目录, { hyperlink: true }), new Paragraph({ text: 一、项目概述, heading: HeadingLevel.HEADING_1 }), new Paragraph({ text: 本季度共交付 3 个里程碑。, heading: HeadingLevel.HEADING_2 }), new Table({ rows: [ new TableRow({ children: [阶段, 计划, 实际].map(t new TableCell({ width: { size: 3000, type: WidthType.DXA }, children: [new Paragraph({ text: t })] }) ) }) ] }) ] }] }); Packer.toBuffer(doc).then(buf fs.writeFileSync(report.docx, buf));关键点TableOfContents插入的是 TOC 域Word 打开后需要「更新域」才会显示页码Header/Footer挂在 section 上整节生效表格列宽用WidthType.DXA控制比百分比稳。4.2 运行与产物把脚本存成gen-report.js执行node gen-report.js ls -lh report.docx看到report.docx生成大小通常在几十 KB。用 Word 或 WPS 打开目录处右键「更新域」→「更新整个目录」页码和条目就出来了。页眉页脚在每一页顶部底部自动出现表格边框和列宽也正常。4.3 编辑已有文档的流程如果是对现有 docx 做批量替换走解包编辑路线python scripts/office/unpack.py report.docx unpacked/ # 编辑 unpacked/word/document.xml python scripts/office/pack.py unpacked/ report-new.docxunpack.py把 docx 拆成 XML 目录你或模型直接改document.xml里的文字节点pack.py重新压缩并做结构校验。这样替换文字能保持原有格式不会像 CtrlH 那样把样式带跑。5. 本篇常见错排查报 401 / invalid api keyANTHROPIC_AUTH_TOKEN填错或过期。去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 重新生成一个注意别把前后空格复制进去。Skill 没被触发检查.claude/skills/docx/SKILL.md是否存在frontmatter 里的name和description有没有写。Claude Code 只在启动时扫描改完要重启会话。Cannot find module docx没装依赖或执行目录不对。在项目根目录跑npm install docx脚本也用绝对路径或从根目录执行。目录打开是空的TOC 是域必须手动「更新域」。这是 Word 机制不是生成失败。想免更新可以在脚本里预生成静态目录但维护成本高一般不建议。页眉页脚只出现在第一页检查是否把 Header/Footer 挂在了正确的 section 上。多 section 文档每节要单独设或者用titlePage区分首页。中文乱码docx-js 默认字体可能不含中文。在TextRun里显式指定font: 微软雅黑或font: SimSun。打包后 Word 提示文件损坏多半是 XML 编辑时破坏了标签闭合。用pack.py的校验输出定位或回退到解包前的备份重来。6. 把文档生成接进你的工作流docx Skill 真正的价值不在单次生成而在可复用。你可以把常用文档类型固化成脚本模板周报、合同、技术方案各存一份 JS 骨架每次只改数据部分。配合 Claude Code 的自然语言入口说一句「用周报模板生成本周的数据在 data.json」就能出稿。如果你要长期跑这类编码和文档自动化任务建议了解一下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它更适合高频、持续的 Agent 场景。接入细节和参数说明都在文档里 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Claude Code 相关的配置示例可以参考 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。下一篇拆 pptx同样的思路一句话出一套演示初稿。