refactor(docs): reorganize docs by type and locale

2026-06-12 18:08:54 +00:00 · 2026-04-17 11:41:36 +08:00
parent 0da962c4b4
commit 4e1ceee62e
168 changed files with 759 additions and 720 deletions
@@ -0,0 +1,68 @@
+# 🔄 非同期タスクと Spawn
+
+> [README](../project/README.ja.md) に戻る
+
+### Spawn を使用した非同期タスク
+
+長時間実行タスク（Web 検索、API 呼び出し）には、`spawn` ツールを使用して**サブ Agent (subagent)** を作成します：
+
+```markdown
+# Periodic Tasks
+
+## Quick Tasks (respond directly)
+
+- Report current time
+
+## Long Tasks (use spawn for async)
+
+- Search the web for AI news and summarize
+- Check email and report important messages
+```
+
+**主な動作：**
+
+| 特性             | 説明                                             |
+| ---------------- | ------------------------------------------------ |
+| **spawn**        | 非同期サブ Agent を作成、メインハートビートをブロックしない |
+| **独立コンテキスト** | サブ Agent は独自のコンテキストを持ち、セッション履歴なし |
+| **message tool** | サブ Agent は message ツールでユーザーと直接通信   |
+| **ノンブロッキング** | spawn 後、ハートビートは次のタスクに進む         |
+
+#### サブ Agent の通信の仕組み
+
+```
+ハートビートトリガー (Heartbeat triggers)
+    ↓
+Agent が HEARTBEAT.md を読み取り
+    ↓
+長時間タスクの場合: サブ Agent を spawn
+    ↓                           ↓
+次のタスクに進む             サブ Agent が独立して作業
+    ↓                           ↓
+すべてのタスク完了           サブ Agent が "message" ツールを使用
+    ↓                           ↓
+HEARTBEAT_OK を応答          ユーザーが直接結果を受信
+```
+
+サブ Agent はツール（message、web_search など）にアクセスでき、メイン Agent を経由せずにユーザーと独立して通信できます。
+
+**設定：**
+
+```json
+{
+  "heartbeat": {
+    "enabled": true,
+    "interval": 30
+  }
+}
+```
+
+| オプション | デフォルト値 | 説明                           |
+| ---------- | ------------ | ------------------------------ |
+| `enabled`  | `true`       | ハートビートの有効/無効        |
+| `interval` | `30`         | チェック間隔（分単位、最小: 5）|
+
+**環境変数:**
+
+- `PICOCLAW_HEARTBEAT_ENABLED=false` で無効化
+- `PICOCLAW_HEARTBEAT_INTERVAL=60` で間隔を変更