Hacker News Publisher
Prepare Hacker News submissions. A request to submit or a queue item marked
排队 authorizes the final submission; do not ask again at the last button.
Stop only when the task is limited to a draft or preview.
Inputs
- Source URL, GitHub repo, paper, demo, blog post, or topic.
- Submission type when specified: regular link, Show HN, Ask HN, or comment.
- Optional title, text, or follow-up plan.
If the source URL is missing, inspect recent docs/blog/posts/, relevant
GitHub repos, and canonical eunomia.dev URLs before asking the user.
Platform Entry Points
Use a browser surface with the logged-in session when UI work is required.
References
Load references/platform-preferences.md when choosing HN fit, title, source
URL, Show HN eligibility, browser checks, promotion balance, or comment
follow-up. Do not load broad strategy drafts for routine submissions unless the
user asks for campaign or content-platform planning.
Browser-Only Platform Boundary
Do not use unofficial submission automation, internal endpoints, or vote-related
actions. All checks and submission prep must come from normal browser
interactions.
Draft Preparation
- Decide whether HN is appropriate for the item.
- Prefer the original source: GitHub repo, paper, demo, or canonical article.
- For an existing long-form source, preserve the original title exactly except
for a platform-required marker such as
[pdf]. A different title requires
explicit user instruction.
- Use Show HN only for something readers can try.
- Do not write generated comments for direct posting; draft comment options for
user review and ownership.
Draft Archive
Before opening the HN submit page or comment box, write or update the HN draft
under draft/media/YYYY-MM-DD/<source-slug>/hackernews.md using the local date.
Include submission type, title, URL, duplicate-check state, Show HN eligibility,
and any full paste-ready comment options for user review.
Browser QA
- the same URL/topic is not already active
- title is neutral, not all-caps, and does not include the site name
- URL is the original/canonical source
- Show HN title is only used when the artifact is tryable
- the final action matches the task: submitted when authorized, untouched for a draft-only task
Follow-Up
After confirmed submission, capture the HN item URL. Monitor comments only when
the user asks or follow-up was part of the task. Draft concise, human-reviewed
technical replies. Do not solicit upvotes or comments, and do not ask others to
submit or promote the link.
Ledger Update
After confirmed submission, update .github/publisher/media/published.md with
source path or URL, HN URL, date, submission type, title, and follow-up notes.
1---2name: hackernews-publisher3description: Prepare or publish Hacker News submissions and follow-up drafts for eunomia.dev content, GitHub projects, papers, demos, and Show HN style launches. Use when asked to submit, adapt, publish, QA, or record HN posts. Covers original-source selection, title normalization, curiosity-first positioning, browser duplicate checks, publication authorization, comment follow-up, and media ledger updates.4---56# Hacker News Publisher78Prepare Hacker News submissions. A request to submit or a queue item marked9`排队` authorizes the final submission; do not ask again at the last button.10Stop only when the task is limited to a draft or preview.1112## Inputs1314- Source URL, GitHub repo, paper, demo, blog post, or topic.15- Submission type when specified: regular link, Show HN, Ask HN, or comment.16- Optional title, text, or follow-up plan.1718If the source URL is missing, inspect recent `docs/blog/posts/`, relevant19GitHub repos, and canonical eunomia.dev URLs before asking the user.2021## Platform Entry Points2223- Submit: <https://news.ycombinator.com/submit>24- Show HN: <https://news.ycombinator.com/show>25- New: <https://news.ycombinator.com/newest>26- Search: <https://hn.algolia.com/>2728Use a browser surface with the logged-in session when UI work is required.2930## References3132Load `references/platform-preferences.md` when choosing HN fit, title, source33URL, Show HN eligibility, browser checks, promotion balance, or comment34follow-up. Do not load broad strategy drafts for routine submissions unless the35user asks for campaign or content-platform planning.3637## Browser-Only Platform Boundary3839Do not use unofficial submission automation, internal endpoints, or vote-related40actions. All checks and submission prep must come from normal browser41interactions.4243## Draft Preparation44451. Decide whether HN is appropriate for the item.462. Prefer the original source: GitHub repo, paper, demo, or canonical article.473. For an existing long-form source, preserve the original title exactly except48 for a platform-required marker such as `[pdf]`. A different title requires49 explicit user instruction.504. Use Show HN only for something readers can try.515. Do not write generated comments for direct posting; draft comment options for52 user review and ownership.5354## Draft Archive5556Before opening the HN submit page or comment box, write or update the HN draft57under `draft/media/YYYY-MM-DD/<source-slug>/hackernews.md` using the local date.58Include submission type, title, URL, duplicate-check state, Show HN eligibility,59and any full paste-ready comment options for user review.6061## Browser QA626364- the same URL/topic is not already active65- title is neutral, not all-caps, and does not include the site name66- URL is the original/canonical source67- Show HN title is only used when the artifact is tryable68- the final action matches the task: submitted when authorized, untouched for a draft-only task6970## Follow-Up7172After confirmed submission, capture the HN item URL. Monitor comments only when73the user asks or follow-up was part of the task. Draft concise, human-reviewed74technical replies. Do not solicit upvotes or comments, and do not ask others to75submit or promote the link.7677## Ledger Update7879After confirmed submission, update `.github/publisher/media/published.md` with80source path or URL, HN URL, date, submission type, title, and follow-up notes.