基于 Ekko Agent 的 document-to-action-items 技能:从文档、笔记与会议记录中提取可追踪行动项

发布时间:2026/9/23 19:29:33
基于 Ekko Agent 的 document-to-action-items 技能:从文档、笔记与会议记录中提取可追踪行动项 AI 应用人工智能AI Agent本地部署前端后端工作流自动化【免费下载链接】ekko-studioEkko Studio is a local-first AI workspace for multi-agent chat, coding, and visual workflows, available on desktop and the web.项目地址https://gitcode.com/gh_mirrors/he/ekko-studio点击查看免费下载导读document-to-action-items是 Ekko Agent 内置技能之一用于把文档、笔记、转录稿和会议纪要转化为结构化的行动项Action Items、决策Decisions、负责人Owners、截止时间Deadlines与后续跟进Follow-ups且严格禁止虚构源材料中不存在的承诺。本文以其 SKILL.md 为骨架结合 Ekko Agent 的源码与测试讲解该技能的触发方式、源文档读取策略、七类信息抽取规则、标准输出格式以及外部写入的安全边界帮助你用它对任意文档执行一次可追溯、可执行的任务化改造。技能定位Ekko Agent 内置技能体系中的一员在 Ekko AgentEkko Studio 的独立 TypeScript Agent 运行时中技能是打包在packages/ekko-agent/skills目录下、以SKILL.md为核心文件的指令包。根据 README.md 与 builtin-skills.test.tsdocument-to-action-items属于每次启动都会自动安装到每个 Profile 的包内置技能之一与pdf、docx、powerpoint、xlsx、ocr-and-documents等同属文档类技能。该技能的 frontmatter 声明了它的定位name: document-to-action-items description: Turn documents, notes, transcripts, and meeting records into traceable action items, decisions, owners, deadlines, and follow-ups without inventing missing commitments. metadata: keywords: - action items - meeting action items - document to tasksdescription与metadata.keywords是技能路由的关键输入。从 tools/skills.ts 的源码可以看到技能名称与 frontmatter 中的显式关键词是仅有的两种路由输入主模型将任意语言的请求映射到技能名并通过skill_view加载完整指令宿主侧还会把最近一条有效用户消息与技能名、紧凑英文 ASCII 关键词做精确匹配命中时确定性预加载。因此当用户说出把这份会议纪要变成任务清单、extract action items from this transcript或document to tasks等意图时该技能就会被路由触发。第一步准确地读取源文档技能的抽取质量取决于源文档的读取准确性。SKILL.md 明确要求使用匹配的内置技能来读取不同格式而不是用同一个工具通吃源格式使用方式.docxdocx技能PDFpdf技能仅当普通提取失败时才使用ocr-and-documents.pptxpowerpoint技能.xlsx或 CSVxlsx技能纯文本或 Markdown内置read_file工具对于 URL应使用可用的浏览器或 HTTP 工具且必须保留源 URL——技能不假设存在某个特定连接器。这一分层策略在配套技能中得到了印证在 pdf/SKILL.md 中明确写着仅当正常文本提取为空或明显不完整时才使用 OCR扫描类文档请路由到 ocr-and-documents 技能而 ocr-and-documents/SKILL.md 进一步按扫描页数给出了阶梯式方案少量扫描页用pdf技能渲染后用view_image逐页转录文本型扫描 PDF 优先尝试轻量的本地路径extract_pymupdf.py复杂版式、表格、数学公式或大量扫描页才使用extract_marker.py。也就是说document-to-action-items不会重复实现文件解析而是把读准这件事委托给专门的格式技能自己专注在提炼结构化信息上。核心提取规则七类信息各归其位SKILL.md 定义了抽取时必须区分的七个类别这是整个技能的灵魂也是保证输出可追溯的根基Action行动源文档中明确表达或强烈暗示的任务。Owner负责人只认源文档中实际指派的具名人员或角色。Deadline截止时间保留确切的日期、时间与时区相对日期如下周五仅当文档日期已知时才以该文档日期为基准解析。Decision决策已经达成一致的结果而不是提案或意向。Open question开放问题尚未解决的信息或所有权归属不明的事项。Dependency or risk依赖或风险可能阻塞行动项的事物。Evidence证据页码、幻灯片页码、工作表/单元格、章节、段落、时间戳或源 URL。第七条 Evidence 是区分AI 生成的总结与可审计的任务清单的关键每个行动项都必须携带其出处让读者可以回到原始文档核对。禁止虚构原则技能对幻觉的约束非常刚性Do not invent an owner, deadline, priority, or decision. Use Unassigned, No deadline stated, or Needs confirmation when the source is silent.即源材料没有提及负责人就写Unassigned未指派没有截止时间就写No deadline stated未说明截止时间不确定的项标注Needs confirmation需确认。绝不为了看起来完整而补造优先级、负责人或决策。这也是该技能在 frontmatter 中承诺的 without inventing missing commitments 的落地方式。输出格式紧凑表格 决策与开放问题清单技能默认要求使用紧凑表格输出ActionOwnerDeadlineStatusDependency/RiskEvidence任务描述负责人或 Unassigned日期时间或 No deadline stated状态依赖/风险或留空证据定位表格之后单独列出决策Decisions与开放问题Open questions。重复出现的行动项要去重但不能丢失各自不同的证据——例如同一任务在三个章节出现去重后应合并为一行而 Evidence 列需要能反映多次出现的出处。外部写入先确认、再执行、逐条验证创建任务、日历事件、工单、提醒或数据库记录都属于改变外部状态的操作。SKILL.md 给出的安全流程是先展示再写入除非用户已明确授权否则必须先展示拟创建的项目列表并确认目标系统和写入范围。只用实际可用的工具不假设某个连接器存在只用当前环境真实暴露的工具。保留源链接在创建的记录中保留源材料链接。逐条验证写入每次写入都要核实成功。精确报告部分失败没有成功结果就绝不声称该项目已创建。这一约定与 Ekko Agent 的工具安全模型一致在 README.md 中危险工具在执行前需要授权决策为once/session/always/deny拒绝在工具启动前 fail-closed宿主通过requestToolApproval将这些决策桥接到 UI。也就是说先确认不只是技能层面的提示还落在运行时的工具授权机制上。源码佐证技能如何被安装、校验与路由内置技能集合与安装策略builtin-skills.test.ts 验证了packages/ekko-agent/skills目录下的内置技能清单精确等于预期集合document-to-action-items位列其中同一测试还校验每个SKILL.md都必须以 YAML frontmatter 开头、metadata.keywords为 18 个纯 ASCII 关键词。同文件的其他用例第 3372 行验证了安装语义缺失的内置技能会被安装进每个 Profile但用户已存在的同名技能不会被覆盖未被修改的托管副本会随版本更新本地修改过的副本则原样保留。frontmatter 与 keywords 的解析实现在 tools/skills.ts 中skillFrontmatter()用正则解析---包裹的 YAML 块listFrontmatterValues()从中取出keywords列表。skill_view第 188241 行在加载技能时返回技能内容、字符数、SHA-256 摘要和绝对baseDirectory后者用于执行技能捆绑的脚本skill_list第 124166 行则提供不区分大小写的后备发现对技能名、描述和 keywords 进行子串匹配。可见document-to-action-items的action items/meeting action items等关键词不仅用于宿主侧确定性路由也参与skill_list的搜索索引。与托管副本的一致性校验值得注意的还有 tools/skills.tsSKILL.md必须以 YAML frontmatter 开头frontmatter 中的name必须与技能目录名一致且必须有description和keywords。因此该技能的 frontmatter 结构不是可选的装饰而是通过校验、参与路由、决定能否安装与执行的硬性契约。组合使用一条完整的会议纪要 → 行动项流水线结合技能体系一条可复现的典型流水线是用户提供.docx会议纪要 → 触发docx技能读取正文若纪要含扫描附件先经pdfocr-and-documents完成文本化模型按七类规则提取行动项Evidence 列逐条标注页码/段落/时间戳输出紧凑表格 决策 开放问题先展示给用户经用户授权后再调用实际可用的任务/日历工具写入外部系统并在每条记录中保留源链接最后逐条验证并如实报告结果。整个过程中document-to-action-items承担的是结构化提炼 防幻觉约束 可追溯证据这一核心职责而读取、OCR、外部写入分别由专门的技能与工具完成——这正是 Ekko Agent 技能系统单一技能专注单一职责、宿主负责任务编排的设计体现。适用前提与限制该技能以SKILL.md形式随 Ekko Agent 内置分发通常不需要手工安装若需查看或修改其源码位于 packages/ekko-agent/skills/document-to-action-items/并附带独立的 LICENSE。技能本身只负责读取与提炼不内置任何任务管理、日历或工单连接器外部写入完全取决于当前运行时实际暴露的工具。证据质量受源文档读取质量的制约PDF 扫描件必须先完成 OCR 才能被准确提炼因此建议按 pdf/SKILL.md 与 ocr-and-documents/SKILL.md 的阶梯策略选择读取路径。赞分享AI 应用人工智能AI Agent本地部署前端后端工作流自动化【免费下载链接】ekko-studioEkko Studio is a local-first AI workspace for multi-agent chat, coding, and visual workflows, available on desktop and the web.项目地址https://gitcode.com/gh_mirrors/he/ekko-studio点击查看免费下载相关推荐用 instructor 从会议记录中自动提取 Action Items基于 Iterable 的结构化任务抽取实战用 instructor 从会议记录中自动提取 Action Items基于 Iterable 的结构化任务抽取实战 会议中的讨论最终要靠行动项Acti人工智能大模型AI 应用Quarkdown会议记录模板结构化笔记与行动项跟踪Quarkdown会议记录模板结构化笔记与行动项跟踪 痛点与解决方案 你是否还在使用纯文本或基础Markdown记录会议信息散乱、行动项跟踪困难、决策过程不开发工具CLI一起听歌吧多房间版Jusic-Serve-Houses打造你的专属在线音乐社交空间一起听歌吧多房间版Jusic Serve Houses打造你的专属在线音乐社交空间 一起听歌吧多房间版Jusic Serve Houses是一款基于J后端音视频创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考