# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

エージェント ランチャー - エージェント管理とプロセス制御
=======================================================

BACH エージェント (ボス エージェントとエキスパート) を独立したエージェントとして起動および管理します
クロードは、モデルとモードのパラメーター化を使用してプロセスを処理します。


説明
------------

agent_launcher ハンドラーにより、エージェントのライフサイクル管理が可能になります。エージェント
別のプロセスとして開始および監視されます。各エージェントは 1 つを受け取ります
一時的な CLAUDE.md ファイルとその SKILL.md をアイデンティティ定義として使用します。
プロセス ID は監視と制御のために保持されます。


操作
-----------

  bach agent list                               利用可能なすべてのエージェントをリストする

  bach agent start <name> [OPTIONS]             エージェントを新しいプロセスとして開始
    --mode MODE モード: plan (計画モード) または
                                                  デフォルト (デフォルト、デフォルト)
    --model MODEL モデル: ソネット、作品、または俳句
                                                  (デフォルト: ソネット)
    --dry-run チェックのみを行い、開始しません

  bach agent stop <name>                        実行中のエージェントを停止します (プロセスを終了
、PID ファイルはクリーンアップされます)

  bach agent status                             実行中のすべてのエージェントを表示
                                                PID、モデル、開始時刻を使用した


例
---------

  # 利用可能なエージェントを表示
  bach agent list
  出力: 名前、タイプ (ボス/エキスパート)、ステータス [RUNNING:pid]/[STOPPED]

 を含むテーブル  # 標準モード (ソネット) でエージェントを開始します
  bach agent start ati
  出力: [OK] エージェント 'ati' が開始され、PID と一時フォルダーが表示されました

  # 特定のモデルとモードでエージェントを起動します
  bach agent start research --model opus --mode plan
  プランモードでのクロード・オーパスのトライアル

  # 開始のみをシミュレートします
  bach agent start ati --dry-run
  出力: [DRY-RUN] エージェント 'ati' を開始します ...

  # 実行中のエージェントを表示
  bach agent status
  出力: PID、開始時刻、ステータスを含む実行中のすべてのプロセスのテーブル

  # エンドエージェント
  bach agent stop ati
  出力: [OK] エージェント 'ati' (PID xyz) が停止しました


詳細
-------

エージェント スキャン:
  - ボスエージェント：agents/ (SKILL.mdのあるディレクトリ)
  - エキスパート: Agents/_experts/ (SKILL.md のあるディレクトリ)
  - アンダースコア接頭辞を持つエントリを無視します

プロセスの実行:
  - Windows: Temp フォルダー内の start.bat、新しい CMD ウィンドウ
  - Unix/Linux: start_new_session を使用してプロセスを切り離しました
  - モデルオプション: ソネット (デフォルト)、作品、俳句
  - モード オプション: デフォルト (デフォルト)、プラン

永続性:
  - PID ファイル: data/agent_pids/<名前>.pid (JSON)
  - 内容: pid、名前、タイプ、モデル、モード、開始済み、temp_dir
  - ステータスチェック中の停止プロセスの自動クリーンアップ
  - Temperaere CLAUDE.md: data/temp/agent_<name>/CLAUDE.md


エラー処理
----------------

  [エラー] エージェント名が必要です オペランドがありません (リストとステータス
                                                 名前は必要ありません)

  [警告] エージェント '<名前>' はすでに実行中です (PID..) エージェントはすでにアクティブです

  [エラー] エージェント '<名前>' が見つかりません SKILL.md が見つからないか、
                                                ディレクトリが存在しません

  [エラー] 無効なモード: X 'plan' または 'default' のみが許可されます

  [エラー] 無効なモデル: X 'sonnet'、'opus'、'haiku' のみ

  [エラー] 'claude' CLI が見つかりません クロード コードがインストールされていません


ファイル
-------

  ハンドラー: Hub/agent_launcher.py
  エージェント：agents/*/SKILL.md
  エキスパート: Agents/_experts/*/SKILL.md
  PID レジストリ: data/agent_pids/*.pid (JSON)
  一時ファイル: data/temp/agent_*/


関連項目
----------

  ヘルプエージェント エージェントの概要 (上司、専門家、構造)
  ヘルプ パス ディレクトリ構造とパス
  新しいエージェントの開発を支援する
