cc-viewer 1.6.182 → 1.6.183

package/concepts/ja/Tool-TaskList.md

@@ -1,56 +1,62 @@
 # TaskList
 
-## 定義
+現在のチーム (またはセッション) のすべてのタスクを要約形式で返します。未処理の作業を調査し、次に何をピックアップするかを決定し、重複の作成を避けるために使用します。
 
-タスクリスト内のすべてのタスクを一覧表示し、全体の進捗と利用可能な作業を確認します。
+## 使用タイミング
+
+- セッションの開始時に、すでに追跡されているものを確認する。
+- `TaskCreate` を呼び出す前に、作業がまだキャプチャされていないことを確認する。
+- チームメイトまたはサブエージェントとして次にどのタスクを請求するかを決定する。
+- チーム全体の依存関係を一目で確認する。
+- 長いセッション中、チームメイトがタスクを請求、完了、追加した可能性があるため、定期的に再同期する。
+
+`TaskList` は読み取り専用で安価です。概要が必要なときはいつでも自由に呼び出してください。
 
 ## パラメータ
 
-パラメータなし。
+`TaskList` はパラメータを取りません。常にアクティブなコンテキストの完全なタスクセットを返します。
 
-## 返却内容
+## 応答の形状
 
-各タスクの要約情報：
-- `id` — タスク識別子
-- `subject` — 短い説明
-- `status` — ステータス：`pending`、`in_progress` または `completed`
-- `owner` — 担当者（agent ID）、空は未割り当て
-- `blockedBy` — このタスクをブロックしている未完了タスク ID のリスト
+リスト内の各タスクは完全なレコードではなく、サマリです。おおよそ以下が期待されます。
 
-## 使用シナリオ
+- `id` — `TaskGet` / `TaskUpdate` で使用する安定した識別子。
+- `subject` — 短い命令型のタイトル。
+- `status` — `pending`、`in_progress`、`completed`、`deleted` のいずれか。
+- `owner` — エージェントまたはチームメイトのハンドル、または未請求の場合は空。
+- `blockedBy` — 先に完了する必要があるタスク ID の配列。
 
-**適している場合：**
-- 利用可能なタスクの確認（ステータスが pending、owner なし、ブロックされていない）
-- プロジェクト全体の進捗確認
-- ブロックされているタスクの検索
-- タスク完了後に次のタスクを検索
+特定のタスクの完全な説明、受け入れ基準、またはメタデータについては、`TaskGet` でフォローアップしてください。
 
-## 注意事項
+## 例
 
-- ID 順にタスクを処理することを優先（最小 ID 優先）。早期のタスクは通常、後続タスクにコンテキストを提供するため
-- `blockedBy` があるタスクは依存が解除されるまで認領できない
-- TaskGet で特定タスクの完全な詳細を取得
+### 例 1
 
-## 原文
+クイックなステータスチェック。
 
-<textarea readonly>Use this tool to list all tasks in the task list.
+```
+TaskList()
+```
 
-## When to Use This Tool
+出力をスキャンして、`owner` のない `in_progress` のもの (古い作業) と、`blockedBy` が空の `pending` のもの (ピックアップ可能) を探します。
 
-- To see what tasks are available to work on (status: 'pending', no owner, not blocked)
-- To check overall progress on the project
-- To find tasks that are blocked and need dependencies resolved
-- After completing a task, to check for newly unblocked work or claim the next available task
-- **Prefer working on tasks in ID order** (lowest ID first) when multiple tasks are available, as earlier tasks often set up context for later ones
+### 例 2
 
-## Output
+チームメイトが次のタスクを選ぶ。
 
