Smart Document Summarizer

Quick Start

最短执行路径：

cd ~/.openclaw/workspace/skills/smart-doc-summarizer-skill
pip install -r requirements.txt
python scripts/summarizer.py /path/to/document.docx

输出：生成 {原文件名}_总结.docx 和 {原文件名}_总结.html

Workflow

接收用户提供的文件路径。
检查文件是否存在、格式是否受支持。
解析文档内容（Word / PDF / PPTX）。
使用本地规则提取核心观点、预览内容和关键信息。
将总结结果写入 DOCX 和 HTML 报告。
返回输出文件路径与摘要预览。

决策点：

文件不存在 → 提示用户重新提供路径
格式不支持 → 列出支持的格式
模板文件缺失 → HTML 报告生成失败并提示修复

Inputs

| 字段 | 必填 | 来源 | 约束 | | --- | --- | --- | --- | | file_path | 是 | 用户输入 | 必须存在，格式为 .docx / .pdf / .pptx | | output_dir | 否 | 用户输入 | 如提供则目录必须可写；默认与原文件同目录 |

Outputs

成功输出：

{
  "ok": true,
  "kind": "action_result",
  "data": {
    "doc_path": "/path/to/原文件名_总结.docx",
    "html_path": "/path/to/原文件名_总结.html",
    "summary_preview": "核心观点摘要前200字..."
  },
  "next": "可打开 HTML 报告查看完整内容"
}

失败输出：

{
  "ok": false,
  "error": {
    "code": "FILE_NOT_FOUND",
    "message": "文件不存在: /path/to/file.docx",
    "debug": "请检查文件路径是否正确"
  }
}

Errors

| 错误类型 | 错误码 | 处理策略 | | --- | --- | --- | | 文件不存在 | FILE_NOT_FOUND | 提示用户重新提供路径 | | 格式不支持 | UNSUPPORTED_FORMAT | 列出支持格式 | | 依赖缺失 | DEPENDENCY_MISSING | 输出安装命令 | | 模板缺失 | TEMPLATE_NOT_FOUND | 提示补齐 assets/report_template.html | | 报告写入失败 | WRITE_FAILED | 提示检查输出目录权限 |

Resources

scripts/（确定性执行）

| 脚本 | 用途 | 何时执行 | | --- | --- | --- | | summarizer.py | 主总结脚本 | 每次调用 |

仅声明当前实际存在并参与执行的脚本。若后续新增 check_deps.py、validate.py，再同步更新此处。

references/（按需阅读）

当前版本未内置 references 文档。如后续补充文档解析规则、错误码说明、字段校验规则，再新增 references/ 目录并在此登记。

assets/（产物资源）

| 资源 | 用途 | | --- | --- | | report_template.html | HTML 报告模板 |

Constraints

安全边界

不读取或使用任何外部模型密钥
只处理用户明确指定的文件路径
不在日志和输出中回显敏感信息
本技能会读取输入文件，并在输出目录写入 DOCX / HTML 报告文件

确认点

本技能不执行外部高风险动作（如下单、删除、发送消息）
本技能包含本地文件写入行为，输出目录默认为原文件同目录

速率 / 限流

单次处理应在合理时间内完成；超大文件可能导致耗时增加