SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场lark-workflow-doc-summarizer

lark-workflow-doc-summarizer

办公与效率

查看项目

更新于 10-16 10:16

技能介绍

用途

文档智能摘要工作流用于读取飞书云文档或知识库文档的内容，并生成结构化的摘要。当用户需要总结文档、提取文档要点、快速了解一篇长文档的核心内容，或提出「帮我总结这个文档」这类需求时使用。典型触发场景包括：

  • 「帮我总结这个文档」/「这篇文档讲了什么」
  • 「提取文档要点」/「这个文档的核心内容是什么」
  • 「帮我快速了解这篇文档」/「文档摘要」
  • 「总结一下这个链接里的内容」/「摘出关键决策」
  • 「批量摘要这几个文档」/「帮我把文档要点整理出来」

前置条件

支持 user 身份。执行前确保已授权：

lark-cli auth login --domain doc,drive,wiki

开始前 MUST 先用 Read 工具读取 lark-shared/SKILL.md，其中包含认证、权限处理和安全规则。

工作流概览

用户指定文档后，解析输入类型（/docs/ 链接、/wiki/ 链接或 doc_token），再通过 docs +fetch 读取文档内容（Markdown 格式），经 AI 分段摘要后输出结构化结果，输出包含要点、关键决策、待确认项，并可选择写回文档。

主要能力与使用方式

Step 1：解析文档来源

用户可能提供以下几种输入：

A. 飞书文档链接（/docs/ 或 /docx/）：直接提取 doc_token。例如 https://xxx.feishu.cn/docs/<doc_token> 或 https://xxx.feishu.cn/docx/<doc_token>。

B. 知识库链接（/wiki/）：知识库链接的 token 不能直接用作 doc_token，必须先查询真实类型：

lark-cli wiki spaces get_node --params '{"token":"<wiki_token>"}'

从返回结果中提取 node.obj_type（文档类型，如 docx/doc/sheet/bitable 等）、node.obj_token（真实文档 token）、node.title（文档标题）。仅当 obj_type 为 docx 或 doc 时继续摘要；其他类型提示用户「该链接指向的是{类型}，暂不支持摘要。」

C. 直接提供 doc_token：直接进入 Step 2。

Step 2：读取文档内容

参考 lark-doc/SKILL.md：

lark-cli docs +fetch --doc "<doc_token>" --format markdown

长文档处理：如果文档内容超过 AI 上下文限制（通常 > 50KB），提示用户文档较长并分段处理，按大标题（# / ##）拆分为段落，逐段生成摘要后合并。

Step 3：AI 生成结构化摘要

摘要输出结构包括：

  • 📄 文档摘要：{文档标题}
  • 📌 核心要点：提取 3-7 个最重要的信息点，按重要性排序
  • 🔑 关键决策：识别文档中的决策性内容（「决定」「确定」「采用」「选择」等关键词）
  • ❓ 待确认 / 开放问题：识别未决事项（「待定」「需讨论」「TBD」「?」「待确认」等）
  • 📊 数据与指标（如有）：提取数字、百分比、KPI 等
  • 📝 一句话总结：不超过 50 字的核心总结

Step 4：批量摘要模式（可选）

当用户需要批量摘要多个文档时：

  • 方式 1：用户提供多个链接/token，串行处理每个文档（每个文档间隔 1 秒）
  • 方式 2：搜索并摘要，使用 lark-cli drive files search --data '{"search_key":"<关键词>","count":10}' --format json，然后对搜索结果中的文档逐个 fetch + 摘要

高级搜索语法（v1.0.7+）可提升批量摘要的搜索精度：布尔搜索「A AND B」表示同时包含 A 和 B；标题搜索「intitle:设计方案」表示仅搜索标题含关键词的文档。

批量模式输出包括各文档标题、一句话总结、要点，以及跨文档洞察（共性发现、矛盾或冲突点）。

Step 5：写回文档（可选，用户要求时）

在文档开头插入摘要：

lark-cli docs +update --doc "<doc_token>" --mode prepend --markdown "## 📄 文档摘要\n\n<摘要内容>\n\n---\n\n"

或创建单独的摘要文档：

lark-cli docs +create --title "摘要：{原文档标题}" --markdown "<摘要内容>"

适用场景

  • 快速了解长文档核心内容
  • 从会议记录、方案文档中提取要点与决策
  • 梳理文档中的待确认事项
  • 批量摘要多个文档并发现跨文档共性或冲突
  • 将摘要写回原文档或生成独立摘要文档

容错机制

  • 文档无权限：提示用户检查权限，或联系文档管理员
  • wiki 链接指向非文档类型：提示「该链接指向的是{类型}，暂不支持摘要」
  • 文档内容为空：提示「该文档暂无内容」
  • 文档过长（>50KB）：分段处理 + 合并摘要
  • 批量处理中某个文档失败：记录失败，继续处理其余文档

权限表

  • 读取文档：docs +fetch，所需 scope 为 docx:document:readonly，必选
  • 解析 wiki：wiki spaces get_node，所需 scope 为 wiki:wiki:readonly，可选（wiki 链接时）
  • 搜索文档：drive files search，所需 scope 为 drive:drive:readonly，可选（批量模式）
  • 写回文档：docs +update / docs +create，所需 scope 为 docx:document:write，可选（写回时）

限制

  • 仅支持 obj_type 为 docx 或 doc 的文档摘要，其他类型（如 sheet、bitable）暂不支持
  • 长文档（通常 > 50KB）需要分段处理
  • 前置认证与权限 scope 的细节以 lark-shared/SKILL.md 为准

参考

  • lark-shared — 认证、权限（必读）
  • lark-doc — +fetch、+create、+update 详细用法
  • lark-wiki — wiki 节点查询详细用法
  • lark-drive — 文件搜索详细用法