cc-viewer 1.7.21 → 1.7.23

package/concepts/ja/Tool-ProposeGoal.md

@@ -0,0 +1,43 @@
+# ProposeGoal
+
+セッションの検証可能な完了ゴールを提案します。ゴールは (デフォルトでは) 承認ダイアログでユーザーに表示され、一度設定されると、会話の残りをチェック可能な結果へと導きます。
+
+## 使用タイミング
+
+- セッションに、評価者が会話から検証できる具体的な終了状態がある場合 (例: "all tests in test/auth pass")。
+- 大きな作業の前に、「完了」の意味についてユーザーの明示的な承認を得たい場合。
+- ユーザー自身の言葉がすでに結果を述べており、それをセッションゴールとして記録したい場合。
+
+## 有効化
+
+- デフォルトではオフです (サーバーサイドの機能フラグ)。
+- 対話型セッションとバックグラウンドセッションでは除外されます。
+- `modelProposedGoals: "disabled"` 設定キーでオフになります。
+
+## パラメータ
+
+- `condition` (string, required): 完了条件。別の評価者が会話から検証できるように書きます (例: "all tests in test/auth pass (bun test exits 0)")。最大 500 文字 — ユーザーは承認ダイアログで条件全体を読める必要があります。
+- `ask_user` (boolean, optional): ゴールが設定される前にユーザーに承認を求めるかどうか。デフォルトは true (承認ダイアログが表示されます)。この会話におけるユーザー自身の言葉がこの結果を望んでいることを述べている場合にのみ false を設定してください。その場合ゴールは可視の通知付きで直接設定され、ユーザーは `/goal clear` でクリアできます。
+
+## 例
+
+### 例 1: テストに裏付けられたゴールを提案
+
+```
+ProposeGoal(condition="npm run test exits 0 with the new catalog cases included")
+```
+
+ユーザーは承認ダイアログで条件を確認し、承認、編集、拒否できます。
+
+### 例 2: ユーザーの述べた結果を直接採用
+
+```
+ProposeGoal(condition="the login form validates email format and shows an inline error", ask_user=false)
+```
+
+会話の前段でユーザーがその結果を明示的に述べた場合のみ有効です。
+
+## 注意事項
+
+- `condition` は短く、客観的にチェック可能に保ってください — 曖昧なゴール ("make it better") は目的を損ないます。
+- `ask_user=false` は、ユーザー自身が述べた結果に厳密に限定されます。それ以外は承認ダイアログを通す必要があります。

package/concepts/ja/Tool-PushNotification.md

@@ -14,6 +14,12 @@
 
 タスク中の通常の進捗更新には通知を送らないでください。ユーザーが直前に質問して明らかに待機中の場合も同様です。短いタスクが完了しても通知は不要です——ユーザーが送信してすぐ待っているなら、通知は無意味であり、今後の通知への信頼を損ないます。基本的には送らないことを強く推奨します。
 
+## 有効化
+
+- デフォルトではオフです (サーバーサイドの機能フラグ)。
+- 配信は Anthropic がホストするインフラストラクチャを経由します — Amazon Bedrock、Claude Platform on AWS、Google Cloud、Microsoft Foundry では利用できません。
+- 電話へのプッシュにはさらに、接続済みの Remote Control クライアントが必要です。
+
 ## パラメータ
 
 - `message`（文字列、必須）：通知の本文。200文字以内に収めてください。モバイルOSはそれ以上の文字列を切り捨てます。ユーザーが行動しやすい内容から始めてください："build failed: 2 auth tests" は "task complete" よりも有用です。

package/concepts/ja/Tool-REPL.md

