office
/office
Tworzy, czyta, zmienia i sprawdza dokumenty Word, Excel i PowerPoint, a także starsze formaty plików biurowych.
- Autor
- touzi0 ↗
- Repozytorium
- jx-assistant ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 06.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 3
- Skrypty
- 1
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 06.11.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
- 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/check_office.py
Co robi i kiedy
Tworzy, czyta, zmienia i sprawdza dokumenty Word, Excel i PowerPoint, a także starsze formaty plików biurowych.
Oryginalny opis (EN)
创建、读取、修改并校验 Word(docx)/ Excel(xlsx)/ PowerPoint(pptx)文档。当输入是这三类文件,或用户要求产出/修改文档、表格、演示文稿时使用。老式格式(.doc/.xls/.ppt)与 WPS 专有格式用 kind=com 老格式分册。
Jak działa
- 通用纪律
- docx 分册要点
- xlsx 分册要点
- pptx 分册要点
- com 分册要点(老式格式与 WPS 文档)
- 结构校验
Podgląd SKILL.md
---
name: office
description: 创建、读取、修改并校验 Word(docx)/ Excel(xlsx)/ PowerPoint(pptx)文档。当输入是这三类文件,或用户要求产出/修改文档、表格、演示文稿时使用。老式格式(.doc/.xls/.ppt)与 WPS 专有格式用 kind=com 老格式分册。
---
# Office 文档技能
三个文档族分别使用:docx → `python-docx`;xlsx → `openpyxl`;
pptx → `python-pptx`。由助手的 `office_skill` 工具获取对应分册要点,
然后用 `run_python` 执行 Python 实际操作(`run_command` 也可用)。
## 通用纪律
- 源脚本、中间文件、成品都放在任务工作区内;技能目录是只读资源。
- 修改既有文件前,先遍历结构(段落/表格/节/页)看清再动手;
用户没要求重设计时,保留原有样式。
- **docx / pptx 动手前先出 MD 草稿**(xlsx 不需要):新建整份文档
先给大纲草稿(每节/每页讲什么),修改既有文档先给修改点清单
(改哪里、改成什么样),交用户过目、同意后再动手;只有用户
明确说「不用确认、直接做」的小改动才可跳过。
- 保存到新文件,除非用户明确要求原地修改。
- **生成后必须跑结构校验**(见下),校验通过才算完成。
- 校验器只保证包结构与文字内容;分页、截断、字体渲染它管不了,
交付前把摘要与用户需求对一遍。
## docx 分册要点
- 直接改 `paragraph.text` 会丢掉 run 级格式;要保格式就改具体的 run。
- 中文必须同时设置 `run.font.name` 与东亚字体(rPr.rFonts 的 w:eastAsia),
只写字体名不保证字形生效。
- 表格按所在节页面宽度设列宽;注意合并单元格与嵌套表。
- python-docx 不做分页与渲染;不要把普通替换谎报为"修订"。
## xlsx 分册要点
- openpyxl 读写同一工作簿,保留公式与格式;公式不会被计算——
要读"计算结果"需 `data_only=True` 打开(前提是文件被 Excel 存过)。
- 大表先看 `ws.dimensions` / `max_row`,不要整表灌进上下文。
- 样式在单元格对象上设置;合并用 `ws.merge_cells`。
## pptx 分册要点
- 版式页:`slide_layouts[0]`=标题页、`[1]`=标题+内容;文本在
shape.text_frame 的 paragraph/run 层级里。
- 图片 `add_picture` 的坐标单位是 EMU(914400 每英寸)。
## com 分册要点(老式格式与 WPS 文档)
适用:python 库读不了的老式 Office 格式(.doc/.xls/.ppt)与 WPS 专有
格式(.wps/.et/.dps)——用本机已装的 Office/WPS 软件的 COM 口处理。
本分册由 office_skill(kind=com) 提供,自动装配 pywin32。
- **run_python 必须带 `com: true` 参数**(如 `{"code": "...", "com": true}`)。
该参数不在工具 schema 里,是本分册的专用执行通道:置 true 时脚本绕过
OS 沙箱在宿主直接执行——COM 在沙箱内无法运行,不带此参数 Dispatch 必
挂起或报错,不要硬试。**仅限 COM 驱动 Office/WPS 的脚本使用,其他脚本
一律不带**;全电脑只读档下该通道不可用。
- ProgID:Word=`Word.Application`、Excel=`Excel.Application`、
PPT=`PowerPoint.Application`;WPS 文字/表格/演示=`KWPS.Application` /
`Ket.Application` / `KWPP.Application`(拿不准用 com-probe 技能探测)。
报「无效的类字符串」= 该软件未装或 ProgID 不对,换一个或如实告知用户。
- 纪律:`Visible=False`、`DisplayAlerts=False`;try/finally 里必须
`Quit()`(漏了会残留 WINWORD/WPS 进程占住文件句柄);改既有文件前先
snapshot_file 打快照。
- 常规套路:老 .doc 先 `SaveAs` 另存 .docx(wdFormatXMLDocument=16)、
.xls 另存 .xlsx(xlWorkbookDefault=51),再交给 python-docx/openpyxl 处理;
转换必有细节损耗,重要版式先向用户说明。
## 结构校验
生成/修改后对本文件执行(由 `office_skill` 工具返回的命令为准):
```text
<python> <技能目录>/office/scripts/check_office.py <文档> --contains 必须出现的文字
```
校验 ZIP 完整性、关键部件 XML、关系文件,并统计 docx 段落/表格/节、
xlsx 工作表与单元格、pptx 页与形状。退出码 0 = 通过。
Pliki w paczce (3)
- SKILL.md 4 KB
- manifest.json 1 KB
- scripts/check_office.py 6 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · touzi0/jx-assistant | 100 | Apache-2.0 |
| lynricsy/hyperskills | 100 | MIT |
| Q00jkf/pixel-office | 96 | MIT |
| okou-ai/okou-skills | 86 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki ffaf34426975 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 98office-file-process
Tworzy, czyta, edytuje i konwertuje pliki Word, Excel i PowerPoint, od odczytu po generowanie raportów, arkuszy i prezentacji. - 85office-parser
Odczytuje dokumenty Word, PowerPoint i Excel strumieniowo, dzieląc je na fragmenty do dalszej pracy z treścią i danymi. - 100wps-cli
Steruje Wordem, Excelem, PowerPointem i PDF przez COM WPS, z 76 poleceniami i wyjściem JSON dla agentów. - 88memory-office-docs
Pomaga tworzyć i sprawdzać dokumenty Word, Excel, PowerPoint i PDF kodem, w tym wzory, konwersje i naprawę błędów otwierania. - 100docview
Pokazuje pliki Word, Excel, PowerPoint, CSV i PDF w oryginalnym układzie w panelu podglądu, zamiast uruchamiać pakiet biurowy. - 90office-documents
Tworzy i konwertuje pliki Word, Excel, PowerPoint i PDF, a przed oddaniem sprawdza je w formacie i przelicza arkusze.