name	docx-report
description	使用 python-docx 读取、分析和修改 Word .docx 文件的通用工作流程，适用于读取段落、表格、单元格、样式，填写现有 Word 表格报告，或从 Excel/JSON 等数据源生成新的 docx。

Docx Report

处理 Word .docx 文件时使用本 skill。

核心原则

优先用事实读取结果驱动操作。不要凭文件名、肉眼印象或用户口头描述猜表格结构。

库选择：

python-docx：读取和修改现有 .docx 的段落、表格、单元格、样式。默认优先使用。
docxtemplater：用于已有 {占位符} 的模板渲染，不作为直接修改现有表格报告的默认方案。
直接读取 docx 内部 XML：仅在 python-docx 无法处理页眉页脚、复杂字段、特殊结构时使用。

工作流程

确认输入 .docx 存在，先只读不改。
用 python-docx 输出结构：
- 段落数量和非空段落文本
- 表格数量
- 每个表格的行数、列数
- 每个表格前几行的单元格文本
根据读取结果给表格编号、行号、列号，不要使用模糊定位。
如果要从外部数据源填 Word，先读取数据源结构并说明字段映射。
写回前默认生成新文件，不覆盖原始 docx；用户明确要求覆盖时才覆盖。
写回后重新读取目标文件，核对目标段落或单元格内容已经写入。

常用读取脚本

from pathlib import Path
from docx import Document

path = Path("input.docx")
doc = Document(path)

print("paragraphs", len(doc.paragraphs))
print("tables", len(doc.tables))

for i, paragraph in enumerate(doc.paragraphs, 1):
    text = paragraph.text.strip()
    if text:
        print(f"{i}: {text}")

for table_index, table in enumerate(doc.tables, 1):
    print(f"TABLE {table_index}: rows={len(table.rows)} cols={len(table.columns)}")
    for row_index, row in enumerate(table.rows[:10], 1):
        values = [cell.text.strip().replace("\n", " / ") for cell in row.cells]
        print(f"  {row_index}: {values}")

写回注意

修改表格时优先按表格编号、行号、列号定位。
如果表格有合并单元格，读取时同一文本可能重复出现；写入前要确认目标单元格。
涉及计算结果时，先说明计算口径，再写入。
写入后必须重新读取目标文件验证，不要只凭保存成功判断完成。
不要把未经核对的数据写进文档。

禁止事项

不要在没读取表格结构前直接写单元格。
不要直接覆盖原始文件，除非用户明确要求。
不要把 docxtemplater 当成修改现有表格文档的默认处理方式。
不要根据文件名或用户口头描述猜表格编号、行列位置。

Más de este repositorio

mismo repositorio

ohmyflight-dev

luckymaomi/ohmyflight

ohmyflight 仓库内新增或修改工具的一般开发流程，适用于前端工具、Python 小工具、Excel 解析导出工具、业务规则实现、入口注册、spec 文档、测试和构建收尾。

2026-07-120

personnel-report-check

luckymaomi/ohmyflight

核对人员结构统计和人员结构 Word 报告填充结果时使用。适用于人员信息 Excel、人员结构报告 docx、app.py 写回结果、统计口径闭合、资质代码映射和报告数据一致性核对。

2026-07-120

training-workbench

luckymaomi/ohmyflight

ohmyflight 培训皇帝/培训工作台专属开发引导。用于修改培训有效期、排班总览、模拟排班、CRM 年度核对、年度已培训人次、培训 Excel 解析导出、培训测试或培训 spec 时。

2026-07-120

read-flight-operations-manual

luckymaomi/ohmyflight

完整阅读、解释、定位和版本复核运行手册，覆盖手册与记录管理、运行组织、运行政策、机组资格和搭配、飞行时间值勤休息、飞行程序、签派与燃油、适航地面运行、安保、货物危险品、通信、性能载重平衡、紧急和恶劣天气、特殊运行、非计划运行、新辟航线及航站管理。用户询问真实航班运行规则、限制、职责、章节位置或要求核对新版运行手册时使用。

2026-07-120

read-flight-technical-management-manual

luckymaomi/ohmyflight

完整阅读、解释、定位和版本复核飞行技术管理手册，覆盖飞行训练组织、技术检查、航线资格、副驾驶与机长等级、教员和考试员聘任、执照、技术资料、技术档案、岗位胜任力、资质管理及全生命周期信息。用户询问飞行人员技术等级变化、进入条件、经历门槛、训练检查、资格获取保持恢复、章节位置，或要求核对新版飞行技术管理手册时使用。

2026-07-120

read-flight-training-program

luckymaomi/ohmyflight

完整阅读、解释、定位和版本复核飞行人员训练大纲，覆盖新雇员、副驾驶与机长转机型、航线和型别教员、检查员、重新获得资格、应急生存、英语、特殊机场、高原、CRM、PBN、EDTO、极地、EBT及其他专项训练。用户询问进入条件、训练课时、课程科目、考试、运行经历、资格获取保持恢复、某章是否适用，或要求核对新版训练大纲时使用。

2026-07-120

Docx Report

处理 Word .docx 文件时使用本 skill。

核心原则

优先用事实读取结果驱动操作。不要凭文件名、肉眼印象或用户口头描述猜表格结构。

库选择：

python-docx：读取和修改现有 .docx 的段落、表格、单元格、样式。默认优先使用。

docxtemplater：用于已有 {占位符} 的模板渲染，不作为直接修改现有表格报告的默认方案。

直接读取 docx 内部 XML：仅在 python-docx 无法处理页眉页脚、复杂字段、特殊结构时使用。

工作流程

确认输入 .docx 存在，先只读不改。

用 python-docx 输出结构：

段落数量和非空段落文本
表格数量
每个表格的行数、列数
每个表格前几行的单元格文本

根据读取结果给表格编号、行号、列号，不要使用模糊定位。

如果要从外部数据源填 Word，先读取数据源结构并说明字段映射。

写回前默认生成新文件，不覆盖原始 docx；用户明确要求覆盖时才覆盖。

写回后重新读取目标文件，核对目标段落或单元格内容已经写入。

常用读取脚本

from pathlib import Path from docx import Document path = Path("input.docx") doc = Document(path) print("paragraphs", len(doc.paragraphs)) print("tables", len(doc.tables)) for i, paragraph in enumerate(doc.paragraphs, 1): text = paragraph.text.strip() if text: print(f"{i}: {text}") for table_index, table in enumerate(doc.tables, 1): print(f"TABLE {table_index}: rows={len(table.rows)} cols={len(table.columns)}") for row_index, row in enumerate(table.rows[:10], 1): values = [cell.text.strip().replace("\n", " / ") for cell in row.cells] print(f" {row_index}: {values}")

写回注意

修改表格时优先按表格编号、行号、列号定位。

如果表格有合并单元格，读取时同一文本可能重复出现；写入前要确认目标单元格。

涉及计算结果时，先说明计算口径，再写入。

写入后必须重新读取目标文件验证，不要只凭保存成功判断完成。

不要把未经核对的数据写进文档。

禁止事项

不要在没读取表格结构前直接写单元格。

不要直接覆盖原始文件，除非用户明确要求。

不要把 docxtemplater 当成修改现有表格文档的默认处理方式。

不要根据文件名或用户口头描述猜表格编号、行列位置。