@@ -0,0 +1,47 @@
+# REPL
+
+セッション内の永続的な Node.js vm コンテキストで JavaScript を実行します。トップレベル `await` がサポートされており、ある呼び出しで定義した変数や関数は後の呼び出しでも利用可能です。
+
+## 使用タイミング
+
+- シェルのワンライナーよりコードで書く方が簡単な、素早い計算、データ変換、JSON の加工。
+- 呼び出し間で中間状態を保持すべきマルチステップスクリプト (カウンター、蓄積された結果)。
+- ファイルに書き込む前に、API やライブラリの動作を対話的に調べる。
+
+## 有効化
+
+- デフォルトではオフです — 有効にするには `CLAUDE_CODE_REPL=true` を設定します。
+- ターミナル (`cli`) および claude.ai (`remote`) セッションでは、サーバーサイドの機能フラグによって有効になることもあります。
+- オフの場合、REPL はモデルのツールリストから隠されます。オンの場合、`Read`、`Glob`、`Grep`、`Bash`、`PowerShell`、`NotebookEdit` は REPL の短縮形に置き換えられます。
+
+## パラメータ
+
+- `code` (string, required): 実行する JavaScript コード。トップレベル await をサポートします。状態は呼び出しをまたいで保持されます。
+- `description` (string, optional): このスクリプトが何をするかの明確で簡潔な説明 (能動態、5〜10 語)。例: "Trace upgrade message to its GrowthBook flag"。
+- `timeout` (number, optional): タイムアウト (ミリ秒)。デフォルトは 30000、最大 600000。
+
+## 例
+
+### 例 1: 状態を計算して再利用
+
+```
+REPL(code="const counts = new Map(); ['a','b','a'].forEach(k => counts.set(k, (counts.get(k)||0)+1)); counts.get('a')")
+```
+
+`2` を返します。`counts` は同じセッション内の後続の REPL 呼び出しでも定義されたままです。
+
+### 例 2: 長めのタイムアウトでのトップレベル await
+
+```
+REPL(
+  code="const res = await fetch('https://example.com/api'); await res.json()",
+  description="Fetch example API and parse JSON",
+  timeout=60000
+)
+```
+
+## 注意事項
+
+- 状態はセッションごとです。セッションを再起動するとすべての定義がクリアされます。
+- これは JavaScript (Node) 環境です — シェルコマンド、ファイルシステムを多用する作業、非 JS ランタイムには Bash を使用してください。
+- 長時間実行コードには明示的な `timeout` を設定してください。デフォルトの 30 秒では遅い処理はすべて終了させられます。

package/concepts/ja/Tool-ReadMcpResource.md

@@ -0,0 +1,32 @@
+# ReadMcpResource
+
+接続された MCP (Model Context Protocol) サーバーが公開する単一のリソースを、その URI で指定して読み取ります。
+
+## 使用タイミング
+
+- MCP サーバーがリソース (ファイル、レコード、ドキュメント) を公開しており、その内容がコンテキストに必要な場合。
+- 具体的なリソース URI がある場合 — `ListMcpResources`、サーバーのドキュメント、または以前のツール結果から。
+
+## 有効化
+
+- 常に有効ですが、モデルのツールリストには公開されません — シンクライアント / サイドカーでの使用を意図しています。
+
+## パラメータ
+
+- `server` (string, required): MCP サーバー名。
+- `uri` (string, required): 読み取るリソース URI。
+
+## 例
+
+### 例 1: URI でサーバーリソースを読み取る
+
+```
+ReadMcpResource(server="github", uri="file:///repo/docs/architecture.md")
+```
+
+`github` MCP サーバーが提供するリソース内容を返します。
+
+## 注意事項
+
+- サーバーがどのリソースを公開しているか分からない場合は、まず `ListMcpResources` を使用してください。ディレクトリ型の一覧には `ReadMcpResourceDir` を使用してください。
+- URI スキームはサーバー固有です (`file://`、`https://`、カスタムスキーム) — 対象サーバーが宣伝しているものを確認してください。

package/concepts/ja/Tool-ReadMcpResourceDir.md

@@ -0,0 +1,32 @@
+# ReadMcpResourceDir
+
+接続された MCP サーバーが公開するディレクトリ型リソースのエントリを、その URI で指定して一覧表示します。
+
+## 使用タイミング
+
+- MCP サーバーがリソースを階層的に整理しており、その階層の 1 レベルを列挙する必要がある場合。
+- `ReadMcpResource` で個々のリソースを読み取る前にブラウズしたい場合。
+
+## 有効化
+
+- 常に有効ですが、モデルのツールリストには公開されません — シンクライアント / サイドカーでの使用を意図しています。
+
+## パラメータ
+
+- `server` (string, required): MCP サーバー名。
+- `uri` (string, required): 一覧表示するディレクトリリソースの URI。
+
+## 例
+
+### 例 1: リソースディレクトリを一覧表示
+
+```
+ReadMcpResourceDir(server="filesystem", uri="file:///project/src/")
+```
+
+そのディレクトリ URI の下でサーバーが公開する子エントリを返します。
+
+## 注意事項
+
+- リソースをディレクトリとしてモデル化するサーバーのみがこれをサポートします。フラットなサーバーはエラーまたは空の一覧を返します — `ListMcpResources` にフォールバックしてください。
+- `ReadMcpResource` と組み合わせて、関連しそうなエントリに掘り下げてください。

