mcpField
S
setup

setup

github.com/upbit-official開発10124 回インストール17 週間前に更新
リポジトリ

setup について

setup は upbit-strategy-toolkit の環境診断スキルで、初回利用者や CLI の問題を調べる利用者向けです。利用モードを判定し、uv と対応する CLI コマンドを確認します。インストールの自動化、戦略設計、バックテストは扱いません。

主な機能

  1. 01clone と Skill のモード判定
  2. 02uv の利用可否を確認
  3. 03モード別の CLI 診断
  4. 04uv インストール手順の参照
  5. 05診断後に create-strategy へ引き継ぎ

活用シーン

  1. 01初回利用前の環境確認
  2. 02create-strategy や backtest の失敗調査
  3. 03uv 不在や依存関係同期エラーの確認

インストール

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

$npx skills add https://github.com/upbit-official/upbit-strategy-toolkit --skill setup

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

同梱ファイルreferences/uv-install.md

詳細

セットアップ

upbit-strategy-toolkit の使用モードを特定し、現在の環境で CLI を実行できるかを診断します。このスキルはモードの検出と診断を行うユーティリティであり、インストールを自動化するものではありません。ストラテジーの作成とバックテストには、create-strategy と backtest を使用します。

uv がない場合の OS 別インストール手順は、references/ に分かれています。

トリガー

  • 「初めて使います」
  • 「環境をセットアップするにはどうすればよいですか？」
  • 「uv とは何ですか？／uv が見つからないと表示されます」
  • 別のスキル（create-strategy／backtest）で環境要件が満たされていないこと（uv がない、uv sync の失敗、CLI の実行失敗など）が検出され、ここに案内するよう推奨された場合

自動ルーティングの推奨：create-strategy／backtest で初回のラッパー実行に失敗した場合は、setup を推奨します。

ルーティング契約

  • 役割：環境の診断と復旧の窓口
  • 次のステップ：create-strategy
  • 復旧時の案内：create-strategy または backtest で uv がない、uv sync に失敗した、または CLI の実行に失敗したことが検出された場合、このスキルに案内します
  • 対象外：このスキルでは、ストラテジーの設計、バックテストの解釈、市場ルールの作業は扱いません

禁止事項

  • ユーザーのシステム Python を任意に変更しないでください - uv は仮想環境内に必要なバージョンを分離します。システム Python のアップグレードやダウングレードを案内しないでください。
  • pip install -g を推奨しないでください - クローンモードの依存関係は、uv sync により仮想環境内に保持されます。
  • ライブ取引に接続しないでください - ライブ取引のガードレールを参照してください。

ワークフロー

次の項目に進む前に、各項目の成功／失敗を確認してください。失敗した場合は、失敗したコマンドと発生したエラーを事実に即して報告してください。

setup

[ ] 1. Identify usage mode
[ ] 2. Check uv installation
[ ] 3. Run mode-specific CLI diagnostics
1. 使用モードの特定

現在のワークスペースが upbit-strategy-toolkit リポジトリかどうかを確認します。

モード検出方法デフォルトのデータルート（config set data-dir を実行していない場合に使用）
クローンモード現在の cwd またはその親ディレクトリに pyproject.toml の name = "upbit-strategy-toolkit" と upbit_strategy_toolkit/ がある実行時の現在の作業ディレクトリ
エージェントスキルモード（グローバル）npx skills add ... -g でスキルがインストールされ、ラッパースクリプト自体のパスが $HOME/.claude/skills、$HOME/.agents/skills、または $HOME/.cursor/skills の直下にある実行時の現在の作業ディレクトリ
エージェントスキルモード（プロジェクトスコープ）npx skills add ...（-g なし）でスキルがインストールされ、ラッパースクリプト自体のパスが上記のホームディレクトリ内のスキル用パス配下になく、現在のワークスペースにも upbit-strategy-toolkit リポジトリがない実行時の現在の作業ディレクトリ

