mcpField
T
technical-analyst

technical-analyst

github.com/tradermontyその他3.4k4.0k 回インストール2 日前に更新
リポジトリ

technical-analyst について

technical-analystは、ユーザーが提供する週足チャート画像を分析するスキルです。トレンドや支持・抵抗線、移動平均、出来高、パターンを順に確認し、確率付きシナリオを含むMarkdownレポートを作成します。

主な機能

  1. 01週足チャートの体系的な分析
  2. 02トレンドと支持・抵抗線の評価
  3. 03移動平均・出来高・パターンの確認
  4. 04確率加重の価格シナリオ作成
  5. 05Markdown分析レポートの作成

活用シーン

  1. 01株式・指数・暗号資産の週足分析
  2. 02重要水準や反転候補の特定
  3. 03今後の値動きのシナリオ作成
  4. 04複数チャートの分析結果の記録

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tradermonty/claude-trading-skills --skill technical-analyst

インストール後、Claude Code で/technical-analystを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

requirements.txt
assets/
analysis_template.md
references/
contrarian-confirmation-checklist.md
technical_analysis_framework.md
scripts/
check_weekly_price_action.py
weekly_price_action.py
scripts/tests/
test_check_weekly_price_action.py
test_skill_contract.py
test_weekly_price_action.py

詳細

テクニカルアナリスト

概要

このスキルは、週足チャートの包括的なテクニカル分析を可能にします。チャート画像を分析して、トレンド、サポートとレジスタンスの水準、移動平均線の関係、出来高のパターンを特定し、今後の価格変動について確率に基づくシナリオを作成します。分析はすべて、ニュース、ファンダメンタルズ、市場センチメントの影響を受けず、チャートデータのみを用いて客観的に行います。

使用する場面

  • ユーザーが週足チャート画像を提示し(株式、指数、暗号資産、外国為替など)、テクニカル分析を求めている
  • トレンドの方向、強さ、反転の可能性があるポイントを特定する必要がある
  • サポート/レジスタンスの水準や重要な価格帯を把握したい
  • 具体的な価格目標を含む、確率に基づくシナリオを作成したい
  • ファンダメンタルズやニュースを考慮せず、チャートに基づく客観的な分析が必要である

前提条件

  • チャート画像:分析には、ユーザーが週足のチャート画像を提示する必要があります
  • API キーは不要:このスキルはユーザーが提示した画像を分析するため、外部データの取得は行いません

出力

このスキルは、reports/ ディレクトリに保存される Markdown 形式の分析レポートを生成します。

  • ファイル形式:[SYMBOL]_technical_analysis_[YYYY-MM-DD].md
  • 内容:トレンド、S/R 水準、移動平均線の分析、出来高、チャートパターン、および価格目標と無効化水準を示す 2~4 件の確率に基づくシナリオを含む、包括的な分析

基本原則

  1. チャートのみの分析:すべての結論は、チャート上で確認できるテクニカルデータのみに基づきます
  2. 体系的なアプローチ:各チャートの分析で、構造化された手法に従います
  3. 客観的な評価:主観的な偏りを避け、観察可能なパターンとデータに焦点を当てます
  4. 確率に基づくシナリオ:今後起こり得る展開を、確率を加味したシナリオとして示します
  5. 順次処理:各チャートを個別に分析し、所見をその都度記録します

分析ワークフロー

ステップ 1:チャート画像を受け取る

ユーザーが分析用の週足チャート画像を 1 枚以上提示した場合:

  1. すべてのチャート画像を受け取ったことを確認します
  2. 分析対象のチャート数を特定します
  3. ユーザーが指定した注目点があれば記録します
  4. チャートを 1 枚ずつ順番に分析します
ステップ 2:テクニカル分析フレームワークを読み込む

分析を始める前に、包括的なテクニカル分析の手法を読み込みます。

Read: references/technical_analysis_framework.md

このリファレンスには、以下に関する詳細なガイダンスが含まれています。

  • トレンド分析と分類
  • サポートとレジスタンスの特定
  • 移動平均線の解釈
  • 出来高分析
  • チャートパターンとローソク足の分析
  • シナリオの作成と確率の設定
  • 分析における規律と客観性
ステップ 3:各チャートを体系的に分析する

各チャート画像について、以下の順序に従って体系的に分析します。