package/concepts/ja/Tool-ReadNotifications.md

@@ -0,0 +1,27 @@
+# ReadNotifications
+
+現在のセッションでアシスタントに対してキューに入れられた通知 — サブスクライブした PR の GitHub アクティビティ (`github_webhook`)、スケジュールトリガーの発火 (`trigger_fire`)、他の Claude セッションから到着したメッセージ (`mcp_send_message`) — を読み取ります。
+
+## 使用タイミング
+
+- 何かが起きたと通知され (サブスクライブした PR の更新、スケジュールトリガーの発火、他のセッションからのメッセージ)、実際のペイロードが必要な場合。
+- バックログの排出: 大きなバッチは分割して返されるため、結果が `remaining` 0 を報告するまで呼び出し続けてください。
+
+## パラメータ
+
+このツールはパラメータを取りません。
+
+## 例
+
+### 例 1: 保留中の通知を排出
+
+```
+ReadNotifications()
+```
+
+キューに入れられた通知を古いものから順に返します。結果には、この排出の後もまだキューに残っている通知の `remaining` カウントが含まれます — それらを読むにはもう一度ツールを呼び出してください。
+
+## 注意事項
+
+- 排出にはサイズの上限があります: フォローアップの呼び出しは、新しい到着分だけではなく、同じキューの残り (新しく到着した分も含む) を返します。`remaining` が 0 になるまでループしてください。
+- 通知は、サブスクライブした PR の GitHub ウェブフック、スケジュールトリガー、他の Claude セッションからのメッセージから発生します。現在のバージョンにはフィルタリングパラメータはありません。

package/concepts/ja/Tool-RemoteTrigger.md

@@ -10,6 +10,13 @@ claude.ai のリモートトリガー API を呼び出し、スケジュール
 - すべての現在のトリガーを一覧表示または監査して、設定とステータスを確認
 - トリガーを再作成せずに、スケジュール、ペイロード、説明などのトリガー設定を更新
 
+## 有効化
+
+- claude.ai の Pro、Max、Team、または Enterprise プランが必要です。
+- Amazon Bedrock、Claude Platform on AWS、Google Cloud、Microsoft Foundry では利用できません。
+- サーバーサイドの機能フラグと `allow_remote_sessions` / `allow_routines` ポリシー設定が必要です。
+- リモートセッション自体では利用できません。
+
 ## パラメータ
 
 - `action` (string, 必須): 実行する操作 — `list`、`get`、`create`、`update`、`run` のいずれか

package/concepts/ja/Tool-ScheduleWakeup.md

@@ -10,6 +10,11 @@
 - ユーザープロンプトなしの自律ループを実行する場合——リテラルセンチネル `<<autonomous-loop-dynamic>>` を `prompt` として渡す
 - まもなく状態が変化するプロセスをポーリングする場合（短い遅延でキャッシュをウォームに保つ）
 
+## 有効化
+
+- Amazon Bedrock、Claude Platform on AWS、Google Cloud Agent Platform、Microsoft Foundry では利用できません。
+- 機能フラグの取得が無効化されている場合 (テレメトリ/トラフィックの環境変数) もオフになります。
+
 ## パラメータ
 
 - `delaySeconds`（数値、必須）：再開までの秒数。ランタイムが値を `[60, 3600]` に自動クランプするため、手動でクランプする必要はありません。

package/concepts/ja/Tool-SearchMcpRegistry.md

