Bestblogs Discover
Apps & Automationbestblogs-discoverBestblogs Discover is an Agent Skill for apps & automation published in the ginobefun/BestBlogs repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use this skill when the user wants to find today's most worth-reading content from BestBlogs, browse personalized feeds, check trending items, search specific topics, or explore curated newsletters. Triggers include "今天有什么值得读的 / BestBlogs 推荐 / 本周 BestBlogs 热趋 / 搜一下 AI coding / 看关注源的最新 / 最近有什么好周刊", "what's worth reading today", "bestblogs trending this week", "bestblogs discover", "search BestBlogs". Invokes the `bestblogs` CLI.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/ginobefun/BestBlogs/blob/HEAD/skills/bestblogs-discover/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/bestblogs-discover, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
bestblogs-discover — 发现(今日 / 个性化 / 关注流 / 热趋 / 搜索 / 周刊)
何时使用
- 用户想快速了解 "今天最值得读的内容"(最重要触发)。
- 用户想找某个主题、作者、内容类型的 BestBlogs 精选。
- 用户想浏览周刊。
原语
| 原语 | CLI | 说明 |
|---|---|---|
bestblogs.discover.today | bestblogs discover today --json | 带多源回退链的今日候选 |
bestblogs.discover.for_you | bestblogs discover for-you --json | 个性化推荐(需 Pro) |
bestblogs.discover.following | bestblogs discover following --json | 关注源流 |
bestblogs.discover.trending | bestblogs discover trending --period week --json | 热趋内容(today / week / month) |
bestblogs.discover.search | bestblogs discover search "<q>" --json | 关键词搜索 |
bestblogs.discover.newsletter.list | bestblogs discover newsletters --json | 周刊列表 |
bestblogs.discover.newsletter.get | bestblogs discover newsletter <id> --json | 单期周刊 |
前置检查
bestblogs auth status --json
多数命令需要 API Key;search、newsletters 在某些配置下也可匿名消费。若未登录,提示先 bestblogs auth login。
核心动作:discover today
bestblogs discover today --limit 20 --json
返回:
{
"success": true,
"data": {
"candidates": [
{
"resourceId": "RAW_xxx",
"title": "...",
"url": "...",
"resourceType": "ARTICLE",
"language": "en_US",
"score": 92,
"sourceName": "...",
"candidateSource": "my_brief",
"selectionReason": "今日个性化精选",
"fallbackApplied": false,
"personalized": true
}
],
"primarySource": "my_brief",
"fallbackApplied": false,
"details": { "triedSources": ["my_brief", "for_you"] }
}
}
candidateSource 枚举:
my_brief— Pro 个性化早报public_brief— 公共精选(非 Pro 或未生成个性化时)public_brief_fallback— 公共早报降级兜底for_you— For You 推荐following— 关注源
展示给用户时应按 candidateSource 打徽标,并显式标注降级状态(fallbackApplied=true 时)。
其它动作
# 个性化流
bestblogs discover for-you --limit 15 --lang en_US --json
# 热趋(今日 / 本周 / 本月)
bestblogs discover trending --period week --limit 20 --json
bestblogs discover trending --period today --lang zh_CN --json
# 搜索
bestblogs discover search "AI coding" --type ARTICLE --sort score --limit 10 --json
# 周刊
bestblogs discover newsletters --limit 10 --json
bestblogs discover newsletter <id> --json
错误处理
403 / FORBIDDENonfor-you→ 用户非 Pro,降级到following或today404 / NOT_FOUNDon brief 相关 → 当日早报尚未生成,尝试public_brief或following429 / RATE_LIMITED→ CLI 已退避一次;仍失败时退出并告诉用户稍后重试- 空
candidates→ 向用户报告 "今日无推荐",建议做bestblogs intake setup建立/修正画像
组合建议
- 拿到候选后,对感兴趣的条目链式调用
bestblogs-readskill 做深读 - 高价值条目链式调用
bestblogs-captureskill 收藏/加笔记 - 想知道 "为什么推这条"?把
candidateSource/selectionReason直接展示;更深层的解释(如贡献来源的评分)用bestblogs-explainskill