UPBIT_TOOLKIT_DATA_DIR も保存済みの config set data-dir の値もない場合、CLI はモードにかかわらず、実行時の現在の作業ディレクトリをデータルートとして解決します。ユーザーが config set data-dir を実行済みの場合は、保存された値が使用されます。上記のモード表から推測せず、config get data-dir で解決された値を報告してください。

2. uv のインストール確認
uv --version

正常に出力されれば成功です。uv がない場合は、references/uv-install.md を案内し、インストール後にもう一度 uv --version を確認してください。

3-A. クローンモードの診断

リポジトリのワークスペース／cwd から実行します。

uv sync
uv run upbit-strategy-toolkit --help

uv sync は .venv/ を作成し、必要な Python と依存関係を準備します。uv run upbit-strategy-toolkit --help でヘルプが表示されれば、クローンモードの診断は成功です。

失敗した場合は、失敗したパッケージと発生したエラーを事実に即して報告してください。任意の pip install で回避しないでください。

3-B. エージェントスキルモード（グローバルまたはプロジェクト）の診断

リポジトリをクローンしていない場合は、GitHub ソースから CLI を直接実行して確認します。この手順は、グローバルインストールとプロジェクトスコープのインストールで共通です。

uvx --from git+https://github.com/upbit-official/upbit-strategy-toolkit.git upbit-strategy-toolkit --help

ヘルプが表示されれば、エージェントスキルモードの診断は成功です。失敗した場合は、元のエラーに基づいて、uv の不足、GitHub へのアクセス失敗、Python 3.12 の取得失敗のいずれかを報告します。

双方向の引き継ぎ

セットアップ完了後 -> create-strategy

診断が成功したら、次のスキルへ自然に引き継ぐため、次の行を使用します。

upbit-strategy-toolkit CLI diagnostics complete. You can now create a strategy.

Next step: create-strategy skill
- Start with natural language such as "Create a golden cross strategy".
- The generated {data_root}/strategies/{slug}.json can be validated with the backtest skill.
セットアップ中にブロックされた場合 -> 事実に基づく報告

良し悪しを判断せず、どの手順でどのエラーが発生したかを正確に述べます。

[Step 2 blocked] `uv --version` returned "command not found"
-> Shell restart or PATH check is required (see references/uv-install.md)

[clone mode Step 3 blocked] pandas wheel build failed during `uv sync`
Original error: ...
-> Recheck Python 3.12+ availability. If system Python is 3.11 or lower, run `uv python install 3.12` and retry.

[agent skills mode Step 3 blocked] GitHub access failed during `uvx --from ... upbit-strategy-toolkit --help`
Original error: ...
-> Network or GitHub access permissions need to be checked.

ライブ取引のガードレール

create-strategy / backtest と同じポリシーです。セットアップ中であっても、ライブ取引との統合リクエストは拒否します。

応答テンプレート：ユーザーのメッセージが韓国語の場合は韓国語版を、それ以外の場合は英語版を使用します。

韓国語：

이 도구는 백테스트(과거 데이터 시뮬레이션) 전용입니다.
실전 매매가 필요하다면 [upbit-agent-skills](https://github.com/upbit-official/upbit-agent-skills)를 이용해주세요.

setup 스킬은 백테스트 환경 설정만 지원합니다.

英語：

This tool is for backtesting (historical data simulation) only.
Use the separate [upbit-agent-skills](https://github.com/upbit-official/upbit-agent-skills) tool for live trading.

The setup skill only supports backtest environment setup.

実行ルールの概要

  • まずモードを特定し、そのモードの診断コマンドのみを実行します
  • clone モード：uv --version、uv sync、uv run upbit-strategy-toolkit --help
  • エージェントスキルモード（グローバルまたはプロジェクトスコープ）：uv --version、uvx --from git+https://github.com/upbit-official/upbit-strategy-toolkit.git upbit-strategy-toolkit --help
  • システム Python の変更は案内しません。uv が仮想環境内で分離します
  • 失敗は事実のみで報告します（手順 + コマンド + 元のエラー）
  • セットアップ完了後は、自然に create-strategy へ引き継ぎます
  • ライブ取引のリクエストは拒否し、upbit-agent-skills を案内します

コメント

Markdown 対応