@@ -0,0 +1,31 @@
+# SearchMcpRegistry
+
+MCP コネクタレジストリをキーワードで検索し、タスクの完了に役立つ可能性のあるコネクタを発見します。
+
+## 使用タイミング
+
+- タスクが外部サービス (データベース、イシュートラッカー、SaaS API) の恩恵を受ける場合に、それに対応する MCP コネクタが存在するか確認したいとき。
+- ユーザーが製品名を挙げて接続を求めた場合 — レジストリを検索して一致するコネクタを探してください。
+
+## 有効化
+
+- ファーストパーティ API 上のリモート (claude.ai) セッションでのみ利用可能です。
+
+## パラメータ
+
+- `keywords` (array of strings, required): ユーザーの意図または名前付き製品を説明するキーワードフレーズ。1〜8 項目、各 1〜64 文字。
+
+## 例
+
+### 例 1: 名前付き製品のコネクタを探す
+
+```
+SearchMcpRegistry(keywords=["linear", "issue tracker"])
+```
+
+キーワードに一致するコネクタを持つレジストリエントリを返します。コネクタの完全な詳細は `SuggestConnectors` で解決してください。
+
+## 注意事項
+
+- 読み取り専用で、並行実行に対して安全です。結果のサイズには上限があります。
+- 検索は何もインストールしません — 純粋に発見のためのものです。

package/concepts/ja/Tool-SendFeedback.md

@@ -0,0 +1,38 @@
+# SendFeedback
+
+セッションを離れることなく、Claude Code に関する構造化フィードバック — バグ報告、機能アイデア、欠けている機能 — を Anthropic に送信します。
+
+## 使用タイミング
+
+- ユーザーが Claude Code 自体に関するバグの報告やフィードバックの送信を求めた場合。
+- 報告する価値のある明確なプロダクトの欠陥 (壊れたコマンド、誤った動作、クラッシュ) に遭遇した場合。
+- ユーザーが存在してほしい機能 (アイデアや欠けている機能) を説明した場合。
+
+## パラメータ
+
+- `type` (string, required): `bug`、`idea`、`missing_capability` のいずれか。
+- `title` (string, required): 問題の短く具体的な 1 行の要約。
+- `details` (string, required): ラベル付き箇条書きを順に: **What happened:** (観察された動作と期待された動作、短ければ正確なエラーテキスト); **What the user said:** (引用、または "User didn't comment; observed by the model."); **Repro:** (最小の手順); **Evidence:** (リクエスト ID、タイムスタンプ、パス、バージョン — なければ省略); 任意で最後に **Cause:** をセッション内で検証できた場合のみ。各箇条書きは 1〜3 行。ナラティブな段落、推測、シークレットは含めないでください。
+- `area` (string, optional): これがどの部分の Claude Code に関するものかを示す短いタグ (例: "hooks config"、"/help"、"file editing")。不明なら空のままにします。
+- `failure_mode` (string, optional): モデル動作の報告の場合、最も近い失敗モード (例: `instruction_following`、`repetition_and_looping`、`context_and_memory`、`stopping_short`、または `other`)。報告が純粋なプロダクト/ツールのバグの場合のみ省略します。
+- `task_category` (string, optional): 問題発生時にセッションが行っていた作業: `code_edit`、`debug`、`explain`、`plan`、`shell`、`search`、`review`、または `other`。
+
+## 例
+
+### 例 1: プロダクトのバグを報告
+
+```
+SendFeedback(
+  type="bug",
+  title="/export truncates the last message",
+  details="**What happened:** exported transcript is missing the final assistant message.\n**What the user said:** \"the last reply never shows up in the file\".\n**Repro:** run /export after any multi-turn session.\n**Evidence:** v2.1.233, macOS.",
+  area="/export",
+  task_category="other"
+)
+```
+
+## 注意事項
+
+- `details` にシークレット、トークン、ユーザーのプライベートデータを決して含めないでください。
+- 可能ならユーザーの言葉を引用してください。そうでなければ、モデルが問題を観察したと明記してください。
+- 報告は事実に基づいてください — 根本原因の推測は、セッション内で検証できた場合にのみ `**Cause:**` に含めてください。

package/concepts/ja/Tool-SendFile.md