3.1 トレンド分析
  • トレンドの方向(上昇、下降、横ばい)を特定します
  • トレンドの強さ(強い、中程度、弱い)を評価します
  • トレンドの継続期間と、勢いが尽きる可能性を示す兆候を確認します
  • 高値・安値の切り上げ、または切り下げのパターンを調べます
3.2 サポートとレジスタンスの分析
  • 重要な水平サポート水準を記録します
  • 重要な水平レジスタンス水準を記録します
  • トレンドラインのサポート/レジスタンスを特定します
  • サポートとレジスタンスの役割が入れ替わった箇所があれば記録します
  • 複数の S/R 水準が重なるコンフルエンスゾーンを評価します
3.3 移動平均線の分析
  • 価格が 20 週、50 週、200 週の移動平均線に対してどの位置にあるかを確認します
  • 移動平均線の配列(強気、弱気、中立)を評価します
  • 移動平均線の傾き(上向き、下向き、横ばい)を確認します
  • 最近発生した、または発生が近い移動平均線のクロスオーバーを特定します
  • 移動平均線が動的なサポートまたはレジスタンスとして機能しているかを確認します
3.4 出来高分析
  • 全体的な出来高の推移(増加、減少、安定)を評価します
  • 出来高の急増とその状況(サポート/レジスタンス付近、ブレイクアウト時など)を特定します
  • 価格に対する出来高の裏付け、または乖離を確認します
  • 出来高のクライマックスや勢いの枯渇を示すパターンがあれば記録します
3.5 チャートパターンとプライスアクション
  • 反転パターン(ハンマー、シューティングスター、包み足パターンなど)を特定する
  • 継続パターン(フラッグ、トライアングルなど)を特定する
  • 重要なローソク足の形成に注目する
  • 最近のブレイクアウトまたはブレイクダウンを観察する
3.6 観察結果の統合
  • すべてのテクニカル要素を統合し、一貫性のある現在の評価を行う
  • チャートに影響を与える最も重要な要因を特定する
  • 矛盾するシグナルや曖昧さがあれば指摘する
  • 今後の方向性を決定づける主要なレベルを設定する
ステップ 4: 確率シナリオの作成

分析した各チャートについて、今後の価格変動に関する 2~4 個の異なるシナリオを作成します。

シナリオの構成

各シナリオには以下を含める必要があります。

  1. シナリオ名: 明確で説明的なタイトル(例: 「強気ケース: レジスタンス上抜けのブレイクアウト」)
  2. 確率の推定: テクニカル要因に基づく可能性のパーセンテージ(すべてのシナリオの合計が 100% になる必要があります)
  3. 説明: このシナリオが何を意味し、どのように展開するか
  4. 根拠となる要因: このシナリオを裏付けるテクニカルな証拠(最低 2~3 個の要因)
  5. 目標レベル: シナリオが実現した場合に予想される価格水準
  6. 無効化レベル: このシナリオを否定する具体的な価格水準
典型的なシナリオの枠組み
  • 基本ケースシナリオ(40~60%): 現在の構造に基づく最も可能性の高い結果
  • 強気ケースシナリオ(20~40%): 上方向へのブレイクアウトを必要とする楽観的シナリオ
  • 弱気ケースシナリオ(20~40%): 下方向へのブレイクダウンを必要とする悲観的シナリオ
  • 代替シナリオ(5~15%): 確率は低いがテクニカル的に妥当な結果

裏付けとなるテクニカル要因の強さに基づいて確率を調整してください。確率が現実的であり、合計が 100% になることを確認してください。

ステップ 5: 分析レポートの生成

分析した各チャートについて、テンプレート構造を用いて包括的な Markdown レポートを作成します。

Read and use as template: assets/analysis_template.md

レポートにはすべてのセクションを含める必要があります。

  1. チャートの概要
  2. トレンド分析
  3. サポートとレジスタンスのレベル
  4. 移動平均の分析
  5. 出来高の分析
  6. チャートパターンとプライスアクション
  7. 現在の市場評価
  8. シナリオ分析(確率付きの 2~4 個のシナリオ)
  9. まとめ
  10. 免責事項

ファイル命名規則: 各分析を [SYMBOL]_technical_analysis_[YYYY-MM-DD].md として保存します。

例: SPY_technical_analysis_2025-11-02.md

ステップ 6: 複数チャートでの繰り返し

