cc-viewer 1.6.182 → 1.6.183

package/concepts/ja/Tool-Read.md

@@ -1,56 +1,41 @@
 # Read
 
-## 定義
+ローカルファイルシステムから単一ファイルの内容をロードします。プレーンテキスト、ソースコード、画像、PDF、Jupyter ノートブックをサポートし、結果を 1 始まりの行番号を持つ `cat -n` スタイルで返します。
 
-ローカルファイルシステムからファイル内容を読み取ります。テキストファイル、画像、PDF、Jupyter notebook に対応。
+## 使用タイミング
+
+- 編集や分析の前に既知のパスでソースファイルを読む
+- 設定ファイル、ロックファイル、ログ、生成されたアーティファクトを検査
+- ユーザーが会話に貼り付けたスクリーンショットや図を表示
+- 長い PDF マニュアルから特定のページ範囲を抽出
+- `.ipynb` ノートブックを開いてコードセル、マークダウン、セル出力を一緒にレビュー
 
 ## パラメータ
 
-| パラメータ | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `file_path` | string | はい | ファイルの絶対パス |
-| `offset` | number | いいえ | 開始行番号（大きなファイルの分割読み取り用） |
-| `limit` | number | いいえ | 読み取り行数（大きなファイルの分割読み取り用） |
-| `pages` | string | いいえ | PDF ページ範囲（例："1-5"、"3"、"10-20"）、PDF のみ適用 |
+- `file_path` (string, required): 対象ファイルの絶対パス。相対パスは拒否されます。
+- `offset` (integer, optional): 読み込みを開始する 1 始まりの行番号。大きなファイルで `limit` と組み合わせると便利です。
+- `limit` (integer, optional): `offset` から返す最大行数。省略時は、ファイルの先頭から最大 2000 行がデフォルト。
+- `pages` (string, optional): PDF ファイルのページ範囲。例えば `"1-5"`、`"3"`、または `"10-20"`。10 ページを超える PDF には必須。リクエストあたり最大 20 ページ。
+
+## 例
+
+### 例 1: 小さなファイル全体を読む
+`file_path` を `/Users/me/project/src/index.ts` に設定して `Read` を呼び出すだけです。行番号付きで最大 2000 行が返され、通常は編集コンテキストに十分です。
 
-## 使用シナリオ
+### 例 2: 長いログをページング
+数千行のログファイルで `offset: 5001` と `limit: 500` を使用して、コンテキストトークンを無駄にせずに狭いウィンドウを取得します。
 
-**適している場合：**
-- コードファイル、設定ファイルなどのテキストファイルを読み取り
-- 画像ファイルの表示（Claude はマルチモーダルモデル）
-- PDF ドキュメントの読み取り
-- Jupyter notebook の読み取り（すべてのセルと出力を返す）
-- 複数ファイルを並列読み取りしてコンテキストを取得
+### 例 3: 特定の PDF ページを抽出
+`/tmp/spec.pdf` の 120 ページ PDF に対し、`pages: "8-15"` を設定して必要な章のみを引き出します。大きな PDF で `pages` を省略するとエラーが発生します。
 
-**適していない場合：**
-- ディレクトリの読み取り——Bash の `ls` コマンドを使用すべき
-- オープンエンドなコードベース探索——Task（Explore タイプ）を使用すべき
+### 例 4: 画像を表示
+PNG または JPG スクリーンショットの絶対パスを渡します。画像は視覚的にレンダリングされ、Claude Code が直接推論できます。
 
 ## 注意事項
 
