hn-top10

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

HN Top 10

Overview

概述

Use this skill to pull the latest Hacker News front-page stories, save the full result as JSON, and return a concise summary the agent can keep using in the conversation.

使用该技能拉取Hacker News首页的最新故事，将完整结果保存为JSON格式，并返回一份简洁的摘要，供Agent在对话中持续使用。

When To Use

使用场景

Use this skill when the user asks for:

Hacker News top stories
HN front-page posts
top 10 HN items
current developer hot topics
today's startup or YC community stories
a quick scan of tech-community discussion

If the user asks for broad industry news that clearly requires multiple sources, do not rely on this skill alone. Use it as one input, not the full answer.

在用户询问以下内容时使用该技能：

Hacker News热门故事
HN首页帖子
HN热门10条内容
当前开发者热门话题
今日创业公司或YC社区相关故事
科技社区讨论快速概览

如果用户询问的是需要多来源的广泛行业新闻，请勿仅依赖该技能，可将其作为其中一个输入源，而非完整答案。

Inputs

输入参数

Decide these inputs before running the script:

```
limit
```
: default
```
10
```
; allow
```
1-30
```
```
format
```
: default
```
json
```
```
output_path
```
: default a timestamped JSON file using local time, such as
```
hn-top10-20260302-231500.json
```

If the user does not specify a count, keep the default

运行脚本前确定以下输入参数：

```
limit
```
：默认值为
```
10
```
；允许范围
```
1-30
```
```
format
```
：默认值为
```
json
```
```
output_path
```
：默认使用本地时间生成带时间戳的JSON文件，例如
```
hn-top10-20260302-231500.json
```

如果用户未指定数量，保持默认值

。

Run The Script

运行脚本

Run:

bash

python skills/hn-top10/scripts/hn_top10.py --json --limit 10 --output <output_path>

Adjust

--limit

and

--output

when the user asks for something different. When saving JSON, the script will ensure the filename includes a timestamp. If

--output

is omitted, it creates a timestamped JSON file automatically.

If the user explicitly wants CSV, run without

--json

运行：

bash

python skills/hn-top10/scripts/hn_top10.py --json --limit 10 --output <output_path>

当用户有不同需求时，调整

--limit

和

--output

参数。保存JSON文件时，脚本会确保文件名包含时间戳。如果省略

--output

参数，会自动创建带时间戳的JSON文件。

如果用户明确要求CSV格式，运行时不添加

--json

参数。

Required Output Behavior

要求的输出行为

Always produce both:

A saved machine-readable file.
A short conversational summary.

The summary should include:

what source was used:
```
Hacker News front page
```
how many items were fetched
the top 3-5 story titles
notable patterns if obvious: repeated topics, AI concentration, startup themes, security incidents
the saved file path

始终生成以下两种输出：

一份保存的机器可读文件。
一份简短的对话式摘要。

摘要应包含：

使用的来源：
```
Hacker News front page
```
获取的条目数量
排名前3-5的故事标题
明显的显著模式（如果存在）：重复话题、AI相关内容集中、创业主题、安全事件等
保存的文件路径

Summary Template

摘要模板

Use this structure:

text

Source: Hacker News front page
Items fetched: <N>
Top stories:
1. <title>
2. <title>
3. <title>

Patterns:
- <pattern or "No strong pattern">

Saved JSON:
<path>

使用以下结构：

text

Source: Hacker News front page
Items fetched: <N>
Top stories:
1. <title>
2. <title>
3. <title>

Patterns:
- <pattern or "No strong pattern">

Saved JSON:
<path>

Error Handling

错误处理

If the script fails:

say that Hacker News fetch or parsing failed
include the command error briefly
do not invent stories or partial results
ask whether to retry or use another source

If the user asked for general tech hot topics and this skill fails, explicitly note that the HN signal is unavailable and another source set is needed.

如果脚本运行失败：

告知用户Hacker News数据获取或解析失败
简要说明命令错误
不要编造故事或部分结果
询问用户是否重试或使用其他来源

如果用户询问的是通用科技热门话题且该技能运行失败，需明确说明HN信号不可用，需要使用其他数据源。

Notes

注意事项

Prefer JSON because agents can reuse it in later steps.
Treat the JSON file as the source of truth for downstream processing.
Do not claim these are all tech-news trends; they are Hacker News front-page signals.

优先使用JSON格式，因为Agent可在后续步骤中复用该格式的数据。
将JSON文件作为下游处理的真实数据源。
不要声称这些内容涵盖所有科技新闻趋势，它们仅代表Hacker News首页的信号。