hertzflow

hertzflow — 暗号資産の取引判断インテリジェンス（単一スキル、複数ドメイン）

hertzflow は、オンチェーンと CEX の取引リサーチを統括する HertzFlow のスキルです。Surf と同様に、内部ルーティングを備えた単一のスキルです。以下の表で、ユーザーのリクエストを処理するサブドメインを確認し、そのサブドメインの INSTRUCTIONS.md に従ってください。

🌐 言語 — 必須、最初に読むこと

ユーザーの最新のメッセージの言語を検出し、会話での返信と生成するレポートの両方に、その言語を使用してください。 これは任意ではなく、ユーザーが指定する必要もありません。

• メッセージに CJK 文字（一-鿿、かな、ハングル）が含まれる場合 → 中国語（zh）で処理します。中国語で返信し、--lang zh を指定してパイプラインを実行します。
• それ以外（英語／ラテン文字のプロンプト） → 英語（en）で処理します。英語で返信し、--lang en を指定してパイプラインを実行します。

レポートでサポートされる言語は zh と en です（静的な人手キュレーション済みパック）。それ以外の言語でのプロンプトには、その言語で返信しますが、レポートは最も近いサポート言語である en で生成し、その旨を1行で伝えてください。

レポート本文の言語は、forensic_pipeline.py --lang {zh|en} によってパイプライン実行時に固定されます。レンダリング時に変更することはできず、ナラティブの入力内容も同じ言語で作成する必要があります。正確なルールについては、alpha/INSTRUCTIONS.md の「Report language」セクションを参照してください。ここで誤ると、パイプライン全体を再実行する必要があり（Surf クレジットも再消費します）、最初にユーザーの言語に基づいて設定してください。

ルーティングテーブル

ユーザー入力が次に該当する場合…	サブドメイン	手順ファイル
0x で始まる EVM の40桁の16進数 CA（0xea37a8de…）	alpha（Binance Alpha のフォレンジック）	alpha/INSTRUCTIONS.md
Solana の base58 CA（例：Grass7B4R…）	alpha（HOLDER_SNAPSHOT モード）	alpha/INSTRUCTIONS.md
現在 Binance Alpha で扱われているトークンのティッカー（$JCT、$VELVET など）	alpha — まず surf search-token --q <ticker> でティッカー → CA を解決してから、処理を振り分けます	alpha/INSTRUCTIONS.md
Alpha の配布／内幕出货／链上派发／quiet insider／chip structure に関する自然言語での表現	alpha	alpha/INSTRUCTIONS.md
Perp のシンボル（例：BTCUSDT）＋分析の意図	perp（未リリース）	— 近日公開
Bridge プロトコル名＋監査の意図	bridge（未リリース）	— 近日公開
HertzFlow 独自のコントラクトアドレス＋診断の意図	core（未リリース）	— 近日公開

呼び出し時の最初のアクション

1. 上記のルーティングテーブルからサブドメインを特定します（デフォルト：alpha）。
2. cat <sub-domain>/INSTRUCTIONS.md を実行します（パスはこのスキルのインストールルートからの相対パスです。実行時は ~/.claude/skills/hertzflow/ または同等のエージェントスキルディレクトリであり、リポジトリのルートではありません。そのため、alpha サブドメインの場合は alpha/INSTRUCTIONS.md を読みます）。または、エージェントのファイル読み取りツールを使って読み込みます。このファイルには、オンボーディング（Surf CLI のインストールと API キーのプロンプト）、前提条件、3ステップのワークフロー（forensic_pipeline.py → LLM 入力 → render_report.py）、書き込み可能なスロットのガイド、バリデーターのルール、出力スキーマを含む、ドメインごとの完全な SKILL.md が記載されています。
3. そのファイルの指示に一字一句従ってください。このルーターファイルからワークフローを再構成しないでください。ドメインごとの手順が正式なものであり、バージョンも固定されています。

このスキルがこのような構成になっている理由

• 単一のスラッシュコマンド /hertzflow：HertzFlow は、複数のリサーチドメイン（Alpha のフォレンジック、perp 指標、bridge 監査、HertzFlow core）を扱う単一の製品ブランドです。ユーザーは1つのスラッシュコマンドを実行し、ルーターが振り分けを処理します。
• 広範な説明による自動起動：上記の説明では、Surf と同様に、インサイダーによる配布やチップ構造などの自然言語での言及をエージェントが自動的に検出して起動するよう指示しています。ユーザーが明示的にスラッシュコマンドを入力する必要はありません。
• サブドメインの分離：各サブドメインは、それぞれ独自の INSTRUCTIONS.md、ヘルパー、バージョン管理を持つ専用フォルダーに配置されています。後から perp/ を追加しても、alpha/ のコードを変更する必要はありません。

信頼境界（すべてのサブドメインに適用）

• パイプライン（Python）。 決定論的です。すべての SQL、オンチェーン読み取り、エビデンスグラフ ID を管理します。データに触れる唯一のレイヤーです。
• LLM（すべてのモデル）。 構造化された書き込み可能フィールド内のナラティブ用スロットを埋めます。SQL を記述できません。判定を選べません。しきい値を決定できません。
• バリデーター。 書き込み可能なスロット外への LLM による書き込み、エビデンスグラフに存在しないデータへの参照、重複した定型文、パイプラインのロック済み出力を上書きしようとするあらゆる試みを拒否します。

すべてのサブドメインの INSTRUCTIONS.md は、この3つの境界を守る必要があります。

アップグレード

npx skills update hertzflow

HertzFlow/hertzflow-skills の main から最新リビジョンを取得します。 メジャーリリース後（v0.9.x → v1.0.0 など）に実行してください。現在のバージョンはフロントマター（metadata.version）と alpha/v06/helpers/_version.py に記載されています。