複数のチャートが提供された場合:

  1. 最初のチャートについて完全な分析ワークフロー(ステップ 3~5)を完了します
  2. 分析レポートを保存します
  3. 次のチャートに進みます
  4. すべてのチャートが分析・文書化されるまで繰り返します

分析をまとめて処理しないでください。次のチャートに移る前に、各レポートを完成させて保存してください。

品質基準

客観性の要件
  • すべての分析は、観察可能なチャートデータに厳密に基づいてください
  • 外部情報(ニュース、ファンダメンタルズ、センチメント)を取り入れないでください
  • 「私はこう思う」「私はこう感じる」といった主観的な表現を使わないでください
  • シグナルが曖昧な場合は、不確実性を明確に表現してください
  • 確証バイアスを避けるため、強気と弱気の両方の可能性を示してください
完全性の要件
  • 分析テンプレートのすべてのセクションに対応してください
  • サポート、レジスタンス、目標について具体的な価格水準を示してください
  • 確率の推定をテクニカル要因で正当化してください
  • 各シナリオに無効化レベルを含めてください
  • 分析の限界や注意事項があれば指摘してください
明確性の要件
  • 正確なテクニカル用語を正しく使用してください
  • 明確でプロフェッショナルな言葉で書いてください
  • 情報を論理的に構成してください
  • 具体的な価格水準を含めてください(曖昧な説明ではなく)
  • シナリオを明確かつ相互排他的にしてください

使用例のシナリオ

例 1: 単一チャートの分析

User: "Please analyze this weekly chart of the S&P 500"
[Provides chart image]

Analyst:
1. Confirms receipt of chart image
2. Reads technical_analysis_framework.md for methodology
3. Conducts systematic analysis (trend, S/R, MA, volume, patterns)
4. Develops 3 scenarios with probabilities (e.g., 55% bullish continuation, 30% consolidation, 15% reversal)
5. Generates comprehensive analysis report using template
6. Saves as SPY_technical_analysis_2025-11-02.md

例 2: 複数チャートの分析

User: "Analyze these three charts: Bitcoin, Ethereum, and Nasdaq"
[Provides 3 chart images]

Analyst:
1. Confirms receipt of 3 charts
2. Reads technical_analysis_framework.md
3. Analyzes Bitcoin chart completely → Generates report → Saves as BTC_technical_analysis_2025-11-02.md
4. Analyzes Ethereum chart completely → Generates report → Saves as ETH_technical_analysis_2025-11-02.md
5. Analyzes Nasdaq chart completely → Generates report → Saves as NDX_technical_analysis_2025-11-02.md
6. Notifies user that all three analyses are complete

例 3: 焦点を絞った分析リクエスト

User: "I'm particularly interested in whether this stock will break above resistance. Analyze the chart."
[Provides chart image]

Analyst:
1. Conducts full systematic analysis
2. Pays special attention to resistance levels and breakout probability
3. Develops scenarios with emphasis on breakout vs. rejection possibilities
4. Assigns probabilities based on volume, trend strength, and proximity to resistance
5. Generates complete report with focused scenario analysis

逆張り確認モード(Shapiro ステップ 3)

これは、上記のチャート分析のみのワークフローとは別の、追加モードです。明示的な逆張り確認の依頼があった場合にのみ有効になります。通常は、cot-contrarian-detector(ステップ 1)が市場のポジションの偏りを検出し、必要に応じて news-reaction-failure-analyzer(ステップ 2)が有利なニュースに市場が反応しなかったことを示した後に実行されます。単に「このチャートを分析してください」と依頼された場合は、従来のワークフロー(上記のステップ 1~6)が変更なく実行されます。

目的

週足チャートに、ポジションの偏った市場が反転していることを示す値動きの証拠があるかどうかを確認します。対象となるのは、週足のキーリバーサル、週内に発生した極値の失敗、またはブレイクアウトを確認した後に否定された動きです。ただし、継続チェック(検出されたシグナルのいずれよりも後に、ポジションの偏った側の方向で新たな終値ベースの極値が付いている場合は無効)によって覆されることがあります。チャートモードとスクリプトモードで共有される、完全かつ一字一句同じ手法については、references/contrarian-confirmation-checklist.md を参照してください。

入力
  • ポジションの偏りの方向:CROWDED_LONG または CROWDED_SHORT。ユーザー、または以前の cot-contrarian-detector レポートから取得します。
  • チャート画像(優先):ユーザーが提供する週足チャート。既存のワークフローと同じ方法で読み取り、以下の厳密な定義を適用します。
  • スクリプトによる代替(データ駆動型):チャートが提供されない場合、または視覚的な判定の代わりに(あるいはそれと併せて)監査可能で決定論的な結果が必要な場合は、scripts/check_weekly_price_action.py を使用します。
