Run any Skill in Manus with one click

$pwd:

word-format

Name: Word Format
Author: yeap531

// 把一份参考 Word (.docx) 的排版样式（字体/字号/缩进/行距/对齐/页面设置/样式表/主题）复刻到新内容上。当用户要求「按某个 .docx 模板排版」「在已有文档基础上续写」「修复后半部分排版混乱」「统一字体字号缩进」等场景时使用。仅在 macOS 工作（依赖 Microsoft Word + 浏览器 + System Events 的 UI 自动化）。

Run Skill in Manus

$ git log --oneline --stat

stars:221

forks:9

updated:April 27, 2026 at 09:05

File Explorer

4 files

SKILL.md

readonly

package.json

"author": "yeap531"

"repository": "yeap531/word-format-skill"

View GitHub Repository View Creator Repositories

$ install --global

$ download --local

Run Skill in Manus

$ useful --forSOC

Word Processors and TypistsOffice and Administrative Support Occupations43-9022L4

Run any Skill with one click

name

word-format

description

把一份参考 Word (.docx) 的排版样式（字体/字号/缩进/行距/对齐/页面设置/样式表/主题）复刻到新内容上。当用户要求「按某个 .docx 模板排版」「在已有文档基础上续写」「修复后半部分排版混乱」「统一字体字号缩进」等场景时使用。仅在 macOS 工作（依赖 Microsoft Word + 浏览器 + System Events 的 UI 自动化）。

word-format

把参考 Word 文档的排版视觉一致地复刻到新内容上。工作方式：直接在原件 HTML 上增删改文字，再让浏览器渲染并把富文本送进 Word。

工作原理：HTML Bridge

参考 .docx
    │  ① docx_to_html.py
    ▼
Word Filtered HTML（原件，所有样式 inline）
    │  ② Claude 在原件上增删改文本（保留所有 inline style）
    ▼
edited.html
    │  ③ render_and_paste.sh
    │     浏览器渲染 → Cmd+A/C → Word 粘贴 → 保存
    ▼
最终 .docx

步骤 ③ 有两种模式，决定能保留多少模板格式：

模式	命令	能保留
B. 续写（推荐）	`--append-to <reference.docx>`	100% 模板格式：页面设置、样式表、主题、页眉页脚、字体表 + 字符级排版
A. 新建	（不带 `--append-to`）	仅字符/段落级排版（字体/字号/缩进/行距/对齐）

想 100% 保留模板格式 → 必须用模式 B。 浏览器粘贴管线本身只能传字符级直接属性，不传@page/样式表/theme1.xml。模式 B 的诀窍：不靠粘贴管线传这些——直接复制原 .docx 副本作为承载文档，新内容用 Cmd+A → → → Cmd+V 续写到末尾，原文档的页面设置 / 样式表 / 主题原封不动地继承下来。

为什么不直接让 Word 打开生成的 HTML 再另存为 .docx

走「Word 打开 HTML → 另存 docx」的是 Word 的 Open Web Page 遗留导入器，对通用 HTML 行为保守诡异：

字体回退链评估方式与浏览器不同，font-family: '宋体', SimSun, serif 可能落到默认字体
text-indent、line-height 在导入时会被 clamp 到 Word 默认范围
<body> 的 padding/margin 不严格遵守 CSS spec

而当前方案：浏览器渲染 → 系统剪贴板 → Word 粘贴，走的是 Word 的「粘贴外部富文本」管线：

浏览器是严格的 CSS 渲染器，所见即所得
字体在浏览器渲染那一刻就钉死，剪贴板里携带的是确定的字体名
Word 粘贴管线把剪贴板里的 HTML+RTF 直接展开成段落直接属性，跳过 HTML 导入器

对 inline-CSS HTML 而言，这是中间损失最小的链路。

环境要求

OS: macOS（脚本依赖 AppleScript / System Events）
Microsoft Word for Mac（/Applications/Microsoft Word.app）
浏览器: Google Chrome（首选）或 Safari
Python 3：系统自带，无第三方依赖
首次运行须开启系统授权：
- 系统设置 → 隐私与安全性 → 自动化：勾选允许「终端宿主进程（Terminal / iTerm / Ghostty / Claude Code）」控制 Microsoft Word、Chrome（或 Safari）、System Events
- 系统设置 → 隐私与安全性 → 辅助功能：启用同一个宿主进程

环境检查：

bash "${SKILL_DIR}/scripts/verify_env.sh"

