制限事項と制約

バイナリファイルは未対応

Verdent のファイルツールはテキストベースの形式でのみ動作します。以下は編集できません。

回避策: バイナリファイルはコード内で参照したり概念的に扱ったりできますが、変更には外部ツールが必要です。

file_read の行数制限

制限事項:

• 大きなファイル（10,000 行を超えるもの）はセクションごとに読み込むべきです
• 大きなファイル全体を読み込むとコンテキストを使い果たす可能性があります

解決策: 行範囲を使用します: file_read("file.js", start_line=100, max_lines=50)

bash コマンドのタイムアウト

制限事項:

• 最大タイムアウト: 120 秒（2 分）
• 長時間実行される処理は自動的に終了されます

解決策: 処理を 2 分以内に完了する小さなコマンドに分割します

検索のパフォーマンス

制限事項:

• 広範な glob パターン（**/*）は数千件の結果を返すことがあります
• 正規表現検索はリテラル文字列より遅くなります

解決策: 具体的なパターンを使用し、不要なディレクトリを除外します

コンテキストの枯渇

問題: 長いセッションや複雑な操作の間に、AI のコンテキストウィンドウがいっぱいになり、以前の会話を参照できなくなることがあります。

緩和策:

• 探索的な調査にはサブエージェントを使用します（結果のみがメインコンテキストを消費します）
• 行範囲を使ってファイルを戦略的に読み込みます
• 全体を読み込む前に grep_file を使用します
• バックグラウンドタスクを Explorer サブエージェントに委任します

直接的なシステム管理はできない

できないこと:

• VS Code の設定をプログラムで変更する
• VS Code の拡張機能を自動でインストールする
• システムレベルの構成を変更する
• VS Code やシステムサービスを再起動する

範囲: Verdent は VS Code ワークスペース内で動作し、システム管理レベルでは動作しません。

自律的な実行はできない

Manual Accept Mode による制御:

• ユーザーは Manual Accept Mode でツールの実行を承認する必要があります
• 承認なしの自動バックグラウンド処理はありません
• VS Code が閉じている間はコマンドを実行できません

目的: すべての操作に対する安全性とユーザーの制御。

リアルタイム監視はできない

できないこと:

• 実行中のプロセスを継続的に監視する
• ファイルシステムの変更をリアルタイムで追跡する
• システムイベントを通知する
• ログファイルを継続的にストリーミングする

代替策: 外部監視ツールには MCP 連携を使用します。

MCP なしでのネットワーク操作はできない

組み込みの制限:

• 任意の HTTP リクエストを行うことはできません（特定のページには web_fetch を使用）
• データベースへの直接接続はできません（MCP が必要）
• クラウドサービスに直接アクセスすることはできません（MCP が必要）
• リアルタイムの API 連携はできません（MCP が必要）

解決策: 外部システムへのアクセスには MCP サーバーを構成します。

バイナリファイルの変更

制限事項: 画像、PDF、コンパイル済みバイナリは編集できません

回避策:

• bash コマンドで外部ツールを参照します: bash("convert input.png -resize 50% output.png")
• 外部ツールが実行できるスクリプトを生成します
• バイナリファイル操作の手動手順を文書化します

例:

# Image conversion
bash("convert input.png -resize 50% output.png")

# PDF to text
bash("pdftotext document.pdf output.txt")

大きなファイルの扱い

制限事項: 10,000 行を超えるファイルはコンテキストウィンドウに負荷をかけます

回避策:

• 行範囲を使用します: file_read("large.log", start_line=1000, max_lines=100)
• 先に検索します: grep_content("ERROR", glob="large.log") で関連セクションを見つけます
• ファイルをより小さなモジュールに分割して管理しやすくします

コンテキストウィンドウの枯渇

制限事項: 長い会話はコンテキストウィンドウをいっぱいにします

回避策:

• コードベースの調査は Explorer サブエージェントに委任します
• 独立した検証タスクには Verifier サブエージェントを使用します
• 別個のタスクには新しい会話を開始します
• todo_update を使ってセッション間で進捗を追跡します

ベストプラクティス: バックグラウンドの調査をサブエージェントに委任し、メインコンテキストをアクティブな開発のために確保します。

プラットフォームによるコマンドの違い

制限事項: bash コマンドは Windows と Unix で異なります

回避策:

• クロスプラットフォームのツールを使用します: 生の bash の代わりに npm スクリプトを使う
• 条件付きコマンド: bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then ...; fi")
• プラットフォームの注意事項を記したプロジェクト固有の AGENTS.md

例:

# Cross-platform
bash("npm run build")

# Platform-specific conditional
bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then make; else nmake; fi")