-Returns a summary of each task:
-- **id**: Task identifier (use with TaskGet, TaskUpdate)
-- **subject**: Brief description of the task
-- **status**: 'pending', 'in_progress', or 'completed'
-- **owner**: Agent ID if assigned, empty if available
-- **blockedBy**: List of open task IDs that must be resolved first (tasks with blockedBy cannot be claimed until dependencies resolve)
+```
+TaskList()
+# フィルタ: status == pending かつ blockedBy が空かつ owner が空。
+# その中で、より小さい ID を優先します (タスクは通常作成順に番号付けされるため、
+# より小さい ID は古く、通常優先度が高い)。
+TaskGet(taskId: "<chosen id>")
+TaskUpdate(taskId: "<chosen id>", status: "in_progress", owner: "<your handle>")
+```
+
+## 注意事項
 
-Use TaskGet with a specific task ID to view full details including description and comments.
-</textarea>
+- チームメイトヒューリスティック: 複数の `pending` タスクがブロックされず未所有の場合、最小の ID を選んでください。これにより作業が FIFO に保たれ、2 つのエージェントが同じ目立つタスクを取り合うのを避けられます。
+- `blockedBy` を尊重してください: ブロッカーがまだ `pending` または `in_progress` のタスクを開始しないでください。先にブロッカーに取り組むか、その所有者と調整してください。
+- `TaskList` はタスクの唯一の発見メカニズムです。検索はありません。リストが長い場合は、構造的に (ステータス、次に所有者で) スキャンしてください。
+- 削除されたタスクは追跡可能性のために `deleted` ステータスでリストに残ることがあります。計画目的では無視してください。
+- リストはチームのライブ状態を反映するため、チームメイトが呼び出し間でタスクを追加または請求する可能性があります。時間が経過した場合は、請求前に再リストしてください。

package/concepts/ja/Tool-TaskOutput.md

@@ -1,40 +1,50 @@
 # TaskOutput
 
-## 定義
+実行中または完了したバックグラウンドタスク — バックグラウンドシェルコマンド、ローカルエージェント、またはリモートセッション — の蓄積された出力を取得します。長時間実行タスクがこれまでに生成したものを検査する必要があるときに使用します。
 
-実行中または完了したバックグラウンドタスクの出力を取得します。バックグラウンドシェル、非同期 agent、リモートセッションに適用。
+## 使用タイミング
+
+- リモートセッション (例えばクラウドサンドボックス) が実行中で、その stdout が必要な場合。
+- ローカルエージェントがバックグラウンドで派遣され、戻る前に部分的な進捗が欲しい場合。
+- バックグラウンドシェルコマンドが十分長く実行されており、停止せずに確認したい場合。
+- さらに待つか `TaskStop` を呼び出す前に、バックグラウンドタスクが実際に進捗しているかを確認する必要がある場合。
+
+`TaskOutput` に反射的に手を伸ばさないでください。ほとんどのバックグラウンド作業には、より直接的なパスがあります — 以下の注意事項を参照してください。
 
 ## パラメータ
 
-| パラメータ | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `task_id` | string | はい | タスク ID |
-| `block` | boolean | はい | タスク完了までブロック待機するかどうか、デフォルト `true` |
-| `timeout` | number | はい | 最大待機時間（ミリ秒）、デフォルト 30000、最大 600000 |
+- `task_id` (string, required): バックグラウンド作業が開始されたときに返されたタスク識別子。タスクリストの `taskId` と同じではありません。これは特定の実行のランタイムハンドルです。
+- `block` (boolean, optional): `true` (デフォルト) の場合、タスクが新しい出力を生成するか終了するまで待ってから返します。`false` の場合、バッファされたものを即座に返します。
+- `timeout` (number, optional): 返す前にブロックする最大ミリ秒。`block` が `true` の場合にのみ意味があります。デフォルトは `30000`、最大は `600000`。
 
-## 使用シナリオ
+## 例
 
-**適している場合：**
-- Task（`run_in_background: true`）で起動したバックグラウンド agent の進捗確認
-- バックグラウンド Bash コマンドの実行結果を取得
-- 非同期タスクの完了を待って出力を取得
+### 例 1
 
-**適していない場合：**
-- フォアグラウンドタスク——フォアグラウンドタスクは直接結果を返すため、このツールは不要
+ブロックせずにリモートセッションを覗き見ます。
 
