Communitygithub.com

lishn6/daily-econ-literature-radar

一個用於每日經濟學文獻資訊追蹤的 Codex 技能。

daily-econ-literature-radar 是什麼?

這個技能是為 Codex 或 Claude Code 等 AI 編碼代理設計的,專門用來建立一個自動化的每日經濟學文獻摘要系統。它能從多種來源(如 Crossref 目標期刊、NBER 工作論文及 RSS/Atom 訂閱源)擷取開放的元數據,並根據研究者的個人研究設定檔進行相關性排序。該工具支援兩種主要運作模式:基本版會輸出 Markdown 摘要,進階版則可排程每天定時發送格式化的 HTML 電子郵件,並附帶純文字 Markdown 備用方案。整個系統不處理付費 PDF,完全仰賴開放元數據,非常適合需要系統性追蹤最新經濟學研究文獻的研究人員。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/lishn6/daily-econ-literature-radar/tree/main

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

預覽

來自技能 README

Rendered HTML email preview

說明文件

每日文獻雷達技能

每日文獻雷達 (Daily Literature Radar) 是一個 Codex 技能,用於追蹤來自目標期刊、工作論文來源、RSS 訂閱源以及關注作者的經濟學研究論文。它會擷取開放的元數據,根據使用者定義的研究設定檔對論文進行評分,並產生一份每日摘要。

基本版本會生成 Markdown 格式。進階版本則按每日排程運行,並以格式化的 HTML 電子郵件發送摘要,同時附帶 Markdown 格式的備用方案。

目前的來源庫包括:用於目標期刊的 Crossref、官方 NBER 工作論文元數據,以及通用的 RSS/Atom 訂閱源(如 CEPR、RePEc/NEP、聯邦儲備系統的訂閱源和期刊快訊)。其他工作論文儲存庫可以透過 RSS 訂閱源或來源適配器添加。

建議:與 Codex 一起設定

此技能設計為在 Codex 或 Claude Code 的協助下進行設定。編碼代理可以透過以下方式,將您的研究興趣轉化為可運作的 daily-econ-literature-radar.config.json:

  • 將您的研究主題轉換為 fields、keywords、jel_codes、methods 和 geographies
  • 在您的研究設定檔定義完成後,推薦特定領域的頂級期刊,然後僅添加您選擇的期刊
  • 尋找並驗證期刊的 ISSN,再將其添加到 target_journals 中
  • 添加關注作者及其名稱別名
  • 添加 RSS 訂閱源或 NBER 計畫/工作小組篩選條件
  • 設定 Gmail SMTP 和排程器,以實現進階的每日定時電子郵件功能

基本設定只需要 Markdown 輸出即可。進階設定會在配置好 Gmail SMTP 和排程器後,自動發送每日 HTML 電子郵件摘要。

功能說明

  • 透過 Crossref ISSN 查詢監控目標期刊。
  • 透過官方 NBER 元數據 TSV 檔案監控 NBER 工作論文。
  • 監控 RSS/Atom 來源,例如 CEPR、RePEc/NEP、聯邦儲備系統訂閱源或期刊快訊。
  • 在所有擷取的元數據中追蹤關注作者。
  • 根據來源、目標期刊狀態、關注作者匹配、主題匹配、JEL/方法/地理匹配以及摘要/標題關鍵字匹配,對候選論文進行排序。
  • 透過 DOI 或標題/作者備用方案進行去重。
  • 每次執行最多輸出 max_papers 篇論文,預設為 10 篇。
  • 產生一份 Markdown 摘要。
  • 可選擇透過 Gmail SMTP 或其他 SMTP 供應商,在每日固定時間發送 HTML 電子郵件摘要。
  • 不會下載付費論文或受限的全文內容。

專案結構

daily-econ-literature-radar/
├── README.md
├── config.example.json
├── example-output/
│   ├── sample-digest.md
│   ├── sample-email.html
│   └── sample-email-preview.png
├── .gitignore
└── daily-econ-literature-radar/
    ├── SKILL.md
    ├── agents/openai.yaml
    ├── references/
    │   ├── default-config.md
    │   ├── journal-watchlist.md
    │   └── source-notes.md
    └── scripts/
        ├── economics_literature_radar.py
        ├── render_digest.py
        ├── send_digest.py
        └── run_daily_radar.py

