Option Desk

Option Desk

ローカルダッシュボード、エージェントスキル、MCP ツールを使ったオプション調査です。 オプションチェーンを取り込み、グリークスやポジショニングを確認し、戦略を比較して、結果を読みやすいファイルとして保存できます。

目次

このページの内容

• ダッシュボードを見る
• 始める
• エージェントに質問する
• 調査ワークフローを実行する
• ドキュメントを読む
• 開発
• ライセンス

ガイドと Wiki

• Wiki
• アーキテクチャと図
• スキルをインストールする
• ユーザーガイド
• 例
• インストール
• トラブルシューティング

ダッシュボードを見る

ダッシュボードでは、オプションチェーン、モデルの前提条件、調査結果を1ページにまとめて確認できます。 以下は、合成された学習用入力を使った現在のローカルダッシュボードのキャプチャです。 市場の観測結果や取引実績の証拠を示すものではありません。 キャプチャの詳細では、入力シナリオとキャプチャ日を区別しています。

ダッシュボードの概要

画像を開くと、フル解像度で表示できます。完全なギャラリーには、個々のパネルやチャートが含まれています。 ダッシュボードガイドでは、各項目の読み方を説明しています。

ポジショニング	ボラティリティ
想定されるディーラーエクスポージャーとチェーンのカバレッジを確認します。	欠損値を隠さずに、ストライクと満期を比較します。

構造のペイオフ	2つの満期を使った構造
レッグ、損益分岐点、上限をまとめて確認します。	残存するレッグの評価に関する前提を確認します。

シミュレーション	バックテスト
ファンチャートと収束診断を確認します。	ベンチマークとモデルの制約を踏まえて結果を確認します。

複合比較	コントラクトラダー
数式とモデル間の不一致を確認します。	感応度とペイオフの形状を比較します。

はじめに

次のいずれかを選択してください。

現在の状況	最初に行うこと	続けて読む
データアカウントなしで試したい	以下の付属サンプルを実行します。	最初のウォークスルー
Claude Code または Codex を使っている	ローカルツールをインストールしてから、プラグインを接続します。	エージェントのワークフロー
CSV または JSON のチェーンがある	ソースとタイムスタンプを指定してインポートします。	データのインポート
ブラウザーで使える例を見たい	ホストされたサンプルを開きます。	ホスト接続

付属サンプルを試す

要件：Git と Python 3.11 以降。 macOS または Linux で次のコマンドを実行します。

git clone https://github.com/Iman/agent-driven-options-desk-and-skills.git
cd agent-driven-options-desk-and-skills
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e ./engine -e ./shell
optiondesk chain SYNTH --from-file examples/chain-synth.json --accept-data-rights --out-dir artifacts/tutorial
optiondesk greeks --out-dir artifacts/tutorial
optiondesk exposure --out-dir artifacts/tutorial
optiondesk compare --out-dir artifacts/tutorial
optiondesk dashboard --out-dir artifacts/tutorial

同じコンピューターで http://127.0.0.1:8787 を開きます。 SYNTH と 2026-10-08 を選択します。 サーバーを停止するには、ターミナルで Ctrl+C を押します。結果ファイルは artifacts/tutorial に残ります。

付属サンプルには、62件の合成コントラクトと固定の評価シナリオが含まれています。 インストール後に外部プロバイダーは必要ありません。 ウォークスルーでは、Windows での有効化、期待される結果、次の手順について説明しています。 サンプルの出典では、入力について説明しています。

ローカルデスク一式をインストールする

チェックアウトしたディレクトリから、次を実行します。

./install.sh
optiondesk doctor

これによりローカルツールとスキルがインストールされ、見つかった対応ランタイムの CLI への MCP 登録が試みられます。 インストールでは、パス、フラグ、Docker、削除について説明しています。 プラグインをインストールしただけでは、ローカル計算エンジンはインストールされません。

既存のローカルプロバイダー設定を使って、デモ全体を実行するには、次を実行します。

./run.sh --symbols SPY