-- パスは絶対パスでなければならず、相対パスは不可
-- デフォルトでファイルの最初の 2000 行を読み取り
-- 2000 文字を超える行は切り詰められる
-- 出力は `cat -n` 形式で、行番号は 1 から開始
-- 大きな PDF（10 ページ超）は `pages` パラメータの指定が必須、1回最大 20 ページ
-- 存在しないファイルの読み取りはエラーを返す（クラッシュしない）
-- 単一メッセージ内で複数の Read を並列呼び出し可能
-
-## 原文
-
-<textarea readonly>Reads a file from the local filesystem. You can access any file directly by using this tool.
-Assume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.
-
-Usage:
-- The file_path parameter must be an absolute path, not a relative path
-- By default, it reads up to 2000 lines starting from the beginning of the file
-- You can optionally specify a line offset and limit (especially handy for long files), but it's recommended to read the whole file by not providing these parameters
-- Any lines longer than 2000 characters will be truncated
-- Results are returned using cat -n format, with line numbers starting at 1
-- This tool allows Claude Code to read images (eg PNG, JPG, etc). When reading an image file the contents are presented visually as Claude Code is a multimodal LLM.
-- This tool can read PDF files (.pdf). For large PDFs (more than 10 pages), you MUST provide the pages parameter to read specific page ranges (e.g., pages: "1-5"). Reading a large PDF without the pages parameter will fail. Maximum 20 pages per request.
-- This tool can read Jupyter notebooks (.ipynb files) and returns all cells with their outputs, combining code, text, and visualizations.
-- This tool can only read files, not directories. To read a directory, use an ls command via the Bash tool.
-- You can call multiple tools in a single response. It is always better to speculatively read multiple potentially useful files in parallel.
-- You will regularly be asked to read screenshots. If the user provides a path to a screenshot, ALWAYS use this tool to view the file at the path. This tool will work with all temporary file paths.
-- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.</textarea>
+- 常に絶対パスを優先してください。ユーザーが提供した場合、そのまま信頼してください。
+- 2000 文字を超える行は切り詰められます。極めて幅の広いデータに対しては、返された内容がクリップされている可能性があることを念頭に置いてください。
+- 独立した複数のファイルを読みますか？ 同じ応答で複数の `Read` 呼び出しを発行すると、並列で実行されます。
+- `Read` はディレクトリをリストできません。代わりに `Bash` の `ls` 呼び出しまたは `Glob` ツールを使用してください。
+- 既存だが空のファイルを読むと、ファイルバイトではなくシステムリマインダーが返されるので、その信号を明示的に処理してください。
+- 現在のセッションで同じファイルに `Edit` を使用する前に、成功した `Read` が必要です。

package/concepts/ja/Tool-RemoteTrigger.md