3 つのチェックとスイング水準
  1. 週足のキーリバーサル:新たなスイング・ルックバックの極値(デフォルトは 13 週)を付けた後、前週の反対側の水準を超えて引けること。
  2. 極値の失敗:週内に、過去の極値を参照するルックバック水準(デフォルトは 52 週)を超える動きがあった後、同じ週のうちにその水準を再び超えて引けること。
  3. ブレイクアウトの失敗:週足の終値が、過去の極値を参照するルックバック水準を超えてブレイクアウトした後、以降 <=3 週以内に否定され(再びその水準を超えて引け)、失敗すること。week_of は失敗した週を指し、ブレイクアウトした週を指すことはありません。
  4. 継続による無効化:ポジションの偏った側の方向で新たな終値ベースの極値が付き、それが上記でトリガーされた最新のシグナルよりも厳密に後の日付である場合、どのシグナルがトリガーされていたかにかかわらず、確認は無効になります。
  5. スイング水準:最も近いフラクタル・スイング高値/安値(5 週のピボット。文書化された代替手順あり)が stop_reference になります。ポジションの偏った LONG に逆張りする場合は最も近いスイング高値、ポジションの偏った SHORT に逆張りする場合は最も近いスイング安値です。

比較はすべて厳密な不等号を使用します。期間の切り詰めは実行単位ではなく、評価対象の週ごとに行われます。完全な定義、方向を反転した場合の対応表、具体例、および confidence-HIGH のルールについては、references/contrarian-confirmation-checklist.md を参照してください。チャートモードで判定を出す前にこれを読み、チャートとスクリプトが同じ基準で判定されるようにしてください。

出力仕様
symbol: BT
direction: CROWDED_LONG
mode: data # "chart" for a Claude chart-image read
verdict: CONFIRMED | NOT_CONFIRMED | INSUFFICIENT_DATA
confidence: HIGH | MEDIUM | LOW # LOW reserved, never emitted in v1
verdict_reason: key_reversal | failed_extreme | failed_breakout |
  continuation_intact | no_reversal_evidence |
  insufficient_weekly_bars | no_price_source | ...
checks:
  weekly_key_reversal:
    { triggered, week_of, swing_window_weeks_used,
      extreme_window_weeks_used, is_full_window_extreme, detail }
  failed_extreme: { triggered, attempted_level, week_of, window_weeks_used, detail }
  failed_breakout: { triggered, breakout_level, week_of, window_weeks_used, detail }
  continuation: { new_closing_extreme_with_crowd, week_of, window_weeks_used }
swing_levels:
  nearest_swing_high: { price, week_of, fallback }
  nearest_swing_low: { price, week_of, fallback }
  stop_reference: 0.0
weekly_bars_used: 52
last_completed_week: 2026-07-06
handoff: # consumed by contrarian-setup-gate (#241)
  price_action: { verdict, confidence, stop_reference, report_path }
run_context:
  {
    price_symbol,
    price_source,
    proxy_used,
    as_of,
    lookbacks,
    recency,
    min_weeks,
    detector_json,
    detector_age_days,
    schema_version,
  }

不変条件:理由(no_price_source、insufficient_weekly_bars、detector-json による拒否など)にかかわらず、verdict: INSUFFICIENT_DATA の場合、checks(および swing_levels)は null になります。後続の利用側は、verdict_reason に応じた分岐をせず、verdict だけを確認してから checks.* を安全に読み取れるか判断できます。

ファイル名:ta_confirmation_<SYMBOL>_<as-of>.json および ta_confirmation_<SYMBOL>_<as-of>.md。reports/ に保存します。

チャート優先、スクリプトはフォールバック

チャート画像を引き続き主たる入力とします。これは、このスキルの 特性に沿ったものです。チャートが提供されていない場合、または 監査可能で決定論的な結果が望ましい場合は、チャートの読み取りの 代わりに、または併せてスクリプトを実行します。

python3 skills/technical-analyst/scripts/check_weekly_price_action.py \
  --symbol BT --direction CROWDED_LONG --as-of 2026-07-15 \
  --output-dir reports/

または、cot-contrarian-detector のレポートから直接方向を判断します。