輸入設定

在 daily-econ-literature-radar.config.json 中設定各項輸入。

研究設定檔

用於相關性排序:

  • fields:廣泛的研究領域
  • jel_codes:JEL 代碼或部分 JEL 分類
  • keywords:主題關鍵字
  • methods:研究方法或實證設計
  • geographies:國家、地區、資料集或研究情境

目標期刊

透過 Crossref 精確監控期刊。預設啟用經濟學前五大期刊。設定研究設定檔後,該技能可以推薦領域頂級期刊;使用者應選擇要添加哪些推薦。每個期刊應包含:

  • name
  • tier
  • field
  • issn

範例:

{
  "name": "Journal Name",
  "tier": "field_top",
  "field": "labor",
  "issn": ["0000-0000"]
}

在添加 ISSN 之前,請務必驗證其正確性。

關注作者

要優先關注的作者姓名及其別名:

{
  "name": "Author Name",
  "aliases": ["A. Name", "Author M. Name"],
  "notes": "Optional note"
}

來源

  • nber:官方 NBER 元數據適配器
  • rss_feeds:CEPR、RePEc/NEP、Fed、期刊快訊或其他 RSS/Atom 訂閱源
  • target_journals:Crossref ISSN 查詢

限制條件

  • max_papers:最終摘要的論文數量
  • per_source_rows:每個來源查詢要取得的行數
  • source_caps:軟性上限,防止某一來源類別壟斷整個摘要

電子郵件

電子郵件為選用功能。僅在配置好 SMTP 憑證後,才將 email.enabled 設為 true。

輸出

範例輸出包含在 example-output/sample-digest.md、example-output/sample-email.html 和 example-output/sample-email-preview.png 中。它們使用合成的論文元數據,同時保留了與真實運行相同的結構和電子郵件樣式。

Rendered HTML email preview

擷取的 JSON

由 fetch 產生:

daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json

每筆論文記錄可包含:

  • title
  • authors
  • source
  • source_kind
  • date
  • date_type
  • doi
  • url
  • abstract
  • keywords
  • matched_terms
  • priority
  • score
  • notes

Markdown 摘要

由 render_digest.py 產生:

daily-econ-literature-radar-output/YYYY-MM-DD.md

每篇論文包含:標題、作者、來源、出版/更新日期、DOI/URL、匹配詞彙、優先級、摘要和備註。

電子郵件摘要

當啟用電子郵件時,由 send_digest.py 或 run_daily_radar.py 產生。郵件包含:

  • 用於 Gmail/Outlook 可讀顯示的 HTML 正文
  • 純文字 Markdown 備用方案

使用方法

提示:請 Codex 或 Claude Code 協助設定研究設定檔、領域頂級期刊選擇、關注作者以及排程的電子郵件發送。已測試過 Gmail SMTP 搭配 Google 應用程式密碼,可以正常運作。

基本版本:僅 Markdown

從專案根目錄執行:

cp config.example.json daily-econ-literature-radar.config.json

編輯 daily-econ-literature-radar.config.json,填入您的研究設定檔、作者和來源。如果需要,保留預設的前五大期刊,然後在從推薦中選擇後,添加領域頂級期刊。

擷取論文:

python3 daily-econ-literature-radar/scripts/economics_literature_radar.py fetch --config daily-econ-literature-radar.config.json

渲染 Markdown:

python3 daily-econ-literature-radar/scripts/render_digest.py \
  daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json \
  --output daily-econ-literature-radar-output/YYYY-MM-DD.md

檢視摘要後,標記為成功處理:

python3 daily-econ-literature-radar/scripts/economics_literature_radar.py mark-success \
  --config daily-econ-literature-radar.config.json \
  --data daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json

mark-success 會更新 state.json,使未來的執行不會重複處理相同的論文。

進階版本:每日定時電子郵件

進階版本是一個排程工作流程。腳本本身不會作為背景守護行程運行;應使用排程器(例如 Codex 自動化、cron、macOS LaunchAgent 或 Windows 工作排程器)在每天的指定時間呼叫 run_daily_radar.py。

在您的排程器中設定所需的傳送時間。您也可以將其記錄在配置檔中:

"push_time": "09:00",
"timezone": "America/Toronto"

Gmail SMTP

目前的實作已通過 Gmail SMTP 和 Google 應用程式密碼的測試。

在 daily-econ-literature-radar.config.json 中設定:

"email": {
  "enabled": true,
  "provider": "gmail_smtp",
  "from": "Daily Literature Radar <[email protected]>",
  "to": "[email protected]",
  "smtp_host": "smtp.gmail.com",
  "smtp_port": 587,
  "smtp_username": "[email protected]",
  "smtp_password_env": "DAILY_RADAR_GMAIL_APP_PASSWORD",
  "smtp_password_file": ".secrets/gmail_app_password",
  "use_starttls": true
}

Gmail 通常需要使用 Google 應用程式密碼,而非您的一般 Google 密碼。請從您的 Google 帳戶安全設定中建立一組應用程式密碼,然後以下列其中一種方式儲存。

環境變數:

export DAILY_RADAR_GMAIL_APP_PASSWORD="your-app-password"

忽略的本地檔案:

mkdir -p .secrets
printf '%s' 'your-app-password' > .secrets/gmail_app_password
chmod 600 .secrets/gmail_app_password

.gitignore 檔案會排除 .secrets/、.env、本地配置檔和輸出檔。

發送單份摘要

python3 daily-econ-literature-radar/scripts/send_digest.py \
  daily-econ-literature-radar-output/YYYY-MM-DD.md \
  --config daily-econ-literature-radar.config.json

執行完整的電子郵件管線

python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json

這會執行:

擷取 -> 渲染 Markdown -> 發送 HTML 電子郵件 -> 標記成功

僅在電子郵件發送成功後,才會標記為成功。

排程每日傳送

在您選擇的時間,每天執行一次這個確切的命令:

python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json

該命令會執行完整的每日電子郵件工作流程:

擷取 -> 渲染 Markdown -> 發送 HTML 電子郵件 -> 標記成功

排程選項

Codex 自動化

建立一個每日 cron 自動化,從此專案目錄執行:

python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json

使用使用者偏好的本地時區和時間,例如每天早上 09:00。

macOS Cron 或 LaunchAgent

此專案是在 MacBook/macOS 環境中使用 Python 3 開發和測試的。最簡單的 macOS 排程選項有:

  • Codex 自動化
  • cron
  • launchd / LaunchAgent

對於 cron,請確保工作從專案目錄啟動,並使用與測試時相同的 Python 可執行檔。

Windows 相容性

目前版本已在 MacBook/macOS 上測試。Python 腳本僅使用標準函式庫,理論上應可移植,但 Windows 使用者需要調整:

  • 使用 python 或 py -3 代替 python3。
  • 使用 PowerShell 路徑語法,並對包含空格的路徑加上引號。
  • 使用 Windows 工作排程器代替 cron/launchd。
  • 將 chmod 600 替換為 Windows 檔案權限設定,或將應用程式密碼儲存在環境變數中。
  • 如果使用檔案儲存機密,在 Windows 路徑中使用 .secrets\gmail_app_password。
  • 確認 TLS SMTP 連線未被本地防火牆或防毒軟體封鎖。

PowerShell 命令範例:

cd "C:\path\to\daily-econ-literature-radar"
py -3 daily-econ-literature-radar\scripts\run_daily_radar.py --config daily-econ-literature-radar.config.json

隱私與安全

請不要提交以下檔案:

  • daily-econ-literature-radar.config.json
  • .secrets/
  • .env
  • daily-econ-literature-radar-output/

此技能僅使用來源提供的元數據和摘要。它不會下載付費論文或受限的全文內容。如果來源沒有摘要,摘要會將論文標記為「無摘要/僅有標題」,而不會推測其發現。

自訂注意事項

  • 保持 max_papers 值夠小,使摘要易於閱讀。
  • 預設啟用前五大期刊;在從推薦中選擇後,透過已驗證的 ISSN 添加領域頂級期刊。
  • 添加帶有別名(用於姓名首字母或姓名變體)的關注作者。
  • 逐步添加 RSS 訂閱源,並在排程每日傳送前,先評估其內容品質。
  • 使用來源上限 (source_caps) 防止單一來源壟斷摘要內容。

相關技能