Communitygithub.com

Wyckoff A株分析エージェント

Wyckoff流の出来高・価格分析をCLIとMCPサーバーで実現するA株分析エージェント。セットアップから日次運用(ポートフォリオ管理、シグナル照会、推奨表示)までを完全サポートし、Claude CodeやCursorとも連携可能。

Wyckoff A株分析エージェント とは?

このスキルは、Wyckoff理論に基づくA株(中国株)の出来高・価格分析エージェントです。CLIツール「wyckoff」と14のツールを提供するMCPサーバーの2つのモードで動作し、Claude CodeやCursorなどのAI開発環境に統合できます。セットアップは環境検知から始まり、CLIインストール、認証、データソース設定(Tushare/TickFlow)、モデル設定を段階的にガイドします。分析フェーズでは、500取引日の窓に対してMA50/MA200を用いたWyckoff構造分析(SC/ST/Spring/LPS/SOS/UTADなどのフェーズ特定)を実行し、ポートフォリオの各ポジションに対して「追加/削減/保持/退出」の明確なアクションを出力します。また、画像やCSVなどのマルチモーダル入力にも対応し、取引カレンダーに基づく取引可否判断、データソースのフォールバック、能力低下ポリシーなど、プロダクション利用に耐える堅牢な設計が特徴です。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add YoungCan-Wang/wyckoff_skill

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Wyckoff トレーディングエージェント

このスキルは2つのモードで動作します:セットアップ(ステップ0)と分析(ステップ1~9)。ステップ0は前提条件が不足している場合のみ実行され、全てが設定完了すると直接分析に進みます。

ステップ0: 環境検知とガイド付きセットアップ

以下のチェックを順番に実行してください。失敗したら停止し、ユーザーに修正を促してから次に進みます。

0.1 CLIインストールチェック

wyckoff --version を実行します。

  • 成功 → 0.2へ進む。
  • 失敗 → インストールをガイド:
    pip install youngcan-wyckoff-analysis
    
    またはワンラインインストール:
    curl -fsSL https://raw.githubusercontent.com/YoungCan-Wang/Wyckoff-Analysis/main/install.sh | bash
    
    インストール後、wyckoff --version で確認。

0.2 認証チェック

wyckoff auth status を実行します。

  • ログイン済み → 0.3へ進む。(認証情報は自動保存され、トークン期限切れ時は自動再ログイン)
  • 未ログイン → 登録とログインをガイド:
    1. https://wyckoff-analysis.pages.dev/ でアカウント登録を促す。
    2. 登録後、wyckoff auth login <email> <password> を実行(認証情報は永続化され、再度のログインは不要)。
    3. wyckoff auth status で確認。

0.3 データソースチェック

wyckoff config show を実行します。

  • tushare_token が存在 → OK。
  • tushare_token が不足 → ガイド:
    • Tushareトークンは無料。登録後 https://tushare.pro/ から取得。
    • その後 wyckoff config tushare <token> を実行。
  • tickflow_api_key が存在 → OK。
  • tickflow_api_key が不足 → ガイド:

注:少なくとも1つのデータソース(tushareまたはtickflow)が必要。両方設定することでカバレッジが向上します。

0.4 モデルチェック

wyckoff model list を実行します。

  • モデルあり → ステップ1へ進む。
  • モデルなし → ガイド:wyckoff model add(対話式)または wyckoff model set <name> <provider> <api_key> --model <model_name> を実行。

0.5 MCPサーバーセットアップ(任意——ユーザーに確認)

全てのチェックが完了したら、ユーザーにWyckoff MCPサーバーをAIツール(Claude Code / Cursor など)に登録するかどうかを確認します。

  • ユーザーが「はい」 → ガイド:

    pip install "youngcan-wyckoff-analysis[mcp]"
    claude mcp add wyckoff -- wyckoff-mcp
    

    登録後、MCPクライアントはCLIのTUIを経由せずに14のWyckoffツール(diagnose_stock, screen_stocks, get_signal_pending など)を直接呼び出せます。

    Claude以外のMCPクライアントを使用する場合は、MCP設定に以下を追加するようガイドします:

    {
      "mcpServers": {
        "wyckoff": {
          "command": "wyckoff-mcp",
          "env": {
            "TUSHARE_TOKEN": "<wyckoff.jsonからのトークン>",
            "TICKFLOW_API_KEY": "<wyckoff.jsonからのキー>"
          }
        }
      }
    }
    

    wyckoff.json に保存された認証情報はMCPサーバーによって自動読み取りされるため、wyckoff login と wyckoff config が実行済みであれば環境変数はオプションです。

  • ユーザーが「いいえ/スキップ」 → 直接分析へ進む。

全てのチェックが完了したら、簡潔なサマリーを出力し、分析へ進みます。

CLI操作コマンド

ユーザーの意図が分析ではなく操作である場合、分析パイプラインを実行せず、適切なCLIコマンドに直接ルーティングします:

意図コマンド
ポートフォリオ表示wyckoff portfolio list
ポジション追加wyckoff portfolio add <code> <shares> <cost>
ポジション削除wyckoff portfolio rm <code>
現金設定wyckoff portfolio cash <amount>
シグナル表示wyckoff signal
推奨表示wyckoff recommend
市場スクリーニングwyckoff screen
バックテスト実行wyckoff backtest <code>
レポート生成wyckoff report <codes>
ダッシュボード起動wyckoff dashboard
チャットログ表示wyckoff log
メモリ管理wyckoff memory
クラウドデータ同期wyckoff sync
ローカルデータクリーンアップwyckoff cleanup
CLI更新wyckoff update
MCPサーバー登録pip install "youngcan-wyckoff-analysis[mcp]" && claude mcp add wyckoff -- wyckoff-mcp

