メインコンテンツへスキップ
見出し画像

【Claude Code専用】「絶対に落ちない」最強の器を作る。仮想通貨・高堅牢自動売買システム構築仕様書(bitbank/ccxt対応)

■ 誰も教えてくれない、自動売買の「不都合な真実」

ネットにあふれる「儲かるサイン」「AI価格予測」のコード。それらをコピペして、実際に動かしてみたことはありますか?

意気揚々と動かし始めた数時間後、あなたの目に飛び込んでくるのは、

・「API Timeout」で真っ赤になったログ ・なぜか固まって動かなくなったGUI画面 ・通信エラーで中途半端に約定した、謎のポジション ・そして、ツールが落ちている間に起きた大暴落

これが、自動売買の現場の「現実」です。 どれほど優れた売買ロジックを持っていても、それを動かす「器」が脆弱であれば、資産は守れません。機関投資家のツールが強いのは、ロジックが良いからではなく、「絶対に落ちない、止まらない、バグっても自己復旧する」システム基盤(インフラ)に巨額を投じているからです。

■ 必要なのは「儲かるロジック」ではなく、「壊れない器」

本書は、Pythonの自動売買ツールを構築するエンジニアに向けて、日本の暗号資産取引所(bitbank等、ccxt対応)で実運用に耐えうる「最強の堅牢性」を持ったデスクトップアプリを作るための「仕様書 兼 プロンプトドキュメント」です。

巷にある「動けば良い」レベルのサンプルコードではありません。以下のような、実戦的なカオス耐性を実装させるための具体的な指示が詰め込まれています。

・GUIが絶対にフリーズしないスレッド分離設計 ・SQLiteのロック競合を「秒数指定」で回避する自作ロック機構 ・API接続が切れても、5分以内に自動でセッションと実行キューを作り直す「ウォッチドッグ(自己監視)」システム ・WSL環境特有のファイルシステム問題を自動検知し、データ破損を防ぐ退避機構

■ あなたの代わりに、AI(Claude Code)が実装する

このドキュメントは、あなた自身がゼロからコードを書くためのものではありません。AIエンジニアリングツール(Claude Code等)に投げて、段階的に、かつ確実に「堅牢なコード」を出力させるための「司令塔」となるドキュメントです。

私自身、この仕様書を使ってAIと対話しながら、何度もエラーをわざと発生させ、それをAIに自己修復させるテストを繰り返して、今のツールを育て上げました。

■ 【重要】AIツールを使ったコードのブラッシュアップ

AIが一度に出力したコードは、機能的には正しくても「例外処理が甘い」「リソース解放が不十分」な場合があります。本仕様書でコードを生成した後は、AIに対して以下の指示(プロンプト)を追加で投げ、コードを実戦レベルに磨き上げてください。

【ブラッシュアップ用プロンプト】 「出力されたコードに対して、以下の観点でリファクタリングを行ってください。

  1. 例外処理の徹底:try-exceptで見逃されているエラー(ccxt.NetworkError, sqlite3.OperationalError等)がないか確認し、失敗時のリトライロジックを追加してください。

  2. リソース管理:通信セッションやDB接続が確実にクローズ(解放)されるよう、with構文を徹底してください。

  3. デバッグ性:重要な状態変化(リセット処理やエラー発生時)において、時刻と詳細な理由を出力するログを追加してください。」

それでは、実際にClaude Codeに渡す「仕様書 兼 プロンプト」の全文を公開します。一度に全部を投げず、フェーズ1から順番にAIへ渡して実装を進めてください。

【以下、Claude Codeへ入力するプロンプト全文】

 
 
週末副業をAIとPythonで完全効率化!実際に作って「稼げたツール・稼げなかったツール」を赤裸々に公開します。役立つ自動化ツールの作り方やPythonコードも提供可能。下書きだけ私が書き、残りはAIが仕上げる超時短・執筆術も紹介します。ぜひフォローをお願いします!

あなたへのおすすめ