-## 注意事項
+```
+TaskOutput(task_id: "sess_01HXYZ...", block: false)
+```
+
+タスクが開始されてから (またはランタイムに応じて、最後の `TaskOutput` 呼び出しから) 生成された stdout/stderr を返します。
 
-- `block: true` はタスク完了またはタイムアウトまでブロック
-- `block: false` はノンブロッキングで現在の状態を確認
-- タスク ID は `/tasks` コマンドで検索可能
-- すべてのタスクタイプに適用：バックグラウンドシェル、非同期 agent、リモートセッション
+### 例 2
 
-## 原文
+ローカルエージェントがさらに出力を発するのを簡単に待ちます。
+
+```
+TaskOutput(
+  task_id: "agent_01ABCD...",
+  block: true,
+  timeout: 10000
+)
+```
+
+## 注意事項
 
-<textarea readonly>- Retrieves output from a running or completed task (background shell, agent, or remote session)
-- Takes a task_id parameter identifying the task
-- Returns the task output along with status information
-- Use block=true (default) to wait for task completion
-- Use block=false for non-blocking check of current status
-- Task IDs can be found using the /tasks command
-- Works with all task types: background shells, async agents, and remote sessions</textarea>
+- バックグラウンド bash コマンド: `TaskOutput` はこのユースケースでは事実上非推奨です。バックグラウンドシェルタスクを開始すると、結果には既にその出力ファイルへのパスが含まれています — そのパスを `Read` ツールで直接読んでください。`Read` はランダムアクセス、行オフセット、安定したビューを提供します。`TaskOutput` はそうではありません。
+- ローカルエージェント (`Agent` ツールをバックグラウンドで派遣): エージェントが完了すると、`Agent` ツールの結果にはすでに最終応答が含まれています。それを直接使用してください。シンボリックリンクされたトランスクリプトファイルを `Read` しないでください — 完全なツール呼び出しストリームが含まれ、コンテキストウィンドウがオーバーフローします。
+- リモートセッション: `TaskOutput` は正しく、多くの場合出力をストリームバックする唯一の方法です。タイトなポーリングループよりも、控えめな `timeout` で `block: true` を優先してください。
+- 不明な `task_id`、または出力がガベージコレクトされたタスクはエラーを返します。まだ必要な場合は作業を再派遣してください。
+- `TaskOutput` はタスクを停止しません。終了するには `TaskStop` を使用してください。

package/concepts/ja/Tool-TaskStop.md

@@ -1,32 +1,45 @@
 # TaskStop
 
-## 定義
+ランタイムハンドルで、実行中のバックグラウンドタスク — シェルコマンド、派遣されたエージェント、またはリモートセッション — を停止します。リソースを回収したり、もう役に立たない作業をキャンセルしたり、タスクが詰まった場合に回復するために使用します。
 
-実行中のバックグラウンドタスクを停止します。
+## 使用タイミング
+
+- バックグラウンドシェルコマンドが予想より長く実行されており、もはやその結果が必要ない場合。
+- ローカルエージェントがループまたは停滞しており、短く打ち切る必要がある場合。
+- ユーザーが方向を変更し、前の方向のバックグラウンド作業を放棄すべき場合。
+- リモートセッションがタイムアウトしようとしているか、必要なリソースを保持している場合。
+- 同じタスクの新しい実行を開始する前にクリーンな状態が必要な場合。
+
+短命のバックグラウンド作業は自身で完了させることを優先してください。`TaskStop` は、継続実行に価値がないか、積極的に有害な場合のためのものです。
 
 ## パラメータ
 
-| パラメータ | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `task_id` | string | いいえ | 停止するバックグラウンドタスクの ID |
-| `shell_id` | string | いいえ | 非推奨、`task_id` を代わりに使用 |
+- `task_id` (string, required): バックグラウンドタスクが開始されたときに返されたランタイムハンドル。これは `TaskOutput` が受け付ける同じ識別子であり、タスクリストの `taskId` ではありません。
 
