AI Daily Digest#

从 Karpathy 推荐的 92 个热门技术博客及国内科技媒体（36氪、少数派、InfoQ中文）中抓取最新文章，通过 AI 评分筛选，生成每日精选摘要。

When to Use#

Use this skill when the user wants to:

• Get a daily tech news digest from top Hacker News blogs
• Summarize recent tech blog articles with AI scoring
• Generate a structured Markdown report from RSS feeds
• Run /digest command

When NOT to Use#

Do not use this skill when:

• The user wants real-time news from APIs (use web search instead)
• The topic is non-tech (this skill only covers tech blogs)
• The user wants to search a specific website (use web search tools)

---

Quick Start#

One-command run (with saved config)#

bash

npx -y bun {baseDir}/scripts/digest.ts --hours 48 --top-n 15 --lang zh

The script auto-generates the output file as ./digest-YYYYMMDD.md in the current directory. Use --output <path> to customize.

With environment variables (first run)#

bash

export OPENAI_API_KEY="<your-openai-compatible-key>"
export OPENAI_API_BASE="https://api.deepseek.com/v1"  # Optional, default: https://api.openai.com/v1
export OPENAI_MODEL="deepseek-chat"                  # Optional, auto-detected if omitted
# Optional fallback:
export GEMINI_API_KEY="<your-gemini-api-key>"

npx -y bun {baseDir}/scripts/digest.ts --hours 48 --top-n 15 --lang zh

---

Script Reference#

ScriptPurpose{baseDir}/scripts/digest.tsMain script — RSS fetching, AI scoring, digest generation

All scripts are located in the scripts/ subdirectory of this skill. Use {baseDir} to reference the skill's root directory.

---

Parameters#

FlagDefaultDescription--hours``48Time range in hours (24, 48, 72, 168)--top-n``15Number of top articles to include (10, 15, 20)--lang``zhOutput language: zh (Chinese) or en (English)--output``./digest-YYYYMMDD.mdOutput file path for the generated Markdown report (auto-generated if omitted)

---

Environment Variables#

VariableRequiredDescriptionOPENAI_API_KEYYes (one of the two)OpenAI-compatible API key — primary provider (supports DeepSeek, 通义千问, 智谱, etc.)GEMINI_API_KEYNoGoogle Gemini API key — used as fallback when OpenAI fails. Get a free key at https://aistudio.google.com/apikeyOPENAI_API_BASENoCustom API base URL (defaults to https://api.openai.com/v1)OPENAI_MODELNoModel name for OpenAI-compatible API (auto-detected from API base if omitted)

AI provider selection: The script uses OPENAI_API_KEY as the primary provider. If it fails (quota exceeded, network error), the script automatically falls back to Gemini ( GEMINI_API_KEY). If only GEMINI_API_KEY is set (no OpenAI key), the script uses Gemini directly.

Using domestic (Chinese) AI providers#

Set only OPENAI_API_KEY + OPENAI_API_BASE (do NOT set GEMINI_API_KEY):

ProviderOPENAI_API_BASE``OPENAI_MODELDeepSeekhttps://api.deepseek.com/v1``deepseek-chat通义千问https://dashscope.aliyuncs.com/compatible-mode/v1``qwen-plus智谱 GLMhttps://open.bigmodel.cn/api/paas/v4``glm-4-flashGroqhttps://api.groq.com/openai/v1``llama-3.3-70b-versatile

OPENAI_MODEL is auto-detected from the API base URL. For DeepSeek it defaults to deepseek-chat; for others it defaults to gpt-4o-mini. Override with OPENAI_MODEL if needed.

---

Configuration Persistence#

Config file path: ~/.hn-daily-digest/config.json

Before running, check if this file exists:

bash

cat ~/.hn-daily-digest/config.json 2>/dev/null || echo "NO_CONFIG"

If config exists and has a geminiApiKey, ask the user whether to reuse saved settings. After a successful run, save the current configuration using the Write tool to ~/.hn-daily-digest/config.json with the following content:

json

{
  "geminiApiKey": "<key>",
  "timeRange": <hours>,
  "topN": <topN>,
  "language": "<zh|en>",
  "lastUsed": "<ISO timestamp>"
}

Use the Write tool (not Bash) to save the config file for cross-platform compatibility.

---

Interactive Flow#

Step 0: Check saved config#

bash

cat ~/.hn-daily-digest/config.json 2>/dev/null || echo "NO_CONFIG"

If config exists with geminiApiKey, ask user:

• "Use saved config?" — If yes, skip to Step 2 with saved parameters
• "Reconfigure" — Continue to Step 1

Step 1: Collect parameters#

Ask the user the following questions using AskUserQuestion:

1. Time range: 24h / 48h (recommended) / 72h / 7 days
2. Top N articles: 10 / 15 (recommended) / 20
3. Output language: Chinese (recommended) / English

Step 1b: API Key#

If no saved openaiApiKey exists, ask the user for an OpenAI-compatible API Key (e.g. DeepSeek, OpenAI). Optionally ask for GEMINI_API_KEY as fallback.

Step 2: Execute#

bash

export OPENAI_API_KEY="<key>"
export OPENAI_API_BASE="https://api.deepseek.com/v1"
export OPENAI_MODEL="deepseek-chat"
# Optional fallback:
export GEMINI_API_KEY="<fallback-key>"

npx -y bun {baseDir}/scripts/digest.ts \
  --hours <timeRange> \
  --top-n <topN> \
  --lang <zh|en>

The output file is auto-generated as ./digest-YYYYMMDD.md. To specify a custom path, add --output <path>.

Step 3: Present results#

On success:

• Show the output file path
• Show summary: feeds scanned, articles fetched, articles selected
• Show Top 3 preview: Chinese title + one-line summary

Report structure (in the generated Markdown file):

1. Today's Highlights — 3-5 sentence macro trend summary by AI
2. Must-Read Top 3 — Bilingual titles, summaries, recommendations, keyword tags
3. Data Overview — Statistics table + Mermaid category pie chart + keyword bar chart + ASCII chart + tag cloud
4. Categorized Articles — Grouped by 6 categories (AI/ML, Security, Engineering, Tools/Open Source, Opinions, Other)

On failure:

• Display error message
• Common issues: invalid API key, network problems, RSS source unavailable

---

Requirements#

• npx (comes with Node.js) — used to run bun runtime automatically
• bun runtime (auto-installed via npx -y bun)
• At least one AI API key ( OPENAI_API_KEY or GEMINI_API_KEY)
• Network access (for RSS feeds and AI API)

---

Troubleshooting#

"OPENAI_API_KEY not set"#

Provide an OpenAI-compatible API Key (e.g. DeepSeek, OpenAI). Optionally set OPENAI_API_BASE for custom endpoints.

"OpenAI API request failed"#

The script automatically falls back to Gemini. Make sure GEMINI_API_KEY is set.

"Failed to fetch N feeds"#

Some RSS sources may be temporarily unavailable. The script skips failed sources and continues.

"No articles found in time range"#

Try expanding the time range (e.g., from 24 hours to 48 hours).