ランナーはデータを取得し、リサーチ成果物を作成して、ペーパーポジションを開き、ダッシュボードを提供します。 デフォルトでは ~/TradingDesk/option-desk-demo に書き込みます。 --dry-run を使うと、実行されるコマンドを確認できます。 Yahoo へのアクセスを有効にする前に、プロバイダーのセットアップをお読みください。

エージェントに質問する

製品にスキルをインストールする

製品	インストール方法
Codex	npx、手動コピー、シェルインストーラー、またはプラグイン。
Claude Code	npx、手動コピー、シェルインストーラー、またはプラグイン。
ChatGPT	アカウントが Skills に対応している場合は個別のホスト型スキルをアップロードし、別途 MCP アプリを使用します。
Claude chat	個別のホスト型スキル ZIP とカスタム MCP コネクター。

インストールガイドには、単一スキルと全スキルのインストールコマンド、ユーザー／プロジェクトのスコープ、ZIP の準備、接続確認が記載されています。

ローカルツールを接続したら、次のように尋ねてください。

Use examples/chain-synth.json, the supplied synthetic teaching sample.
I can use this file for private analysis.
Save the results under artifacts/tutorial.
Show its Greeks and positioning, then compare an iron condor with a straddle.
State the source, missing inputs, model assumptions, and degradation first.

やりたいこと	スキル	例
ツールの動作確認	desk-setup	MCP ツールが使えない理由を確認してください。
契約の感応度	options-greeks	このチェーンのデルタ、ガンマ、セータ、ベガを表示してください。
チェーンのポジショニング	options-positioning	ガンマウォールを表示し、ディーラーの符号に関する前提を明記してください。
マルチレッグ構造	options-strategy	これらの構造をペイオフ、損失、グリークスで比較してください。
将来の分布	options-simulation	使用が許可された履歴データから原資産をシミュレートし、収束状況を報告してください。
過去データの調査	options-backtest	この構造をバックテストし、ベンチマークと未考慮のコストについて説明してください。

ローカル MCP サーバーは 12 個のツールを公開します。 ホスト型サービスで対応するワークフローは、スナップショットの検証、グリークス、ポジショニング、ストラテジーのプロットに限られます。 シミュレーションとバックテストは引き続きローカルのワークフローです。 エージェントのセットアップとプロンプトを参照してください。

調査ワークフローに沿って進める

手順	アクション	確認する内容
1. 読み込み	チェーンをインポートする	データソース、タイムスタンプ、満期、欠損している入力。
2. 確認	グリークスとポジショニングを計算する。	単位、スキップ件数、ディーラーの符号に関する前提。
3. 比較	構造を作成する	レッグ、損益分岐点、最大損失、スプレッドコスト。
4. 時間軸を調べる	2 つの満期を比較する	満期直前の評価とスキャンの上限。
5. 過去を調査する	シミュレーションまたはバックテストを行う	収束、ベンチマーク、不確実性、未考慮のコスト。
6. 記録する	ペーパーポジションを開く	計画、仮説、その後の評価、取得できない気配値。

ダッシュボードは保存済みの成果物を読み込みます。ページを開いても、新しいデータは取得しません。 関連するコマンドとダッシュボードでは、同じ --out-dir を使用してください。 結果ガイドでは、各段階の解釈方法を説明しています。

ドキュメントを読む

ガイド	目的
ユーザーガイドのホーム	タスクを選び、結果が得られるまで手順に従います。
インストールリファレンス	ローカル、プラグイン、スキルのみ、ホスト型、コンテナーでの利用に対応する8つのインストール方法を紹介します。
ダッシュボードツアー	パネルを読み、計算が不足している箇所を特定します。
例	コピーして使えるコマンドと期待される結果を紹介します。
トラブルシューティング	インストール、プロバイダー、インポート、チャートに関する問題を解決します。
FAQ	よくある質問と解釈上の制限を紹介します。
機能	機能とインターフェースの一覧です。
マスターアルゴリズム	スキル、ループ、グラフルーティング、プロンプト、バックテスト、ペーパーテストを網羅する単一の疑似コードリファレンスです。
アーキテクチャ	パッケージ、データフロー、契約、現在の図、保存された設計リファレンスを紹介します。
保存されたプロジェクトリファレンス	技術的な詳細、測定値、例を含む以前のREADMEの完全版です。
API一覧	公開関数とクラスの生成済みリファレンスです。
ドキュメントマップ	すべてのガイド、ポリシー、保守リファレンスを一覧表示します。

