mcpField
S
sustainability-summary

sustainability-summary

github.com/tiangong-ai生产力1157 次安装1 周前更新
代码仓库

关于 sustainability-summary

sustainability-summary 是用于生成可追溯证据的可持续发展摘要的技能，可读取相关 RSS 记录并选用全文数据。它适合处理定期或自定义时间范围的报告，并以 DOI 和 URL 标注关键依据。

主要功能

  1. 01生成每日、每周、每月及自定义报告
  2. 02仅检索相关 RSS 记录
  3. 03支持可选全文上下文
  4. 04通过 DOI 和 URL 引用依据

适用场景

  1. 01制作每周可持续发展摘要
  2. 02汇总自定义日期范围内的记录
  3. 03根据 RSS 和全文证据撰写内容

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tiangong-ai/agent-skills --skill sustainability-summary

安装后在 Claude Code 中输入/sustainability-summary确认已加载。

详细介绍

可持续发展摘要

核心目标

  • 仅从 RSS 数据库中读取相关（is_relevant=1）记录。
  • 根据 DOI 索引条目构建精简的 RAG 上下文。
  • 如果存在，可从单独的全文数据库 entry_content 中纳入补充内容。
  • 让 Agent 基于证据锚点生成最终摘要文本。

触发条件

  • 收到生成每日／每周／每月可持续发展摘要的请求。
  • 收到生成自定义日期范围摘要的请求。
  • 需要根据带标签的 RSS 条目和补充内容生成有证据支撑的输出。

输入要求

  • 必需的数据表：feeds、entries（来自 sustainability-rss-fetch）。
  • entries 必须以 DOI 为索引键，并带有相关性标签。
  • 可选的全文数据库表：entry_content（来自 sustainability-fulltext-fetch）。
  • RSS 数据库和全文数据库必须是不同的文件。

工作流

  1. 按时间范围构建检索上下文。
export SUSTAIN_RSS_DB_PATH="/absolute/path/to/workspace-rss-bot/sustainability_rss.db"
export SUSTAIN_FULLTEXT_DB_PATH="/absolute/path/to/workspace-rss-bot/sustainability_fulltext.db"

python3 scripts/time_report.py \
  --rss-db "$SUSTAIN_RSS_DB_PATH" \
  --content-db "$SUSTAIN_FULLTEXT_DB_PATH" \
  --period weekly \
  --date 2026-02-10 \
  --max-records 120 \
  --max-per-feed 20 \
  --summary-chars 8192 \
  --fulltext-chars 8192 \
  --pretty \
  --output /tmp/sustainability-weekly-context.json

  1. 根据返回的 records + aggregates 生成最终摘要。

  2. 对关键论点使用 DOI + URL 引用证据。

时间范围模式

  • --period daily --date YYYY-MM-DD
  • --period weekly --date YYYY-MM-DD
  • --period monthly --date YYYY-MM-DD
  • --period custom --start ... --end ...

默认字段

  • doi,timestamp_utc,timestamp_source,feed_title,feed_url,title,url,summary,fulltext_status,fulltext_length,fulltext_excerpt

可配置参数

  • --rss-db
  • --content-db
  • SUSTAIN_RSS_DB_PATH
  • SUSTAIN_FULLTEXT_DB_PATH
  • --period
  • --date
  • --start
  • --end
  • --max-records
  • --max-per-feed
  • --summary-chars
  • --fulltext-chars
  • --top-feeds
  • --top-keywords
  • --fields
  • --output
  • --pretty
  • --fail-on-empty

错误处理

  • 缺少必需的 DOI 索引表：快速失败并提供设置指南。
  • RSS 数据库和全文数据库路径冲突：快速失败并要求使用不同的文件。
  • 日期／时间／字段列表无效：返回解析错误。
  • 缺少 entry_content：以仅含元数据的模式继续运行。
  • 相关记录集为空：返回空上下文；可通过 --fail-on-empty 选择失败。

参考资料

  • references/time-window-rules.md
  • references/report-format.md

资源文件

  • assets/config.example.json

脚本

  • scripts/time_report.py

评论

支持 Markdown