promo-scout 是做什麼的？
通用、驗證優先的提升情報工具。它與炒作蒐集器完全相反：除非即時 GitHub 狀態支持，否則沒有任何項目能進入看板；而且判斷是透過 sshx 共識（隔離觀點 + 真值表）達成，而非單一模型的片面之詞。
需要：已透過 gh auth login 或 GH_TOKEN 認證的 gh，以及呼叫方可用的 sshx 技能。
使用時機
當智能體或操作者想要針對某個目標儲存庫或組織了解：目前真正值得推廣的項目是什麼、不同儲存庫之間如何連結，以及哪些誘人宣稱是無法驗證的。
步驟 0 — 與使用者確認明確範圍
沒有全域帳號的預設值。要求使用者指定：
- 整個組織（預設僅限公開儲存庫），
- 一個或多個特定儲存庫（
owner/repo），或 - 混合清單。
同時確認組織目標的 REPO_LIMIT（預設為最近活躍的 12 個公開儲存庫）。如需收集私有儲存庫，必須由使用者明確同意後加上 --include-private；未經使用者確認不得使用該旗標。
步驟 1 — 即時狀態擷取（確定性；可從任何位置執行）
使用明確目標執行內建擷取器：
python3 scripts/promo_scout_fetch.py <org | owner/repo> [more...] # 公開/預設範圍
python3 scripts/promo_scout_fetch.py --include-private <org | owner/repo> [more...] # 僅在使用者明確確認後
它會寫入 /tmp/promo_scout_bundle.json：包含每個儲存庫的 README 標題、近期提交、發行版、開放 PR、近期議題。這是共識步驟唯一可使用的證據。
步驟 2 — 對資料包執行真正的 sshx 共識
呼叫 sshx 技能（工作者委派、隔離觀點、codex-cli 工作者），以該資料包為固定輸入，做出以下決策：
僅根據此即時 GitHub 狀態資料包，產生三個清單。(1) 可推廣：目前真正值得推廣的項目——每項都必須引用資料包中的具體證據（發行版標籤、有日期的提交、README 中的功能）。(2) 關聯：跨儲存庫連結，其中一個儲存庫的工作與另一個儲存庫的工作相互組成，每項都由資料包中的真實訊號支持（共享 PR、依賴關係提及、互補功能）。(3) 已剔除：資料包中不支持的誘人宣稱，並說明缺少的證據。不得過度宣稱；如果證據不足，項目就歸入已剔除，而非可推廣。
使用不同的 sshx 思考觀點，例如：可推廣性觀點、跨儲存庫連結觀點，以及質疑/過度宣稱獵手觀點。根據 sshx 真值表要求收斂；當工作者無法建立某項宣稱時，尊重「棄權」。
步驟 3 — 輸出看板
將共識結果寫入看板（Markdown + 可選 JSON）：## 目前可推廣、## 關聯、## 已剔除（無法驗證）。每個可推廣/關聯項目均內嵌其資料包證據。已剔除清單是強制性的——這是看板可信度的來源。
護欄
- 沒有證據就不放行。即時資料包是唯一來源；不得使用外部記憶或誇大數字。
- 關聯與綜合分析必須從即時狀態的共識中浮現——不得注入預先寫好的敘述。
- 誠實為本：無法驗證 → 已剔除；當無法達成共識時，報告「棄權」，而非猜測。