⚠️ 给 Claude 的硬约束 prompt（编辑 HTML 时必须遵守）

请帮我生成一段专门用于复制粘贴到 Word 文档的 HTML 排版代码。核心要求如下：

必须采用"行内样式"（Inline CSS）的写法：请把所有的样式规则（如字体、字号、间距）直接写在每一个 HTML 标签的 style 属性里面，不要使用 <style> 标签或者外部 CSS，以确保 Word 能够完整读取格式。

严格使用"pt"（磅）作为单位：请务必把字体大小的单位设定为 pt，绝对不要使用 px，以防止因屏幕缩放而导致字号出现误差。

强制表格居中：请不要使用 CSS 的 margin: auto，必须直接在 <table> 标签上添加 align="center" 属性（例如 <table align="center" ...>），这是 Word 唯一能识别的居中方式。

防止页面偏移：请确保 <body> 标签没有 padding 或 margin，防止复制后产生左侧缩进。

宽度控制：大表格请设定 style="width:440pt"（适应 A4 版心），小表格请设定 style="width:auto"。

在"就地编辑原件"模式下的实操含义

核心动作：Claude 用 Read 读原件 → cp 复制为 edited.html → 用 Edit 工具只改文字节点的内容。所有 inline style、嵌套结构、<p>/<span>/<table> 标签原样保留。
第 1、2、5 条：原件本来就是 Word 自己导出，已经符合（inline + pt + 表格宽度合理）。只要不引入新的 <style> 块、不引入 px、不引入 margin:auto，就是合规。
第 3 条：如果原件里某个 <table> 视觉上居中但缺 align="center"，编辑时给它补上。
第 4 条：原件 <body> 通常是 <body lang=ZH-CN style='...'>，编辑时把 style 改成 / 补上 margin:0;padding:0;。
额外禁止：在 HTML 文本节点里写 Markdown 语法（**加粗** / # 标题 / - 列表）；凭空写原件中没出现过的字体名。

完整流程

步骤 1：导出参考 .docx 为 HTML

python3 "${SKILL_DIR}/scripts/docx_to_html.py" "/path/to/reference.docx"
# 产物：~/Library/Caches/word-format-skill/<basename>.html

驱动 Word 自身用「另存为 → 筛选过的网页」导出。Filtered HTML 把字体、字号、缩进、行距等全部以 inline CSS 写进每个标签——这是唯一能 100% 保留 Word 排版信息的文本格式。

步骤 2：Claude 在原件上增删改

按场景选编辑方式：

场景 ★ 续写（最常用，与模式 B 配套）

只产出要追加的新内容，从原件里复制一段同类型段落（含完整 inline style），改文字。

# Claude 选一段原件中已有的同类型段落作为模板段，只产出"待追加内容"：
cat > ~/Library/Caches/word-format-skill/append.html <<'HTML'
<p style="margin:0;font-family:'宋体';font-size:12.0pt;text-indent:24.0pt;line-height:150%;text-align:justify;">
新增的正文段落，照抄原件 inline style 写法，只换文字内容。
</p>
<p style="...">…</p>
HTML

这种 append.html 不需要完整 <html>/<body> 外壳——剪贴板复制的是渲染后的富文本，浏览器会把零散段落正常渲染。但若想严谨，可以包一层 <html><body style="margin:0;padding:0;">…</body></html>。

场景整文重写（与模式 A 配套）

cp ~/Library/Caches/word-format-skill/<basename>.html \
   ~/Library/Caches/word-format-skill/<basename>.edited.html

然后用 Edit 工具就地修改 <basename>.edited.html：只动文本节点的内容，所有标签 / style / 嵌套结构原样保留；同时把 <body ...> 的 style 改成包含 margin:0;padding:0;。

步骤 3：渲染 + 复制 + 粘贴 + 保存

模式 B：续写（推荐，100% 保留模板）

bash "${SKILL_DIR}/scripts/render_and_paste.sh" \
    --append-to "/path/to/reference.docx" \
    ~/Library/Caches/word-format-skill/append.html \
    ~/Desktop/最终输出.docx

脚本顺序：

把 reference.docx 复制为 ~/Desktop/最终输出.docx
浏览器加载 append.html，等 2.5s 字体加载完
在浏览器里 Cmd+A / Cmd+C
Word 打开 ~/Desktop/最终输出.docx（即副本，原模板设置全在）
等 Word 成为前台进程
Cmd+A → 右方向键（光标塌缩到文档末尾）→ Cmd+V（粘到末尾）
save active document（不是 save as，副本已命名）
把焦点还给运行前的前台应用

