mcpField
A
ai-tech-summary

ai-tech-summary

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

关于 ai-tech-summary

ai-tech-summary 是供 Agent 使用的技能，可从 SQLite 中的 RSS 记录构建证据上下文，再由 Agent 撰写所需摘要。它支持日、周、月及自定义日期范围，并可选择字段和引用证据。

主要功能

  1. 01日、周、月及自定义时间段
  2. 02检索 SQLite RSS 记录
  3. 03可选字段与记录数量限制
  4. 04使用条目 ID 和 URL 标注证据
  5. 05缺少全文时使用元数据模式

适用场景

  1. 01编写每周科技新闻摘要
  2. 02汇总自定义日期范围内的 RSS 条目
  3. 03基于检索记录生成有证据依据的摘要

安装

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

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

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

详细介绍

AI 技术摘要

核心目标

  • 为请求的时间范围提取合适的记录和字段。
  • 将证据打包为精简的 JSON 上下文，用于 RAG。
  • 让 Agent 根据检索到的证据综合生成最终摘要文本。
  • 支持每日、每周、每月和自定义时间范围。

触发条件

  • 收到生成每日、每周或每月摘要的请求。
  • 收到针对任意日期范围生成摘要的请求。
  • 需要基于 RSS 条目或全文生成有证据支撑的摘要。
  • 需要由 Agent 生成摘要，而非使用僵化的脚本报告格式。

输入要求

  • SQLite 中必须包含以下表：feeds、entries（来自 ai-tech-rss-fetch）。
  • 可选表：entry_content（来自 ai-tech-fulltext-fetch）。
  • 所有 RSS 技能应使用相同的共享数据库路径。
  • 在多 Agent 运行时中，将 AI_RSS_DB_PATH 设置为此 Agent 使用的一个绝对数据库路径。

RAG 工作流

  1. 按时间范围检索证据上下文。
export AI_RSS_DB_PATH="/absolute/path/to/workspace-rss-bot/ai_rss.db"

python3 scripts/time_report.py \
  --db "$AI_RSS_DB_PATH" \
  --period weekly \
  --date 2026-02-10 \
  --max-records 120 \
  --max-per-feed 20 \
  --summary-chars 8192 \
  --fulltext-chars 8192 \
  --pretty \
  --output /tmp/ai-tech-weekly-context.json
  1. 加载检索结果，并在 Agent 回复中生成最终摘要。
  • 阅读 query、dataset、aggregates、records。
  • 优先将 records 作为证据来源。
  • 基于记录说明关键趋势、重大事件和显著变化。
  1. 在摘要中加入证据锚点。
  • 为关键结论注明 entry_id、feed 和 URL。
  • 如果检索结果被截断，应说明摘要基于抽样选取的头部记录。

时间范围模式

  • --period daily --date YYYY-MM-DD
  • --period weekly --date YYYY-MM-DD
  • --period monthly --date YYYY-MM-DD
  • --period custom --start ... --end ...
  • 时间筛选始终基于 entries.first_seen_at（UTC）。

自定义边界支持 YYYY-MM-DD 和 ISO 日期时间格式。

RAG 字段选择

  • 使用 --fields 控制 Token 预算和相关性。
  • 默认字段针对摘要任务进行了调优：
    • entry_id,timestamp_utc,timestamp_source,feed_title,feed_url,title,url,summary,fulltext_status,fulltext_length,fulltext_excerpt
  • 上下文需要精简时常用的最小字段集：
    • entry_id,timestamp_utc,feed_title,title,url,summary

推荐的 Agent 输出格式

  • 最终回复按以下顺序组织：
    1. 时间范围
    2. 主要主题／趋势
    3. 关键进展（分组呈现）
    4. 风险／待解问题
    5. 证据列表（条目 ID + URL）

可配置参数

  • --db
  • AI_RSS_DB_PATH（建议在多 Agent 运行时使用绝对路径）
  • --period
  • --date
  • --start
  • --end
  • --max-records
  • --max-per-feed
  • --summary-chars
  • --fulltext-chars
  • --top-feeds
  • --top-keywords
  • --fields
  • --output
  • --pretty
  • --fail-on-empty

错误处理

  • 缺少 feeds／entries：立即失败并提供设置指引。
  • 日期／时间／字段列表无效：返回解析错误。
  • 缺少 entry_content：以仅含元数据的模式继续。
  • 检索结果为空：返回空上下文；也可通过 --fail-on-empty 设置为失败。

参考资料

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

资源

  • assets/config.example.json

脚本

  • scripts/time_report.py

评论

支持 Markdown