-## 使用シナリオ
+## 例
 
-**適している場合：**
-- 不要になった長時間実行タスクの終了
-- 誤って起動したバックグラウンドタスクのキャンセル
+### 例 1
 
-## 注意事項
+暴走したバックグラウンドシェルコマンドを停止します。
+
+```
+TaskStop(task_id: "bash_01HXYZ...")
+```
 
-- 成功または失敗のステータスを返す
-- `shell_id` パラメータは非推奨、`task_id` を使用すべき
+コマンドは終了シグナルを受け取ります。これまでに書き込まれたバッファされた出力は、その出力パスで引き続き読み取り可能です。
 
-## 原文
+### 例 2
+
+ユーザーの方向修正後に派遣されたエージェントをキャンセルします。
+
+```
+TaskStop(task_id: "agent_01ABCD...")
+```
+
+## 注意事項
 
-<textarea readonly>
-- Stops a running background task by its ID
-- Takes a task_id parameter identifying the task to stop
-- Returns a success or failure status
-- Use this tool when you need to terminate a long-running task
-</textarea>
+- `TaskStop` は終了を要求しますが、瞬時のシャットダウンを保証しません。行儀の良いタスクは速やかに終了しますが、ブロッキング I/O を行っているプロセスはアンワインドに時間がかかる場合があります。
+- タスクを停止しても出力は削除されません。バックグラウンドシェルタスクの場合、ディスク上の出力ファイルは保持され、`Read` で引き続き読み取り可能です。エージェントとセッションの場合、停止前にキャプチャされた出力は `TaskOutput` を介して引き続きアクセス可能です。
+- 不明な `task_id`、またはすでに終了したタスクはエラーまたは no-op を返します。これは安全です — 最初にステータスをチェックせずに防御的に `TaskStop` を呼び出せます。
+- 同じ作業を再開するつもりなら、共有リソース (ファイル、ポート、データベース行) で 2 つの並列実行が競合しないように、新しいものを派遣する前に古いタスクを停止してください。
+- `TaskStop` はチームのタスクリストのエントリに影響を与えません。追跡されたタスクをキャンセルするには、`TaskUpdate` でステータスを `deleted` に更新してください。

package/concepts/ja/Tool-TaskUpdate.md

@@ -1,123 +1,70 @@
 # TaskUpdate
 
-## 定義
+既存のタスクを変更します — ステータス、コンテンツ、所有権、メタデータ、または依存関係エッジ。これがタスクのライフサイクルを進める方法であり、Claude Code、チームメイト、サブエージェント間で作業が引き渡される方法です。
 
-タスクリスト内の特定タスクのステータス、内容、または依存関係を更新します。
+## 使用タイミング
 
-## パラメータ
-
-| パラメータ | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `taskId` | string | はい | 更新するタスクの ID |
-| `status` | enum | いいえ | 新しいステータス：`pending` / `in_progress` / `completed` / `deleted` |
-| `subject` | string | いいえ | 新しいタイトル |
-| `description` | string | いいえ | 新しい説明 |
-| `activeForm` | string | いいえ | 進行中に表示する現在進行形テキスト |
-| `owner` | string | いいえ | 新しいタスク担当者（agent 名） |
-| `metadata` | object | いいえ | マージするメタデータ（null に設定するとキーを削除） |
-| `addBlocks` | string[] | いいえ | このタスクによってブロックされるタスク ID のリスト |
-| `addBlockedBy` | string[] | いいえ | このタスクをブロックする前提タスク ID のリスト |
-
-## ステータス遷移
-
-```
-pending → in_progress → completed
-```
-
-`deleted` は任意のステータスから遷移可能で、タスクを永久に削除します。
-
-## 使用シナリオ
-
-**適している場合：**
-- 作業開始時にタスクを `in_progress` にマーク
-- 作業完了後にタスクを `completed` にマーク
-- タスク間の依存関係を設定
-- 要件変更時にタスク内容を更新
-
-**重要なルール：**
-- タスクを完全に完了した場合のみ `completed` にマーク
-- エラーやブロックに遭遇した場合は `in_progress` を維持
-- テスト失敗、実装不完全、未解決エラーがある場合は `completed` にマークしてはならない
-
-## 注意事項
-
-- 更新前に TaskGet でタスクの最新ステータスを取得し、古いデータを避ける
-- タスク完了後に TaskList を呼び出して次の利用可能なタスクを検索
+- 作業中にタスクをステータスワークフローに沿って遷移させる。
+- 自分 (または別のエージェント) を `owner` として割り当ててタスクを請求する。
+- 問題についてより多く学んだら `subject` や `description` を洗練する。
+- `addBlocks` / `addBlockedBy` で新しく発見された依存関係を記録する。
+- 外部チケット ID や優先度ヒントなどの構造化された `metadata` を添付する。
 
