jackwener--opencli/sitemaps/hackernews/workflows/submit-story.md

schema_version, workflow_id, intent, last_verified, source

schema_version	workflow_id	intent	last_verified	source
1.1	submit-story	submit a new story to HN (URL or text post)	2026-06-02	global

Goal

提交一条 story：title (≤80 char) + url XOR text body。URL post 或 Ask HN / Show HN 文本 post 二选一。

State signature

• entry: 任意 page，logged_in，title 和 url(or text) 已准备
• success: redirect to /newest 顶部出现新 story by 当前 user

Best path

• adapter: null
• adapter_health: broken （HN 无 write adapter，必须走 browser workflow）
• preconditions: logged_in / title ≤ 80 char / url or text ready
• estimated_turns: 4-5

Fallback path

实际就是唯一 path（browser）：

1. opencli browser open https://news.ycombinator.com/submit
2. type title → input[name="title"]
3. type url → input[name="url"] || type text → textarea[name="text"] （互斥，不能同时填）
4. click input[type="submit"]
5. 验证 redirect /newest，顶部新 story by 当前 user

• estimated_turns: 4-5

Avoid

• 不要同时填 url + text（HN 拒绝）
• 不要 submit 超过 daily rate limit (throw_too_fast)
• 不要重复 submit 同 URL（HN dedupe → 抛 "have submitted"）
• title 不带 emoji（部分 emoji 引起 form 拒收）

Re-entry checkpoints

• 已 open /submit，form empty → step 2 起
• title filled 但 url/text 未填 → step 3 起
• form 全填但未 submit → step 4 起
• redirect /newest 且 story 出现 → 完成

State validation

• redirect URL 含 /newest 或 /item?id=<new-id>
• /newest 顶部 story.by 等于当前 user
• title 完全匹配（HN 不修改 title）

Stale markers

• /submit form field name (title / url / text) 几乎不变（10 年没改 form schema）
• HN 偶尔加 captcha 给 new user (< 7 天账号)