binance-us-briefing-engine

Binance.US ブリーフィングエンジン

ユーザーのアカウントに合わせた Binance.US のブリーフィングを生成します。このスキルは、市場の動向をユーザー自身のアカウントに結び付ける場合にのみ価値があります。

このリポジトリは、Binance.US スキルファミリーです。

• ルートの SKILL.md：主要なマーケットブリーフィングスキル
• ネストされた SKILL.md ファイル：リサーチ、資金調達、取引、アカウント状況に対応したインストール可能なコンパニオンスキル

リポジトリ全体からスキルファミリーを確認するには、次を使用します。

npx skills add cmeiliu/binance-us-skills --list --full-depth

ネストされたコンパニオンスキルをインストールするには、--full-depth --skill <name> を使用します。

使用しない場合

• 明示的な資金調達ワークフロー
• 現物取引の執行レビュー
• アカウント状況のトラブルシューティング
• ユーザーがすでに銘柄を選んだ後の、単一資産に関する詳細なデューデリジェンス

同梱スクリプトでは、次を優先してください。

• パーセンテージだけの出力より、価格を基準にした出力
• 単一期間の解説より、24時間と7日間の視点
• ポートフォリオ固有の結論より、市場の状況
• 過去のニュースだけでなく、今後のきっかけ
• 保有資産やウォッチ対象資産に関連する、重複を除いて優先順位付けしたニュース
• 一般的なポートフォリオの CTA テキストより、具体的な次のステップ
• コンプライアンスレポートのような表現より、会話形式のアドバイザー調
• 行動を促す場合は、ウォッチリストの不足や遊休資金の状況を明示

このスキルを使用する場面

• 「自分向けのマーケットサマリーをください」
• 「今日、私の Binance.US アカウントで重要なことは何ですか？」
• 「ウォッチリストを要約してください」
• 「ポートフォリオの概要を教えてください」
• 「遊休資金や集中リスクはありますか？」
• 「最近の取引以降、何が変わりましたか？」
• 「資金準備状況を確認してください」
• 「週次の振り返りをしてください」

基本ルール

一般的な市場解説より、アカウントに合わせた出力を優先してください。

認証情報が利用できる場合は、次を使用します。

• 現在の残高
• 最近の取引履歴
• ウォッチリストまたは設定済みの優先資産
• 必要に応じて入金履歴
• 保有中、ウォッチ対象、または最近取引した資産に関する最近の見出し

認証情報が利用できない場合でも、スクリプトは市場のみを対象とした限定的なブリーフィングを生成できますが、その旨を明確に伝える必要があります。

実行方法

同梱スクリプトを実行します。

python3 scripts/binance_us_brief.py --mode daily_brief --format both

よく使うバリエーション：

python3 scripts/binance_us_brief.py --mode portfolio_brief --format text
python3 scripts/binance_us_brief.py --mode watchlist_brief --watchlist BTC,ETH,SOL
python3 scripts/binance_us_brief.py --mode opportunity_alert --alert-threshold-pct 5
python3 scripts/binance_us_brief.py --mode capital_readiness --format text
python3 scripts/binance_us_brief.py --mode asset_research --asset BTC --format text
python3 scripts/binance_us_brief.py init-config

インストール時の動作

• ローカル開発では、--copy を使わないデフォルトのインストール動作を優先してください。これにより、OpenClaw はシンボリックリンクを使用し、ローカルリポジトリの変更をすぐに反映します。
• GitHub からインストールする場合や、コピーしてインストールする場合は、npx skills update を使用して最新の公開バージョンを取得してください。
• 生成されるブリーフィングには、コピーしてインストールした場合のバージョンと更新の案内が含まれるため、古いスナップショットを見つけやすくなります。

認証情報

スクリプトは、次の順序で Binance.US の認証情報を探します。

1. 環境変数：
   • BINANCE_US_API_KEY
   • BINANCE_US_SECRET_KEY
2. ~/.openclaw/secrets.env
3. ~/.env
4. 現在のワークスペースにある .env

スクリプトは特定のキーのみを読み取り、シークレットの生データは出力しません。

オプション設定

スクリプトは、次の場所にある小規模な JSON 設定をサポートしています。

~/.openclaw/binance-us-briefing-engine.json

次のコマンドで作成します。

python3 scripts/binance_us_brief.py init-config

便利なフィールド：

• watchlist
• quote_assets
• quiet_hours
• recent_days
• portfolio_currency
• alert_threshold_pct

推奨ワークフロー

1. daily_brief を実行して、残高と最近の取引に関連付けた全般的な要約を取得します。
2. ユーザーがアカウントへの影響、集中、または遊休資金の状況を知りたい場合は、portfolio_brief を実行します。
3. ユーザーが追跡中の資産について尋ねた場合は、watchlist_brief を実行します。
4. 最近のニュース見出しを使って、今日それらの資産が重要である理由を説明します。
5. 商品を押し付けるような印象を与えずに、市場の状況とアカウントの準備状況を結び付けるには、capital_readiness を実行します。
6. 保有中、ウォッチ対象、または最近取引した資産について、トリガー型の確認を行うには、opportunity_alert を実行します。
7. ポートフォリオを考慮した、より長期的な振り返りには weekly_reset を実行します。
8. ブリーフィングで詳細かつ体系的な追加調査が必要な状況が見つかった場合は、asset_research を実行します。
9. ユーザーがブリーフィングの段階を終え、運用ワークフローを必要としている場合は、binance-us-fund-account、binance-us-spot-trade、または binance-us-account-status に引き継ぎます。

出力仕様

スクリプトは次のいずれかを返します。

• JSON のみ
• テキストのみ
• または両方

JSON 出力が正となる情報源です。テキスト出力は、そのまま配布できる形式です。

ガードレール

• ブリーフは情報提供を目的としたものであり、金融アドバイスではないものとして扱ってください。
• 確実性や利益が保証されていると主張しないでください。
• 取引を自動的に行わないでください。
• ブリーフを読んだ後にユーザーがアクションを求めた場合は、明示的な別のステップとして対応してください。
• このスキルは読み取り専用です。注文の発注、資金の移動、アカウント設定の変更は行いません。
• 許可される外部接続先のドメインは、次のものに限定されます。
  • api.binance.us
  • news.google.com