-## 原文
-
-<textarea readonly>Use this tool to update a task in the task list.
-
-## When to Use This Tool
-
-**Mark tasks as resolved:**
-- When you have completed the work described in a task
-- When a task is no longer needed or has been superseded
-- IMPORTANT: Always mark your assigned tasks as resolved when you finish them
-- After resolving, call TaskList to find your next task
-
-- ONLY mark a task as completed when you have FULLY accomplished it
-- If you encounter errors, blockers, or cannot finish, keep the task as in_progress
-- When blocked, create a new task describing what needs to be resolved
-- Never mark a task as completed if:
-  - Tests are failing
-  - Implementation is partial
-  - You encountered unresolved errors
-  - You couldn't find necessary files or dependencies
-
-**Delete tasks:**
-- When a task is no longer relevant or was created in error
-- Setting status to `deleted` permanently removes the task
+## パラメータ
 
-**Update task details:**
-- When requirements change or become clearer
-- When establishing dependencies between tasks
+- `taskId` (string, required): 変更するタスク。`TaskList` または `TaskCreate` から取得。
+- `status` (string, optional): `pending`、`in_progress`、`completed`、`deleted` のいずれか。
+- `subject` (string, optional): 置換用の命令型タイトル。
+- `description` (string, optional): 置換用の詳細な説明。
+- `activeForm` (string, optional): 置換用の現在進行形スピナーテキスト。
+- `owner` (string, optional): タスクの責任を取るエージェントまたはチームメイトのハンドル。
+- `metadata` (object, optional): タスクにマージするメタデータキー。キーを `null` に設定すると削除されます。
+- `addBlocks` (array of strings, optional): このタスクがブロックするタスク ID。
+- `addBlockedBy` (array of strings, optional): このタスクの前に完了する必要があるタスク ID。
 
-## Fields You Can Update
+## ステータスワークフロー
 
-- **status**: The task status (see Status Workflow below)
-- **subject**: Change the task title (imperative form, e.g., "Run tests")
-- **description**: Change the task description
-- **activeForm**: Present continuous form shown in spinner when in_progress (e.g., "Running tests")
-- **owner**: Change the task owner (agent name)
-- **metadata**: Merge metadata keys into the task (set a key to null to delete it)
-- **addBlocks**: Mark tasks that cannot start until this one completes
-- **addBlockedBy**: Mark tasks that must complete before this one can start
+ライフサイクルは意図的に線形です: `pending` → `in_progress` → `completed`。`deleted` は終端で、決して作業されないタスクを撤回するために使用します。
 
-## Status Workflow
+- 実際に作業を始めた瞬間に `in_progress` を設定してください、その前ではありません。特定の所有者に対して `in_progress` は一度に 1 つだけであるべきです。
+- 作業が完全に完了したときのみ `completed` を設定してください — 受け入れ基準が満たされ、テストが通り、出力が書き込まれた。ブロッカーが現れた場合、タスクを `in_progress` のまま保ち、解決する必要があるものを記述する新しいタスクを追加してください。
+- テストが失敗している、実装が部分的、または未解決のエラーに遭遇した場合は、決してタスクを `completed` としてマークしないでください。
+- キャンセルまたは重複のタスクには `deleted` を使用してください。タスクを無関係な作業のために再利用しないでください。
 