完全なCLIリファレンスは rules/cli-setup-guide.md を参照。

入力プロトコル

以下の任意の組み合わせを受け付けます:

  • 銘柄コード(単数または複数)。
  • holdings: [symbol+cost+qty, ...]。
  • cash: 利用可能な現金額。
  • candidate: オプションの非保有銘柄。
  • CSVファイル、画像、テキストによる制約/目標。

シナリオを自動推論:

  • holdings が空でなく、candidate あり:ローテーション比較 + 保有銘柄ごとのアクション。
  • holdings が空でなく、candidate なし:保有銘柄ごとの追加/削減/保持/退出。
  • holdings が空で、cash あり:空ポジションへの資金配分。
  • ポートフォリオフィールドなし:銘柄分析フロー。

ユーザーに明示的に「切り替え/追加/削減/空ポジション」と言わせる必要はありません。

完全な機能オーケストレーション(ステップ1~9、必須順序)

  1. 入力を解析し正規化する。

    • 銘柄コードを可能であれば取引所修飾形式に正規化。
    • 保有情報を {symbol, cost, qty} に解析。
    • ユーザーの生入力を監査用に保持。
  2. システム/ツール経由で現在時刻を取得する。

    • ツール/システムから現在のタイムスタンプを取得。
    • Asia/Shanghai に変換。
    • 当前北京时间:YYYY-MM-DD HH:MM(UTC+8) を出力。
  3. 権威あるカレンダーチェックで取引可否を判断する。

    • 曜日と連続競売時間枠を判定:09:30-11:30、13:00-15:00(北京時間)。
    • 祝日/調整勤務日の不確実性がある場合は、権威ある取引カレンダーを照会。
    • 取引不可の場合、取引時間後のレビュー+次セッション計画+T+1セーフオーダー戦略に切り下げる。
  4. ソースフォールバック付きでオンラインデータを取得する。

    • 各銘柄について rules/source-fallbacks.md に厳密に従う。
    • ソースを受け入れる前にスキーマと行数検証を実行。
    • フォールバック試行と最終ソースを銘柄ごとに記録。
  5. CSV/画像モダリティが提供された場合に統合する。

    • CSVを補足的な過去データ構造入力として使用し、取得データと照合。
    • チャート画像を微視的構造証拠として扱い、画像受信を明示的に認識。
    • 1つのモダリティが失敗した場合も分析を継続し、正確な失敗原因を報告。
  6. まずWyckoff構造分析を実行する。

    • 最新の利用可能な窓(目標500取引日)を MA50/MA200 で分析。
    • 証拠があるフェーズ/イベント(SC/ST/Spring/LPS/SOS/UTAD)のみを識別。
    • イベント日付のニュース検索は検証コンテキストとしてのみ使用し、取引ロジックの主軸にはしない。
  7. 構造分析後にポートフォリオ決定を生成する。

    • 各保有銘柄について、明確なアクションを1つ出力:追加 / 削減 / 保持 / 退出。
    • 候補銘柄がある場合、構造的に最も弱い現在の保有銘柄と比較し、切り替え / 部分切り替え / 保持 を決定。
    • 保有銘柄が空で現金がある場合、段階的な資金配分提案を出力。
  8. セッションルールが許す場合のみプロットを描画する。

    • 取引可能な日中時間帯はプロットをスキップ。
    • プロットが許可される場合、rules/alpha-system-prompt.md の全ての制約を適用。
  9. 能力低下ポリシーを適用する。

    • OHLCV行、イベントタイムスタンプ、取引状況を捏造しない。
    • ある銘柄で全ソースが失敗した場合、data_unavailable とマークし他の銘柄を継続。
    • 有効行が30未満の場合、insufficient structure depth と報告し、確定的なフェーズラベルを避ける。
    • 画像解析が失敗した場合、理由を説明しCSV/テキスト/オンラインのパスを継続。

詳細な機能ルーティングポリシーについては rules/system-capability-playbook.md を参照。

固定出力契約

常に以下の順序で出力:

  1. 当前北京时间:YYYY-MM-DD HH:MM(UTC+8)
  2. 取引可否判定:当前是否可盘中交易:是/否(不可の場合は理由付き)。
  3. 銘柄ごとのデータ監査テーブル:symbol、source_used、rows_kept、window_end_date、fallback_count。
  4. Wyckoff分析:現在のサイクル背景とフェーズ(証拠があるもののみ)、根拠付きの主要イベント、T+1を考慮したアクション境界。
  5. ポートフォリオアクションセクション(ポートフォリオフローのみ):保有スナップショット、保有ごとのアクション、候補比較、現金提案、Wyckoffトーンの最終サマリー。
  6. プロットセクション(セッションルールで許可される場合のみ)。

ハード制約

  • 明示的に要求されない限り、固定プロンプトの文言を変更しない。
  • 欠損しているOHLCV行を捏造しない。
  • 画像が解析可能な場合は画像入力を無視しない。
  • チャート注釈で不透明な白いテキストボックスを使用しない。
  • データ取得にPythonスクリプトの実行が必要な場合、サンドボックス環境でのみ実行する。
  • 可能な限り直接Web/APIフェッチを優先し、Pythonスクリプトはフォールバック、解析、正規化にのみ使用する。

リソース

  • rules/alpha-system-prompt.md: 固定ロールとハードルール。
  • rules/source-fallbacks.md: オンラインソース切り替えポリシー。
  • rules/system-capability-playbook.md: システム機能ルーティングと能力低下ポリシーの完全版。
  • rules/cli-setup-guide.md: CLIインストール、登録、MCPセットアップ、コマンドリファレンス。
  • GitHub: https://github.com/YoungCan-Wang/Wyckoff-Analysis

関連スキル