> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumi.new/llms.txt
> Use this file to discover all available pages before exploring further.

# トラブルシューティング

> 一般的な開発上の課題を解決するための実用的な手順。

## 「修正を試す」でスタックした場合

Lumiを使ったビルドは、高速で直感的に行えるように設計されていますが、他の強力なツールと同様に、問題が発生することもあります。コードが意図した通りに実行されなかったり、AIが指示を誤解して予期せぬ動作を引き起こしたりすることがあります。

ここでは、これらの問題を解決し、ビルド作業に戻るためのステップバイステップガイドを紹介します。

<Steps>
  <Step title="まず「修正を試す」ボタンを使用する">
    エラーが表示されたら、最初のステップとして「修正を試す」ボタンをクリックしてください。Lumiがログを分析し、問題を特定して、簡単な修正を適用します。これで問題が解決しない場合は、次のステップに進みます。
  </Step>

  <Step title="予期せぬ動作を診断する">
    コードがエラーなく実行されても、意図した通りに機能しないことがあります。これは予期せぬ動作として知られており、デバッグが難しい場合があります。以下にその対処法を示します。

    * **プロンプトの確認:** 元の指示が明確であったか再確認します。
    * **問題の切り分け:** 個々のコンポーネントとロジックを調べて、どこで問題が発生したかを特定します。
    * **視覚的なコンテキストの提供:** スクリーンショットや録画を使用して、何が機能していないかをAIに正確に示します。
  </Step>

  <Step title="より効果的なプロンプトを作成する">
    明確で構造化されたプロンプトは、より良い結果を生み出します。最良の結果を得るために、この形式に従ってください。

    * **プロジェクト概要:** 何をビルドしているかを簡潔に説明します。
    * **ページ構造:** 主要なページとコンポーネントをリストアップします。
    * **ナビゲーションロジック:** 意図するユーザーフローを説明します。
    * **視覚資料:** ワイヤーフレームやモックアップをアップロードします。
    * **実装手順:** 希望するビルドの順序を概説します。
  </Step>

  <Step title="論理的な順序でビルドする">
    構造化された開発アプローチは、多くの一般的な問題を未然に防ぎます。以下の推奨ワークフローに従ってください。

    1. メインのレイアウトとページを作成します。
    2. バックエンドまたはデータベースに接続します。
    3. ユーザー認証とロールを設定します。
    4. 各機能のロジックを計画します。
    5. Lumiに機能を一つずつ実装するようにプロンプトします。
  </Step>

  <Step title="ガイダンスにはディスカスモードを使用する">
    行き詰まった場合は、ディスカスモードに切り替えて支援を求めてください。

    * Lumiにプロジェクトの現状を分析するように依頼します。
    * すでに試された解決策の要約をリクエストします。
    * 根強い問題に取り組むための新しい戦略をプロンプトします。
  </Step>

  <Step title="困難なバグには高度な戦術を適用する">
    問題が解決しない場合は、これらのより高度なテクニックを試してください。

    * **具体的に:** バグと期待される動作を明確に説明します。
    * **ビジュアルを使用:** スクリーンショットや画面録画は、複雑な問題を説明するのに非常に役立ちます。
    * **代替案を尋ねる:** 新しいアイデアを生み出すために、「他に試せることはありますか？」と直接尋ねます。
    * **ロールバック:** プロジェクトを以前の正常に動作していたバージョンに戻し、問題のある機能を段階的に再構築します。
  </Step>
</Steps>

## **一般的なトラブルシューティング領域**

遭遇するほとんどの問題は、以下のカテゴリのいずれかに分類されます。

* UIとレイアウトの不具合
* APIまたはバックエンドのエラー
* プロンプトの誤解
* AIの無応答または誤動作
* プラットフォームまたは統合の失敗

以下のセクションを展開して、特定の症状を特定し、それぞれに対する実用的な解決策を見つけてください。

### 一般的な問題

<Accordion title="問題の迅速な診断を得るにはどうすればよいですか？">
  チャットモードに切り替えて、「何かが正しく動作していません。問題点を説明し、すでに試したことを教えてください」と尋ねてください。
</Accordion>

<Accordion title="UIやレイアウトの問題にはどう対処すればよいですか？">
  * コンポーネント階層を検査し、適用されているスタイルを確認します。
  * スクリーンショットを使用して、視覚的な不具合を明確に示します。
  * Lumiに直接プロンプトします：「この要素がずれています。修正してください。」
</Accordion>

<Accordion title="エラーで完全に手詰まりになった場合はどうすればよいですか？">
  * このプロンプトを試してください：「一歩引いて考えましょう。エラーを分析し、代替の解決策を提案してください。」
  * タスクをより小さく、管理しやすいステップに分割します。
  * エラーが続く場合は、元に戻すボタンを使用して正常に動作していたバージョンにロールバックします。
</Accordion>

<Accordion title="「code sandbox error」とはどういう意味ですか？">
  これはプラットフォームの問題を示しており、発生すべきではありません。すぐにサポートチームに報告してください。
</Accordion>

<Accordion title="「Not found preview」または「spinning up sandbox」というメッセージが表示された場合はどうすればよいですか？">
  まず、ブラウザのハードリフレッシュを試してください。問題が解決しない場合は、サポートに連絡して支援を求めてください。
</Accordion>

### AIの信頼性

<Accordion title="プロンプトエンジニアリングでAIの間違いを避けるにはどうすればよいですか？">
  * 明確で、よく構造化されたプロンプトを作成します。
  * リバースメタプロンプティング技術を利用します。
  * 大きな変更を実装する前に、ディスカスモードでプロンプトをテストします。
</Accordion>

<Accordion title="AIが応答しない場合はどうすればよいですか？">
  これは予期せぬ問題です。すぐにサポートチームに報告して支援を求めてください。
</Accordion>

<Accordion title="永続的な修正エラーのループを断ち切るにはどうすればよいですか？">
  目的を明確にするためにプロンプトを洗練させるか、AIにステップバイステップのデバッグガイドをリクエストしてください。
</Accordion>

<Accordion title="リファクタリングが大きな問題を引き起こした場合はどうすればよいですか？">
  変更は段階的に実装してください。問題が続く場合は、安定したバージョンに戻すか、デバッグのためにディスカスモードを使用してください。
</Accordion>

<Accordion title="AIがエラーループに陥ったり、ハルシネーションを起こしたり、壊れたロジックを使用したりした場合はどうなりますか？">
  エラーループや欠陥のあるロジックに遭遇した場合は、安定したバージョンに戻してください。その後、ビジュアルエディタを使用するか、ナレッジファイルを添付して、次のプロンプトでより具体的なコンテキストを提供してください。
</Accordion>

<Accordion title="AIが要求した変更を実装できない場合はどうすればよいですか？">
  AIがリクエストを誤解しているか、間違ったファイルを対象にしている可能性があります。非常に具体的な指示を与えるか、手動で編集を行ってください。
</Accordion>

<Accordion title="ディスカスモードやエージェントモードが応答しない、または不完全な回答をする場合はどうなりますか？">
  これは予期せぬ問題です。すぐにサポートチームに報告して支援を求めてください。
</Accordion>

<Accordion title="予期せぬクラッシュ、エラー、またはループについてはどうすればよいですか？">
  * 全く同じプロンプトを再試行することは避け、代わりに簡略化または言い換えてください。
  * AIに尋ねます：「すでに試した解決策は何ですか？」
  * プロジェクトの以前の正常に動作していたバージョンを復元します。
</Accordion>