promo-scout
通用的、验证优先的推广情报工具。它与炒作抓取器截然相反：没有实时 GitHub 状态作为证据，任何内容都不会进入看板；判断由 sshx 共识（隔离视角 + 真值表）做出，而非仅凭单一模型的断言。
要求：gh 已通过现有 GitHub 认证进行认证（通过 gh auth login 或 GH_TOKEN），并且调用者可以使用 sshx 技能。
何时使用
当代理或操作者希望针对目标仓库/组织了解以下信息时：当前真正值得推广的内容、跨仓库的关联关系，以及哪些看似诱人的声明实际上无法验证。
步骤 0 — 向用户确认明确的范围
没有宽泛的账号级默认值。要求用户指定：
- 整个组织（默认仅公开仓库），
- 一个或多个特定仓库（
所有者/仓库），或 - 混合列表。
同时确认组织目标时的
REPO_LIMIT（默认为最近活跃的 12 个公开仓库）。私库收集需要用户明确选择加入，必须使用--include-private标志；除非用户已确认，否则不得使用该标志。
步骤 1 — 获取实时状态（确定性的；可在任何地方运行）
使用明确的目标运行内置抓取器：
python3 scripts/promo_scout_fetch.py <org | owner/repo> [更多...] # 公开/默认范围
python3 scripts/promo_scout_fetch.py --include-private <org | owner/repo> [更多...] # 仅在明确确认后
它会写入 /tmp/promo_scout_bundle.json：每个仓库的 README 头部、最近的提交、发布版本、打开的 PR、最近的问题。这是共识步骤唯一可以使用的证据。
步骤 2 — 对数据包运行真正的 sshx 共识
调用 sshx 技能（工人委托、隔离视角、codex-cli 工人），并将数据包作为固定输入，做出以下决策：
仅依据此实时 GitHub 状态包，生成三个列表。（1）可推广：当前真正值得推广的项目——每个项目必须引用数据包中的具体证据（发布标签、带日期的提交、README 功能）。（2）关联关系：跨仓库链接，其中一个仓库的工作与另一个仓库的工作相关联，每个链接都应有数据包中的真实信号支持（共享的 PR、依赖关系提及、互补功能）。（3）已丢弃：数据包不支持的那些诱人声明，需注明缺失的证据。不得过度声明；如果证据缺失，则归入“已丢弃”，而非“可推广”。
使用不同的 sshx 思考视角，例如：推广性视角、跨仓库关联视角以及怀疑论/过度声明检测视角。要求根据 sshx 真值表达成收敛；当工人无法确立某个声明时，应遵循 abstain（弃权）。
步骤 3 — 输出看板
将达成一致的结果以看板形式写出（Markdown + 可选 JSON）：## 可推广、## 关联关系、## 已丢弃（无法验证）。每个可推广/关联项目都内嵌其数据包证据。“已丢弃”列表是必须的——它代表了看板的可信度。
护栏
- 没有证据就不得发布。实时数据包是唯一的来源；不得使用外部记忆，不得夸大数字。
- 关联关系/综合结论必须从对实时状态的共识中涌现出来——不得注入预先编写的叙事。
- 本质上的诚实：无法验证 → 已丢弃；当无法达成共识时，报告
abstain（弃权），而非猜测。