@@ -0,0 +1,36 @@
+# SendFile
+
+1 つ以上のファイルを別の Claude Code セッション — `ListAgents` でリストされるピア、または明示的なセッションアドレス — に送信します。
+
+## 使用タイミング
+
+- ピアセッションが自身のタスクを続行するために作業ディレクトリ内のファイル (レポート、パッチ、フィクスチャ) を必要としている場合。
+- セッション間で作業を調整しており、テキストだけでなく成果物を引き渡したい場合 (テキストには `SendMessage` を使用してください)。
+
+## 有効化
+
+- クロスセッションファイル転送がセッションで利用可能でなければなりません。利用できない場合、検証は "Cross-session file transfer is not available in this session." で失敗します。
+- `ListAgents` と同じクロスセッションメッセージング条件によってゲートされます (サーバーサイドの機能フラグ、デフォルトではオフ)。
+
+## パラメータ
+
+- `to` (string, required): 受信者 — `ListAgents` からのピアセッション名、または明示的な `uds:<socket>` / `bridge:<session id>` アドレス。
+- `files` (array of strings, required): 送信するファイルパス (絶対パスまたは cwd からの相対パス)。単一ファイルでも常に配列で渡してください。1〜16 ファイル、各最大 30 MiB。
+- `message` (string, optional): ファイルと一緒に届けられる短いメッセージ。
+
+## 例
+
+### 例 1: ピアセッションにレポートを送信
+
+```
+SendFile(
+  to="teammate-a",
+  files=["./dist/report.html"],
+  message="The analysis you asked for"
+)
+```
+
+## 注意事項
+
+- リモートマシンへの転送には追加の承認が必要な場合があります。
+- ファイル内容の読み取りは送信の一部です — 権限ルールによってファイル読み取りが無効化されている場合は拒否されます。

package/concepts/ja/Tool-SendMessage.md

@@ -10,6 +10,11 @@
 - シャットダウン要求やチームリーダーからのプラン承認要求などのプロトコルプロンプトに応答する。
 - 委任されたタスクの終わりにループを閉じ、リーダーがアイテムを完了としてマークできるようにする。
 
+## 有効化
+
+- `ListAgents` と同じクロスセッションメッセージング条件によってゲートされます (サーバーサイドの機能フラグ、デフォルトではオフ)。
+- チームメイトにはさらに、実験的なエージェントチームの有効化が必要です。
+
 ## パラメータ
 
 - `to` (string, required): チームに登録されている対象チームメイトの `name`、または `*` ですべてのチームメイトに一度にブロードキャスト。

package/concepts/ja/Tool-SendUserFile.md

@@ -0,0 +1,38 @@
+# SendUserFile
+
+1 つ以上のファイル — 生成された成果物、スクリーンショット、レポート — をユーザーに送信し、クライアントがどう提示するかを制御します。
+
+## 使用タイミング
+
+- ユーザーが必要とするファイル (レポート、画像、HTML ページ) を生成し、パスを言及するだけでなくそれを提示したい場合。
+- 添付付きで返信する (`status="normal"`)、またはユーザーが求めていないが今見る必要のあるものを先回りして提示する (`status="proactive"`)。
+
+## 有効化
+
+- Remote Control クライアントが接続されているか、セッションがマネージドクラウド環境 (例: ウェブ版 Claude Code) で実行されている場合のみ利用可能です。
+- Amazon Bedrock、Google Cloud、Microsoft Foundry では利用できません。
+- セッションがファイル送信を許可している必要があります (設定/機能ゲート付きのケイパビリティ)。brief モードでは提供されません。
+
+## パラメータ
+
+- `files` (array of strings, required): ユーザーに送信するファイルパス (絶対パスまたは cwd からの相対パス)。単一ファイルでも常に配列で渡してください。
+- `caption` (string, optional): ファイルの短いキャプション。
+- `status` (string, required): ユーザーが求めていないが今見る必要のあるファイル — 生成された成果物や完了したレポート — を提示する場合は `proactive`。ユーザーが今言ったことへの返信の場合は `normal`。
+- `display` (string, optional): `render` はサイドパネルでファイルをインライン表示します (HTML、SVG、Mermaid、画像、PDF)。`attach` はダウンロードカードのみを表示します (ユーザーが保存して別の場所で開く成果物向け)。省略するとクライアントがファイルタイプに応じて決定します。
+
+## 例
+
+### 例 1: 生成したレポートを届ける
+
+```
+SendUserFile(
+  files=["./out/weekly-report.html"],
+  caption="Weekly usage report",
+  status="proactive",
+  display="render"
+)
+```
+
+## 注意事項
+
+- ユーザーが保存して別のアプリで開くファイルには `display="attach"` を、すぐに見るべきものには `render` を選んでください。

