返回顶部
k

key-takeaways 要点提取

Extracts and summarizes key takeaways from documents, meeting notes, articles, and other text content. Use when the user asks for summaries, bullet points, main points, highlights, or a TL;DR of any document or body of text. Produces structured outputs such as numbered lists, executive summaries, and action items. Supports configurable output formats including JSON export for downstream use.

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 1.0.0
安全检测
已通过
95
下载量
免费
免费
0
收藏
概述
安装方式
版本历史

key-takeaways

关键要点

从任何文本内容(会议记录、文章、报告或文档)中提取并呈现最重要的要点,以简洁、结构化的形式输出。支持多种输出格式,并可根据受众或深度进行配置。

使用场景

  • - 当任务需要从文档、会议记录、文章及其他文本内容中提取并总结关键要点时使用此技能。当用户要求对任何文档或文本内容进行摘要、要点列表、主要内容、重点提炼或TL;DR时使用。生成结构化输出,如编号列表、执行摘要和行动项。支持可配置的输出格式,包括供下游使用的JSON导出。
  • 在需要明确假设、限定范围以及可复现输出格式的证据洞察任务中使用此技能。
  • 当需要针对缺失输入、执行错误或部分证据提供文档化的备用路径时使用此技能。

主要特性

  • - 以范围为核心的工作流程,专注于:从文档、会议记录、文章及其他文本内容中提取并总结关键要点。当用户要求对任何文档或文本内容进行摘要、要点列表、主要内容、重点提炼或TL;DR时使用。生成结构化输出,如编号列表、执行摘要和行动项。支持可配置的输出格式,包括供下游使用的JSON导出。
  • 打包的可执行路径:scripts/main.py。
  • 参考资料位于 references/ 目录下,提供任务特定指导。
  • 结构化的执行路径,确保输出一致且可审查。

依赖项

  • - Python:3.10+。当前打包技能的仓库基线版本。
  • 第三方包:本技能包中未明确固定版本。如果此技能需要更严格的环境控制,请添加固定版本。

使用示例

bash
cd 20260318/scientific-skills/Evidence Insight/key-takeaways
python -m py_compile scripts/main.py
python scripts/main.py --help

示例运行计划:

  1. 1. 确认用户输入、输出路径以及任何必需的配置值。
  2. 如果脚本使用固定设置,编辑文件内的 CONFIG 块或文档化参数。
  3. 使用验证后的输入运行 python scripts/main.py。
  4. 审查生成的输出,并返回最终成果,同时说明任何假设。

实现细节

相关详情请参见上面的 ## 工作流程。

  • - 执行模型:验证请求,选择打包的工作流程,生成限定范围的可交付成果。
  • 输入控制:在运行任何脚本之前,确认源文件、范围限制、输出格式和验收标准。
  • 主要实现接口:scripts/main.py。
  • 参考指南:references/ 目录包含支持规则、提示或检查清单。
  • 需要首先明确的参数:输入路径、输出路径、范围过滤器、阈值以及任何领域特定约束。
  • 输出规范:保持结果可复现,明确标识假设,避免未记录的副作用。

快速检查

在深入执行之前,使用此命令验证打包脚本的入口点是否可解析。

bash
python -m py_compile scripts/main.py

审计就绪命令

使用这些具体命令进行验证。它们特意设计为自包含,避免使用占位符路径。

bash
python -m py_compile scripts/main.py
python scripts/main.py

工作流程

  1. 1. 在进行详细工作之前,确认用户目标、所需输入以及不可协商的约束条件。
  2. 验证请求是否与文档化范围匹配,如果任务需要不支持的假设,则尽早停止。
  3. 仅使用实际可用的输入,使用打包的脚本路径或文档化的推理路径。
  4. 返回结构化的结果,将假设、可交付成果、风险和未解决事项分开。
  5. 如果执行失败或输入不完整,切换到备用路径,并准确说明阻止完整完成的原因。

快速入门

python
from scripts.main import Key_Takeaways

初始化

tool = Key_Takeaways()

从文档中提取关键要点

result = tool.process(meeting_notes.txt)

导出为结构化JSON

tool.export(result, format=json)

核心能力

1. 从文本中提取关键点

python

读取源文档并提取主要要点

result = tool.process(quarterly_report.txt)

返回:[{point: 收入同比增长12%, source_line: 4}, ...]

