office-writerlisted
Install: claude install-skill sanqiuyef/office-writer-skill
# Office Writer
一个能力一个入口,32 个脚本与 mcp-office-writer 0.6.0 的 32 个工具 1:1 对应。所有文档逻辑在 `scripts/office_engine/`(vendored),本 skill 只做 CLI 适配、JSON 契约和验收辅助,不启动 MCP 服务。
## 触发条件
用户要求创建、修改、读取、转换或验收办公文档时使用:
- Word:写报告/公文/论文/简历/合同、套模板、Markdown 转 Word、追加内容、目录、页眉页脚、封面。
- Excel:多工作表、表头/格式/合并/冻结/筛选、公式写入与重算。
- PowerPoint:新建演示文稿、追加幻灯片、配色、布局优化、清理占位符、分析模板、生成框架图/流程图。
- PDF:新建 PDF、Office 转 PDF、逐页渲染 PNG、结构化读取、字号/字体验收。
- 结构化编辑:按 `/body/p[1]`、`/Sheet1/A1`、`/slide[1]/shape[2]` 路径原子批量编辑。
- 活动文档:Word/WPS、Excel/WPS 表格、PowerPoint 已打开文档的实时追加。
## 何时不要用
- 只想“想文案/改措辞”,不需要生成或修改文档 → 直接写文本或使用写作类 skill。
- 只做 Excel 数据排序、透视、统计建模 → 用 pandas/openpyxl 脚本;本 skill 负责版式与写入。
- 只做 PDF 拆分/合并/加密/OCR 校对 → 用专门的 PDF 工具;本 skill 的 OCR 仅用于读取扫描件。
- 需要生成示意图/海报/插画 → 用绘图或生图工具;`ppt_create_framework_diagram` 只画阶段+节点+箭头。
- 需要启动 Word/WPS/Excel/PowerPoint → 活动文档入口只连接现有窗口,不启动应用;转换/渲染/重算的 COM 回退是例外:它用 `DispatchEx` 启动隐藏独立实例,完成后 Quit。
- 非 Windows 环境需要 COM 活动文档或 COM 转换 → 用文件级入口并安装 dsoffice;COM 回退会明确报不可用。
## 能力→脚本索引
所有脚本在 `scripts/`,用同一解释器(Python ≥ 3.10)运行;通用前缀:
```bash
python -X utf8 scripts/<脚本名>.py --help
```
所有入口都支持 `--params '<JSON 对象>'` 与 `--params-file <路径>`;复杂模型参数放在 JSON 中,由 Pydantic `model_validate` 校验。显式 flag 优先于同名 `--params` 键。
| 脚本 | 能力 | 关键参数 |
|:---|:---|:---|
| `scripts/create_word_document.py` | 创建 Word;模板/场景/封面/页眉页脚 | `--output-path`、`--template`、`--scene`、`--params`(`content`、`page_setup`、`header_footer`、`default_font`、`cover_config`) |
| `scripts/edit_word_document.py` | 向已有 Word 追加内容块 | `--file-path`、`--params`(`appe