技能介绍

要解决什么问题

做技术调研或舆情跟踪时，Hacker News 仍是高质量讨论的来源，但官方 Firebase API 与 Algolia 索引各有一套参数语义；在 Agent 对话里，模型若自行「猜」HN 内容既不可靠，也违反数据边界。本技能通过 Model Context Protocol 把搜索、首页、最新帖、单条详情和用户档案收敛成一组固定工具，由模型做路由与参数抽取，底层只负责调 API 并返回 result["raw"]。

核心能力与工作方式

安装并启用技能后，代理应按文档约定的工作流运行：

检查 API 密钥：若 scripts.config.settings.api_key 为空，须用 AskUserQuestion 向用户索取，再调用 scripts.config.set_api_key 写入（密钥在 xiaobenyang.com 获取，环境变量名为 XBY_APIKEY）。
选工具并传参：根据意图调用 scripts.tools 中的函数，且使用关键字参数。

主要工具包括：

search_posts：关键词检索标题、正文与作者；支持 tags（如 story、comment、author_pg、(story,poll) 的 OR）、numericFilters（points、num_comments、created_at_i）与分页。
get_front_page：按 HN 排名算法取首页故事，可翻页与调整 hitsPerPage。
get_latest_posts：按时间倒序取最新内容，可按类型过滤。
get_item：按 itemId 拉取完整元数据与嵌套评论树（大线程可能需 2～3 秒）。
get_user：查询用户 karma、简介与注册时间（用户名大小写敏感）。

成功时以 result["success"] 判断，将 result["raw"] 整理后呈现给用户；参数不全时应追问，而不是臆造查询条件。

适用边界与注意点

无密钥不得调用：缺少 API 密钥时禁止自行搜索或编造 HN 数据，这是硬性约束。
模型是路由层：业务逻辑在工具与远端 API；不要在对话里假装已访问 HN 而未走工具。
删除与不存在：get_item / get_user 对无效 ID 或用户会返回错误，需在展示时说明。
文档中数值过滤运算符说明以 SKILL 原文为准（如 >= 与 > 的字段语义），组合多条件时默认 AND 逻辑。

截图预览

使用场景

撰写开源/AI 选题稿前，用关键词与 `numericFilters`（如 `points>=100`）检索 story，再对目标 `itemId` 调用 `get_item` 拉全量嵌套评论做归纳。
晨会前快速扫一遍社区热点：先 `get_front_page` 取首页排名帖，对需跟进的条目用 `get_item` 展开讨论线程摘录争议点。
核实某作者身份与历史发声时，用 `tags` 中的 `author_USERNAME` 配合 `search_posts`，并用 `get_user` 查看 karma 与简介。
跟踪某技术关键词的实时讨论：用 `get_latest_posts` 限定 `story`/`comment`，按页翻阅并对比 `num_comments` 过滤高互动新帖。

适合人员

每周整理技术舆情简报的独立写作者，需要按分值、标签从 HN 捞 story 并展开评论树提取论据。
在 IDE 里搭建调研 Agent 的全栈工程师，要把用户自然语言意图路由到 `search_posts`/`get_item` 等 MCP 工具而非手写爬虫。
做早期项目桌面研究的创投分析助理，常按时间戳与关键词批量检索 startup 相关高票讨论。
负责 DevRel 发布的工程师，发帖后需根据 item ID 回访完整评论树并核对 points、回复结构。