word-document

Word Document Workflows

技术栈目标与版本：Word 桌面版，或采用当前兼容 OOXML 工作流的 python-docx 自动化。

当 .docx 版式与文档结构（而非仅原始文本）重要时，使用此技能。

在可用的情况下，利用原生并行子代理调度与 200k 以上上下文窗口。

当前 MCP 现实情况

Microsoft 在 Microsoft 365 Agents Toolkit 预览中公开记录了一个 Word MCP 服务器，但工具的可用性仍取决于宿主。在 GitHub Copilot 中你可能会看到 Word 专用工具；在其他客户端中它们可能缺失。若无法直接使用 Word MCP 访问，请使用随附的本地脚本工作流。

激活条件

使用“症状到动作”触发器：当某一条件匹配时，应用此技能并用下方协议进行验证。

创建或编辑 .docx 报告、备忘录或结构化交付物
应用标题、表格、图片或样式
审阅或提取文档结构
在后续 PDF 转换前准备 Word 输出

实用工作流

确认客户端是否暴露 Word MCP 能力。
从结构开始：标题、各级标题、章节、表格。
仅在结构正确后，再一致地应用样式。
在导出前验证批注、脚注与引用。
当 MCP 访问不可用时，使用本地生成器脚本。

MCP 回退——原生自动化

当 MCP 不可用时，使用原生自动化：对 .docx 使用 python-docx，对不支持的结构直接检查 OOXML，当版式重要时进行 PDF 导出检查。保留样式、表格、页眉、页脚、批注、修订预期与元数据，然后在声称成功前重新打开或解析文档。

跨客户端可移植性

本技能在编写上力求在 GitHub Copilot、Claude Code 与 Codex 中保持可用。

GitHub Copilot：将文件夹放在 Copilot 可见的技能路径中，或在文件夹发现不可用时将工作流包装进项目指令。

Claude Code：将文件夹放在本地技能目录或兼容的插件源中。

Codex：将文件夹安装或同步到 $CODEX_HOME/skills/word-document，并在重大更改后重启 Codex。

MCP 可用性与回退

首选 MCP 服务器：Word Document MCP

回退提示词：“Use the Word Document Workflows skill without MCP. Follow the documented local or manual fallback, show the selected tool surface, and report the verification evidence.”

当 MCP 表面不可用时，使用 python-docx、Word 桌面版或文档导出脚本。

在本地重新打开或渲染文档，以便在交付前验证格式、批注与分页。

当活动宿主未暴露 MCP 时，不要声称使用了 MCP 操作。

反模式

为作者而非读者写作：这会固化未言明的上下文，令实际受众不确定下一步该做什么。
跳过具体示例或命令：抽象指引容易获得认可，却难以正确应用。
放任链接、截图或版本漂移：如果指令不再成立，再精致的格式也无济于事。

验证协议

在声称“技能已成功应用”之前：

通过/不通过：在编辑前已说明 Word 文档工件类型、目标格式与所需输出保真度。
通过/不通过：已检查 MCP 可用性，并在 MCP 缺失时指明原生自动化回退路径。
通过/不通过：生成的文件或公式已在本地打开、解析、渲染或以其他方式验证。
压力测试场景：将工作流应用于具有格式、元数据或转换边缘情况的文件，并验证没有重要内容丢失。
成功指标：零未经验证的文档声明；工件本身即证据。

文档检查清单

标题层级清晰
表格可读且样式一致
批注或审阅备注是有意为之
占位文本已移除
生成后已重新打开或以其他方式验证最终文档

参考与资源

文档

DOCX Formatting Reference - Practical formatting notes and document structure guidance（DOCX 格式参考——实用格式说明与文档结构指引）

脚本

DOC Template Generator - Local fallback for generating Word-ready document structures（DOC 模板生成器——用于生成 Word 就绪文档结构的本地回退方案）

示例

Report Generation Example - Example report workflow for .docx output（报告生成示例——输出 .docx 的报告工作流示例）

技能介绍