// Use this skill when the user wants to set up, inspect, or update their BestBlogs interest profile and onboarding state (cold start). Triggers include "帮我做 BestBlogs 冷启动 / 设置兴趣标签 / 看我现在的画像 / bestblogs 的 onboarding", "set up my BestBlogs profile", "what topics have I chosen on BestBlogs". Invokes the `bestblogs` CLI.
Use this skill when the user wants to save, annotate, or review their BestBlogs reading — create/list/update/remove bookmarks, add highlights with optional notes, view highlight-only vs. note-only lists, and manage reading history. Triggers include "收藏这篇 / 给这段划线 / 加个笔记 / 看我的收藏 / 我的笔记 / 我的阅读历史 / 删掉这条历史", "bookmark this on BestBlogs", "highlight this quote", "show my notes", "clear my BestBlogs reading history". Invokes the `bestblogs` CLI.
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.
Use this skill when the user wants to understand the "why" behind BestBlogs recommendations — view their interest profile summary, see which followed sources are driving their daily brief, or inspect the score breakdown of a specific resource. Triggers include "BestBlogs 为什么推这条 / 看我的画像 / 我关注的源哪些最有价值 / 这篇文章评分多少", "why did BestBlogs recommend this", "which of my followed sources contribute most", "show score for this resource". Invokes the `bestblogs` CLI.
Use this skill when the user wants to deep-read a specific BestBlogs resource (article / podcast / video / tweet) — fetch its metadata + markdown so a local LLM or reader can consume it, and automatically report the read behavior back to BestBlogs. Triggers include "深度阅读这篇 / 拉这篇内容的 markdown / bestblogs read / 给我看看 RAW_xxx 的正文", "deep read this BestBlogs article", "pull markdown for resource RAW_...". Invokes the `bestblogs` CLI.
| name | bestblogs-profile |
| description | Use this skill when the user wants to set up, inspect, or update their BestBlogs interest profile and onboarding state (cold start). Triggers include "帮我做 BestBlogs 冷启动 / 设置兴趣标签 / 看我现在的画像 / bestblogs 的 onboarding", "set up my BestBlogs profile", "what topics have I chosen on BestBlogs". Invokes the `bestblogs` CLI. |
| 原语 | CLI | 说明 |
|---|---|---|
bestblogs.profile.setup | bestblogs intake setup | 交互或非交互地完成 onboarding |
bestblogs.profile.get | bestblogs intake show --json | 获取当前画像 + onboarding 状态 |
bestblogs auth status --json
若输出 loggedIn: false 或报 AUTH_REQUIRED，先提示用户运行 bestblogs auth login，获取 API Key 来自 https://bestblogs.dev/settings/api-keys。
bestblogs intake setup --non-interactive \
--tags "tag_ai,tag_coding,tag_product" \
--lang both \
--source-limit 10 \
--json
输出示例：
{
"success": true,
"data": {
"onboardingCompleted": true,
"interestTagCount": 3,
"followedSources": 10,
"languagePreference": "both"
}
}
bestblogs intake setup
（CLI 会用 prompts 弹出多选，Skill 在 Claude Code 里 fork 子进程执行即可。）
bestblogs intake show --json
关心的字段（parse 时按需取）：
data.interests.explicitInterests[] — 显式兴趣（含 tagName, weight）data.interests.implicitInterests[] — 隐式兴趣data.interests.recentActiveTopics[] — 近 7 天活跃主题data.onboarding — onboarding 状态data.interests.driftDetected — 是否有漂移error.code=AUTH_REQUIRED → 提示运行 bestblogs auth login，中断流程error.httpStatus=403 → 某些子能力需要 Pro，提示用户升级error.code=RATE_LIMITED → CLI 已自动退避重试一次；如仍失败告知用户稍后重试Skill 的 caller 应拿到结构化结果，例如：
{
"onboardingCompleted": true,
"explicitInterestCount": 6,
"languagePreference": "both",
"driftDetected": false,
"recentActiveTopics": ["AI Coding", "Dev Tools"]
}
bestblogs-discover 展示 "today" 列表，给用户第一次价值点击。profile.get，根据 driftDetected=true 建议用户打开 bestblogs-profile setup 重新调整。