directory-launch-kit 是做什麼的？
目標：使用者獲得一份簡短、誠實、符合其產品特性的目錄清單、可直接貼上的表單文案、正確尺寸的圖片以及一份追蹤表，而所有提交與付款動作均由使用者親自完成。 此技能絕不代為建立帳號、提交表單、付款、按讚或留言。
步驟 1 — 讀取產品資訊，不自行發明
從存放庫與正式網站收集以下資料（只問缺少的項目）：
| 欄位 | 從哪裡取得 |
|---|---|
name, url（正式 https://，自有網域） | 網站 metadata、package.json、README |
| tagline（≤ 60 字元）與 description（≤ 500） | 首頁主視覺與 meta description |
| pricing | 定價頁面，原文照錄 |
| ai / open_source / developer_tool / agent_skills | 產品實際上歸屬於哪一類 |
| competitors | 詢問使用者（SaaSHub 需要這欄） |
| maker_comment | 使用者自己的話：與使用者共同草擬，永不代貼 |
| logo + 2–5 張真實截圖 | public/ 資料夾，或擷取正式網站（步驟 3） |
依照 assets/product.example.json 的格式寫入 product.json。文案規則請見 references/copy-guide.md。絕不自行添加使用者無法證明的數字、見證、用戶數或「#1」等宣稱；目錄審核會拒絕這些內容，讀者也會失去信任。
步驟 2 — 重新檢查目錄資料
python3 scripts/check_directories.py # 每個目錄顯示 OK / CHANGED / BLOCKED / DOWN
references/directories.json 記錄每個目錄的提交網址、觀察到的費用、規則與讀取日期。在引用任何價格之前，請先打開該目錄的頁面（若狀態為 BLOCKED 或 CHANGED 則使用瀏覽器），並說明讀取日期。當某項目變動時，請更新 JSON。
步驟 3 — 真實截圖
使用真實產品的螢幕截圖，而非 mockup。如果網站已上線，請擷取：
npx playwright screenshot --viewport-size=1440,900 https://example.com shot-1.png
npx playwright screenshot --viewport-size=1440,900 https://example.com/pricing shot-2.png
（或任何瀏覽器設定為 1440×900 解析度）。呈現產品實際運作情況：主畫面、某項結果、定價頁面。各平台的圖片尺寸請見 references/assets.md。
步驟 4 — 建立發布套件
python3 scripts/make_kit.py --product product.json --out launch-kit
產出項目：
launch-kit/copy.md：每個目錄一節，包含提交網址、觀察到的費用與日期、規則、每個表單欄位（含n/limit）以及 maker comment。若某欄位超出限制，會標記OVER LIMIT並使腳本退出回傳 1：此時需與使用者一起縮短product.json中的文字後重新執行。腳本絕不自動截斷。launch-kit/tracker.csv：欄位包含 id, directory, submit_url, cost_observed, checked, backlink_required, status, submitted_on, listing_url, link_rel, notes。重新執行時會保留已記錄的狀態。launch-kit/images/：ph-thumbnail-240.png、logo-512.png、og-1200x630.png、gallery-N-1270x760.png、screenshot-N-1920x1080.png，採用信箱模式（letterboxed，絕不裁切），每個檔案小於 3 MB。
不適合產品的目錄會被跳過並說明原因（非 AI 產品跳過 AI-only 目錄、閉源產品跳過 OpenAlternative、非開發者工具跳過 DevHunt、除非 agent_skills: true 否則跳過 agent-skill 市集）。若使用產品需要註冊，Show HN 會出現警告。
步驟 5 — 安排提交順序（不指定日期，只給順序）
- 審核佇列較長的免費目錄優先（Fazier 免費版、Dang.ai 免費版、SaaSHub、Launching Next、Uneed 免費版）：這些佇列會在您處理其他目錄時持續運行。
- 需要使用者親自回覆的社群（Show HN、Indie Hackers、Reddit、V2EX）：一次一個，僅在使用者接下來幾小時內能回覆留言時進行。
- Product Hunt：先建立草稿，在使用者能整天關注時才發布。
- 付費升級選項：僅在使用者認定價格值得時才考慮；列出觀察到的價格與日期，讓使用者決定。絕不代為付款或輸入信用卡資訊。
需要反向連結的目錄（在 copy.md 中標記）：明確告知使用者該目錄要求哪種徽章／連結，以及該連結將會出現在其網站的哪個位置，只有使用者同意後才加入。
步驟 6 — 追蹤已發布的 listing
使用者提交後，將每個 listing 的網址貼到 tracker.csv。然後執行：
python3 scripts/check_listing.py --tracker launch-kit/tracker.csv --domain example.com --write
此腳本會將狀態標記為 live（附 follow / nofollow）、no-link 或 error。
規則
- 絕不代為提交、註冊、付款、按讚、留言或發文。草擬；使用者執行。
- BetaList 提供官方 agent API，僅會建立草稿（betalist.com/agent）：僅在使用者要求時，你可以建立草稿，然後將認領連結交給使用者；由其自行審閱、付款並發布。
- SaaSHub 明確要求 AI agent 讓人類自行提交：請勿自動化。
- 禁止 vote ring、禁止「請按讚」訊息、禁止假帳號。Product Hunt 與 HN 會對此進行處罰。
- 報價時只能寫「於 <日期> 在 <網址> 觀察到」。
檔案
scripts/make_kit.py：product.json → copy.md, tracker.csv, images/scripts/check_directories.py：即時重新檢查每個目錄頁面與記錄的價格scripts/check_listing.py：確認 listing 是否連結回你的網站，follow 或 nofollowscripts/test_kit.py：自我測試（離線）references/directories.json：資料（26 個目錄，最近檢查日期 2026-11-03）references/directories.md：與 JSON 相同的可讀表格references/copy-guide.md：taglines、描述、Show HN 標題、maker comment 撰寫指引references/assets.md：每個平台的圖片尺寸以及如何擷取
完成條件
-
product.json僅包含來自產品本身與使用者自己話語的事實 - 已執行
check_directories.py，並手動檢查了標記為 CHANGED 或 BLOCKED 的列 -
make_kit.py退出回傳 0（無 OVER LIMIT 欄位），且已開啟圖片確認無誤 - 使用者已取得
copy.md、tracker.csv與images/，並了解提交順序