关于 content-hackernews
content-hackernews 是用于撰写 Hacker News 投稿和评论的技能,涵盖 Show HN、Ask HN 和普通链接投稿,并遵循社区重视技术内容、直述且反营销的风格。
主要功能
- 01三类投稿的撰写指南
- 02Show HN 标题与评论结构
- 03Ask HN 问题及背景说明指南
- 04普通链接投稿规则
- 05语气与投稿质量检查
适用场景
- 01为项目撰写 Show HN 投稿
- 02准备明确具体的 Ask HN 问题
- 03调整文章标题以提交至 Hacker News
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ vstorm-co/ content-skills --skill content-hackernews安装后在 Claude Code 中输入/content-hackernews确认已加载。
附带文件hn-voice.mdshow-hn-template.md
详细介绍
Hacker News 内容生成
开始之前
-
理解 HN 文化:Hacker News (news.ycombinator.com) 是一个由求知欲和技术深度驱动的社区。它由 Y Combinator 运营,吸引着创始人、工程师、研究人员和技术素养高的读者。这个社区对营销、夸张用语和炒作极其反感。
-
确定帖子类型:
- Show HN:分享你构建的东西以获取社区反馈
- Ask HN:向社区提问
- 常规投稿:分享内容链接(你自己的或他人的)
-
检查品牌语调:如果存在
brand/VOICE.md,请阅读它,然后使用hn-voice.md对其进行大幅调整。在所有平台中,HN 对语调的要求最为严格。任何形式的营销语言都会导致帖子被标记、被踩或被忽视。
HN 文化
HN 看重什么
- 求知欲和对想法发自内心的兴趣
- 技术深度和严谨思考
- 诚实,尤其是对局限性和取舍的坦诚
- 新颖的见解和原创思考
- 清晰、直接、不加修饰的写作
- 实质重于包装
HN 排斥什么
- 任何形式的营销语言("革命性的"、"颠覆性的"、"改变游戏规则的")
- 夸张用语("最好的"、"最快的"、"最强大的")
- 情绪操纵或诱导互动
- 标题党
- 自我夸耀
- 没有实质内容的炒作
- 没有与社区贡献相称的过度自我推广
HN 受众
- 技术素养高:假设你的读者有能力评估技术主张
- 注重细节:含糊的说法会在评论中受到质疑
- 对炒作持怀疑态度:非凡的主张需要非凡的证据
- 全球化:读者遍布各个时区和众多行业
- 时间有限:他们快速扫读标题并有选择地点击
Show HN 格式与规则
Show HN 用于向社区分享你自己的项目、产品或作品。
标题格式
Show HN: [Concise description of what it is]
好的标题:
- "Show HN: A terminal-based Markdown editor written in Rust"
- "Show HN: Open-source tool to visualize PostgreSQL query plans"
- "Show HN: I built a search engine for academic papers using semantic embeddings"
差的标题:
- "Show HN: The revolutionary new way to manage your infrastructure"(营销)
- "Show HN: Check out my awesome app!"(含糊、炒作)
- "Show HN: [ProductName] -- Disrupting the observability space"(流行词堆砌)
标题规则
- 描述它做什么,而不是它有多棒
- 如果相关,说明所用技术("written in Rust"、"using WASM")
- 保持在 80 个字符以内
- 不要使用全大写或感叹号
- 标题中不要包含定价或"free"
附带评论
每个 Show HN 帖子都应该有创作者发布的一条顶层评论。这条评论至关重要。使用 show-hn-template.md 作为结构参考。
评论应涵盖:
- 它是什么:一句话。清晰、具体、不用术语。
- 你为什么构建它:你面临的问题或项目背后的动机。
- 它如何运作:为好奇者提供的简要技术概述。架构、关键技术、有趣的设计决策。
- 技术上有什么有趣之处:你学到了什么?什么很困难?有什么新颖之处?
- 当前状态和局限性:什么能用,什么不能用,下一步是什么。在这里保持诚实会赢得极大的尊重。
- 你想要什么:你正在寻求的具体反馈。"Feedback welcome"很含糊。"I'd love feedback on the query optimizer approach"则可操作。
Ask HN 格式
Ask HN 用于向社区提问。
标题格式
Ask HN: [Your question]
好的 Ask HN 帖子:
- 具体、定义明确的问题
- 能引出多样、基于经验回答的问题
- 社区近期没有被问过的问题
- 提问者有背景信息可以分享的问题
糟糕的 Ask HN 帖子:
- 搜索引擎就能轻松回答的问题
- 伪装成问题的问卷调查或市场调研
- 「你觉得 [我的产品] 怎么样?」(请改用 Show HN)
正文
- 提供你提问原因的上下文
- 分享你已经尝试过或考虑过的内容
- 具体说明限制条件或要求
- 保持简洁。HN 读者重视简短。
标准投稿
提交链接(博客文章、文章、论文、工具)时:
标题
- 使用内容的原标题。HN 偏好这样做。
- 如果原标题是标题党,请改写为描述性且中立的标题
- 不要加入评论:「关于 X 的好文章」就是在加入评论。只需提交「X」并附上链接。
- 为较旧内容添加「(2023)」或为 PDF 添加「(PDF)」是可以接受的
投稿时机
- HN 在美国工作时间(太平洋时间)最为活跃
- 在高峰时段发帖能获得更多初始曝光
- 周末竞争较少,但流量也较少
什么会被标记和点踩
了解 HN 的执行文化有助于你避免问题:
被标记(被社区或版主移除):
- 明显带有推广性质的投稿
- 标题党标题
- 对近期故事的重复投稿
- 低质量内容
- 来自重度自我推广域名的投稿
被点踩:
- 带有营销语言的评论
- 对批评的防御性回应
- 对讨论没有增益的评论
- 与讨论无关的自我推广评论
- 没有实质内容的「感谢反馈!」
隐形惩罚:引战检测
- HN 有复杂的引战检测机制
- 激烈或不友善的评论可能会被自动降权
- 在回应中假定对方出于善意,即使对方并非如此
HN 语气
有关详细的语气指导,请参见 hn-voice.md。基本规则:
- 直接。 清晰地陈述事情。不要清嗓子。
- 技术性。 HN 读者期待并欣赏技术深度。
- 坦诚说明局限。 「我们目前还处理不好 X」比「我们什么都能处理」赢得更多尊重。
- 不要用最高级。 用具体的比较替代「最好的」。
- 不要用营销语言。 如果它能出现在新闻稿里,就重写它。
- 展示,而非讲述。 不要只说「它很快」,而要展示基准测试。
输出检查清单
在交付 HN 内容之前:
- 标题具有描述性,而非推广性(少于 80 个字符)
- 零营销语言或最高级
- Show HN 帖子包含实质性的创作者评论
- Ask HN 帖子包含上下文并展示此前的研究
- 在相关处包含技术细节
- 诚实描述局限和当前状态
- 内容能够经受技术精湛、持怀疑态度的受众的审视
- 语气遵循
hn-voice.md指南 - 没有标题党、情绪操纵或互动诱饵
评论
支持 Markdown