python3 skills/technical-analyst/scripts/check_weekly_price_action.py \
  --symbol BT --detector-json reports/cot_crowding_2026-07-12.json \
  --as-of 2026-07-15 --output-dir reports/

スクリプトは、ドキュメントに記載された先物から ETF への フォールバックチェーンを使って、週次にリサンプリングした OHLC を 取得します(詳しくは scripts/check_weekly_price_action.py のモジュール docstring を参照)。 日足バーはリサンプリング前に --as-of までで切り詰められるため、 先読みはありません。また、読み取り不能(ファイルがない)、構文が 無効、古い、または構造が不正な --detector-json、価格履歴が 少なすぎる場合(--min-weeks、デフォルトは 30)、または使用可能な 価格ソースがない場合は、クラッシュせずに INSUFFICIENT_DATA を返し、安全側に倒します。

不一致時の保守的なルール

チャートモードとスクリプトモードの両方が同じシンボル/方向について 結果を出し、その判定が食い違う場合、最終判定は NOT_CONFIRMED(verdict_reason: mode_disagreement)となり、 確認用に両方のサブ結果が添付されます。どちらか一方のモードが 暗黙に優先されることはありません。一方のモードが INSUFFICIENT_DATA で、もう一方が明確な判定を出した場合は、 明確な判定を採用します。

ガードレール
  • 判定のみを行い、それ自体で取引を推奨することはありません。 これは Shapiro のプロセスのステップ 3/5 を確認するものです。 エントリーとエグジットの計画は引き続き手動で行う必要があり、 必須です。ポジションサイズの決定には、このモードではなく position-sizer / futures-position-sizer を使用します。
  • INSUFFICIENT_DATA ではパイプラインを先に進めません。 劣化した入力がある場合はすべて安全側に倒し、常に 0 を返して レポートを出力します。
  • 時間足は週足のみです。
  • 上記の既存のチャート分析ワークフローに変更はありません。 このモードは、明示的にコントラリアン確認がリクエストされた場合に のみ有効になります。
  • 単一シグナルによる MEDIUM 判定は、意図的に弱い証拠として扱います。 「信頼度」セクションについては references/contrarian-confirmation-checklist.md を参照してください。

リソース

このスキルには、以下のリソースが含まれています。

references/technical_analysis_framework.md

以下を含む、テクニカル分析の包括的な手法です。

  • トレンドの分析基準と分類
  • サポートとレジスタンスの特定手法
  • 移動平均の解釈ガイドライン
  • 出来高分析の原則
  • チャートパターンの認識
  • シナリオの作成と確率の割り当てに関するフレームワーク
  • 客観性と規律に関する注意事項

使用方法:体系的かつ客観的な分析を行うため、分析を始める前にこのファイルを読んでください。

assets/analysis_template.md

テクニカル分析レポートに必要なすべてのセクションを備えた、構造化テンプレートです。

使用方法:すべての分析レポートで、このテンプレートの構成を使用してください。形式をコピーし、各チャートに固有の所見を記入してください。

references/contrarian-confirmation-checklist.md

コントラリアン確認モード(Shapiro のステップ 3)に関する完全な手法です。方向の 規約、期間と切り詰めのルール、3 つのシグナルチェックと継続性に関する 拒否判定、スイング水準(フラクタル・ピボット)のルール、判定の統合、 信頼度のルール、出力仕様、チャートモードの実例、および保守的な 不一致ルールを扱います。

使用方法:コントラリアン確認モードの判定を出す前に、このファイルを 読んでください。チャートモードと scripts/check_weekly_price_action.py は 同一の判定を行う必要があるため、どちらにも同じ厳密な定義が適用されます。

scripts/check_weekly_price_action.py

コントラリアン確認モード用の、データ駆動型フォールバック CLI です。 週次にリサンプリングした OHLC を取得し(ドキュメントに記載された 先物から ETF へのフォールバックチェーンを使用し、--as-of の 情報カットオフをリサンプリング前に適用)、3 つのシグナルチェック、 継続性に関する拒否判定、およびスイング水準の検出を実行して、 reports/ に ta_confirmation_<SYMBOL>_<as-of>.json / .md を 出力します。

使用方法:チャート画像が提供されていない場合、または監査可能で 決定論的な結果が必要な場合に実行してください。実行例については、 上記の「コントラリアン確認モード」セクションを参照してください。

コメント