cc-viewer 1.3.1 → 1.3.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/concepts/ar/Tool-Agent.md +55 -0
- package/concepts/ar/Tool-Task.md +2 -0
- package/concepts/da/Tool-Agent.md +55 -0
- package/concepts/da/Tool-Task.md +2 -0
- package/concepts/de/Tool-Agent.md +55 -0
- package/concepts/de/Tool-Task.md +2 -0
- package/concepts/en/Tool-Agent.md +55 -0
- package/concepts/en/Tool-Task.md +2 -0
- package/concepts/es/Tool-Agent.md +55 -0
- package/concepts/es/Tool-Task.md +2 -0
- package/concepts/fr/Tool-Agent.md +55 -0
- package/concepts/fr/Tool-Task.md +2 -0
- package/concepts/it/Tool-Agent.md +55 -0
- package/concepts/it/Tool-Task.md +2 -0
- package/concepts/ja/Tool-Agent.md +55 -0
- package/concepts/ja/Tool-Task.md +2 -0
- package/concepts/ko/Tool-Agent.md +55 -0
- package/concepts/ko/Tool-Task.md +2 -0
- package/concepts/no/Tool-Agent.md +55 -0
- package/concepts/no/Tool-Task.md +2 -0
- package/concepts/pl/Tool-Agent.md +55 -0
- package/concepts/pl/Tool-Task.md +2 -0
- package/concepts/pt-BR/Tool-Agent.md +55 -0
- package/concepts/pt-BR/Tool-Task.md +2 -0
- package/concepts/ru/Tool-Agent.md +55 -0
- package/concepts/ru/Tool-Task.md +2 -0
- package/concepts/th/Tool-Agent.md +55 -0
- package/concepts/th/Tool-Task.md +2 -0
- package/concepts/tr/Tool-Agent.md +55 -0
- package/concepts/tr/Tool-Task.md +2 -0
- package/concepts/uk/Tool-Agent.md +55 -0
- package/concepts/uk/Tool-Task.md +2 -0
- package/concepts/zh/Tool-Agent.md +55 -0
- package/concepts/zh/Tool-Task.md +2 -0
- package/concepts/zh-TW/Tool-Agent.md +55 -0
- package/concepts/zh-TW/Tool-Task.md +2 -0
- package/dist/assets/{index-C8W8UYGw.js → index-DAPmWK2v.js} +94 -94
- package/dist/assets/{index-V2-sKBoM.css → index-Dsn6K9v-.css} +1 -1
- package/dist/index.html +2 -2
- package/interceptor.js +2 -1
- package/package.json +1 -1
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Agent
|
|
2
|
+
|
|
3
|
+
## التعريف
|
|
4
|
+
|
|
5
|
+
بدء وكيل فرعي (SubAgent) لمعالجة المهام المعقدة متعددة الخطوات بشكل مستقل. الوكلاء الفرعيون هم عمليات فرعية مستقلة، لكل منها مجموعة أدوات وسياق مخصص. Agent هو النسخة المعاد تسميتها من أداة Task في الإصدارات الأحدث من Claude Code.
|
|
6
|
+
|
|
7
|
+
## المعاملات
|
|
8
|
+
|
|
9
|
+
| المعامل | النوع | مطلوب | الوصف |
|
|
10
|
+
|---------|-------|-------|-------|
|
|
11
|
+
| `prompt` | string | نعم | وصف المهمة التي سينفذها الوكيل الفرعي |
|
|
12
|
+
| `description` | string | نعم | ملخص مختصر من 3-5 كلمات |
|
|
13
|
+
| `subagent_type` | string | نعم | نوع الوكيل الفرعي، يحدد مجموعة الأدوات المتاحة |
|
|
14
|
+
| `model` | enum | لا | تحديد النموذج (sonnet / opus / haiku)، الافتراضي يرث من الأصل |
|
|
15
|
+
| `max_turns` | integer | لا | الحد الأقصى لعدد الجولات |
|
|
16
|
+
| `run_in_background` | boolean | لا | هل يعمل في الخلفية، المهام الخلفية تُرجع مسار output_file |
|
|
17
|
+
| `resume` | string | لا | معرف الوكيل المراد استئنافه، يستمر من آخر تنفيذ. مفيد لاستئناف وكيل فرعي سابق دون فقدان السياق |
|
|
18
|
+
| `isolation` | enum | لا | وضع العزل، `worktree` ينشئ git worktree مؤقت |
|
|
19
|
+
|
|
20
|
+
## أنواع الوكلاء الفرعيين
|
|
21
|
+
|
|
22
|
+
| النوع | الغرض | الأدوات المتاحة |
|
|
23
|
+
|-------|--------|----------------|
|
|
24
|
+
| `Bash` | تنفيذ الأوامر، عمليات git | Bash |
|
|
25
|
+
| `general-purpose` | مهام عامة متعددة الخطوات | جميع الأدوات |
|
|
26
|
+
| `Explore` | استكشاف سريع لقاعدة الكود | جميع الأدوات باستثناء Agent/Edit/Write/NotebookEdit/ExitPlanMode |
|
|
27
|
+
| `Plan` | تصميم خطط التنفيذ | جميع الأدوات باستثناء Agent/Edit/Write/NotebookEdit/ExitPlanMode |
|
|
28
|
+
| `claude-code-guide` | أسئلة وأجوبة حول دليل استخدام Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
|
|
29
|
+
| `statusline-setup` | تكوين شريط الحالة | Read, Edit |
|
|
30
|
+
|
|
31
|
+
## سيناريوهات الاستخدام
|
|
32
|
+
|
|
33
|
+
**مناسب للاستخدام:**
|
|
34
|
+
- المهام المعقدة التي تتطلب إنجازاً مستقلاً متعدد الخطوات
|
|
35
|
+
- استكشاف قاعدة الكود والبحث المعمق (باستخدام نوع Explore)
|
|
36
|
+
- العمل المتوازي الذي يتطلب بيئة معزولة
|
|
37
|
+
- المهام طويلة المدة التي تحتاج للعمل في الخلفية
|
|
38
|
+
|
|
39
|
+
**غير مناسب للاستخدام:**
|
|
40
|
+
- قراءة مسار ملف محدد — استخدم Read أو Glob مباشرة
|
|
41
|
+
- البحث في 2-3 ملفات معروفة — استخدم Read مباشرة
|
|
42
|
+
- البحث عن تعريف فئة محددة — استخدم Glob مباشرة
|
|
43
|
+
|
|
44
|
+
## ملاحظات
|
|
45
|
+
|
|
46
|
+
- بعد اكتمال الوكيل الفرعي يُرجع رسالة واحدة، نتائجه غير مرئية للمستخدم ويحتاج الوكيل الرئيسي لنقلها
|
|
47
|
+
- يمكن إطلاق عدة استدعاءات Agent بالتوازي في رسالة واحدة لزيادة الكفاءة
|
|
48
|
+
- يتم فحص تقدم المهام الخلفية عبر أداة TaskOutput
|
|
49
|
+
- نوع Explore أبطأ من استدعاء Glob/Grep مباشرة، يُستخدم فقط عندما لا يكفي البحث البسيط
|
|
50
|
+
- استخدم `run_in_background: true` للمهام طويلة المدة التي لا تحتاج نتائج فورية؛ استخدم الوضع الأمامي (الافتراضي) عندما تكون النتيجة مطلوبة قبل المتابعة
|
|
51
|
+
- يتيح معامل `resume` استئناف جلسة وكيل فرعي بدأت سابقاً مع الحفاظ على السياق المتراكم
|
|
52
|
+
|
|
53
|
+
## الأهمية في cc-viewer
|
|
54
|
+
|
|
55
|
+
Agent هو الاسم الجديد لأداة Task في الإصدارات الأخيرة من Claude Code. ينتج استدعاء Agent سلسلة طلبات SubAgent، يمكن رؤية تسلسل طلبات فرعية مستقلة عن MainAgent في قائمة الطلبات. عادة ما تتميز طلبات SubAgent بـ system prompt مختصر وتعريفات أدوات أقل، مما يشكل تبايناً واضحاً مع MainAgent. في cc-viewer، قد يظهر اسم الأداة `Task` أو `Agent` حسب إصدار Claude Code المستخدم في المحادثة المسجلة.
|
package/concepts/ar/Tool-Task.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Task
|
|
2
2
|
|
|
3
|
+
> **ملاحظة:** في الإصدارات الأحدث من Claude Code، تمت إعادة تسمية هذه الأداة إلى **Agent**. راجع مستند [Tool-Agent](Tool-Agent).
|
|
4
|
+
|
|
3
5
|
## التعريف
|
|
4
6
|
|
|
5
7
|
بدء وكيل فرعي (SubAgent) لمعالجة المهام المعقدة متعددة الخطوات بشكل مستقل. الوكلاء الفرعيون هم عمليات فرعية مستقلة، لكل منها مجموعة أدوات وسياق مخصص.
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Agent
|
|
2
|
+
|
|
3
|
+
## Definition
|
|
4
|
+
|
|
5
|
+
Starter en sub-agent (SubAgent) til selvstændigt at håndtere komplekse flertrinsopgaver. Sub-agenter er uafhængige underprocesser, hver med deres eget dedikerede værktøjssæt og kontekst. Agent er den omdøbte version af Task-værktøjet i nyere Claude Code-versioner.
|
|
6
|
+
|
|
7
|
+
## Parametre
|
|
8
|
+
|
|
9
|
+
| Parameter | Type | Påkrævet | Beskrivelse |
|
|
10
|
+
|------|------|------|------|
|
|
11
|
+
| `prompt` | string | Ja | Beskrivelse af opgaven sub-agenten skal udføre |
|
|
12
|
+
| `description` | string | Ja | Kort resumé på 3-5 ord |
|
|
13
|
+
| `subagent_type` | string | Ja | Sub-agent-type, bestemmer det tilgængelige værktøjssæt |
|
|
14
|
+
| `model` | enum | Nej | Angiv model (sonnet / opus / haiku), standard arvet fra forælder |
|
|
15
|
+
| `max_turns` | integer | Nej | Maksimalt antal agentiske ture |
|
|
16
|
+
| `run_in_background` | boolean | Nej | Om den skal køre i baggrunden; baggrundsopgaver returnerer output_file-sti |
|
|
17
|
+
| `resume` | string | Nej | Agent-ID der skal genoptages, fortsætter fra sidste udførelse. Nyttigt til at genoptage en tidligere sub-agent uden at miste kontekst |
|
|
18
|
+
| `isolation` | enum | Nej | Isoleringstilstand, `worktree` opretter et midlertidigt git worktree |
|
|
19
|
+
|
|
20
|
+
## Sub-agent-typer
|
|
21
|
+
|
|
22
|
+
| Type | Formål | Tilgængelige værktøjer |
|
|
23
|
+
|------|------|----------|
|
|
24
|
+
| `Bash` | Kommandoudførelse, git-operationer | Bash |
|
|
25
|
+
| `general-purpose` | Generelle flertrinsopgaver | Alle værktøjer |
|
|
26
|
+
| `Explore` | Hurtig udforskning af kodebasen | Alle værktøjer undtagen Agent/Edit/Write/NotebookEdit/ExitPlanMode |
|
|
27
|
+
| `Plan` | Design af implementeringsplan | Alle værktøjer undtagen Agent/Edit/Write/NotebookEdit/ExitPlanMode |
|
|
28
|
+
| `claude-code-guide` | Q&A om Claude Code-brugsvejledning | Glob, Grep, Read, WebFetch, WebSearch |
|
|
29
|
+
| `statusline-setup` | Konfiguration af statuslinje | Read, Edit |
|
|
30
|
+
|
|
31
|
+
## Brugsscenarier
|
|
32
|
+
|
|
33
|
+
**Egnet til:**
|
|
34
|
+
- Komplekse opgaver der kræver selvstændig fuldførelse i flere trin
|
|
35
|
+
- Udforskning af kodebasen og dybdegående research (brug Explore-type)
|
|
36
|
+
- Parallelt arbejde der kræver isolerede miljøer
|
|
37
|
+
- Langvarige opgaver der skal køre i baggrunden
|
|
38
|
+
|
|
39
|
+
**Ikke egnet til:**
|
|
40
|
+
- Læse en specifik filsti — brug direkte Read eller Glob
|
|
41
|
+
- Søge i 2-3 kendte filer — brug direkte Read
|
|
42
|
+
- Søge efter en specifik klassedefinition — brug direkte Glob
|
|
43
|
+
|
|
44
|
+
## Bemærkninger
|
|
45
|
+
|
|
46
|
+
- Ved fuldførelse returnerer sub-agenten en enkelt besked; dens resultat er ikke synligt for brugeren og skal videreformidles af hovedagenten
|
|
47
|
+
- Man kan starte flere parallelle Agent-kald i en enkelt besked for at øge effektiviteten
|
|
48
|
+
- Baggrundsopgaver overvåges via TaskOutput-værktøjet
|
|
49
|
+
- Explore-typen er langsommere end direkte Glob/Grep-kald, brug den kun når simpel søgning ikke er tilstrækkelig
|
|
50
|
+
- Brug `run_in_background: true` til langvarige opgaver der ikke kræver øjeblikkeligt resultat; brug forgrundstilstand (standard) når resultatet er nødvendigt før man fortsætter
|
|
51
|
+
- `resume`-parameteren gør det muligt at fortsætte en tidligere startet sub-agent-session og bevare den akkumulerede kontekst
|
|
52
|
+
|
|
53
|
+
## Betydning i cc-viewer
|
|
54
|
+
|
|
55
|
+
Agent er det nye navn for Task-værktøjet i nyere Claude Code-versioner. Agent-kald genererer SubAgent-requestkæder, der i requestlisten kan ses som uafhængige underrequestsekvenser adskilt fra MainAgent. SubAgent-requests har typisk et forenklet system prompt og færre værktøjsdefinitioner, i tydelig kontrast til MainAgent. I cc-viewer kan værktøjsnavnene `Task` eller `Agent` forekomme afhængigt af den Claude Code-version der blev brugt i den optagede samtale.
|
package/concepts/da/Tool-Task.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Task
|
|
2
2
|
|
|
3
|
+
> **Bemærk:** I nyere versioner af Claude Code er dette værktøj omdøbt til **Agent**. Se dokumentet [Tool-Agent](Tool-Agent).
|
|
4
|
+
|
|
3
5
|
## Definition
|
|
4
6
|
|
|
5
7
|
Starter en sub-agent (SubAgent) til selvstændigt at håndtere komplekse flertrinsopgaver. Sub-agenter er uafhængige underprocesser, hver med deres eget dedikerede værktøjssæt og kontekst.
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Agent
|
|
2
|
+
|
|
3
|
+
## Definition
|
|
4
|
+
|
|
5
|
+
Startet einen Sub-Agent (SubAgent), der komplexe mehrstufige Aufgaben autonom bearbeitet. Sub-Agents sind unabhängige Unterprozesse mit jeweils eigenen Tool-Sets und Kontext. Agent ist die umbenannte Version des Task-Tools in neueren Claude Code-Versionen.
|
|
6
|
+
|
|
7
|
+
## Parameter
|
|
8
|
+
|
|
9
|
+
| Parameter | Typ | Erforderlich | Beschreibung |
|
|
10
|
+
|-----------|-----|--------------|--------------|
|
|
11
|
+
| `prompt` | string | Ja | Aufgabenbeschreibung für den Sub-Agent |
|
|
12
|
+
| `description` | string | Ja | Kurze Zusammenfassung in 3–5 Wörtern |
|
|
13
|
+
| `subagent_type` | string | Ja | Sub-Agent-Typ, bestimmt das verfügbare Tool-Set |
|
|
14
|
+
| `model` | enum | Nein | Modell angeben (sonnet / opus / haiku), Standard wird vom übergeordneten Agent geerbt |
|
|
15
|
+
| `max_turns` | integer | Nein | Maximale Anzahl agentischer Runden |
|
|
16
|
+
| `run_in_background` | boolean | Nein | Ob im Hintergrund ausgeführt werden soll; Hintergrundaufgaben geben den output_file-Pfad zurück |
|
|
17
|
+
| `resume` | string | Nein | Agent-ID zum Fortsetzen, setzt die letzte Ausführung fort. Nützlich, um einen vorherigen Sub-Agent ohne Kontextverlust fortzusetzen |
|
|
18
|
+
| `isolation` | enum | Nein | Isolationsmodus, `worktree` erstellt einen temporären Git-Worktree |
|
|
19
|
+
|
|
20
|
+
## Sub-Agent-Typen
|
|
21
|
+
|
|
22
|
+
| Typ | Zweck | Verfügbare Tools |
|
|
23
|
+
|-----|-------|------------------|
|
|
24
|
+
| `Bash` | Befehlsausführung, Git-Operationen | Bash |
|
|
25
|
+
| `general-purpose` | Allgemeine mehrstufige Aufgaben | Alle Tools |
|
|
26
|
+
| `Explore` | Schnelle Codebasis-Erkundung | Alle Tools außer Agent/Edit/Write/NotebookEdit/ExitPlanMode |
|
|
27
|
+
| `Plan` | Implementierungsplan entwerfen | Alle Tools außer Agent/Edit/Write/NotebookEdit/ExitPlanMode |
|
|
28
|
+
| `claude-code-guide` | Claude Code Nutzungsanleitung Q&A | Glob, Grep, Read, WebFetch, WebSearch |
|
|
29
|
+
| `statusline-setup` | Statusleiste konfigurieren | Read, Edit |
|
|
30
|
+
|
|
31
|
+
## Anwendungsfälle
|
|
32
|
+
|
|
33
|
+
**Geeignet für:**
|
|
34
|
+
- Komplexe Aufgaben, die mehrere autonome Schritte erfordern
|
|
35
|
+
- Codebasis-Erkundung und Tiefenrecherche (Explore-Typ verwenden)
|
|
36
|
+
- Parallele Arbeit, die eine isolierte Umgebung erfordert
|
|
37
|
+
- Lang laufende Aufgaben, die im Hintergrund ausgeführt werden müssen
|
|
38
|
+
|
|
39
|
+
**Nicht geeignet für:**
|
|
40
|
+
- Bestimmte Dateipfade lesen – direkt Read oder Glob verwenden
|
|
41
|
+
- In 2–3 bekannten Dateien suchen – direkt Read verwenden
|
|
42
|
+
- Bestimmte Klassendefinitionen suchen – direkt Glob verwenden
|
|
43
|
+
|
|
44
|
+
## Hinweise
|
|
45
|
+
|
|
46
|
+
- Nach Abschluss gibt der Sub-Agent eine einzelne Nachricht zurück; sein Ergebnis ist für den Benutzer nicht sichtbar und muss vom Haupt-Agent weitergegeben werden
|
|
47
|
+
- Mehrere parallele Agent-Aufrufe können in einer einzelnen Nachricht gestartet werden, um die Effizienz zu steigern
|
|
48
|
+
- Hintergrundaufgaben werden über das TaskOutput-Tool auf Fortschritt geprüft
|
|
49
|
+
- Der Explore-Typ ist langsamer als direkte Glob/Grep-Aufrufe; nur verwenden, wenn einfache Suchen nicht ausreichen
|
|
50
|
+
- Verwenden Sie `run_in_background: true` für lang laufende Aufgaben, die kein sofortiges Ergebnis benötigen; verwenden Sie den Vordergrundmodus (Standard), wenn das Ergebnis vor dem Fortfahren benötigt wird
|
|
51
|
+
- Der `resume`-Parameter ermöglicht die Fortsetzung einer zuvor gestarteten Sub-Agent-Sitzung unter Beibehaltung des angesammelten Kontexts
|
|
52
|
+
|
|
53
|
+
## Bedeutung in cc-viewer
|
|
54
|
+
|
|
55
|
+
Agent ist der neue Name des Task-Tools in neueren Claude Code-Versionen. Agent-Aufrufe erzeugen SubAgent-Anfrageketten, die in der Anfrageliste als eigenständige Unteranfragesequenzen unabhängig vom MainAgent sichtbar sind. SubAgent-Anfragen haben typischerweise einen kompakten System-Prompt und weniger Tool-Definitionen, was einen deutlichen Kontrast zum MainAgent bildet. In cc-viewer können je nach verwendeter Claude Code-Version in der aufgezeichneten Konversation die Tool-Namen `Task` oder `Agent` erscheinen.
|
package/concepts/de/Tool-Task.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Task
|
|
2
2
|
|
|
3
|
+
> **Hinweis:** In neueren Claude Code-Versionen wurde dieses Tool in **Agent** umbenannt. Siehe das [Tool-Agent](Tool-Agent)-Dokument.
|
|
4
|
+
|
|
3
5
|
## Definition
|
|
4
6
|
|
|
5
7
|
Startet einen Sub-Agent (SubAgent), der komplexe mehrstufige Aufgaben autonom bearbeitet. Sub-Agents sind unabhängige Unterprozesse mit jeweils eigenen Tool-Sets und Kontext.
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Agent
|
|
2
|
+
|
|
3
|
+
## Definition
|
|
4
|
+
|
|
5
|
+
Launches a SubAgent to autonomously handle complex multi-step tasks. SubAgents are independent subprocesses, each with their own dedicated tool set and context. Agent is the renamed version of the Task tool in newer Claude Code releases.
|
|
6
|
+
|
|
7
|
+
## Parameters
|
|
8
|
+
|
|
9
|
+
| Parameter | Type | Required | Description |
|
|
10
|
+
|-----------|------|----------|-------------|
|
|
11
|
+
| `prompt` | string | Yes | Description of the task for the SubAgent to execute |
|
|
12
|
+
| `description` | string | Yes | A 3-5 word short summary |
|
|
13
|
+
| `subagent_type` | string | Yes | SubAgent type, determines the available tool set |
|
|
14
|
+
| `model` | enum | No | Specify model (sonnet / opus / haiku), defaults to inheriting from parent |
|
|
15
|
+
| `max_turns` | integer | No | Maximum number of agentic turns |
|
|
16
|
+
| `run_in_background` | boolean | No | Whether to run in the background; background tasks return an output_file path |
|
|
17
|
+
| `resume` | string | No | Agent ID to resume, continues from the last execution. Useful for picking up where a previous SubAgent left off without losing context |
|
|
18
|
+
| `isolation` | enum | No | Isolation mode, `worktree` creates a temporary git worktree |
|
|
19
|
+
|
|
20
|
+
## SubAgent Types
|
|
21
|
+
|
|
22
|
+
| Type | Purpose | Available Tools |
|
|
23
|
+
|------|---------|-----------------|
|
|
24
|
+
| `Bash` | Command execution, git operations | Bash |
|
|
25
|
+
| `general-purpose` | General multi-step tasks | All tools |
|
|
26
|
+
| `Explore` | Quick codebase exploration | All tools except Agent/Edit/Write/NotebookEdit/ExitPlanMode |
|
|
27
|
+
| `Plan` | Design implementation plans | All tools except Agent/Edit/Write/NotebookEdit/ExitPlanMode |
|
|
28
|
+
| `claude-code-guide` | Claude Code usage guide Q&A | Glob, Grep, Read, WebFetch, WebSearch |
|
|
29
|
+
| `statusline-setup` | Configure status bar | Read, Edit |
|
|
30
|
+
|
|
31
|
+
## Use Cases
|
|
32
|
+
|
|
33
|
+
**Good for:**
|
|
34
|
+
- Complex tasks requiring multi-step autonomous completion
|
|
35
|
+
- Codebase exploration and deep research (using Explore type)
|
|
36
|
+
- Parallel work requiring isolated environments
|
|
37
|
+
- Long-running tasks that need to run in the background
|
|
38
|
+
|
|
39
|
+
**Not good for:**
|
|
40
|
+
- Reading a specific file path — use Read or Glob directly
|
|
41
|
+
- Searching within 2-3 known files — use Read directly
|
|
42
|
+
- Searching for a specific class definition — use Glob directly
|
|
43
|
+
|
|
44
|
+
## Notes
|
|
45
|
+
|
|
46
|
+
- After completion, the SubAgent returns a single message; its results are not visible to the user and need to be relayed by the main agent
|
|
47
|
+
- Multiple Agent calls can be issued in parallel within a single message for efficiency
|
|
48
|
+
- Background tasks are checked for progress via the TaskOutput tool
|
|
49
|
+
- The Explore type is slower than directly calling Glob/Grep; only use it when simple searches are insufficient
|
|
50
|
+
- Use `run_in_background: true` for long-running tasks that don't need immediate results; use foreground (default) when the main agent needs the result before proceeding
|
|
51
|
+
- The `resume` parameter allows continuing a previously started SubAgent session, preserving its accumulated context
|
|
52
|
+
|
|
53
|
+
## Significance in cc-viewer
|
|
54
|
+
|
|
55
|
+
Agent is the new name for the Task tool in recent Claude Code versions. Agent calls produce SubAgent request chains, which appear in the request list as sub-request sequences independent of MainAgent. SubAgent requests typically have streamlined system prompts and fewer tool definitions, forming a clear contrast with MainAgent. In cc-viewer, both `Task` and `Agent` tool names may appear depending on the Claude Code version used in the recorded conversation.
|
package/concepts/en/Tool-Task.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Task
|
|
2
2
|
|
|
3
|
+
> **Note:** In newer versions of Claude Code, this tool has been renamed to **Agent**. See the [Tool-Agent](Tool-Agent) document.
|
|
4
|
+
|
|
3
5
|
## Definition
|
|
4
6
|
|
|
5
7
|
Launches a SubAgent to autonomously handle complex multi-step tasks. SubAgents are independent subprocesses, each with their own dedicated tool set and context.
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Agent
|
|
2
|
+
|
|
3
|
+
## Definición
|
|
4
|
+
|
|
5
|
+
Inicia un sub-agent (SubAgent) para manejar de forma autónoma tareas complejas de múltiples pasos. Los sub-agents son subprocesos independientes, cada uno con su propio conjunto de herramientas y contexto dedicados. Agent es la versión renombrada de la herramienta Task en las versiones más recientes de Claude Code.
|
|
6
|
+
|
|
7
|
+
## Parámetros
|
|
8
|
+
|
|
9
|
+
| Parámetro | Tipo | Requerido | Descripción |
|
|
10
|
+
|-----------|------|-----------|-------------|
|
|
11
|
+
| `prompt` | string | Sí | Descripción de la tarea a ejecutar por el sub-agent |
|
|
12
|
+
| `description` | string | Sí | Resumen breve de 3-5 palabras |
|
|
13
|
+
| `subagent_type` | string | Sí | Tipo de sub-agent, determina el conjunto de herramientas disponibles |
|
|
14
|
+
| `model` | enum | No | Especificar modelo (sonnet / opus / haiku), por defecto hereda del padre |
|
|
15
|
+
| `max_turns` | integer | No | Número máximo de turnos agénticos |
|
|
16
|
+
| `run_in_background` | boolean | No | Si se ejecuta en segundo plano; las tareas en segundo plano devuelven la ruta del output_file |
|
|
17
|
+
| `resume` | string | No | ID del agent a reanudar, continúa desde la última ejecución. Útil para retomar un sub-agent anterior sin perder el contexto |
|
|
18
|
+
| `isolation` | enum | No | Modo de aislamiento, `worktree` crea un git worktree temporal |
|
|
19
|
+
|
|
20
|
+
## Tipos de sub-agent
|
|
21
|
+
|
|
22
|
+
| Tipo | Propósito | Herramientas disponibles |
|
|
23
|
+
|------|-----------|--------------------------|
|
|
24
|
+
| `Bash` | Ejecución de comandos, operaciones git | Bash |
|
|
25
|
+
| `general-purpose` | Tareas generales de múltiples pasos | Todas las herramientas |
|
|
26
|
+
| `Explore` | Exploración rápida de la base de código | Todas las herramientas excepto Agent/Edit/Write/NotebookEdit/ExitPlanMode |
|
|
27
|
+
| `Plan` | Diseñar planes de implementación | Todas las herramientas excepto Agent/Edit/Write/NotebookEdit/ExitPlanMode |
|
|
28
|
+
| `claude-code-guide` | Preguntas y respuestas sobre la guía de uso de Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
|
|
29
|
+
| `statusline-setup` | Configurar la barra de estado | Read, Edit |
|
|
30
|
+
|
|
31
|
+
## Casos de uso
|
|
32
|
+
|
|
33
|
+
**Adecuado para:**
|
|
34
|
+
- Tareas complejas que requieren completarse de forma autónoma en múltiples pasos
|
|
35
|
+
- Exploración de la base de código e investigación profunda (usar tipo Explore)
|
|
36
|
+
- Trabajo paralelo que necesita entornos aislados
|
|
37
|
+
- Tareas de larga duración que necesitan ejecutarse en segundo plano
|
|
38
|
+
|
|
39
|
+
**No adecuado para:**
|
|
40
|
+
- Leer rutas de archivos específicas — usar directamente Read o Glob
|
|
41
|
+
- Buscar en 2-3 archivos conocidos — usar directamente Read
|
|
42
|
+
- Buscar definiciones de clases específicas — usar directamente Glob
|
|
43
|
+
|
|
44
|
+
## Notas
|
|
45
|
+
|
|
46
|
+
- El sub-agent devuelve un solo mensaje al completarse, sus resultados no son visibles para el usuario y el agent principal necesita transmitirlos
|
|
47
|
+
- Se pueden lanzar múltiples llamadas Agent en paralelo en un solo mensaje para mejorar la eficiencia
|
|
48
|
+
- Las tareas en segundo plano verifican el progreso mediante la herramienta TaskOutput
|
|
49
|
+
- El tipo Explore es más lento que llamar directamente a Glob/Grep, usar solo cuando la búsqueda simple no es suficiente
|
|
50
|
+
- Use `run_in_background: true` para tareas de larga duración que no necesitan resultados inmediatos; use el modo en primer plano (predeterminado) cuando se necesita el resultado antes de continuar
|
|
51
|
+
- El parámetro `resume` permite continuar una sesión de sub-agent iniciada previamente, preservando el contexto acumulado
|
|
52
|
+
|
|
53
|
+
## Significado en cc-viewer
|
|
54
|
+
|
|
55
|
+
Agent es el nuevo nombre de la herramienta Task en las versiones recientes de Claude Code. Las llamadas a Agent producen cadenas de solicitudes SubAgent, visibles en la lista de solicitudes como secuencias de sub-solicitudes independientes del MainAgent. Las solicitudes SubAgent generalmente tienen un system prompt simplificado y menos definiciones de herramientas, formando un contraste claro con el MainAgent. En cc-viewer, pueden aparecer los nombres de herramienta `Task` o `Agent` según la versión de Claude Code utilizada en la conversación grabada.
|
package/concepts/es/Tool-Task.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Task
|
|
2
2
|
|
|
3
|
+
> **Nota:** En las versiones más recientes de Claude Code, esta herramienta ha sido renombrada a **Agent**. Consulte el documento [Tool-Agent](Tool-Agent).
|
|
4
|
+
|
|
3
5
|
## Definición
|
|
4
6
|
|
|
5
7
|
Inicia un sub-agent (SubAgent) para manejar de forma autónoma tareas complejas de múltiples pasos. Los sub-agents son subprocesos independientes, cada uno con su propio conjunto de herramientas y contexto dedicados.
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Agent
|
|
2
|
+
|
|
3
|
+
## Définition
|
|
4
|
+
|
|
5
|
+
Lance un sous-agent (SubAgent) pour gérer de manière autonome des tâches complexes multi-étapes. Les sous-agents sont des sous-processus indépendants, chacun avec son propre ensemble d'outils et contexte dédiés. Agent est la version renommée de l'outil Task dans les nouvelles versions de Claude Code.
|
|
6
|
+
|
|
7
|
+
## Paramètres
|
|
8
|
+
|
|
9
|
+
| Paramètre | Type | Requis | Description |
|
|
10
|
+
|-----------|------|--------|-------------|
|
|
11
|
+
| `prompt` | string | Oui | Description de la tâche à exécuter par le sous-agent |
|
|
12
|
+
| `description` | string | Oui | Résumé bref de 3-5 mots |
|
|
13
|
+
| `subagent_type` | string | Oui | Type de sous-agent, détermine l'ensemble d'outils disponibles |
|
|
14
|
+
| `model` | enum | Non | Spécifier le modèle (sonnet / opus / haiku), par défaut hérité du parent |
|
|
15
|
+
| `max_turns` | integer | Non | Nombre maximum de tours agentiques |
|
|
16
|
+
| `run_in_background` | boolean | Non | Si la tâche s'exécute en arrière-plan ; les tâches en arrière-plan renvoient le chemin du output_file |
|
|
17
|
+
| `resume` | string | Non | ID de l'agent à reprendre, continue depuis la dernière exécution. Utile pour reprendre un sous-agent précédent sans perdre le contexte |
|
|
18
|
+
| `isolation` | enum | Non | Mode d'isolation, `worktree` crée un git worktree temporaire |
|
|
19
|
+
|
|
20
|
+
## Types de sous-agents
|
|
21
|
+
|
|
22
|
+
| Type | Utilité | Outils disponibles |
|
|
23
|
+
|------|---------|-------------------|
|
|
24
|
+
| `Bash` | Exécution de commandes, opérations git | Bash |
|
|
25
|
+
| `general-purpose` | Tâches générales multi-étapes | Tous les outils |
|
|
26
|
+
| `Explore` | Exploration rapide de la base de code | Tous les outils sauf Agent/Edit/Write/NotebookEdit/ExitPlanMode |
|
|
27
|
+
| `Plan` | Concevoir des plans d'implémentation | Tous les outils sauf Agent/Edit/Write/NotebookEdit/ExitPlanMode |
|
|
28
|
+
| `claude-code-guide` | Questions-réponses sur le guide d'utilisation de Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
|
|
29
|
+
| `statusline-setup` | Configurer la barre d'état | Read, Edit |
|
|
30
|
+
|
|
31
|
+
## Cas d'utilisation
|
|
32
|
+
|
|
33
|
+
**Adapté pour :**
|
|
34
|
+
- Tâches complexes nécessitant une réalisation autonome en plusieurs étapes
|
|
35
|
+
- Exploration de la base de code et recherche approfondie (utiliser le type Explore)
|
|
36
|
+
- Travail parallèle nécessitant des environnements isolés
|
|
37
|
+
- Tâches de longue durée nécessitant une exécution en arrière-plan
|
|
38
|
+
|
|
39
|
+
**Non adapté pour :**
|
|
40
|
+
- Lire des chemins de fichiers spécifiques — utiliser directement Read ou Glob
|
|
41
|
+
- Rechercher dans 2-3 fichiers connus — utiliser directement Read
|
|
42
|
+
- Rechercher des définitions de classes spécifiques — utiliser directement Glob
|
|
43
|
+
|
|
44
|
+
## Notes
|
|
45
|
+
|
|
46
|
+
- Le sous-agent renvoie un seul message à la fin, ses résultats ne sont pas visibles pour l'utilisateur et l'agent principal doit les transmettre
|
|
47
|
+
- Plusieurs appels Agent peuvent être lancés en parallèle dans un seul message pour améliorer l'efficacité
|
|
48
|
+
- Les tâches en arrière-plan vérifient la progression via l'outil TaskOutput
|
|
49
|
+
- Le type Explore est plus lent que l'appel direct à Glob/Grep, à utiliser uniquement quand la recherche simple ne suffit pas
|
|
50
|
+
- Utilisez `run_in_background: true` pour les tâches longues ne nécessitant pas de résultat immédiat ; utilisez le mode premier plan (par défaut) quand le résultat est nécessaire avant de continuer
|
|
51
|
+
- Le paramètre `resume` permet de continuer une session de sous-agent précédemment démarrée, en préservant le contexte accumulé
|
|
52
|
+
|
|
53
|
+
## Signification dans cc-viewer
|
|
54
|
+
|
|
55
|
+
Agent est le nouveau nom de l'outil Task dans les versions récentes de Claude Code. Les appels Agent produisent des chaînes de requêtes SubAgent, visibles dans la liste des requêtes comme des séquences de sous-requêtes indépendantes du MainAgent. Les requêtes SubAgent ont généralement un system prompt simplifié et moins de définitions d'outils, formant un contraste net avec le MainAgent. Dans cc-viewer, les noms d'outils `Task` ou `Agent` peuvent apparaître selon la version de Claude Code utilisée dans la conversation enregistrée.
|
package/concepts/fr/Tool-Task.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Task
|
|
2
2
|
|
|
3
|
+
> **Note :** Dans les versions récentes de Claude Code, cet outil a été renommé en **Agent**. Voir le document [Tool-Agent](Tool-Agent).
|
|
4
|
+
|
|
3
5
|
## Définition
|
|
4
6
|
|
|
5
7
|
Lance un sous-agent (SubAgent) pour gérer de manière autonome des tâches complexes multi-étapes. Les sous-agents sont des sous-processus indépendants, chacun avec son propre ensemble d'outils et contexte dédiés.
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Agent
|
|
2
|
+
|
|
3
|
+
## Definizione
|
|
4
|
+
|
|
5
|
+
Avvia un sub agent (SubAgent) per gestire autonomamente task complessi multi-step. I sub agent sono sottoprocessi indipendenti, ciascuno con il proprio set di strumenti e contesto dedicati. Agent è la versione rinominata dello strumento Task nelle versioni più recenti di Claude Code.
|
|
6
|
+
|
|
7
|
+
## Parametri
|
|
8
|
+
|
|
9
|
+
| Parametro | Tipo | Obbligatorio | Descrizione |
|
|
10
|
+
|------|------|------|------|
|
|
11
|
+
| `prompt` | string | Sì | Descrizione del task da eseguire per il sub agent |
|
|
12
|
+
| `description` | string | Sì | Breve riepilogo di 3-5 parole |
|
|
13
|
+
| `subagent_type` | string | Sì | Tipo di sub agent, determina il set di strumenti disponibili |
|
|
14
|
+
| `model` | enum | No | Specifica il modello (sonnet / opus / haiku), predefinito ereditato dal padre |
|
|
15
|
+
| `max_turns` | integer | No | Numero massimo di turni agentici |
|
|
16
|
+
| `run_in_background` | boolean | No | Se eseguire in background; i task in background restituiscono il percorso output_file |
|
|
17
|
+
| `resume` | string | No | ID dell'agent da riprendere, continua dall'ultima esecuzione. Utile per riprendere un sub agent precedente senza perdere il contesto |
|
|
18
|
+
| `isolation` | enum | No | Modalità di isolamento, `worktree` crea un git worktree temporaneo |
|
|
19
|
+
|
|
20
|
+
## Tipi di sub agent
|
|
21
|
+
|
|
22
|
+
| Tipo | Scopo | Strumenti disponibili |
|
|
23
|
+
|------|------|----------|
|
|
24
|
+
| `Bash` | Esecuzione comandi, operazioni git | Bash |
|
|
25
|
+
| `general-purpose` | Task multi-step generici | Tutti gli strumenti |
|
|
26
|
+
| `Explore` | Esplorazione rapida del codebase | Tutti gli strumenti tranne Agent/Edit/Write/NotebookEdit/ExitPlanMode |
|
|
27
|
+
| `Plan` | Progettazione del piano di implementazione | Tutti gli strumenti tranne Agent/Edit/Write/NotebookEdit/ExitPlanMode |
|
|
28
|
+
| `claude-code-guide` | Q&A sulla guida all'uso di Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
|
|
29
|
+
| `statusline-setup` | Configurazione della barra di stato | Read, Edit |
|
|
30
|
+
|
|
31
|
+
## Scenari d'uso
|
|
32
|
+
|
|
33
|
+
**Adatto per:**
|
|
34
|
+
- Task complessi che richiedono il completamento autonomo in più step
|
|
35
|
+
- Esplorazione del codebase e ricerca approfondita (usando il tipo Explore)
|
|
36
|
+
- Lavoro parallelo che richiede ambienti isolati
|
|
37
|
+
- Task a lunga esecuzione che devono essere eseguiti in background
|
|
38
|
+
|
|
39
|
+
**Non adatto per:**
|
|
40
|
+
- Leggere un percorso file specifico — usare direttamente Read o Glob
|
|
41
|
+
- Cercare in 2-3 file noti — usare direttamente Read
|
|
42
|
+
- Cercare una definizione di classe specifica — usare direttamente Glob
|
|
43
|
+
|
|
44
|
+
## Note
|
|
45
|
+
|
|
46
|
+
- Al completamento, il sub agent restituisce un singolo messaggio; il suo risultato non è visibile all'utente e deve essere riportato dall'agent principale
|
|
47
|
+
- È possibile lanciare più chiamate Agent in parallelo in un singolo messaggio per migliorare l'efficienza
|
|
48
|
+
- I task in background vengono monitorati tramite lo strumento TaskOutput
|
|
49
|
+
- Il tipo Explore è più lento delle chiamate dirette a Glob/Grep, usarlo solo quando la ricerca semplice non è sufficiente
|
|
50
|
+
- Usare `run_in_background: true` per task a lunga esecuzione che non necessitano di risultati immediati; usare la modalità in primo piano (predefinita) quando il risultato è necessario prima di procedere
|
|
51
|
+
- Il parametro `resume` consente di continuare una sessione di sub agent avviata in precedenza, preservando il contesto accumulato
|
|
52
|
+
|
|
53
|
+
## Significato in cc-viewer
|
|
54
|
+
|
|
55
|
+
Agent è il nuovo nome dello strumento Task nelle versioni recenti di Claude Code. Le chiamate Agent generano catene di richieste SubAgent, visibili nella lista delle richieste come sequenze di sotto-richieste indipendenti dal MainAgent. Le richieste SubAgent hanno tipicamente un system prompt semplificato e meno definizioni di strumenti, in netto contrasto con il MainAgent. In cc-viewer, possono apparire i nomi strumento `Task` o `Agent` a seconda della versione di Claude Code utilizzata nella conversazione registrata.
|
package/concepts/it/Tool-Task.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Task
|
|
2
2
|
|
|
3
|
+
> **Nota:** Nelle versioni più recenti di Claude Code, questo strumento è stato rinominato in **Agent**. Vedere il documento [Tool-Agent](Tool-Agent).
|
|
4
|
+
|
|
3
5
|
## Definizione
|
|
4
6
|
|
|
5
7
|
Avvia un sub agent (SubAgent) per gestire autonomamente task complessi multi-step. I sub agent sono sottoprocessi indipendenti, ciascuno con il proprio set di strumenti e contesto dedicati.
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Agent
|
|
2
|
+
|
|
3
|
+
## 定義
|
|
4
|
+
|
|
5
|
+
サブ agent(SubAgent)を起動して、複雑なマルチステップタスクを自律的に処理します。サブ agent は独立したサブプロセスで、それぞれ専用のツールセットとコンテキストを持ちます。Agent は新しい Claude Code バージョンにおける Task ツールのリネーム版です。
|
|
6
|
+
|
|
7
|
+
## パラメータ
|
|
8
|
+
|
|
9
|
+
| パラメータ | 型 | 必須 | 説明 |
|
|
10
|
+
|------------|------|------|------|
|
|
11
|
+
| `prompt` | string | はい | サブ agent が実行するタスクの説明 |
|
|
12
|
+
| `description` | string | はい | 3〜5語の短い要約 |
|
|
13
|
+
| `subagent_type` | string | はい | サブ agent タイプ、利用可能なツールセットを決定 |
|
|
14
|
+
| `model` | enum | いいえ | モデルを指定(sonnet / opus / haiku)、デフォルトは親から継承 |
|
|
15
|
+
| `max_turns` | integer | いいえ | 最大 agentic ターン数 |
|
|
16
|
+
| `run_in_background` | boolean | いいえ | バックグラウンドで実行するかどうか。バックグラウンドタスクは output_file パスを返す |
|
|
17
|
+
| `resume` | string | いいえ | 再開する agent ID、前回の実行から続行。コンテキストを失わずに以前のサブ agent を引き継ぐのに有用 |
|
|
18
|
+
| `isolation` | enum | いいえ | 隔離モード、`worktree` で一時的な git worktree を作成 |
|
|
19
|
+
|
|
20
|
+
## サブ agent タイプ
|
|
21
|
+
|
|
22
|
+
| タイプ | 用途 | 利用可能なツール |
|
|
23
|
+
|--------|------|------------------|
|
|
24
|
+
| `Bash` | コマンド実行、git 操作 | Bash |
|
|
25
|
+
| `general-purpose` | 汎用マルチステップタスク | 全ツール |
|
|
26
|
+
| `Explore` | コードベースの高速探索 | Agent/Edit/Write/NotebookEdit/ExitPlanMode 以外のすべて |
|
|
27
|
+
| `Plan` | 実装方針の設計 | Agent/Edit/Write/NotebookEdit/ExitPlanMode 以外のすべて |
|
|
28
|
+
| `claude-code-guide` | Claude Code 使用ガイド Q&A | Glob, Grep, Read, WebFetch, WebSearch |
|
|
29
|
+
| `statusline-setup` | ステータスバーの設定 | Read, Edit |
|
|
30
|
+
|
|
31
|
+
## 使用シナリオ
|
|
32
|
+
|
|
33
|
+
**適している場合:**
|
|
34
|
+
- マルチステップで自律的に完了する必要がある複雑なタスク
|
|
35
|
+
- コードベースの探索と深い調査(Explore タイプを使用)
|
|
36
|
+
- 隔離環境が必要な並列作業
|
|
37
|
+
- バックグラウンドで実行する必要がある長時間タスク
|
|
38
|
+
|
|
39
|
+
**適していない場合:**
|
|
40
|
+
- 特定のファイルパスの読み取り——直接 Read または Glob を使用
|
|
41
|
+
- 2〜3個の既知ファイル内の検索——直接 Read を使用
|
|
42
|
+
- 特定のクラス定義の検索——直接 Glob を使用
|
|
43
|
+
|
|
44
|
+
## 注意事項
|
|
45
|
+
|
|
46
|
+
- サブ agent は完了後に単一メッセージを返し、その結果はユーザーには見えないため、メイン agent が伝達する必要がある
|
|
47
|
+
- 単一メッセージ内で複数の並列 Agent 呼び出しを発行して効率を向上できる
|
|
48
|
+
- バックグラウンドタスクは TaskOutput ツールで進捗を確認
|
|
49
|
+
- Explore タイプは直接 Glob/Grep を呼び出すより遅いため、単純な検索では不十分な場合にのみ使用
|
|
50
|
+
- 長時間実行で即座に結果が不要なタスクには `run_in_background: true` を推奨。結果が必要な場合はフォアグラウンド(デフォルト)を使用
|
|
51
|
+
- `resume` パラメータにより、以前開始したサブ agent セッションを継続でき、蓄積されたコンテキストを保持
|
|
52
|
+
|
|
53
|
+
## cc-viewer での意義
|
|
54
|
+
|
|
55
|
+
Agent は新しい Claude Code バージョンにおける Task ツールの新名称です。Agent 呼び出しは SubAgent リクエストチェーンを生成し、リクエストリストで MainAgent とは独立したサブリクエストシーケンスとして確認できます。SubAgent リクエストは通常、簡潔な system prompt と少ないツール定義を持ち、MainAgent と明確な対比を形成します。cc-viewer では、記録された会話で使用された Claude Code のバージョンに応じて、`Task` または `Agent` のいずれかのツール名が表示される場合があります。
|
package/concepts/ja/Tool-Task.md
CHANGED
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Agent
|
|
2
|
+
|
|
3
|
+
## 정의
|
|
4
|
+
|
|
5
|
+
서브 agent (SubAgent)를 시작하여 복잡한 다단계 태스크를 자율적으로 처리합니다. 서브 agent는 독립된 서브프로세스로, 각각 전용 도구 세트와 컨텍스트를 가집니다. Agent는 최신 Claude Code 버전에서 Task 도구의 이름이 변경된 버전입니다.
|
|
6
|
+
|
|
7
|
+
## 파라미터
|
|
8
|
+
|
|
9
|
+
| 파라미터 | 타입 | 필수 | 설명 |
|
|
10
|
+
|----------|------|------|------|
|
|
11
|
+
| `prompt` | string | 예 | 서브 agent가 실행할 태스크 설명 |
|
|
12
|
+
| `description` | string | 예 | 3~5단어의 짧은 요약 |
|
|
13
|
+
| `subagent_type` | string | 예 | 서브 agent 타입, 사용 가능한 도구 세트를 결정 |
|
|
14
|
+
| `model` | enum | 아니오 | 모델 지정 (sonnet / opus / haiku), 기본값은 부모로부터 상속 |
|
|
15
|
+
| `max_turns` | integer | 아니오 | 최대 agentic 턴 수 |
|
|
16
|
+
| `run_in_background` | boolean | 아니오 | 백그라운드 실행 여부. 백그라운드 태스크는 output_file 경로를 반환 |
|
|
17
|
+
| `resume` | string | 아니오 | 재개할 agent ID, 이전 실행에서 계속. 컨텍스트를 잃지 않고 이전 서브 agent를 이어받는 데 유용 |
|
|
18
|
+
| `isolation` | enum | 아니오 | 격리 모드, `worktree`로 임시 git worktree 생성 |
|
|
19
|
+
|
|
20
|
+
## 서브 agent 타입
|
|
21
|
+
|
|
22
|
+
| 타입 | 용도 | 사용 가능한 도구 |
|
|
23
|
+
|------|------|------------------|
|
|
24
|
+
| `Bash` | 명령 실행, git 작업 | Bash |
|
|
25
|
+
| `general-purpose` | 범용 다단계 태스크 | 전체 도구 |
|
|
26
|
+
| `Explore` | 코드베이스 빠른 탐색 | Agent/Edit/Write/NotebookEdit/ExitPlanMode 외 모든 도구 |
|
|
27
|
+
| `Plan` | 구현 방안 설계 | Agent/Edit/Write/NotebookEdit/ExitPlanMode 외 모든 도구 |
|
|
28
|
+
| `claude-code-guide` | Claude Code 사용 가이드 Q&A | Glob, Grep, Read, WebFetch, WebSearch |
|
|
29
|
+
| `statusline-setup` | 상태 표시줄 설정 | Read, Edit |
|
|
30
|
+
|
|
31
|
+
## 사용 시나리오
|
|
32
|
+
|
|
33
|
+
**적합한 경우:**
|
|
34
|
+
- 다단계로 자율 완료해야 하는 복잡한 태스크
|
|
35
|
+
- 코드베이스 탐색 및 심층 조사 (Explore 타입 사용)
|
|
36
|
+
- 격리 환경이 필요한 병렬 작업
|
|
37
|
+
- 백그라운드 실행이 필요한 장시간 태스크
|
|
38
|
+
|
|
39
|
+
**적합하지 않은 경우:**
|
|
40
|
+
- 특정 파일 경로 읽기 — 직접 Read 또는 Glob 사용
|
|
41
|
+
- 2~3개 알려진 파일 내 검색 — 직접 Read 사용
|
|
42
|
+
- 특정 클래스 정의 검색 — 직접 Glob 사용
|
|
43
|
+
|
|
44
|
+
## 주의사항
|
|
45
|
+
|
|
46
|
+
- 서브 agent는 완료 후 단일 메시지를 반환하며, 그 결과는 사용자에게 보이지 않으므로 메인 agent가 전달해야 함
|
|
47
|
+
- 단일 메시지 내에서 여러 병렬 Agent 호출을 발행하여 효율 향상 가능
|
|
48
|
+
- 백그라운드 태스크는 TaskOutput 도구로 진행 상황 확인
|
|
49
|
+
- Explore 타입은 직접 Glob/Grep 호출보다 느리므로, 단순 검색으로 충분하지 않을 때만 사용
|
|
50
|
+
- 장시간 실행되며 즉시 결과가 필요 없는 태스크에는 `run_in_background: true` 권장; 결과가 필요한 경우 포그라운드(기본값) 사용
|
|
51
|
+
- `resume` 파라미터를 통해 이전에 시작한 서브 agent 세션을 계속할 수 있으며, 축적된 컨텍스트를 유지
|
|
52
|
+
|
|
53
|
+
## cc-viewer에서의 의의
|
|
54
|
+
|
|
55
|
+
Agent는 최신 Claude Code 버전에서 Task 도구의 새 이름입니다. Agent 호출은 SubAgent 요청 체인을 생성하며, 요청 목록에서 MainAgent와 독립된 서브 요청 시퀀스로 확인할 수 있습니다. SubAgent 요청은 보통 간결한 system prompt와 적은 도구 정의를 가지며, MainAgent와 뚜렷한 대비를 이룹니다. cc-viewer에서는 기록된 대화에서 사용된 Claude Code 버전에 따라 `Task` 또는 `Agent` 도구 이름이 표시될 수 있습니다.
|