2. 生成结构化摘要

python

生成要点式执行摘要

result = tool.process(meeting_notes.txt, style=executive)

返回:{summary: ..., action_items: [...], decisions: [...]}

3. 配置输出深度和受众

python

调整要点数量和目标受众

result = tool.process(article.txt, max_points=5, audience=non-technical)

4. 导出结果

python

将要点导出为JSON或纯文本

tool.export(result, format=json, output_path=takeaways.json) tool.export(result, format=txt, output_path=takeaways.txt)

CLI使用

text

从文件中提取关键要点

python scripts/main.py --input document.txt --output takeaways.txt

使用配置文件设置深度、受众和格式

python scripts/main.py --input document.txt --config config.json --verbose

批量处理文档目录

python scripts/main.py --batch inputdir/ --output outputdir/

批量处理说明:

  • - 运行前确认输出目录存在:mkdir -p outputdir/
  • 如果单个文件处理失败,工具会记录错误并继续处理其余文件;运行后检查 outputdir/errors.log
  • 批量完成后,验证所有JSON输出:for f in output_dir/*.json; do python -m json.tool $f > /dev/null && echo OK: $f || echo FAIL: $f; done

示例输入/输出

输入 (meeting_notes.txt):

Q3回顾:销售额增长15%。新产品发布推迟至Q4。
行动项:Alice需在周五前更新路线图。招聘预算已获批。

输出 (takeaways.json):
json
{
key_points: [
Q3销售额增长15%,
产品发布重新安排至Q4
],
action_items: [
Alice需在周五前更新路线图
],
decisions: [
招聘预算已获批
]
}

质量检查清单

  • - [ ] 处理前源文本可读且完整
  • [ ] 输出要点数量与配置的 max_points 设置一致
  • [ ] 行动项和决策与一般观察分开
  • [ ] 导出的文件能正确打开和验证(例如 python -m json.tool takeaways.json)
- 如果JSON验证失败,检查源文件编码(应为UTF-8)并重新运行;检查 --verbose 输出以查找解析错误
  • - [ ] 对照原始来源审查结果的准确性

参考资料

  • - references/guide.md - 详细文档
  • references/examples/ - 示例输入和输出

技能ID: 308 | 版本: 1.0 | 许可证: MIT

输出要求

每个最终响应在相关时应明确以下事项:

  • - 目标或请求的可交付成果
  • 使用的输入和引入的假设
  • 工作流程或决策路径
  • 核心结果、建议或成果
  • 约束条件、风险、注意事项或验证需求
  • 未解决事项和后续检查步骤

错误处理

  • - 如果缺少必需的输入,准确说明缺少哪些字段,并仅请求最少的额外信息。
  • 如果任务超出文档化范围,应停止,而不是猜测或悄然扩大任务范围。
  • 如果 scripts/main.py 失败,报告失败点,总结仍可安全完成的内容,并提供手动备用方案。
  • 不得捏造文件、引用、数据、搜索结果或执行结果。

输入验证

此技能接受与 key-takeaways 文档化目的匹配且包含足够上下文以安全完成工作流程的请求。

当请求超出范围、缺少关键输入或需要不支持的假设时,不要继续工作流程。而是回复:

key-takeaways 仅处理其文档化的工作流程。请提供缺失的必需输入或切换到更合适的技能。

响应模板

对于非简单请求,使用以下固定结构:

  1. 1. 目标
  2. 收到的输入
  3. 假设
  4. 工作流程
  5. 可交付成果
  6. 风险和限制
  7. 后续检查

如果请求简单,可以压缩结构,但当假设和限制影响正确性时,仍需明确说明。

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 key-takeaways-1776023292 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 key-takeaways-1776023292 技能

通过命令行安装

skillhub install key-takeaways-1776023292

下载

⬇ 下载 key-takeaways v1.0.0(免费)

文件大小: 7.88 KB | 发布时间: 2026-4-13 10:45

v1.0.0 最新 2026-4-13 10:45
Initial release of the Key Takeaways skill.

- Extracts and summarizes key points from documents, meeting notes, articles, and other text.
- Supports structured outputs: numbered lists, executive summaries, action items, and JSON export.
- Configurable output formats for different audiences and detail levels.
- Includes batch processing, input validation, and documented fallback/error handling.
- Provides command line and Python usage examples for quick integration.

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large
返回顶部