Bitget Agent Skill

bitget-agent-skill — Bitget 公式 AI 取引スキル

Claude Code、Codex、OpenClaw が取引の指示を理解し、いつ Bitget を呼び出すか、適切なコマンドをどう組み立てるか、問題が起きたときにどう対処するかを判断できるようにします。

クイックスタート · 変更点 · スキルを使う理由 · インストール · セキュリティ · トラブルシューティング · FAQ

---

Bitget Agent Hub は、Bitget 公式のオープンソース AI エージェントエコシステムです。このリポジトリは bitget-agent-skill、つまりターミナル AI エージェントに Bitget ツールをいつ、どのように正しく呼び出すかを教える スキルの提供部分です。エコシステムのパッケージ：agent-skill（このリポジトリ）、agent-cli、agent-mcp、agent-sdk、bitget-signal、agent_hub。

@bitget-ai/bitget-agent-skill は Bitget 公式の AI 取引スキルファイルです。Claude Code、Codex、OpenClaw が Bitget ツールを正しく使えるよう、いつ Bitget を呼び出すか、指示を適切な複数ステップの操作にどう分解するか、書き込み操作の前に確認をどう扱うか、問題が起きたときにどう対処するかを判断できるようにします。純粋な Markdown で、ランタイムは不要です。

これはあなた向けですか？ すでに Claude Code、Codex、OpenClaw を使っていて、ツールを利用できるだけでなく、取引の指示を本当に理解して適切に使えるようにしたい場合は、これをインストールしてください。

---

クイックスタート

以下のブロックを AI エージェントに貼り付けてください。セットアップ全体が実行されます（Node.js 20 以降が必要です）。

Please help me install the Bitget trading skill (requires Node.js 20+): 1. Run npx @bitget-ai/bitget-agent-skill --target all to deploy the skill files to my AI tool; 2. Run npm install -g @bitget-ai/bitget-agent-cli to install the bgc CLI globally. Tell me the result when done.

両方を一緒にインストールする必要があります。スキルファイルは AI の取扱説明書で、bgc は実行ツールです。スキルが AI に呼び出すタイミングとコマンドの組み立て方を教え、bgc が実際に API リクエストを送信します。どちらか一方が欠けると、フロー全体が完成しません。

動作を確認する。 AI に 「Bitget がサポートする取引モジュールは何ですか？」 と尋ねてください。正しいモジュール一覧（market、trade、account など）が返ってくれば、スキルは読み込まれ、有効になっています。

---

インストール後の変化

graph LR
    A[You<br/>Natural Language] --> B[Claude Code / Codex<br/>with bitget-agent-skill]
    B -->|Generates v3 Command| C[bgc CLI<br/>bitget-agent-cli]
    C -->|HMAC-SHA256 Signed| D[Bitget REST API]
    style B fill:#28a745,stroke:#333,stroke-width:2px,color:#fff

スキルがない場合、bgc は一度に1つのコマンドを実行します。スキルを読み込むと、AI は意図を複数のモジュールにまたがる一連の操作に連携できます。ポジションを確認し、条件を評価し、注文を出し、結果を処理するまでを一度に実行します。

• 英語と中国語のトリガー認識：「buy BTC at market」と言っても「帮我买 BTC」と言っても、AI は Bitget の取引指示だと認識し、適切なツールを自動的に呼び出します。コマンドの構文を指定する必要はありません。
• v3 文法と完全なリファレンス：スキルファイルには bgc v3 文法（bgc <tool> --action <name>）と、すべての操作を網羅した自動生成カタログが含まれています。AI は、どの意図を表す動詞がどの操作に対応するか、パラメーターをどう入力すればよいかを把握しています。
• 複数ステップのワークフロー：「ポジションを確認して、BTC のポジションがなければレバレッジ 10 倍でロングする」と伝えると、AI はまず照会して判断し、その後に注文を出します。書き込み操作の前には毎回 [CAUTION] を表示し、確認を待ちます。
• ペーパートレードとエラー処理：AI に「デモアカウントを使って」と伝えると、Bitget のサンドボックスに自動的に切り替わります。API エラーが発生した場合も、AI は再試行するべきか、問題をユーザーに知らせるべきかを判断するため、行き詰まりません。