デスクの掲載先

掲載先	リンク	ステータス
公式MCPレジストリ	com.avidquant/optiondesk	2026-09-11に公開。ホスト型エンドポイントのリモートエントリーで、ドメイン認証済みです。
Smithery	iman-samizadeh/option-desk	2026-09-11に掲載。ホスト型エンドポイントで、13個のツールがスキャンされ、TXTレコードが認証済みです。
Glama サーバー	Iman/agent-driven-options-desk-and-skills	リポジトリからインデックスされ、12個のローカルツールが掲載されています。
Glama コネクター	com.avidquant.optiondesk/option-desk	ホスト型エンドポイント。2026-09-11に掲載され、Glamaによるヘルスチェック済みで、13個のツールがあります。
Claude Code と Codex のマーケットプレイス	このリポジトリ：/plugin marketplace add Iman/agent-driven-options-desk-and-skills	ローカルプラグイン option-desk とホスト型プラグイン option-desk-hosted があります。
ホスト型サンプル	optiondesk.avidquant.com、MCPは /mcp	合成SYNTHデータを使用し、アカウントは不要です。
LinkedInの記事	エージェントが操作できるオプションデスクを構築しました	2026-09-10に公開。
dev.to	dev.to/imansamizadeh	LinkedInへの正規リンクを付けた記事の再投稿です。初週の終了後に公開されます。

ディレクトリの掲載内容は、記載された日時点でのホスト型エンドポイントまたはリポジトリの状態を示します。掲載ページは各ディレクトリで管理されており、このリポジトリでは管理されていません。

開発

テストとカバレッジでは、正常系と異常系、BDD シナリオ、統合チェック、およびパッケージごとのユニットテスト行カバレッジ 80% のゲートについて説明しています。

開発用依存関係をインストールした状態で、リポジトリのルートから実行してください。 環境のセットアップとスクリーンショットの撮影については、開発を参照してください。

python -m pytest engine/tests -q    # 355 tests
python -m pytest shell/tests -q     # 574 tests
python -m pytest agent/tests -q     # 161 tests
python -m pytest -q                # 1090 tests

これらはテストの集計値であり、このドキュメントの編集時にすべてのテストを実行したという主張ではありません。 ワークフローバッジから実際の CI 結果を確認できます。

python3 scripts/refresh.py --no-index
python3 scripts/mutate.py --list

全 10 ステージの実行では、生成ドキュメントとパッケージを再構築し、記録されたエビデンスを確認して、テストスイートとリポジトリのルールを実行します。 ミューテーションハーネスでは 99 個のミューテーションを定義しています。その出力から、検出された変更、生き残った変更、スキップされたケースを確認してください。

shell/src/optiondesk/contracts/ にある 8 つのスキーマがアーティファクトのインターフェースを定義しています：8 schemas + validator。 それぞれの役割については、アーキテクチャガイドを参照してください。

記録された過去の例

エビデンス記録には、以前のチェーン計測値として 2026-08-30T14:12:17+00:00 が固定されています。 607 contracts, spot, listed expiries と 595 solved, 12 refused as unidentified が記録されています。 これらは過去のエビデンス文字列であり、サンプルや現在のスクリーンショットの件数ではありません。 レコーダーは既存のドキュメントチェックのため、これらをここに保持しています。

貢献 · バックログ · 変更履歴 · セキュリティ

ライセンス

このリポジトリは PolyForm Noncommercial 1.0.0 を採用しています。 ソースコードを利用でき、非商用利用は無料です。 商用利用には別途、書面による契約が必要です。LICENSES.mdを参照してください。 ソフトウェアライセンスによってプロバイダーデータの権利が付与されることはありません。

研究用ソフトウェアです。注文の発注は行いません。モデルの結果は約定、推奨、投資助言ではありません。 免責事項、プライバシーポリシー、第三者に関する通知をお読みください。