promo-scout
ジェネリックで検証第一のプロモーションインテリジェンス。これは誇大広告スクレイパーの逆を行くものです。ライブのGitHub状態がそれを裏付けない限り、ボードに何も到達できず、判断は1つのモデルの意見ではなく、sshxコンセンサス(分離された視点+真理値表)によって行われます。
要件: ghが既存のGitHub認証で認証されていること(gh auth loginまたはGH_TOKENを介して)、および呼び出し元がsshxスキルを利用可能であること。
使用するタイミング
エージェントまたはオペレーターが、ターゲットのリポジトリ/組織について次のことを知りたい場合:今現在本当にプロモーション可能なものは何か、リポジトリ間でどのように関連しているか、そして検証不可能な魅力的な主張は何か。
ステップ0 — ユーザーと明示的なスコープを確認する
アカウント全体のデフォルトはありません。ユーザーに以下の指定を要求します:
- 組織全体(デフォルトでは公開リポジトリのみ)、
- 1つ以上の特定のリポジトリ(
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状態バンドルのみを考慮して、3つのリストを作成してください。(1) プロモーション可能: 今すぐ本当に宣伝する価値のある項目。各項目はバンドル内の具体的な証拠(リリースタグ、日付入りコミット、READMEの機能)を引用する必要があります。(2) 関連性: あるリポジトリの作業が別のリポジトリと組み合わさるクロスリポジトリリンク。各リンクはバンドル内の実際のシグナル(共有PR、依存関係の言及、補完的な機能)によって裏付けられている必要があります。(3) 却下: バンドルがサポートしない魅力的な主張と、欠落している証拠。過剰主張は禁止。証拠がない場合は、プロモーション可能ではなく却下に分類します。
異なるsshx思考視点を使用します。例:プロモーション可能性のレンズ、クロスリポジトリ接続のレンズ、懐疑論者/過剰主張ハンターのレンズ。sshxの真理値表に従って収束を要求し、ワーカーが主張を確立できない場合はabstainを尊重します。
ステップ3 — ボードを出力する
合意された結果をボード(マークダウン+オプションでJSON)として書き込みます:## Promotable now、## Connections、## Dropped (unverifiable)。各プロモーション可能/関連性項目には、そのバンドル証拠がインラインで含まれます。却下リストは必須です — それがボードの信頼性です。
ガードレール
- 証拠がなければ出荷しません。ライブバンドルが唯一のソースであり、外部メモリや水増しされた数字は使用しません。
- 関連性/統合は、ライブ状態に対するコンセンサスから創発する必要があります — 事前に書かれたナラティブを注入してはいけません。
- 構造的に正直であること:検証不可能 → 却下。コンセンサスに達しない場合は、推測ではなく
abstainを報告します。