@@ -0,0 +1,73 @@
+# RemoteTrigger
+
+claude.ai のリモートトリガー API を呼び出し、スケジュールされたタスクとオンデマンドのトリガー実行を管理します。OAuth トークンはツール内部で処理され、モデルやシェルに公開されることはありません。
+
+## 使用タイミング
+
+- claude.ai 上のリモートエージェント（トリガー）の管理 — 既存トリガーの一覧表示、検査、更新を含む
+- cron ベースの自動化タスクの作成 — Claude エージェントを定期的なスケジュールで実行させる設定
+- 次回のスケジュール実行を待たずに既存のトリガーをオンデマンドで実行
+- すべての現在のトリガーを一覧表示または監査して、設定とステータスを確認
+- トリガーを再作成せずに、スケジュール、ペイロード、説明などのトリガー設定を更新
+
+## パラメータ
+
+- `action` (string, 必須): 実行する操作 — `list`、`get`、`create`、`update`、`run` のいずれか
+- `trigger_id` (string, `get`、`update`、`run` では必須): 操作するトリガーの識別子。パターン `^[\w-]+$`（単語文字とダッシュのみ）に一致する必要がある
+- `body` (object, `create` と `update` では必須；`run` では任意): API に送信されるリクエストペイロード
+
+## 例
+
+### 例 1: すべてのトリガーを一覧表示する
+
+```json
+{
+  "action": "list"
+}
+```
+
+`GET /v1/code/triggers` を呼び出し、認証済みアカウントに関連するすべてのトリガーの JSON 配列を返します。
+
+### 例 2: 毎週平日の朝に実行される新しいトリガーを作成する
+
+```json
+{
+  "action": "create",
+  "body": {
+    "name": "weekday-morning-report",
+    "schedule": "0 8 * * 1-5",
+    "description": "毎週平日 UTC 08:00 に日次サマリーを生成する"
+  }
+}
+```
+
+提供されたボディで `POST /v1/code/triggers` を呼び出し、割り当てられた `trigger_id` を含む新しく作成されたトリガーオブジェクトを返します。
+
+### 例 3: トリガーをオンデマンドで実行する
+
+```json
+{
+  "action": "run",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+スケジュールされた時刻をバイパスして、即座に `POST /v1/code/triggers/my-report-trigger/run` を呼び出します。
+
+### 例 4: 単一のトリガーを取得する
+
+```json
+{
+  "action": "get",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+`GET /v1/code/triggers/my-report-trigger` を呼び出し、完全なトリガー設定を返します。
+
+## 注意事項
+
+- OAuth トークンはツールによってプロセス内部に注入されます — トークンを手動でコピー、貼り付け、またはログに記録しないでください。これはセキュリティリスクを生じさせ、このツールを使用する場合は不要です。
+- すべてのトリガー API 呼び出しには、生の `curl` や他の HTTP クライアントではなくこのツールを使用してください。直接 HTTP を使用すると、セキュアなトークン注入がバイパスされ、認証情報が公開される可能性があります。
+- ツールは API からの生の JSON レスポンスを返します。呼び出し元はレスポンスを解析し、エラーステータスコードを処理する責任があります。
+- `trigger_id` の値はパターン `^[\w-]+$` に一致する必要があります — 英数字、アンダースコア、ダッシュのみが許可されます。スペースや特殊文字が含まれるとリクエストが失敗します。

package/concepts/ja/Tool-ScheduleWakeup.md

@@ -0,0 +1,56 @@
+# ScheduleWakeup
+
+`/loop` ダイナミックモードで作業を再開するタイミングをスケジュールします。このツールにより、Claude はタスクの反復ペースを自律的に制御し、指定した時間だけスリープしてから同じループプロンプトで再びトリガーできます。
+
+## 使用タイミング
+
+- 反復間隔が固定のクロックではなく作業状態に依存する `/loop` ダイナミックタスクで自律的にペースを制御する場合
+- 長いビルド、デプロイ、またはテスト実行が完了するまで待ってから結果を確認する場合
+- 現時点で監視すべき特定のシグナルがない場合に、反復間のアイドル待機を挿入する場合
+- ユーザープロンプトなしの自律ループを実行する場合——リテラルセンチネル `<<autonomous-loop-dynamic>>` を `prompt` として渡す
+- まもなく状態が変化するプロセスをポーリングする場合（短い遅延でキャッシュをウォームに保つ）
+
+## パラメータ
+
+- `delaySeconds`（数値、必須）：再開までの秒数。ランタイムが値を `[60, 3600]` に自動クランプするため、手動でクランプする必要はありません。
+- `reason`（文字列、必須）：選択した遅延時間の理由を説明する短い一文。ユーザーに表示され、テレメトリに記録されます。具体的に記述してください——「bun ビルドの完了を確認中」は「待機中」より有用です。
+- `prompt`（文字列、必須）：ウェイクアップ時にトリガーされる `/loop` 入力。次のトリガーがタスクを繰り返せるよう、毎ターン同じ文字列を渡します。ユーザープロンプトなしの自律ループの場合は、リテラルセンチネル `<<autonomous-loop-dynamic>>` を渡します。
+
+## 例
+
+### 例 1：急速に変化するシグナルを再確認するための短い遅延（キャッシュウォームを維持）
+
+ビルドが起動したばかりで、通常 2〜3 分で完了します。
+
+```json
+{
+  "delaySeconds": 120,
+  "reason": "約 2 分で完了予定の bun ビルドを確認中",
+  "prompt": "ビルドステータスを確認してエラーを報告する"
+}
+```
+
+120 秒の遅延により、会話コンテキストが Anthropic プロンプトキャッシュに保持されます（TTL 5 分）。次のウェイクアップはより高速で低コストになります。
+
+### 例 2：長いアイドル待機（キャッシュミスを受け入れ、より長い待機に分散）
+
+データベースマイグレーションが実行中で、通常 20〜40 分かかります。
+
+```json
+{
+  "delaySeconds": 1200,
+  "reason": "マイグレーションには通常 20〜40 分かかるため、20 分後に確認",
+  "prompt": "マイグレーションステータスを確認し、完了していれば続行する"
+}
+```
+
+ウェイクアップ時にキャッシュはコールドになりますが、20 分の待機は単一のキャッシュミスのコストを十分に分散させます。5 分ごとにポーリングすると、同じキャッシュミスコストを 4 回支払うことになり、何のメリットもありません。
+
+## 注意事項
+
+- **5 分のキャッシュ TTL**：Anthropic プロンプトキャッシュは 300 秒後に期限切れになります。300 秒未満の遅延はコンテキストをウォームに保ちます。300 秒を超えると、次のウェイクアップでキャッシュミスが発生します。
+- **ちょうど 300 秒は避ける**：これは最悪の選択です——キャッシュミスのコストを支払いながら、実質的に長い待機時間を得られません。270 秒に下げる（キャッシュウォームを維持）か、1200 秒以上にコミットする（1 回のキャッシュミスでより長い待機を確保）かのどちらかにしてください。
+- **アイドル待機のデフォルト値**：監視すべき特定のシグナルがない場合は、**1200〜1800 秒**（20〜30 分）を使用します。これにより、ループは定期的に確認しつつ、無意味なキャッシュミスを毎時 12 回発生させずに済みます。
+- **自動クランプ**：ランタイムは `delaySeconds` を `[60, 3600]` にクランプします。60 未満の値は 60 になり、3600 を超える値は 3600 になります。自分でこれらの境界を処理する必要はありません。
+- **ループを終了するには呼び出しを省略する**：反復を停止する場合は ScheduleWakeup を呼び出さないでください。呼び出しを省略するだけでループが終了します。
+- **毎ターン同じ `prompt` を渡す**：`prompt` フィールドには、毎回の呼び出しで元の `/loop` 指示を含める必要があります。これにより、次のウェイクアップがどのタスクを再開すべきかを認識できます。

package/concepts/ja/Tool-SendMessage.md

@@ -1,41 +1,68 @@
 # SendMessage
 
-## 定義
+アクティブなチーム内で 1 人のチームメンバーから別のチームメンバーにメッセージを配信するか、すべてのチームメイトに一度にブロードキャストします。これはチームメイトが聞ける唯一のチャンネルです — 通常のテキスト出力に書かれたものはチームメイトには見えません。
 
-チーム内の agent 間でメッセージを送信します。直接通信、ブロードキャスト、プロトコルメッセージ（シャットダウン要求/応答、プラン承認）に使用されます。
+## 使用タイミング
+
+- チーム協業中に名前付きチームメイトにタスクを割り当てたり、サブ問題を引き継ぐ。
+- 別のエージェントにステータス、中間結果、またはコードレビューを要求する。
+- `*` を介してチーム全体に決定、共有制約、またはシャットダウン通知をブロードキャストする。
+- シャットダウン要求やチームリーダーからのプラン承認要求などのプロトコルプロンプトに応答する。
+- 委任されたタスクの終わりにループを閉じ、リーダーがアイテムを完了としてマークできるようにする。
 
 ## パラメータ
 
-| パラメータ | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `to` | string | はい | 受信者：チームメンバー名、または `"*"` で全員にブロードキャスト |
-| `message` | string / object | はい | プレーンテキストメッセージまたは構造化プロトコルオブジェクト |
-| `summary` | string | いいえ | UI に表示される 5〜10 単語のプレビュー |
+- `to` (string, required): チームに登録されている対象チームメイトの `name`、または `*` ですべてのチームメイトに一度にブロードキャスト。
+- `message` (string or object, required): 通常の通信のためのプレーンテキスト、または `shutdown_response` や `plan_approval_response` のようなプロトコル応答のための構造化オブジェクト。
+- `summary` (string, optional): プレーンテキストメッセージのチームアクティビティログに表示される 5〜10 語のプレビュー。長い文字列メッセージには必須。`message` がプロトコルオブジェクトの場合は無視されます。
+
+## 例
+
+### 例 1: 直接タスクの引き継ぎ
+
+```
+SendMessage(
+  to="db-lead",
+  message="Please audit prisma/schema.prisma and list any model missing createdAt/updatedAt timestamps. Reply when done.",
+  summary="Audit schema for missing timestamps"
+)
+```
 
-## メッセージタイプ
+### 例 2: 共有制約のブロードキャスト
 
-### プレーンテキスト
-チームメンバー間の直接メッセージ。調整、ステータス更新、タスクに関する議論に使用します。
+```
+SendMessage(
+  to="*",
+  message="Reminder: do not touch files under legacy/ — that subtree is frozen until the migration PR lands.",
+  summary="Freeze legacy/ during migration"
+)
+```
 
-### シャットダウン要求
-チームメンバーに正常終了を要求：`{ type: "shutdown_request", reason: "..." }`
+### 例 3: プロトコル応答
 
-### シャットダウン応答
-チームメンバーがシャットダウンを承認または拒否：`{ type: "shutdown_response", approve: true/false }`
+構造化メッセージを使ってリーダーからのシャットダウン要求に応答します。
 
-### プラン承認応答
-チームメンバーのプランを承認または拒否：`{ type: "plan_approval_response", approve: true/false }`
+```
+SendMessage(
+  to="leader",
+  message={ "type": "shutdown_response", "ready": true, "final_report": "All assigned diff chunks committed on branch refactor-crew/db-lead." }
+)
+```
 
-## ブロードキャストとダイレクト
+### 例 4: プラン承認応答
 
-- **ダイレクト**（`to: "チームメンバー名"`）：特定のチームメンバーに送信 — ほとんどの通信で推奨
-- **ブロードキャスト**（`to: "*"`）：全チームメンバーに送信 — チーム全体への緊急通知にのみ使用
+```
+SendMessage(
+  to="leader",
+  message={ "type": "plan_approval_response", "approved": true, "notes": "LGTM, but please split step 4 into migration + backfill." }
+)
+```
 
-## 関連ツール
+## 注意事項
 
-| ツール | 目的 |
-|--------|------|
-| `TeamCreate` | 新しいチームを作成 |
-| `TeamDelete` | 完了後にチームを削除 |
-| `Agent` | チームに参加するチームメンバーを起動 |
-| `TaskCreate` / `TaskUpdate` / `TaskList` | 共有タスクリストの管理 |
+- 通常のアシスタントテキスト出力はチームメイトには伝わりません。別のエージェントに何かを見せたい場合は、`SendMessage` を通す必要があります。これはチームワークフローで最もよくある間違いです。
+- ブロードキャスト (`to: "*"`) は高コストです — すべてのチームメイトを起こし、彼らのコンテキストを消費します。本当に全員に影響するアナウンスのために予約してください。ターゲットを絞った送信を優先してください。
+- メッセージは簡潔で行動指向に保ってください。受信者が必要とするファイルパス、制約、期待される返信形式を含めてください。彼らにはあなたとの共有メモリがないことを覚えておいてください。
+- プロトコルメッセージオブジェクト (`shutdown_response`、`plan_approval_response`) は固定された形状を持ちます。プロトコルフィールドをプレーンテキストメッセージに混ぜたり、その逆をしないでください。
+- メッセージは非同期です。受信者は次のターンで受け取ります。返信があるまで、彼らが読んだり対応したと仮定しないでください。
+- よく書かれた `summary` は、リーダーにとってチームアクティビティログをスキャンしやすくします — コミットのサブジェクト行のように扱ってください。

package/concepts/ja/Tool-Skill.md

@@ -1,56 +1,47 @@
 # Skill
 
-## 定義
+現在の会話内で名前付きスキルを呼び出します。スキルは事前にパッケージ化された機能バンドル — ドメイン知識、ワークフロー、時にはツールアクセス — で、ハーネスがシステムリマインダーを介してアシスタントに公開します。
 
-メイン会話内でスキル（skill）を実行します。スキルはユーザーが slash command（例：`/commit`、`/review-pr`）で呼び出せる専用機能です。
+## 使用タイミング
 
-## パラメータ
+- ユーザーが `/review` や `/init` などのスラッシュコマンドを入力した場合 — スラッシュコマンドはスキルであり、このツールを通して実行する必要があります。
+- ユーザーが宣伝されているスキルのトリガー条件に一致するタスクを説明した場合 (例えば、繰り返される権限プロンプトについてトランスクリプトをスキャンするよう求めることは `fewer-permission-prompts` に一致します)。
+- スキルの記載された目的が、現在のファイル、リクエスト、または会話のコンテキストに直接一致する場合。
+- 特化した反復可能なワークフローがスキルとして利用可能で、アドホックなアプローチよりも正規の手順が望ましい場合。
+- ユーザーが「どのスキルが利用可能か」と尋ねた場合 — 宣伝されている名前をリストアップし、確認された場合にのみ呼び出してください。
 
-| パラメータ | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `skill` | string | はい | スキル名（例："commit"、"review-pr"、"pdf"） |
-| `args` | string | いいえ | スキルの引数 |
+## パラメータ
 
-## 使用シナリオ
+- `skill` (string, required): 現在の available-skills システムリマインダーにリストされているスキルの正確な名前。プラグイン名前空間のスキルには、完全修飾の `plugin:skill` 形式を使用してください (例えば `skill-creator:skill-creator`)。先頭のスラッシュは含めないでください。
+- `args` (string, optional): スキルに渡される自由形式の引数。形式と意味は各スキル自身のドキュメントで定義されます。
 
-**適している場合：**
-- ユーザーが `/<skill-name>` 形式の slash command を入力した
-- ユーザーのリクエストが登録済みスキルの機能にマッチする
+## 例
 
-**適していない場合：**
-- 組み込み CLI コマンド（例：`/help`、`/clear`）
-- 既に実行中のスキル
-- 利用可能なスキルリストにないスキル名
+### 例 1: 現在のブランチでレビュースキルを実行
 
-## 注意事項
+```
+Skill(skill="review")
+```
 
-- スキルが呼び出されると完全なプロンプトに展開される
-- 完全修飾名をサポート（例：`ms-office-suite:pdf`）
-- 利用可能なスキルリストは system-reminder メッセージで提供される
-- `<command-name>` タグが見えた場合はスキルが既にロード済みであり、このツールを再度呼び出さずに直接実行すべき
-- 実際にツールを呼び出さずにスキルに言及しないこと
+`review` スキルは、現在のベースブランチに対してプルリクエストをレビューするためのステップをパッケージ化します。呼び出すと、ハーネスで定義されたレビュー手順がターンにロードされます。
 
-## 原文
+### 例 2: 引数を持つプラグイン名前空間のスキルを呼び出す
 
-<textarea readonly>Execute a skill within the main conversation
+```
+Skill(
+  skill="skill-creator:skill-creator",
+  args="create a skill that summarizes git log for a given date range"
+)
+```
 
-When users ask you to perform tasks, check if any of the available skills match. Skills provide specialized capabilities and domain knowledge.
+リクエストを `skill-creator` プラグインのエントリポイントを通じてルーティングし、オーサリングワークフローが起動します。
 
-When users reference a "slash command" or "/<something>" (e.g., "/commit", "/review-pr"), they are referring to a skill. Use this tool to invoke it.
-
-How to invoke:
-- Use this tool with the skill name and optional arguments
-- Examples:
-  - `skill: "pdf"` - invoke the pdf skill
-  - `skill: "commit", args: "-m 'Fix bug'"` - invoke with arguments
-  - `skill: "review-pr", args: "123"` - invoke with arguments
-  - `skill: "ms-office-suite:pdf"` - invoke using fully qualified name
+## 注意事項
 
-Important:
-- Available skills are listed in system-reminder messages in the conversation
-- When a skill matches the user's request, this is a BLOCKING REQUIREMENT: invoke the relevant Skill tool BEFORE generating any other response about the task
-- NEVER mention a skill without actually calling this tool
-- Do not invoke a skill that is already running
-- Do not use this tool for built-in CLI commands (like /help, /clear, etc.)
-- If you see a <command-name> tag in the current conversation turn, the skill has ALREADY been loaded - follow the instructions directly instead of calling this tool again
-</textarea>
+- available-skills システムリマインダーに名前がそのまま表示されているスキル、またはユーザーがメッセージで `/name` として直接入力したスキルのみを呼び出してください。メモリやトレーニングデータからスキル名を推測したり発明したりしないでください — スキルが宣伝されていない場合、このツールを呼び出さないでください。
+- ユーザーのリクエストが宣伝されているスキルに一致する場合、`Skill` を呼び出すことはブロッキングの前提条件です。タスクに関する他の応答を生成する前に呼び出してください。スキルが何をするかを説明しないでください — 実行してください。
+- 実際に呼び出すことなく、スキルを名前で言及しないでください。ツールを呼び出さずにスキルをアナウンスすることは誤解を招きます。
+- `/help`、`/clear`、`/model`、`/exit` などの組み込み CLI コマンドには `Skill` を使用しないでください。これらはハーネスによって直接処理されます。
+- 現在のターンですでに実行中のスキルを再呼び出ししないでください。現在のターンで `<command-name>` タグが表示された場合、スキルはすでにロードされています — ツールを再度呼び出す代わりに、その場で指示に従ってください。
+- 複数のスキルが適用可能な場合は、最も具体的なものを選んでください。権限やフックの追加などの設定変更には、一般的な設定アプローチよりも `update-config` を優先してください。
+- スキルの実行により、ターンの残りに新しいシステムリマインダー、ツール、または制約が導入される可能性があります。スキル完了後に会話状態を再度読んでから進めてください。

package/concepts/ja/Tool-TaskCreate.md

@@ -1,78 +1,56 @@
 # TaskCreate
 
-## 定義
+現在のチームのタスクリスト (またはチームがアクティブでない場合はセッションのタスクリスト) に新しいタスクを作成します。追跡、委任、または後で再訪すべき作業項目を記録するために使用します。
 
-構造化されたタスクリストエントリを作成し、進捗の追跡、複雑なタスクの整理、ユーザーへの作業進捗の表示に使用します。
+## 使用タイミング
 
-## パラメータ
-
-| パラメータ | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `subject` | string | はい | 短いタスクタイトル、命令形を使用（例："Fix authentication bug"） |
-| `description` | string | はい | 詳細な説明、コンテキストと受け入れ基準を含む |
-| `activeForm` | string | いいえ | 進行中に表示する現在進行形テキスト（例："Fixing authentication bug"） |
-| `metadata` | object | いいえ | タスクに付加する任意のメタデータ |
-
-## 使用シナリオ
-
-**適している場合：**
-- 複雑なマルチステップタスク（3ステップ以上）
-- ユーザーが複数の TODO 項目を提供した
-- 計画モードで作業を追跡
-- ユーザーが明示的に todo リストの使用を要求
-
-**適していない場合：**
-- 単一の簡単なタスク
-- 3ステップ以内の簡単な操作
-- 純粋な会話や情報照会
+- ユーザーが明示的な追跡から恩恵を受けるマルチステップの作業を説明した場合。
+- 大きなリクエストを個別に完了可能な小さな単位に分割している場合。
+- タスクの途中でフォローアップが発見され、忘れるべきでない場合。
+- チームメイトやサブエージェントに作業を引き渡す前に、意図の永続的な記録が必要な場合。
+- プランモードで動作しており、各プランステップを具体的なタスクとして表現したい場合。
 
-## 注意事項
-
-- すべての新規タスクの初期ステータスは `pending`
-- `subject` は命令形（"Run tests"）、`activeForm` は現在進行形（"Running tests"）を使用
-- 作成後に TaskUpdate で依存関係（blocks/blockedBy）を設定可能
-- 作成前に TaskList を呼び出して重複タスクがないか確認すべき
-
-## 原文
+些細なワンショットアクション、純粋な会話、または 2〜3 の直接的なツール呼び出しで完了できるものには `TaskCreate` をスキップしてください。
 
-<textarea readonly>Use this tool to create a structured task list for your current coding session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user.
-It also helps the user understand the progress of the task and overall progress of their requests.
+## パラメータ
 
-## When to Use This Tool
+- `subject` (string, required): 短い命令型のタイトル。例 `Fix login redirect on Safari`。約 80 文字以内に保ってください。
+- `description` (string, required): 詳細なコンテキスト — 問題、制約、受け入れ基準、将来の読者が必要とするファイルやリンク。チームメイトがコールドでピックアップするかのように書いてください。
+- `activeForm` (string, optional): タスクが `in_progress` のときに表示される現在進行形のスピナーテキスト。例 `Fixing login redirect on Safari`。`subject` を反映しつつ -ing 形式にします。
+- `metadata` (object, optional): タスクに添付される任意の構造化データ。一般的な用途: ラベル、優先度ヒント、外部チケット ID、またはエージェント固有の設定。
 
-Use this tool proactively in these scenarios:
+新しく作成されたタスクは常にステータス `pending` と所有者なしで始まります。依存関係 (`blocks`、`blockedBy`) は作成時には設定されません — 後で `TaskUpdate` で適用してください。
 
-- Complex multi-step tasks - When a task requires 3 or more distinct steps or actions
-- Non-trivial and complex tasks - Tasks that require careful planning or multiple operations
-- Plan mode - When using plan mode, create a task list to track the work
-- User explicitly requests todo list - When the user directly asks you to use the todo list
-- User provides multiple tasks - When users provide a list of things to be done (numbered or comma-separated)
-- After receiving new instructions - Immediately capture user requirements as tasks
-- When you start working on a task - Mark it as in_progress BEFORE beginning work
-- After completing a task - Mark it as completed and add any new follow-up tasks discovered during implementation
+## 例
 
-## When NOT to Use This Tool
+### 例 1
 
-Skip using this tool when:
-- There is only a single, straightforward task
-- The task is trivial and tracking it provides no organizational benefit
-- The task can be completed in less than 3 trivial steps
-- The task is purely conversational or informational
+ユーザーが今提出したバグレポートをキャプチャします。
 
-NOTE that you should not use this tool if there is only one trivial task to do. In this case you are better off just doing the task directly.
+```
+TaskCreate(
+  subject: "Repair broken PDF export on Windows",
+  description: "Users on Windows 11 report the export button produces a 0-byte file. Reproduce with sample doc in test/fixtures/export/, then fix the code path in src/export/pdf.ts. Acceptance: export writes a valid PDF and the existing export test suite passes.",
+  activeForm: "Repairing broken PDF export on Windows"
+)
+```
 
-## Task Fields
+### 例 2
 
-- **subject**: A brief, actionable title in imperative form (e.g., "Fix authentication bug in login flow")
-- **description**: Detailed description of what needs to be done, including context and acceptance criteria
-- **activeForm**: Present continuous form shown in spinner when task is in_progress (e.g., "Fixing authentication bug"). This is displayed to the user while you work on the task.
+セッションの開始時にエピックを追跡単位に分割します。
 
-**IMPORTANT**: Always provide activeForm when creating tasks. The subject should be imperative ("Run tests") while activeForm should be present continuous ("Running tests"). All tasks are created with status `pending`.
+```
+TaskCreate(
+  subject: "Draft migration plan for auth service",
+  description: "Produce a written plan covering rollout stages, rollback strategy, and monitoring. Output: docs/auth-migration.md.",
+  activeForm: "Drafting migration plan for auth service",
+  metadata: { "priority": "P1", "linearId": "AUTH-214" }
+)
+```
 
-## Tips
+## 注意事項
 
-- Create tasks with clear, specific subjects that describe the outcome
-- Include enough detail in the description for another agent to understand and complete the task
-- After creating tasks, use TaskUpdate to set up dependencies (blocks/blockedBy) if needed
-- Check TaskList first to avoid creating duplicate tasks
-</textarea>
+- `subject` は命令形で、`activeForm` は現在進行形で書いてください。タスクが `in_progress` に遷移したときに UI が自然に読めるようになります。
+- 重複を避けるため、作成前に `TaskList` を呼び出してください — チームリストはチームメイトとサブエージェントと共有されます。
+- `description` や `metadata` にシークレットやクレデンシャルを含めないでください。タスクレコードはチームへのアクセス権を持つ全員に見えます。
+- 作成後は、`TaskUpdate` でタスクをライフサイクルに沿って移動させてください。`in_progress` で黙って放置しないでください。

package/concepts/ja/Tool-TaskGet.md

@@ -1,56 +1,47 @@
 # TaskGet
 
-## 定義
+ID で単一タスクの完全なレコードを取得します。説明、現在のステータス、所有者、メタデータ、依存関係エッジを含みます。`TaskList` が返すサマリでは不十分なときに使用します。
 
-タスク ID でタスクの完全な詳細を取得します。
+## 使用タイミング
 
-## パラメータ
-
-| パラメータ | 型 | 必須 | 説明 |
-|------------|------|------|------|
-| `taskId` | string | はい | 取得するタスクの ID |
-
-## 返却内容
+- `TaskList` からタスクをピックアップし、作業開始前に完全な説明が必要な場合。
+- タスクを `completed` としてマークしようとしており、受け入れ基準を再確認したい場合。
+- このタスクが何を `blocks` または `blockedBy` しているかを検査し、次の動きを決める必要がある場合。
+- 履歴を調査中 — 誰が所有しているか、どのメタデータが添付されたか、いつ状態が変わったか。
+- チームメイトまたは前のセッションがタスク ID を参照し、コンテキストが必要な場合。
 
-- `subject` — タスクタイトル
-- `description` — 詳細な要件とコンテキスト
-- `status` — ステータス：`pending`、`in_progress` または `completed`
-- `blocks` — このタスクによってブロックされているタスクのリスト
-- `blockedBy` — このタスクをブロックしている前提タスクのリスト
+高レベルのスキャンだけが必要な場合は `TaskList` を優先してください。`TaskGet` は注意深く読んだり変更したりする特定のレコードのために予約してください。
 
-## 使用シナリオ
+## パラメータ
 
-**適している場合：**
-- 作業開始前にタスクの完全な説明とコンテキストを取得
-- タスクの依存関係を理解
-- タスクを割り当てられた後に完全な要件を取得
+- `taskId` (string, required): `TaskCreate` または `TaskList` によって返されるタスク識別子。ID はタスクの生存期間中安定しています。
 
-## 注意事項
+## 例
 
-- タスク取得後、作業開始前に `blockedBy` リストが空であることを確認すべき
-- TaskList ですべてのタスクの要約情報を確認
+### 例 1
 
-## 原文
+リストで見たばかりのタスクを検索します。
 
-<textarea readonly>Use this tool to retrieve a task by its ID from the task list.
+```
+TaskGet(taskId: "t_01HXYZ...")
+```
 
-## When to Use This Tool
+典型的な応答フィールド: `id`、`subject`、`description`、`activeForm`、`status`、`owner`、`blocks`、`blockedBy`、`metadata`、`createdAt`、`updatedAt`。
 
-- When you need the full description and context before starting work on a task
-- To understand task dependencies (what it blocks, what blocks it)
-- After being assigned a task, to get complete requirements
+### 例 2
 
-## Output
+開始前に依存関係を解決します。
 
-Returns full task details:
-- **subject**: Task title
-- **description**: Detailed requirements and context
-- **status**: 'pending', 'in_progress', or 'completed'
-- **blocks**: Tasks waiting on this one to complete
-- **blockedBy**: Tasks that must complete before this one can start
+```
+TaskGet(taskId: "t_01HXYZ...")
+# blockedBy を検査 — 参照されたタスクがまだ pending
+# または in_progress の場合は、まずブロッカーに取り組んでください。
+```
 
-## Tips
+## 注意事項
 
-- After fetching a task, verify its blockedBy list is empty before beginning work.
-- Use TaskList to see all tasks in summary form.
-</textarea>
+- `TaskGet` は読み取り専用で、繰り返し呼び出しても安全です。ステータスや所有権を変更しません。
+- `blockedBy` が空でなく、`completed` されていないタスクを含んでいる場合、このタスクを開始しないでください — 先にブロッカーを解決 (または所有者と調整) してください。
+- `description` フィールドは長い場合があります。行動する前に完全に読んでください。斜め読みは受け入れ基準の見落としにつながります。
+- 不明または削除された `taskId` はエラーを返します。現在の ID を取得するために `TaskList` を再実行してください。
+- タスクを編集しようとしている場合は、チームメイトが今変更したフィールドを上書きしないように、最初に `TaskGet` を呼び出してください。