模式 A：新建空白文档

bash "${SKILL_DIR}/scripts/render_and_paste.sh" \
    ~/Library/Caches/word-format-skill/<basename>.edited.html \
    ~/Desktop/最终输出.docx

脚本顺序：

浏览器加载 <basename>.edited.html，等 2.5s
Cmd+A / Cmd+C
Word 新建空白文档
Cmd+V 粘贴
save as 为指定 .docx
把焦点还给运行前的前台应用

⚠️ 脚本运行期间（约 5~7 秒）不要使用键盘 / 鼠标，UI 自动化在跑。

故障排查

症状	原因 / 处理
步骤 1 报 `-1728`	Word 自动化授权未开 → 系统设置 → 隐私与安全性 → 自动化；或 Word 处于残留状态（脚本会自动 quit + retry 一次）
步骤 3 键盘事件没生效（错误码 1002）	辅助功能权限未开 → 系统设置 → 隐私与安全性 → 辅助功能 → 把宿主进程加入并打开开关
模式 B 续写后页面设置仍是 Word 默认	`--append-to` 没指对源 docx；或 Word 把粘贴内容放进了新节并应用了节属性，检查目标 docx 是否仍是单节
粘贴后字体变 Word 默认中文	编辑时引入了原件没有的字体名
段落整体左侧出现空白	`<body>` 没设 `margin:0;padding:0;`（违反契约 4）
字号在 Word 里轻微偏移	出现了 `px` 单位（违反契约 2）
表格不居中	`<table>` 缺 `align="center"`（违反契约 3）
出现 Markdown 文本 `**` `#`	编辑时夹带了 Markdown，必须用 HTML 标签
粘贴后 Word 文档为空白	Cmd+V 在 Word 还没拿到键盘焦点时落空；脚本里已通过"等待 frontmost = Microsoft Word"修复，若仍出现可加大 `delay`

核心原则

不要擅自提取格式、不要重写片段。 Word Filtered HTML 是"全 inline 化的可渲染页面"，最忠实的复刻方式就是保留它所有的样式标签，只换文字。

想 100% 保留模板（含页面设置 / 样式表 / 主题）→ 用续写模式（--append-to），让原 .docx 副本承载，新内容粘到末尾。 这是 AI 生成 HTML 进入 Word 时损失最小的链路。

name

word-format

description

word-format

把参考 Word 文档的排版视觉一致地复刻到新内容上。工作方式：直接在原件 HTML 上增删改文字，再让浏览器渲染并把富文本送进 Word。

工作原理：HTML Bridge

参考 .docx
    │  ① docx_to_html.py
    ▼
Word Filtered HTML（原件，所有样式 inline）
    │  ② Claude 在原件上增删改文本（保留所有 inline style）
    ▼
edited.html
    │  ③ render_and_paste.sh
    │     浏览器渲染 → Cmd+A/C → Word 粘贴 → 保存
    ▼
最终 .docx

步骤 ③ 有两种模式，决定能保留多少模板格式：

模式	命令	能保留
B. 续写（推荐）	`--append-to <reference.docx>`	100% 模板格式：页面设置、样式表、主题、页眉页脚、字体表 + 字符级排版
A. 新建	（不带 `--append-to`）	仅字符/段落级排版（字体/字号/缩进/行距/对齐）

想 100% 保留模板格式 → 必须用模式 B。 浏览器粘贴管线本身只能传字符级直接属性，不传@page/样式表/theme1.xml。模式 B 的诀窍：不靠粘贴管线传这些——直接复制原 .docx 副本作为承载文档，新内容用 Cmd+A → → → Cmd+V 续写到末尾，原文档的页面设置 / 样式表 / 主题原封不动地继承下来。

为什么不直接让 Word 打开生成的 HTML 再另存为 .docx

走「Word 打开 HTML → 另存 docx」的是 Word 的 Open Web Page 遗留导入器，对通用 HTML 行为保守诡异：

字体回退链评估方式与浏览器不同，font-family: '宋体', SimSun, serif 可能落到默认字体
text-indent、line-height 在导入时会被 clamp 到 Word 默认范围
<body> 的 padding/margin 不严格遵守 CSS spec

而当前方案：浏览器渲染 → 系统剪贴板 → Word 粘贴，走的是 Word 的「粘贴外部富文本」管线：