-Status progresses: `pending` → `in_progress` → `completed`
+## 例
 
-Use `deleted` to permanently remove a task.
+### 例 1
 
-## Staleness
+タスクを請求して開始します。
 
-Make sure to read a task's latest state using `TaskGet` before updating it.
+```
+TaskUpdate(
+  taskId: "t_01HXYZ...",
+  status: "in_progress",
+  owner: "main-agent"
+)
+```
 
-## Examples
+### 例 2
 
-Mark task as in progress when starting work:
-```json
-{"taskId": "1", "status": "in_progress"}
-```
+作業を終了し、フォローアップの依存関係を記録します。
 
-Mark task as completed after finishing work:
-```json
-{"taskId": "1", "status": "completed"}
 ```
-
-Delete a task:
-```json
-{"taskId": "1", "status": "deleted"}
+TaskUpdate(
+  taskId: "t_01HXYZ...",
+  status: "completed"
+)
+
+TaskUpdate(
+  taskId: "t_01FOLLOWUP...",
+  addBlockedBy: ["t_01HXYZ..."]
+)
 ```
 
-Claim a task by setting owner:
-```json
-{"taskId": "1", "owner": "my-name"}
-```
+## 注意事項
 
-Set up task dependencies:
-```json
-{"taskId": "2", "addBlockedBy": ["1"]}
-```
-</textarea>
+- `metadata` はキーごとにマージされます。キーに `null` を渡すと削除されます。現在の内容が不明な場合は、最初に `TaskGet` を呼び出してください。
+- `addBlocks` と `addBlockedBy` はエッジを追加します。既存のものは削除しません。グラフを破壊的に編集するには専用のワークフローが必要です — 依存関係を書き換える前にチームオーナーに相談してください。
+- `subject` を変更するときは `activeForm` を同期させて、スピナーテキストが自然に読めるようにしてください。
+- 無音化するためにタスクを `completed` としてマークしないでください。ユーザーが作業をキャンセルした場合、`description` に簡単な根拠を付けて `deleted` を使用してください。
+- 更新前に `TaskGet` でタスクの最新状態を読み取ってください — 最後の読み取りと書き込みの間にチームメイトが変更した可能性があります。

package/concepts/ja/Tool-TeamCreate.md

@@ -1,38 +1,53 @@
 # TeamCreate
 
-## 定義
+共有タスクリストとエージェント間メッセージングチャンネルを持つ新しい協業チームを確立します。チームはマルチエージェント作業の調整プリミティブです — メインセッションがリーダーとして動作し、`Agent` ツールを介して名前付きチームメイトを起動します。
 
-プロジェクトに取り組む複数の agent を調整するための新しいチームを作成します。チームは共有タスクリストと agent 間のメッセージングを通じて並列タスク実行を可能にします。
+## 使用タイミング
+
+- ユーザーがチーム、swarm、crew、またはマルチエージェント協業を明示的に要求した場合。
+- プロジェクトに、専門の専任スペシャリスト (例えばフロントエンド、バックエンド、テスト、ドキュメント) から恩恵を受ける、明らかに独立した複数のワークストリームがある場合。
+- 複数のエージェントが進捗するにつれて更新する永続的な共有タスクリストが必要な場合。
+- 一度限りのサブエージェント呼び出しではなく、`SendMessage` を介してメッセージを交換できる、名前付きでアドレス指定可能なチームメイトが必要な場合。
+
+単一の委任された検索や一度限りの並列ファンアウトには使用しないでください — プレーンな `Agent` 呼び出しの方が軽量で十分です。
 
 ## パラメータ
 
