docs: add agent control tool guide

Adds a new docs page explaining the OpenChamber agent control tool and its capabilities. Includes localized versions for supported languages and adds the page to the docs sidebar. Updates the lockfile with the new better-sqlite3 dependency.
2026-07-28 12:58:20 +03:00
parent 8d9f4c1cca
commit fbc064c16f
11 changed files with 366 additions and 0 deletions
@@ -0,0 +1,39 @@
+---
+title: エージェント制御ツール
+description: エージェントがチャットから OpenChamber のセッション、worktree、スケジュールタスクを管理できるようにします。
+---
+
+# エージェント制御ツール
+
+`openchamber` エージェントツールを使うと、チャットからアプリ内の作業を直接管理できます。OpenChamber が独自のローカル OpenCode サーバーを実行している場合はデフォルトで有効になり、別のツールのインストールや shell コマンドの実行は必要ありません。
+
+## 依頼できること
+
+自然な言葉でエージェントに依頼します。例：
+
+- 「このプロジェクトに新しい OpenChamber セッションを作成し、`openai/gpt-5.6-sol` モデルを使って次のプロンプトを送信して：認証フローをレビューして。」
+- 「このタスク用の新しい OpenChamber セッションを別の worktree に作成し、ログインフローのテストを追加するよう依頼して。」
+- 「OpenChamber を使って最近のセッション 10 件とそれぞれの現在の状態を表示して。」
+- 「OpenChamber に平日レビューというスケジュールタスクを作成し、平日の 09:00 に次のプロンプトを送信して：前回の実行以降の変更をレビューして。」
+- 「平日レビューという OpenChamber スケジュールタスクを今すぐ実行して。」
+- 「認証レビューという OpenChamber セッションを確認し、最新のアシスタント応答を表示して。」
+
+このツールは、プロジェクトとモデル設定の一覧表示、セッションの作成と継続、セッションのフォーク、分離された worktree セッションの作成、スケジュールタスクの管理を行えます。この方法で開始したセッションも通常のセッションと同じように OpenChamber に表示されるため、自分で開いて作業を続けられます。
+
+## 注意点
+
+- 新しいセッションへのプロンプトは、デフォルトではすぐに処理を返します。OpenChamber でセッションを確認するか、後でエージェントに結果を確認するよう依頼してください。
+- 別の worktree は、明示的に依頼した場合にのみ作成されます。現在の worktree にある未コミットの変更はコピーされません。
+- このツールは、セッションや worktree の削除、プロジェクトパスの登録、任意の shell コマンドの実行、任意の URL の呼び出しはできません。
+
+## ツールを有効または無効にする
+
+**設定 → 一般 → OpenCode CLI** を開き、**エージェント制御ツール**を変更して、**Save + Reload** を選択します。この設定は、管理対象の OpenCode サーバーが再起動した後に反映されます。
+
+OpenChamber が `OPENCODE_HOST` または skip-start で外部 OpenCode サーバーに接続している場合や、VS Code 拡張機能内では、このツールを利用できません。OpenChamber が管理する OpenCode サーバーを使用するデスクトップ版と Web 版では自動的に利用できます。
+
+## 関連項目
+
+- [スケジュールタスク](/ja/scheduled-tasks/)
+- [Worktree セッション](/ja/worktrees/)
+- [セッションゴール](/ja/session-goals/)