/goal サブコマンド、パラメーター、ステータス、および動作の完全なリファレンス
/goal は、現在のセッションに永続的な目標を設定し、エージェントがその目標を中心に自律的に実行を継続できるようにするために使用されます。本ページでは、すべてのサブコマンド、パラメーター、およびステータスの動作について説明します。Goal モードの使用ガイドについては、目標の継続的達成 を参照してください。
サブコマンドなしで /goal を直接実行すると、/goal status と同等になり、現在の目標ステータスが表示されます。
サブコマンド
| サブコマンド | パラメーター | 説明 |
|---|---|---|
/goal set | <説明> [--turns <N>] | 目標を作成または更新します。設定後、自動的に auto 権限モードに切り替わります。 |
/goal status | なし | 現在の目標の説明、ステータス、経過ターン数、経過時間を表示します。 |
/goal clear | なし | 現在の目標を削除し、目標設定前の権限モードを復元します。 |
/goal pause | なし | 現在の目標を一時停止し、権限モードを復元します。 |
/goal resume | なし | 一時停止された目標を再開し、auto 権限モードに再度移行します。 |
/goal take | なし | 他のセッションが所有する目標を引き継ぎ、現在のセッションの所有とします。 |
set パラメーター
/goal set <説明> [--turns <N>]
<説明>（必須）：目標の自然言語による説明。説明を省略すると、使用方法が表示されます。--turns <N>（任意）：最大対話ターン数。Nは正の整数である必要があります。無効な値は無視されます。上限に達すると、目標はTurnLimitedステータスに移行します。
ステータスフィールド
目標のステータスは永続的に保存され、以下のフィールドが含まれます。
| フィールド | 説明 |
|---|---|
objective | 目標の説明。 |
status | ステータス：Active / Paused / TurnLimited。 |
maxTurns | 最大ターン数上限（任意）。 |
turnsUsed | 経過ターン数。 |
timeUsedSeconds | 経過時間（秒）。 |
ownerSessionId | 目標を所有するセッション ID（マルチセッションコラボレーション用）。 |
planWasActive | 目標のアクティブ化前に Plan モードであったかどうか（復元時の状態復元用）。 |
主な動作
- 権限モードの自動切り替え：
/goal setと/goal resumeは自動的にauto権限モードに切り替わり、目標がアクティブな間は Shift+Tab での切り替えがロックされます。/goal clearと/goal pauseは以前のモードを復元します（現在のモードが引き続きautoである場合にのみ復元されます）。 - クロスセッション永続化：目標はセッションとともに永続化されます。プロセスが予期せず終了した際に目標が
Activeであった場合、次回の起動時に自動的にPausedにダウングレードされ、/goal resumeで再度アクティブ化できます。 - 所有権：目標にはそれを所有するセッション ID が記録されます。他のセッションから目標を参照する場合は、更新前にまず
/goal takeで引き継ぐ必要があります。これにより、新しいウィンドウが別のセッションの未完了の目標を暗黙的に継承することを防ぎます。 - Plan ステータスの復元：目標のアクティブ化前に Plan モードであった場合、
/goal resumeはプロセスの再起動後に Plan モードも併せて復元します。 - ターン制限：
--turnsが設定されている場合、turnsUsedがmaxTurnsに達すると、目標はTurnLimitedに移行します。