package/concepts/ja/Tool-SendUserMessage.md

@@ -0,0 +1,38 @@
+# SendUserMessage
+
+ユーザーにメッセージを送信します — brief スタイルのセッションにおける主要な可視出力チャンネルです。レガシーエイリアス `Brief` としても知られています。
+
+## 使用タイミング
+
+- ユーザーが今言ったことへの返信 (`status="normal"`)。
+- ユーザーが求めていないが今見る必要のあるものを先回りして提示する — ユーザーが離れている間にタスクが完了する、ヒットしたブロッカー、求められていないステータス更新 (`status="proactive"`)。
+
+## 有効化
+
+- 対話型セッションではデフォルトで非表示です。ほとんどの対話型 CLI セッションは代わりにユーザーと直接会話します。
+- brief モードまたはサーバーサイドの機能フラグで有効化されます。
+
+## パラメータ
+
+brief モードの場合:
+
+- `message` (string, required): ユーザーへのメッセージ。markdown フォーマットをサポートします。
+- `attachments` (array, optional): メッセージと一緒に表示される添付。各エントリは、ローカルで読み取り可能なファイルのファイルパス (絶対パスまたは cwd からの相対パス)、または `attach_file` などのデバイスツールから取得した事前解決済みの `{file_uuid, file_name, size, is_image}` オブジェクトです。
+- `status` (string, required): ユーザーが今必要とする求められていない更新には `proactive`。ユーザーへの返信には `normal`。
+
+non-brief ビルドでは `message` のみが利用可能です。
+
+## 例
+
+### 例 1: 先回りの完了通知
+
+```
+SendUserMessage(
+  message="The migration finished — 42 files updated, tests green.",
+  status="proactive"
+)
+```
+
+## 注意事項
+
+- `proactive` は控えめに使用してください — 本当に今ユーザーの注意を必要とするもののためのものです。

package/concepts/ja/Tool-SuggestConnectors.md

@@ -0,0 +1,28 @@
+# SuggestConnectors
+
+`SearchMcpRegistry` が返す `directoryUuid` 値の完全なコネクタペイロードを解決し、有効化できる具体的なコネクタをユーザーに提示できるようにします。
+
+## 使用タイミング
+
+- `SearchMcpRegistry` が候補コネクタを返した後、提示用に完全な詳細を取得するため。
+
+## 有効化
+
+- ファーストパーティ API 上のリモート (claude.ai) セッションでのみ利用可能です。
+
+## パラメータ
+
+- `uuids` (array of strings, required): 解決する `directoryUuid` または `server_id` の値。1〜32 項目、各 1〜64 文字。
+
+## 例
+
+### 例 1: 2 つのレジストリヒットを解決
+
+```
+SuggestConnectors(uuids=["d290f1ee-6c54-4b01-90e6-d701748f0851", "a1b2c3d4-0000-4000-8000-abcdefabcdef"])
+```
+
+## 注意事項
+
+- UUID を推測しないでください — `SearchMcpRegistry` から返ってきた識別子のみを解決してください。
+- このツール自体は何も接続しません。コネクタの有効化はこのツールの外部で行われます。

package/concepts/ja/Tool-SuggestPluginInstall.md