-| パラメータ | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `team_name` | string | はい | 新しいチームの名前 |
-| `description` | string | いいえ | チームの説明 / 目的 |
-| `agent_type` | string | いいえ | チームリーダーのタイプ / ロール |
+- `team_name` (string, required): チームの一意な識別子。`~/.claude/teams/` の下のディレクトリ名として、またチームメイトを起動するときの `team_name` 引数として使用されます。
+- `description` (string, required): チームの目的に関する短いステートメント。起動時にすべてのチームメイトに表示され、チーム設定に書き込まれます。
+- `agent_type` (string, optional): オーバーライドしないチームメイトに適用されるデフォルトのサブエージェントペルソナ。典型的な値は `general-purpose`、`Explore`、`Plan`。
+
+## 例
+
+### 例 1: リファクタリングチームを作成
 
-## 作成されるもの
+```
+TeamCreate(
+  team_name="refactor-crew",
+  description="Refactor the data access layer from raw SQL to Prisma, including migrations and tests.",
+  agent_type="general-purpose"
+)
+```
 
-- **チーム設定ファイル**: `~/.claude/teams/{team-name}/config.json` — メンバーリストとメタデータを保存
-- **タスクリストディレクトリ**: `~/.claude/tasks/{team-name}/` — すべてのチームメンバーが共有するタスクリスト
+作成後、`team_name: "refactor-crew"` と `db-lead`、`migrations`、`tests` などの異なる `name` 値を使用して、`Agent` でチームメイトを起動します。
 
-チームとタスクリストは 1:1 の対応関係にあります。
+### 例 2: 調査チームを作成
 
-## チームワークフロー
+```
+TeamCreate(
+  team_name="perf-investigation",
+  description="Identify and rank the top three performance regressions introduced in the last release.",
+  agent_type="Explore"
+)
+```
 
-1. **TeamCreate** — チームとそのタスクリストを作成
-2. **TaskCreate** — チームのタスクを定義
-3. **Agent**（`team_name` + `name` を指定）— チームに参加するチームメンバーを起動
-4. **TaskUpdate** — `owner` を通じてチ��ムメンバーにタスクを割り当て
-5. チームメンバーがタスクに���り組み、**SendMessage** を通じて通信
-6. 完了後チームメンバーをシャットダウン、その後 **TeamDelete** でクリーンアップ
+起動された各チームメイトは、デフォルトペルソナとして `Explore` を継承し、作業の読み取り専用調査的な性質に一致します。
 
-## 関連ツール
+## 注意事項
 
-| ツール | 目的 |
-|--------|------|
-| `TeamDelete` | チームとタスクディレクトリを削除 |
-| `SendMessage` | チーム内の agent 間通信 |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | 共有タスクリストの管理 |
-| `Agent` | チームに参加するチームメンバーを起動 |
+- 特定のセッションから一度にリードできるのは 1 つのチームだけです。別のチームを作成する前に現在のチームを終了または削除してください。
+- チームは共有タスクリストと 1:1 です。リーダーがタスクの作成、割り当て、クローズを所有し、チームメイトは取り組んでいるタスクのステータスを更新します。
+- チーム設定は `~/.claude/teams/{team_name}/config.json` に永続化され、タスクディレクトリはその隣にあります。これらのファイルは `TeamDelete` で明示的に削除されるまでセッションをまたいで存続します。
+- チームメイトは、一致する `team_name` と異なる `name` を使用して `Agent` ツールで起動されます。`name` は `SendMessage` で使用されるアドレスになります。
+- ファイルシステムに安全な `team_name` (文字、数字、ダッシュ、アンダースコア) を選んでください。スペースやスラッシュは避けてください。
+- まったく新しいチームメイトがコールドで読んだとき、それ以上のコンテキストなしにチームの目標を理解できるように `description` を書いてください。これは各チームメイトの起動プロンプトの一部になります。

package/concepts/ja/Tool-TeamDelete.md

@@ -1,30 +1,44 @@
 # TeamDelete
 
-## 定義
+現在アクティブなチームを解体し、その設定ディレクトリと共有タスクディレクトリを削除します。これは `TeamCreate` のクリーンアップ相当物で、通常はチームの目的が達成され、すべてのチームメイトがシャットダウンした後に呼び出されます。
 