浏览器是严格的 CSS 渲染器，所见即所得
字体在浏览器渲染那一刻就钉死，剪贴板里携带的是确定的字体名
Word 粘贴管线把剪贴板里的 HTML+RTF 直接展开成段落直接属性，跳过 HTML 导入器

对 inline-CSS HTML 而言，这是中间损失最小的链路。

环境要求

OS: macOS（脚本依赖 AppleScript / System Events）
Microsoft Word for Mac（/Applications/Microsoft Word.app）
浏览器: Google Chrome（首选）或 Safari
Python 3：系统自带，无第三方依赖
首次运行须开启系统授权：
- 系统设置 → 隐私与安全性 → 自动化：勾选允许「终端宿主进程（Terminal / iTerm / Ghostty / Claude Code）」控制 Microsoft Word、Chrome（或 Safari）、System Events
- 系统设置 → 隐私与安全性 → 辅助功能：启用同一个宿主进程

环境检查：

bash "${SKILL_DIR}/scripts/verify_env.sh"

⚠️ 给 Claude 的硬约束 prompt（编辑 HTML 时必须遵守）

请帮我生成一段专门用于复制粘贴到 Word 文档的 HTML 排版代码。核心要求如下：

必须采用"行内样式"（Inline CSS）的写法：请把所有的样式规则（如字体、字号、间距）直接写在每一个 HTML 标签的 style 属性里面，不要使用 <style> 标签或者外部 CSS，以确保 Word 能够完整读取格式。

严格使用"pt"（磅）作为单位：请务必把字体大小的单位设定为 pt，绝对不要使用 px，以防止因屏幕缩放而导致字号出现误差。

强制表格居中：请不要使用 CSS 的 margin: auto，必须直接在 <table> 标签上添加 align="center" 属性（例如 <table align="center" ...>），这是 Word 唯一能识别的居中方式。

防止页面偏移：请确保 <body> 标签没有 padding 或 margin，防止复制后产生左侧缩进。

宽度控制：大表格请设定 style="width:440pt"（适应 A4 版心），小表格请设定 style="width:auto"。

在"就地编辑原件"模式下的实操含义

核心动作：Claude 用 Read 读原件 → cp 复制为 edited.html → 用 Edit 工具只改文字节点的内容。所有 inline style、嵌套结构、<p>/<span>/<table> 标签原样保留。
第 1、2、5 条：原件本来就是 Word 自己导出，已经符合（inline + pt + 表格宽度合理）。只要不引入新的 <style> 块、不引入 px、不引入 margin:auto，就是合规。
第 3 条：如果原件里某个 <table> 视觉上居中但缺 align="center"，编辑时给它补上。
第 4 条：原件 <body> 通常是 <body lang=ZH-CN style='...'>，编辑时把 style 改成 / 补上 margin:0;padding:0;。
额外禁止：在 HTML 文本节点里写 Markdown 语法（**加粗** / # 标题 / - 列表）；凭空写原件中没出现过的字体名。

完整流程

步骤 1：导出参考 .docx 为 HTML

python3 "${SKILL_DIR}/scripts/docx_to_html.py" "/path/to/reference.docx"
# 产物：~/Library/Caches/word-format-skill/<basename>.html

步骤 2：Claude 在原件上增删改

按场景选编辑方式：

场景 ★ 续写（最常用，与模式 B 配套）

只产出要追加的新内容，从原件里复制一段同类型段落（含完整 inline style），改文字。

# Claude 选一段原件中已有的同类型段落作为模板段，只产出"待追加内容"：
cat > ~/Library/Caches/word-format-skill/append.html <<'HTML'
<p style="margin:0;font-family:'宋体';font-size:12.0pt;text-indent:24.0pt;line-height:150%;text-align:justify;">
新增的正文段落，照抄原件 inline style 写法，只换文字内容。
</p>
<p style="...">…</p>
HTML

这种 append.html 不需要完整 <html>/<body> 外壳——剪贴板复制的是渲染后的富文本，浏览器会把零散段落正常渲染。但若想严谨，可以包一层 <html><body style="margin:0;padding:0;">…</body></html>。

场景整文重写（与模式 A 配套）

cp ~/Library/Caches/word-format-skill/<basename>.html \
   ~/Library/Caches/word-format-skill/<basename>.edited.html

步骤 3：渲染 + 复制 + 粘贴 + 保存

模式 B：续写（推荐，100% 保留模板）