---

bgc をインストールするだけでなく、スキルを使う理由

CLI だけでも、統合取引アカウントに対する14個の意図動詞（89個の操作）をAIに提供できますが、意味付けはありません。アシスタントは、Bitget をいつ使うか、どの動詞を使うか、どのように安全に操作するかを把握していません。

スキルが追加する内容：

• Claude Code／Codex／OpenClaw が Bitget 関連のリクエストを受けると自動的にスキルを呼び出すためのトリガーの説明。カジュアルな表現（「buy 0.1 BTC at market」）や中国語（「查看我的持仓」）も対象です。
• v3 文法（bgc <tool> --action <name> --<param> <value>）、最初に検出するワークフロー、さらにすべての動詞、アクション、パラメーターを網羅したカタログ。
• 書き込み操作の安全性（--dry-run／--confirm）、決済方向のルール、デモ取引、エラーの分類、認証の設定に関する運用ガイダンス。

その結果、「Bitget で成行注文で 0.1 BTC を買って」と伝えるだけで、実際に処理が行われます。アシスタントは bgc order --action place --category SPOT --symbol BTCUSDT --side buy --orderType market --qty 0.1 を組み立て、--dry-run でプレビューし、ユーザーに確認したうえで実行します。

---

スキルに含まれるファイル

ファイル	目的
SKILL.md	トリガーフレーズ（英語＋中国語）、AI がスキルを呼び出すタイミング、v3 文法、14個の動詞の対応表、書き込み操作の安全性を確保するワークフローを含む、最上位のスキル定義です。
references/commands.md	SDK 独自の discover サーフェスから生成された静的カタログです。すべてのドメイン、動詞、アクション、パラメーター（列挙値と説明を含む）が記載されています。
references/discover-guide.md	bgc discover を使ってライブサーフェスを操作する方法（4つの段階、検索、raw）です。
references/trading-safety.md	決済方向のルール（片方向／ヘッジ）、TP／SL、qty の単位、一括キャンセル、出金の安全性です。
references/auth-setup.md	Bitget API キーの作成方法と環境変数の設定方法です。
references/demo-trading.md	--paper-trading を使って安全にリハーサルする方法です。
references/error-codes.md	v3 のエラーペイロード、カテゴリーに基づく復旧方法、整理された Bitget コード一覧です。

---

インストール

ステップ 1：CLI をインストールする

npm install -g @bitget-ai/bitget-agent-cli

-g を指定する理由：bgc は、AI が1回のセッションで何十回も呼び出す常駐型 CLI なので、$PATH 上にある必要があります。一方、このスキルは一度だけデプロイすればよく、npx が Markdown ファイルを AI ツールのスキルディレクトリにコピーして終了します。npx は常に最新バージョンを取得するため、次回以降の実行時に自動でアップグレードされます。

ステップ 2：スキルファイルをデプロイする

# Default — Claude Code only
npx @bitget-ai/bitget-agent-skill

# All supported AI tools
npx @bitget-ai/bitget-agent-skill --target all

# Choose interactively
npx @bitget-ai/bitget-agent-skill --interactive

--target all を指定すると、Claude Code、Codex、OpenClaw に同時にデプロイされます。

対象	スキルの場所
Claude Code	~/.claude/skills/bitget-agent-skill/
Codex	~/.codex/skills/bitget-agent-skill/
OpenClaw	~/.openclaw/skills/bitget-agent-skill/

Step 3: 認証情報を設定する

export BITGET_API_KEY="your-api-key"
export BITGET_SECRET_KEY="your-secret-key"
export BITGET_PASSPHRASE="your-passphrase"

API キーをお持ちでない場合は、API キーを作成してください。デモ取引を行う場合は、代わりにデモ API キーを使用してください。

export BITGET_DEMO_API_KEY="your-demo-key"
export BITGET_DEMO_SECRET_KEY="your-demo-secret"
export BITGET_DEMO_PASSPHRASE="your-demo-passphrase"

Step 4: 再起動して確認する

AI ツールを終了して再度開き、次のように質問してください。「Bitget の取引機能には何がありますか？」

---

関連ツール