-マルチ agent コラボレーション作業が完了した際に、チームと関連するタスクディレクトリを削除します。TeamCreate のクリーンアップ対応操作です。
+## 使用タイミング
 
-## 動作
+- チームが作業を完了し、最終レポートがユーザーに配信された。
+- チームが誤って作成されたか、スコープが大幅に変わったため、続けるよりも新たに始める方が簡潔。
+- 新しいチームを作成する必要があるが、すでにアクティブなチームが存在する — 一度にリードできるのは 1 つのチームだけなので、古いものを先に削除してください。
+- チームがセッションをまたいで古くなり、`~/.claude/teams/` に永続化された状態がもう不要になった。
 
-- チームディレクトリを削除: `~/.claude/teams/{team-name}/`
-- タスクディレクトリを削除: `~/.claude/tasks/{team-name}/`
-- 現在のセッションからチームコンテキストをクリア
+チームメイトがまだ実行中に呼び出さないでください — まず `SendMessage` で `shutdown_request` を送ってシャットダウンし、すべての `shutdown_response` を待ってから削除してください。
 
-**重要**: チームにまだアクティブなメンバーがいる場合、TeamDelete は失敗します。SendMessage のシャットダウンリクエストを通じて、先にすべてのチームメンバーを適切にシャットダウンする必要があります。
+## パラメータ
 
-## 典型的な使用方法
+`TeamDelete` は典型的な呼び出しではパラメータを取りません。呼び出し元セッションが所有する現在アクティブなチームに対して動作します。
 
-TeamDelete はチームワークフローの終了時に呼び出されます:
+## 例
 
-1. すべてのタスクが完了
-2. `SendMessage` で `shutdown_request` を送信してチームメンバーをシャットダウン
-3. **TeamDelete** がチームとタスクディレクトリを削除
+### 例 1: 成功後のルーチンシャットダウン
 
-## 関連ツール
+1. チームにシャットダウン要求をブロードキャストします。
+   ```
+   SendMessage(to="*", message={ "type": "shutdown_request" })
+   ```
+2. 各チームメイトが `shutdown_response` で返信するのを待ちます。
+3. `TeamDelete()` を呼び出して、チームディレクトリとタスクディレクトリを削除します。
 
-| ツール | 目的 |
-|--------|------|
-| `TeamCreate` | 新しいチームとそのタスクリストを作成 |
-| `SendMessage` | チームメンバーとの通信 / シャットダウンリクエストの送信 |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | 共有タスクリストの管理 |
-| `Agent` | チームに参加するチームメンバーを起動 |
+### 例 2: 誤設定されたチームの置き換え
+
+`TeamCreate` が誤った `agent_type` や `description` で呼び出された場合、まずチームメイトがまだ起動されていないこと (またはシャットダウンされていること) を確認してから。
+
+```
+TeamDelete()
+TeamCreate(team_name="...", description="...", agent_type="...")
+```
+
+## 注意事項
+
+- `TeamDelete` は、チームメイトがまだアクティブな場合は失敗します。エラー応答には生きているチームメイトがリストされます — 各チームメイトに `SendMessage` で `shutdown_request` を送り、`shutdown_response` を待ってから再試行してください。
+- 削除はツールの観点からは取り消せません。`~/.claude/teams/{team_name}/config.json` のチーム設定とタスクディレクトリはディスクから削除されます。タスクリストを保存する必要がある場合は、削除前にディレクトリをエクスポートまたはコピーしてください。
+- チームを作成したリーダーセッションのみが削除できます。起動されたチームメイトは自分のチームで `TeamDelete` を呼び出すことができません。
+- チームの削除はチームメイトがリポジトリで行ったファイルシステム変更をロールバックしません。それらは通常の git 追跡編集であり、不要な場合は別途元に戻す必要があります。
+- `TeamDelete` が正常に戻った後、セッションは新しいチームのために再び `TeamCreate` を呼び出すことができます。