ファイルパスや命名の誤り、優先度による上書き、再読み込みの必要性などに起因する未読み込み問題を解決します。
本ページでは、プロジェクト指示(メモリ)、スキル、エージェントが期待通りに読み込まれない問題のトラブルシューティングについて説明します。
プロジェクト指示ファイル(デフォルトは
メモリ / プロジェクト指示が読み込まれない
プロジェクト指示ファイル(デフォルトは AGENTS.md)がコンテキストに読み込まれない場合:
- ファイル名:ファイル名が
context.fileNameの構成と一致していることを確認します(デフォルトはAGENTS.md)。 - 検出境界:上位ディレクトリへの検索は、
context.memoryBoundaryMarkers(デフォルトは.git)を含むディレクトリに到達すると停止します。ファイルが境界の外側にある場合は検出されません。 - 追加ディレクトリ:デフォルトでは現在のディレクトリのみがスキャンされます。追加の信頼済みディレクトリからメモリを読み込むには、
context.loadMemoryFromIncludeDirectoriesを有効にします。 - 検出上限:
context.discoveryMaxDirs(デフォルトは 200)により検索されるディレクトリ数が制限されるため、非常に大規模なリポジトリでは上限に達する可能性があります。 - フォルダー信頼:信頼されていないディレクトリからはプロジェクトの内容が読み込まれません。
/memoryを使用して、現在読み込まれているメモリのソースを確認します。
スキルが読み込まれない
/skillsを使用して、読み込まれているスキルのリストを確認します。- ディレクトリ構造:スキルは
skills/<name>/SKILL.mdに配置する必要があります。ディレクトリ階層とファイル名が正しいことを確認します。 - ソース優先度:スキルのソース優先度は、組み込み < プラグイン < プロジェクトレベル < ユーザーレベルの順です。同名の場合は優先度の高いものが低いものを上書きします。
- 条件付きスキル:ファイルパスが一致する場合にのみ有効化され、一致しない場合は表示されません。
- フィーチャーフラグ:
/skillsを有効にするには、スキルのサポートと管理者権限が必要です。
エージェントが読み込まれない
/agentsを使用して、読み込まれているエージェントを確認します。- エージェント定義ファイルの場所と形式が正しいことを確認します(
agents/ディレクトリ内の定義ファイル)。 agents.overridesによって対象のエージェントが無効化されていないか確認します。--agentsを介して読み込まれた追加の定義は、現在のセッションでのみ有効です。
再読み込み
- 定義を変更した後は、対象ごとに再読み込みを行います。メモリには
/memory、スキルには/skills reload、エージェントには/agents reload、カスタムコマンドには/commandsを使用します。 - 上記の方法で解決しない場合は、Qoder CLI を再起動します。読み込み関連の一部の構成項目には「要再起動」と明記されており、変更後は再起動が必要です。
次のステップ
- コンテキストとメモリの仕組み:メモリの仕組み、メモリ。
- 拡張機能の読み込みに関する問題:フック、MCP、およびプラグインの問題。
- 構成に関する問題:設定が反映されない。