@@ -0,0 +1,39 @@
+# SuggestPluginInstall
+
+`SearchPlugins` の結果からインラインのプラグインインストールカードをレンダリングし、プラグインの提案をユーザーのリクエストに結び付けます。
+
+## 使用タイミング
+
+- プラグイン検索でユーザーがやろうとしていることに一致するプラグインが見つかり、インストール用に提示したい場合。
+
+## 有効化
+
+- Remote Control クライアントが接続されているか、セッションがマネージドクラウド環境で実行されている場合のみ。
+- HIPAA エンタープライズ構成では無効化されます。
+- brief モードでは利用できません。
+
+## パラメータ
+
+- `contextLabel` (string, required): 提案をユーザーのリクエストに結び付ける短いヘッダー (最大 128 文字)。
+- `plugins` (array, required): `SearchPlugins` の結果から取得したプラグイン — 1〜16 エントリ。各エントリには以下が含まれます:
+  - `pluginId` (string, required)
+  - `pluginName` (string, required)
+  - `description` (string, required)
+  - `skills` (array, optional): プラグインのスキルを説明する最大 32 個の `{name, description?}` エントリ。
+
+## 例
+
+### 例 1: 一致するプラグインを提示
+
+```
+SuggestPluginInstall(
+  contextLabel="For reviewing pull requests",
+  plugins=[{pluginId="pr-toolkit", pluginName="PR Toolkit", description="Review helpers"}]
+)
+```
+
+カードがユーザー向けにレンダリングされます。プラグインの有効化はこのツールの外部で行われます。フォローアップで `ListPlugins` を呼び出し、実際に何がインストールされたかを確認してください。
+
+## 注意事項
+
+- 検索結果から来たプラグインのみを含めてください — プラグインエントリを発明しないでください。

package/concepts/ja/Tool-SuggestSkills.md

@@ -0,0 +1,33 @@
+# SuggestSkills
+
+トピックキーワードに基づいて、ユーザーが追加できるスタンドアロンスキル (まだ有効化されていないスキル) のカードをレンダリングします。
+
+## 使用タイミング
+
+- ユーザーのリクエストが、有効化していないスキルに一致する場合 (ユーザーが求めた場合は `trigger="user_asked"`、求められずに提案する場合は `trigger="proactive"`)。
+
+## 有効化
+
+- Remote Control クライアントが接続されているか、セッションがマネージドクラウド環境で実行されている場合のみ。
+- HIPAA エンタープライズ構成では無効化されます。
+- brief モードでは利用できません。
+
+## パラメータ
+
+- `keywords` (array of strings, required): ユーザーのリクエストからのトピックキーワード。1〜8 項目、各 1〜64 文字。
+- `contextLabel` (string, optional): 提案をリクエストに結び付ける短いラベル (最大 128 文字)。
+- `trigger` (string, optional): この提案がどのように始まったか — `user_asked` または `proactive`。
+
+## 例
+
+### 例 1: トピックでスキルを提案
+
+```
+SuggestSkills(keywords=["data visualization", "charts"], contextLabel="For building the dashboard", trigger="user_asked")
+```
+
+すでに有効化されているスキルは結果から除外されます。
+
+## 注意事項
+
+- 提案カードをレンダリングするだけです — スキルの追加はこのツールの外部で行われます。後で `ListSkills` を呼び出して確認してください。

package/concepts/ja/Tool-TaskCreate.md

@@ -12,6 +12,12 @@
 
 些細なワンショットアクション、純粋な会話、または 2〜3 の直接的なツール呼び出しで完了できるものには `TaskCreate` をスキップしてください。
 
+## 有効化
+
+- ほとんどのモデルでデフォルトで利用可能です。
+- Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 以降のファミリー (v2.1.233+) では、`CLAUDE_CODE_ENABLE_TODO_TOOLS=1`、`--allowedTools`、または `--tools` でオプトインしない限り利用できません。
+- タスクシステム全体は `CLAUDE_CODE_ENABLE_TASKS=false` で無効化されます。
+
 ## パラメータ
 
 - `subject` (string, required): 短い命令型のタイトル。例 `Fix login redirect on Safari`。約 80 文字以内に保ってください。

package/concepts/ja/Tool-TaskGet.md

@@ -12,6 +12,12 @@ ID で単一タスクの完全なレコードを取得します。説明、現
 
 高レベルのスキャンだけが必要な場合は `TaskList` を優先してください。`TaskGet` は注意深く読んだり変更したりする特定のレコードのために予約してください。
 
