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 | bashwyckoff --versionで確認。
0.2 認証チェック
wyckoff auth status を実行します。
- ログイン済み → 0.3へ進む。(認証情報は自動保存され、トークン期限切れ時は自動再ログイン)
- 未ログイン → 登録とログインをガイド:
- https://wyckoff-analysis.pages.dev/ でアカウント登録を促す。
- 登録後、
wyckoff auth login <email> <password>を実行(認証情報は永続化され、再度のログインは不要)。 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 が不足 → ガイド:
- TickFlowはリアルタイムおよび過去のA株データを提供。
- https://tickflow.org/auth/register?ref=5N4NKTCPL4 で購入。
- その後
wyckoff config 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、必須順序)
-
入力を解析し正規化する。
- 銘柄コードを可能であれば取引所修飾形式に正規化。
- 保有情報を
{symbol, cost, qty}に解析。 - ユーザーの生入力を監査用に保持。
-
システム/ツール経由で現在時刻を取得する。
- ツール/システムから現在のタイムスタンプを取得。
Asia/Shanghaiに変換。当前北京时间:YYYY-MM-DD HH:MM(UTC+8)を出力。
-
権威あるカレンダーチェックで取引可否を判断する。
- 曜日と連続競売時間枠を判定:
09:30-11:30、13:00-15:00(北京時間)。 - 祝日/調整勤務日の不確実性がある場合は、権威ある取引カレンダーを照会。
- 取引不可の場合、取引時間後のレビュー+次セッション計画+T+1セーフオーダー戦略に切り下げる。
- 曜日と連続競売時間枠を判定:
-
ソースフォールバック付きでオンラインデータを取得する。
- 各銘柄について
rules/source-fallbacks.mdに厳密に従う。 - ソースを受け入れる前にスキーマと行数検証を実行。
- フォールバック試行と最終ソースを銘柄ごとに記録。
- 各銘柄について
-
CSV/画像モダリティが提供された場合に統合する。
- CSVを補足的な過去データ構造入力として使用し、取得データと照合。
- チャート画像を微視的構造証拠として扱い、画像受信を明示的に認識。
- 1つのモダリティが失敗した場合も分析を継続し、正確な失敗原因を報告。
-
まずWyckoff構造分析を実行する。
- 最新の利用可能な窓(目標500取引日)を
MA50/MA200で分析。 - 証拠があるフェーズ/イベント(SC/ST/Spring/LPS/SOS/UTAD)のみを識別。
- イベント日付のニュース検索は検証コンテキストとしてのみ使用し、取引ロジックの主軸にはしない。
- 最新の利用可能な窓(目標500取引日)を
-
構造分析後にポートフォリオ決定を生成する。
- 各保有銘柄について、明確なアクションを1つ出力:
追加 / 削減 / 保持 / 退出。 - 候補銘柄がある場合、構造的に最も弱い現在の保有銘柄と比較し、
切り替え / 部分切り替え / 保持を決定。 - 保有銘柄が空で現金がある場合、段階的な資金配分提案を出力。
- 各保有銘柄について、明確なアクションを1つ出力:
-
セッションルールが許す場合のみプロットを描画する。
- 取引可能な日中時間帯はプロットをスキップ。
- プロットが許可される場合、
rules/alpha-system-prompt.mdの全ての制約を適用。
-
能力低下ポリシーを適用する。
- OHLCV行、イベントタイムスタンプ、取引状況を捏造しない。
- ある銘柄で全ソースが失敗した場合、
data_unavailableとマークし他の銘柄を継続。 - 有効行が30未満の場合、
insufficient structure depthと報告し、確定的なフェーズラベルを避ける。 - 画像解析が失敗した場合、理由を説明しCSV/テキスト/オンラインのパスを継続。
詳細な機能ルーティングポリシーについては rules/system-capability-playbook.md を参照。
固定出力契約
常に以下の順序で出力:
当前北京时间:YYYY-MM-DD HH:MM(UTC+8)- 取引可否判定:
当前是否可盘中交易:是/否(不可の場合は理由付き)。 - 銘柄ごとのデータ監査テーブル:
symbol、source_used、rows_kept、window_end_date、fallback_count。 - Wyckoff分析:現在のサイクル背景とフェーズ(証拠があるもののみ)、根拠付きの主要イベント、T+1を考慮したアクション境界。
- ポートフォリオアクションセクション(ポートフォリオフローのみ):保有スナップショット、保有ごとのアクション、候補比較、現金提案、Wyckoffトーンの最終サマリー。
- プロットセクション(セッションルールで許可される場合のみ)。
ハード制約
- 明示的に要求されない限り、固定プロンプトの文言を変更しない。
- 欠損している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