Goal コマンドリファレンス

/goal は、現在のセッションに永続的な目標を設定し、エージェントがその目標を中心に自律的に実行を継続できるようにするために使用されます。本ページでは、すべてのサブコマンド、パラメーター、およびステータスの動作について説明します。Goal モードの使用ガイドについては、目標の継続的達成を参照してください。サブコマンドなしで /goal を直接実行すると、/goal status と同等になり、現在の目標ステータスが表示されます。

サブコマンド

サブコマンド	パラメーター	説明
`/goal`	`<説明> [--turns <N>]`	新しいゴールを設定します。引数なしの場合は現在のゴール状態を表示します。権限モードは変更しません。
`/goal status`	なし	現在の目標の説明、ステータス、経過ターン数、経過時間を表示します。
`/goal clear`	なし	現在の目標を削除します。
`/goal pause`	なし	現在の目標を一時停止します。
`/goal resume`	なし	一時停止された目標を再開します。
`/goal take`	なし	他のセッションが所有する目標を引き継ぎ、現在のセッションの所有とします。

/goal パラメーター

/goal <説明> [--turns <N>]

<説明>（任意）：目標の自然言語による説明。省略すると、現在の目標ステータスが表示されます（/goal status と同等）。
--turns <N>（任意）：最大対話ターン数。N は正の安全な整数である必要があり、100 を超える値も指定できます。無効な値は適用されません。上限に達すると Goal は自動的に一時停止し、/goal resume で再開できます。

例：

/goal Fix all failing unit tests and commit
/goal Complete the login module refactoring --turns 20

ターン上限

シナリオ	適用される上限
`--turns <N>` を指定して Goal を新規作成または置き換える	`N`
`--turns` を指定せずに Goal を新規作成または置き換える	現在の Query の Goal デフォルト値。ホストが設定していない場合は `100`
`--turns` を指定せずに現在の Goal を更新する	その Goal に保存されている上限を維持
`maxTurns` がない旧バージョンの Goal を復元する	永続化データを書き換えず、有効な上限として `100` を使用

SDK ホストは Query の初期化時に Goal のデフォルト上限を設定し、Query が存続している間に更新またはリセットできます。実行時の更新が成功した後は、それ以降に新規作成または置き換えられる Goal のみに適用され、現在の Goal は変更されません。リセットすると組み込みのデフォルト値 100 に戻ります。Goal ごとに明示した --turns は常に Query のデフォルト値より優先されます。

ステータスフィールド

目標のステータスは永続的に保存され、以下のフィールドが含まれます。

フィールド	説明
`objective`	目標の説明。
`status`	ステータス：`active` / `paused` / `complete`。
`maxTurns`	最大ターン数上限。旧バージョンで永続化された Goal には存在しない場合があります。
`turnsUsed`	経過ターン数。
`timeUsedSeconds`	経過時間（秒）。
`ownerSessionId`	目標を所有するセッション ID（マルチセッションコラボレーション用）。
`planWasActive`	目標のアクティブ化前に Plan モードであったかどうか（復元時の状態復元用）。

主な動作

権限モードは独立：Goal は権限モードを変更しません。実行中のツール承認は現在のモードに従います。無人実行が必要な場合は、事前に auto または yolo に切り替えてください。
クロスセッション永続化：目標はセッションとともに永続化されます。プロセスが予期せず終了した際に目標が active であった場合、次回の起動時に自動的に paused にダウングレードされ、/goal resume で再度アクティブ化できます。
所有権：目標にはそれを所有するセッション ID が記録されます。他のセッションから目標を参照する場合は、更新前にまず /goal take で引き継ぐ必要があります。これにより、新しいウィンドウが別のセッションの未完了の目標を暗黙的に継承することを防ぎます。
Plan ステータスの復元：目標のアクティブ化前に Plan モードであった場合、/goal resume はプロセスの再起動後に Plan モードも併せて復元します。
ターン制限：turnsUsed が有効な上限に達すると Goal は自動的に一時停止します。上限到達による一時停止の後に /goal resume を実行すると、さらに 100 ターンが付与されます。上限到達前に手動で一時停止した Goal を再開しても、上限は拡張されません。

次のステップ

Goal モードの使用ガイド：目標の継続的達成。
権限モードの説明：権限。
すべてのスラッシュコマンド：スラッシュコマンド。

​サブコマンド

​/goal パラメーター

​ターン上限

​ステータスフィールド