+## 有効化
+
+- ほとんどのモデルでデフォルトで利用可能です。
+- Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 以降のファミリー (v2.1.233+) では、`CLAUDE_CODE_ENABLE_TODO_TOOLS=1`、`--allowedTools`、または `--tools` でオプトインしない限り利用できません。
+- タスクシステム全体は `CLAUDE_CODE_ENABLE_TASKS=false` で無効化されます。
+
 ## パラメータ
 
 - `taskId` (string, required): `TaskCreate` または `TaskList` によって返されるタスク識別子。ID はタスクの生存期間中安定しています。

package/concepts/ja/Tool-TaskList.md

@@ -12,6 +12,12 @@
 
 `TaskList` は読み取り専用で安価です。概要が必要なときはいつでも自由に呼び出してください。
 
+## 有効化
+
+- ほとんどのモデルでデフォルトで利用可能です。
+- Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 以降のファミリー (v2.1.233+) では、`CLAUDE_CODE_ENABLE_TODO_TOOLS=1`、`--allowedTools`、または `--tools` でオプトインしない限り利用できません。
+- タスクシステム全体は `CLAUDE_CODE_ENABLE_TASKS=false` で無効化されます。
+
 ## パラメータ
 
 `TaskList` はパラメータを取りません。常にアクティブなコンテキストの完全なタスクセットを返します。

package/concepts/ja/Tool-TaskUpdate.md

@@ -10,6 +10,12 @@
 - `addBlocks` / `addBlockedBy` で新しく発見された依存関係を記録する。
 - 外部チケット ID や優先度ヒントなどの構造化された `metadata` を添付する。
 
+## 有効化
+
+- ほとんどのモデルでデフォルトで利用可能です。
+- Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 以降のファミリー (v2.1.233+) では、`CLAUDE_CODE_ENABLE_TODO_TOOLS=1`、`--allowedTools`、または `--tools` でオプトインしない限り利用できません。
+- タスクシステム全体は `CLAUDE_CODE_ENABLE_TASKS=false` で無効化されます。
+
 ## パラメータ
 
 - `taskId` (string, required): 変更するタスク。`TaskList` または `TaskCreate` から取得。

package/concepts/ja/Tool-TodoWrite.md

@@ -0,0 +1,43 @@
+# TodoWrite
+
+現在のセッション用に構造化 todo リストを書き込み、以前のリストを置き換えます。各項目はテキスト、ステータス、進捗インジケーターに表示される現在進行形のテキストを持ちます。
+
+## 使用タイミング
+
+- タスクに複数の明確なステップがあり、進捗を追跡することであなた（とユーザー）が進行状況を確認できる場合。
+- ユーザーが明示的に todo リストを求めた場合。
+- ちょうど 1 つの項目を進行中としてマークし、残りを保留または完了のままにしたい場合。
+
+## 有効化
+
+- レガシーツールです: Task ツール (`TaskCreate`、`TaskUpdate`、`TaskList`) を提供するセッションではデフォルトで無効化されます。
+- `CLAUDE_CODE_ENABLE_TASKS=0` で再度有効化できます。
+
+## パラメータ
+
+- `todos` (array, required): 更新後の完全な todo リスト。各エントリには以下が含まれます:
+  - `content` (string): タスクの説明。
+  - `status` (string): `pending`、`in_progress`、`completed` のいずれか。
+  - `activeForm` (string): 項目の進行中に表示される現在進行形のテキスト (例: "Running tests")。
+
+## 例
+
+### 例 1: 3 ステップの変更を追跡
+
+```
+TodoWrite(
+  todos=[
+    {content="Update the parser", status="in_progress", activeForm="Updating the parser"},
+    {content="Add unit tests", status="pending", activeForm="Adding unit tests"},
+    {content="Run the full test suite", status="pending", activeForm="Running the full test suite"}
+  ]
+)
+```
+
+リスト全体は呼び出しごとに書き換えられます — 変更された項目だけでなく、常にすべての項目を含めてください。
+
+## 注意事項
+
+- リストは各呼び出しで丸ごと置き換えられます。1 つの項目を更新するには、新しいステータスで全項目を再送信してください。
+- 一度にちょうど 1 つの項目を `in_progress` に保ってください。
+- 構造化タスクツール (`TaskCreate`/`TaskUpdate`/`TaskList`) が有効なセッションでは、ハーネスが `TodoWrite` の代わりにそれらを提供する場合があります — 宣伝されているツールセットの方を優先してください。