ツール	関係
@bitget-ai/bitget-agent-cli	一緒にインストールする必要があります。bgc は実行ツールで、スキルファイルは AI の取扱説明書です。どちらか一方だけでは機能しません
@bitget-ai/bitget-agent-mcp	デスクトップ AI（Claude Desktop、Cursor）向けの代替手段です。bgc は必要ありません
@bitget-ai/bitget-signal	市場分析スキルです。API キーは不要です。このスキルは取引の実行を担い、bitget-signal は市場分析を担います。相互に補完し合い、併用できます

---

セキュリティ

スキルファイル自体は次のとおりです。

• API キーは不要です。純粋な Markdown です
• ネットワークアクセスはありません。実行時プロセスもありません
• 認証情報は保存しません。キーは環境変数を介して bgc に渡されます

実際の API 呼び出しはすべて bgc 経由で行われ、次の機能が提供されます。

• 認証情報は環境変数にのみ保存されます（.env ファイルの解析は行いません）
• --read-only を指定すると、すべての書き込みツールが無効になります
• --paper-trading を指定すると、デモ環境に切り替わります
• ローカルでの HMAC-SHA256 リクエスト署名

---

トラブルシューティング

「AI がスキルを認識しない」

原因： スキルファイルが配置されていないか、AI ツールが再起動されていません。

対処方法：

1. 再配置します：npx @bitget-ai/bitget-agent-skill --target all
2. AI ツールを完全に再起動します
3. 次のように質問して確認します：「利用できる Bitget の取引モジュールは何ですか？」

「AI に bgc はあるが、取引コマンドを理解しない」

原因： スキルファイルがありません。bgc はインストールされていますが、AI に取扱説明書がありません。

対処方法： スキルを配置し、ファイルが正しい場所にあることを確認してください。

AI ツール	配置先
Claude Code	~/.claude/skills/bitget-agent-skill/SKILL.md
Codex	~/.codex/skills/bitget-agent-skill/SKILL.md
OpenClaw	~/.openclaw/skills/bitget-agent-skill/SKILL.md

「bgc: コマンドが見つかりません」

原因： bitget-agent-cli がインストールされていないか、$PATH に含まれていません。

対処方法： npm install -g @bitget-ai/bitget-agent-cli を実行してから、ターミナルを再起動してください。

---

更新

# Update all Bitget AI packages
npx @bitget-ai/bitget-agent-installer upgrade-all --target all

# Or update just this skill
npx @bitget-ai/bitget-agent-skill@latest

---

よくある質問

スキルをインストールすると、AI は自動的に注文を出しますか？ いいえ。注文や資金移動などの書き込み操作を行う場合、AI は [CAUTION] の注記を表示し、実行前に確認を待ちます。

実際のお金を使わずに取引するにはどうすればよいですか？ AI に「デモ口座を使って」または「ペーパートレーディングを使って」と伝えてください。Bitget のデモ取引環境に自動的に切り替わります。デモ API キーが必要です。

これと MCP サーバーの違いは何ですか？ ターミナル AI（Claude Code、Codex）には bitget-agent-skill と bgc をインストールします。デスクトップ AI（Claude Desktop、Cursor）には bitget-agent-mcp をインストールします。どちらも自然言語で Bitget の取引を可能にしますが、異なる AI 環境に対応しています。

スキルファイルに API キーやネットワークアクセスは必要ですか？ いいえ。実行時プロセスのない純粋な Markdown ファイルです。API 呼び出しはすべて、実行時に bgc 経由で行われます。

無料で使えますか？ MIT ライセンスで、無料で使用できます。

---

貢献

• バグ報告と機能リクエスト： GitHub Issues
• ディスカッション： GitHub Discussions
• セキュリティに関する懸念： [email protected]

---

ライセンス

MIT — 個人利用および商用利用は無料です。

---

_{Bitget の公式オープンソース AI エージェントエコシステムである Bitget Agent Hub エコシステムの一部です。
トレーディングスタック · スキルサーフェス。⚠️ 暗号資産の取引にはリスクが伴います。AI エージェントが発注する注文については、お客様が責任を負います。実際の資金で取引する前に、デモ口座で安全に練習してください。
基盤：agent-sdk · 実行：agent-cli · デスクトップ：agent-mcp · 市場シグナル：bitget-signal}