bash "${SKILL_DIR}/scripts/render_and_paste.sh" \
    --append-to "/path/to/reference.docx" \
    ~/Library/Caches/word-format-skill/append.html \
    ~/Desktop/最终输出.docx

脚本顺序：

把 reference.docx 复制为 ~/Desktop/最终输出.docx
浏览器加载 append.html，等 2.5s 字体加载完
在浏览器里 Cmd+A / Cmd+C
Word 打开 ~/Desktop/最终输出.docx（即副本，原模板设置全在）
等 Word 成为前台进程
Cmd+A → 右方向键（光标塌缩到文档末尾）→ Cmd+V（粘到末尾）
save active document（不是 save as，副本已命名）
把焦点还给运行前的前台应用

模式 A：新建空白文档

bash "${SKILL_DIR}/scripts/render_and_paste.sh" \
    ~/Library/Caches/word-format-skill/<basename>.edited.html \
    ~/Desktop/最终输出.docx

脚本顺序：

浏览器加载 <basename>.edited.html，等 2.5s
Cmd+A / Cmd+C
Word 新建空白文档
Cmd+V 粘贴
save as 为指定 .docx
把焦点还给运行前的前台应用

⚠️ 脚本运行期间（约 5~7 秒）不要使用键盘 / 鼠标，UI 自动化在跑。

故障排查

症状	原因 / 处理
步骤 1 报 `-1728`	Word 自动化授权未开 → 系统设置 → 隐私与安全性 → 自动化；或 Word 处于残留状态（脚本会自动 quit + retry 一次）
步骤 3 键盘事件没生效（错误码 1002）	辅助功能权限未开 → 系统设置 → 隐私与安全性 → 辅助功能 → 把宿主进程加入并打开开关
模式 B 续写后页面设置仍是 Word 默认	`--append-to` 没指对源 docx；或 Word 把粘贴内容放进了新节并应用了节属性，检查目标 docx 是否仍是单节
粘贴后字体变 Word 默认中文	编辑时引入了原件没有的字体名
段落整体左侧出现空白	`<body>` 没设 `margin:0;padding:0;`（违反契约 4）
字号在 Word 里轻微偏移	出现了 `px` 单位（违反契约 2）
表格不居中	`<table>` 缺 `align="center"`（违反契约 3）
出现 Markdown 文本 `**` `#`	编辑时夹带了 Markdown，必须用 HTML 标签
粘贴后 Word 文档为空白	Cmd+V 在 Word 还没拿到键盘焦点时落空；脚本里已通过"等待 frontmost = Microsoft Word"修复，若仍出现可加大 `delay`

核心原则

不要擅自提取格式、不要重写片段。 Word Filtered HTML 是"全 inline 化的可渲染页面"，最忠实的复刻方式就是保留它所有的样式标签，只换文字。

想 100% 保留模板（含页面设置 / 样式表 / 主题）→ 用续写模式（--append-to），让原 .docx 副本承载，新内容粘到末尾。 这是 AI 生成 HTML 进入 Word 时损失最小的链路。

word-format

word-format

工作原理：HTML Bridge

为什么不直接让 Word 打开生成的 HTML 再另存为 .docx

环境要求

⚠️ 给 Claude 的硬约束 prompt（编辑 HTML 时必须遵守）

在"就地编辑原件"模式下的实操含义

完整流程

步骤 1：导出参考 .docx 为 HTML

步骤 2：Claude 在原件上增删改

场景 ★ 续写（最常用，与模式 B 配套）

场景 整文重写（与模式 A 配套）

步骤 3：渲染 + 复制 + 粘贴 + 保存

模式 B：续写（推荐，100% 保留模板）

模式 A：新建空白文档

故障排查

核心原则

word-format

工作原理：HTML Bridge

为什么不直接让 Word 打开生成的 HTML 再另存为 .docx

环境要求

⚠️ 给 Claude 的硬约束 prompt（编辑 HTML 时必须遵守）

在"就地编辑原件"模式下的实操含义

完整流程

步骤 1：导出参考 .docx 为 HTML

步骤 2：Claude 在原件上增删改

场景 ★ 续写（最常用，与模式 B 配套）

场景 整文重写（与模式 A 配套）

步骤 3：渲染 + 复制 + 粘贴 + 保存

模式 B：续写（推荐，100% 保留模板）

模式 A：新建空白文档

故障排查

核心原则

场景整文重写（与模式 A 配套）

场景整文重写（与模式 A 配套）