word-document

Word 文档工作流

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

当 .docx 的布局和文档结构很重要，而不仅仅是原始文本时，请使用此技能。

• 在可用时，充分利用原生并行子 Agent 调度和 200k+ 上下文窗口。

当前 MCP 现状

Microsoft 在 Microsoft 365 Agents Toolkit 预览版中公开记录了 Word MCP 服务，但工具是否可用仍取决于宿主环境。在 GitHub Copilot 中，你可能会看到 Word 专用工具；在其他客户端中，这些工具可能不可用。如果无法直接访问 Word MCP，请使用随附的本地脚本工作流。

激活条件

根据症状触发操作：符合以下任一条件时，应用此技能并按照下文协议进行验证。

• 创建或编辑 .docx 报告、备忘录或结构化交付物
• 应用标题、表格、图片或样式
• 检查或提取文档结构
• 为后续转换为 PDF 做好 Word 文档准备

实用工作流

1. 确认客户端是否提供 Word MCP 功能。
2. 从结构入手：标题、各级标题、章节和表格。
3. 结构正确后，再统一应用样式。
4. 导出前验证批注、脚注和参考文献。
5. 无法使用 MCP 时，使用本地生成脚本。

MCP 回退方案 – 原生自动化

无法使用 MCP 时，请采用原生自动化：使用 python-docx 处理 .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

• 回退提示词：“不使用 MCP，采用 Word 文档工作流技能。遵循文档说明的本地或手动回退方案，展示所选工具接口，并报告验证证据。”
• MCP 接口不可用时，使用 python-docx、Word 桌面版或文档导出脚本。
• 交付前，在本地重新打开或渲染文档，以验证格式、批注和分页。
• 如果当前宿主未提供 MCP 操作，切勿声称使用了 MCP 操作。

反模式

• 只为作者写作，而不考虑读者：这会引入未说明的背景信息，让实际受众不知道接下来该做什么。
• 跳过具体示例或命令：抽象的指导很容易获得认可，却难以正确应用。
• 任由链接、截图或版本过时：格式再精美，如果说明已不再准确，也无济于事。

验证协议

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

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

文档检查清单

• 标题层级清晰
• 表格易于阅读，样式统一
• 批注或审核备注均为有意添加
• 已移除占位文本
• 生成后已重新打开或以其他方式验证最终文档

参考资料

文档

• DOCX 格式参考 - 实用的格式说明和文档结构指南

脚本

• DOC 模板生成器 - 用于生成适合 Word 的文档结构的本地备用方案

示例

• 报告生成示例 - .docx 输出的报告工作流示例

相关技能

• documentation-authoring：当工作流还需要起草结构化的技术或产品文档时使用。
• documentation-patterns：当工作流还需要可复用的文档结构和模板时使用。
• documentation-quality：当工作流还需要文档审核标准和质量门槛时使用。
• documentation-verification：当工作流还需要在发布前进行最终文档验证时使用。