cc-viewer 1.6.182 → 1.6.183

package/concepts/pl/Tool-Skill.md

@@ -1,56 +1,47 @@
 # Skill
 
-## Definicja
+Wywołuje nazwany skill wewnątrz bieżącej rozmowy. Skille to wstępnie spakowane pakiety możliwości — wiedza dziedzinowa, przepływy pracy, a czasem dostęp do narzędzi — które środowisko udostępnia asystentowi poprzez przypomnienia systemowe.
 
-Wykonuje umiejętność (skill) w głównej rozmowie. Umiejętności to specjalizowane zdolności, które użytkownik może wywoływać za pomocą slash command (np. `/commit`, `/review-pr`).
+## Kiedy używać
 
-## Parametry
+- Użytkownik wpisuje komendę ukośnikową, taką jak `/review` czy `/init` — komendy ukośnikowe to skille i muszą być wykonywane przez to narzędzie.
+- Użytkownik opisuje zadanie, które pasuje do warunków wyzwalających reklamowanego skilla (na przykład prośba o skanowanie transkryptów w celu wykrycia powtarzających się monitów o uprawnienia pasuje do `fewer-permission-prompts`).
+- Zadeklarowany cel skilla jest bezpośrednim dopasowaniem do bieżącego pliku, żądania lub kontekstu rozmowy.
+- Wyspecjalizowane, powtarzalne przepływy pracy są dostępne jako skille i kanoniczna procedura jest preferowana nad ad-hoc.
+- Użytkownik pyta "jakie skille są dostępne" — wylistuj reklamowane nazwy i wywołuj tylko po potwierdzeniu.
 
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `skill` | string | Tak | Nazwa umiejętności (np. "commit", "review-pr", "pdf") |
-| `args` | string | Nie | Argumenty umiejętności |
+## Parametry
 
-## Scenariusze użycia
+- `skill` (string, wymagany): Dokładna nazwa skilla wylistowana w bieżącym przypomnieniu systemowym dostępnych skilli. Dla skilli z przestrzenią nazw wtyczki użyj w pełni kwalifikowanej formy `plugin:skill` (na przykład `skill-creator:skill-creator`). Nie dodawaj początkowego ukośnika.
+- `args` (string, opcjonalny): Argumenty w dowolnym formacie przekazywane do skilla. Format i semantyka są zdefiniowane przez własną dokumentację każdego skilla.
 
-**Odpowiednie zastosowanie:**
-- Użytkownik wpisał slash command w formacie `/<skill-name>`
-- Żądanie użytkownika pasuje do funkcjonalności zarejestrowanej umiejętności
+## Przykłady
 
-**Nieodpowiednie zastosowanie:**
-- Wbudowane polecenia CLI (np. `/help`, `/clear`)
-- Umiejętność już jest w trakcie wykonywania
-- Nazwa umiejętności nie znajduje się na liście dostępnych umiejętności
+### Przykład 1: Uruchom skill review na bieżącej gałęzi
 
-## Uwagi
+```
+Skill(skill="review")
+```
 
-- Po wywołaniu umiejętność rozwija się w pełny prompt
-- Obsługuje w pełni kwalifikowane nazwy (np. `ms-office-suite:pdf`)
-- Lista dostępnych umiejętności jest podawana w wiadomościach system-reminder
-- Gdy widoczny jest tag `<command-name>`, oznacza to, że umiejętność została załadowana — należy ją bezpośrednio wykonać, a nie ponownie wywoływać to narzędzie
-- Nie wspominaj o umiejętności bez faktycznego wywołania narzędzia
+Skill `review` pakuje kroki do przeglądu pull requesta względem bieżącej gałęzi bazowej. Wywołanie go ładuje procedurę przeglądu zdefiniowaną przez środowisko do tury.
 
-## Tekst oryginalny
+### Przykład 2: Wywołanie skilla z przestrzeni nazw wtyczki z argumentami
 
-<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.
+Kieruje żądanie przez punkt wejścia wtyczki `skill-creator`, aby uruchomił się przepływ pracy autorski.
 
-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
+## Uwagi
 
-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>
+- Wywołuj tylko skille, których nazwy pojawiają się dosłownie w przypomnieniu systemowym dostępnych skilli, lub skille, które użytkownik wpisał bezpośrednio jako `/nazwa` w swojej wiadomości. Nigdy nie zgaduj ani nie wymyślaj nazw skilli z pamięci lub danych treningowych — jeśli skill nie jest reklamowany, nie wywołuj tego narzędzia.
+- Gdy żądanie użytkownika pasuje do reklamowanego skilla, wywołanie `Skill` jest blokującym warunkiem wstępnym: wywołaj je przed wygenerowaniem jakiejkolwiek innej odpowiedzi dotyczącej zadania. Nie opisuj, co skill zrobiłby — uruchom go.
+- Nigdy nie wymieniaj skilla z nazwy bez faktycznego wywołania go. Zapowiadanie skilla bez wywołania narzędzia jest mylące.
+- Nie używaj `Skill` dla wbudowanych komend CLI, takich jak `/help`, `/clear`, `/model` czy `/exit`. Są one obsługiwane bezpośrednio przez środowisko.
+- Nie wywołuj ponownie skilla, który już działa w bieżącej turze. Jeśli widzisz znacznik `<command-name>` w bieżącej turze, skill został już załadowany — postępuj zgodnie z jego instrukcjami, zamiast wywoływać narzędzie ponownie.
+- Jeśli kilka skilli mogłoby pasować, wybierz najbardziej specyficzny. Dla zmian konfiguracyjnych, takich jak dodawanie uprawnień lub hooków, preferuj `update-config` nad ogólne podejście do ustawień.
+- Wykonanie skilla może wprowadzić nowe przypomnienia systemowe, narzędzia lub ograniczenia na resztę tury. Przeczytaj ponownie stan rozmowy po zakończeniu skilla, zanim kontynuujesz.

package/concepts/pl/Tool-TaskCreate.md

@@ -1,78 +1,56 @@
 # TaskCreate
 
-## Definicja
+Tworzy nowe zadanie na liście zadań bieżącego zespołu (lub na liście zadań sesji, gdy żaden zespół nie jest aktywny). Użyj, aby uchwycić elementy pracy, które powinny być śledzone, delegowane lub odwiedzane ponownie później.
 
-Tworzy strukturalny wpis na liście zadań, służący do śledzenia postępu, organizacji złożonych zadań i prezentowania użytkownikowi postępu prac.
+## Kiedy używać
 
-## Parametry
-
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `subject` | string | Tak | Krótki tytuł zadania w trybie rozkazującym (np. "Fix authentication bug") |
-| `description` | string | Tak | Szczegółowy opis, zawierający kontekst i kryteria akceptacji |
-| `activeForm` | string | Nie | Tekst w czasie teraźniejszym ciągłym wyświetlany podczas wykonywania (np. "Fixing authentication bug") |
-| `metadata` | object | Nie | Dowolne metadane dołączone do zadania |
-
-## Scenariusze użycia
-
-**Odpowiednie zastosowanie:**
-- Złożone wieloetapowe zadania (ponad 3 kroki)
-- Użytkownik podał wiele elementów do wykonania
-- Śledzenie pracy w trybie planowania
-- Użytkownik wyraźnie poprosił o użycie listy todo
-
-**Nieodpowiednie zastosowanie:**
-- Pojedyncze proste zadanie
-- Proste operacje w mniej niż 3 krokach
-- Czysta rozmowa lub zapytanie informacyjne
+- Użytkownik opisuje wieloetapowy element pracy, który korzysta z jawnego śledzenia.
+- Rozbijasz duże żądanie na mniejsze, oddzielnie ukańczalne jednostki.
+- Odkryto kolejny krok w trakcie zadania i nie powinien zostać zapomniany.
+- Potrzebujesz trwałego zapisu intencji przed przekazaniem pracy współpracownikowi lub podagentowi.
+- Działasz w trybie planowania i chcesz, aby każdy krok planu był reprezentowany jako konkretne zadanie.
 
-## Uwagi
-
-- Wszystkie nowo utworzone zadania mają początkowy status `pending`
-- `subject` używa trybu rozkazującego ("Run tests"), `activeForm` używa czasu teraźniejszego ciągłego ("Running tests")
-- Po utworzeniu zadania można ustawić zależności (blocks/blockedBy) za pomocą TaskUpdate
-- Przed utworzeniem należy wywołać TaskList, aby sprawdzić, czy nie ma duplikatów
-
-## Tekst oryginalny
+Pomiń `TaskCreate` dla trywialnych, jednorazowych akcji, czystych rozmów lub czegokolwiek, co można ukończyć w dwóch lub trzech bezpośrednich wywołaniach narzędzi.
 
-<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.
+## Parametry
 
-## When to Use This Tool
+- `subject` (string, wymagany): Krótki tytuł w trybie rozkazującym, np. `Fix login redirect on Safari`. Utrzymuj poniżej około osiemdziesięciu znaków.
+- `description` (string, wymagany): Szczegółowy kontekst — problem, ograniczenia, kryteria akceptacji oraz wszelkie pliki lub linki potrzebne przyszłemu czytelnikowi. Pisz tak, jakby współpracownik miał odebrać to na zimno.
+- `activeForm` (string, opcjonalny): Tekst wskaźnika w czasie ciągłym teraźniejszym pokazywany, gdy zadanie jest `in_progress`, np. `Fixing login redirect on Safari`. Odzwierciedla `subject`, ale w formie z -ing.
+- `metadata` (obiekt, opcjonalny): Dowolne ustrukturyzowane dane dołączone do zadania. Typowe zastosowania: etykiety, wskazówki priorytetowe, ID ticketów zewnętrznych lub konfiguracja specyficzna dla agenta.
 
-Use this tool proactively in these scenarios:
+Nowo utworzone zadania zawsze zaczynają ze statusem `pending` i bez właściciela. Zależności (`blocks`, `blockedBy`) nie są ustawiane przy tworzeniu — zastosuj je później za pomocą `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
+## Przykłady
 
-## When NOT to Use This Tool
+### Przykład 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
+Uchwyć raport błędu, który użytkownik właśnie zgłosił.
 
-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
+### Przykład 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.
+Podziel epik na śledzone jednostki na początku sesji.
 
-**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
+## Uwagi
 
-- 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>
+- Pisz `subject` w trybie rozkazującym, a `activeForm` w czasie ciągłym teraźniejszym, aby interfejs brzmiał naturalnie, gdy zadanie przechodzi do `in_progress`.
+- Wywołaj `TaskList` przed utworzeniem, aby uniknąć duplikatów — lista zespołu jest współdzielona ze współpracownikami i podagentami.
+- Nie umieszczaj sekretów ani poświadczeń w `description` lub `metadata`; rekordy zadań są widoczne dla każdego z dostępem do zespołu.
+- Po utworzeniu przesuwaj zadanie przez jego cykl życia za pomocą `TaskUpdate`. Nie pozostawiaj pracy po cichu porzuconej w `in_progress`.

package/concepts/pl/Tool-TaskGet.md

@@ -1,56 +1,47 @@
 # TaskGet
 
-## Definicja
+Pobiera pełny rekord pojedynczego zadania po ID, wraz z jego opisem, bieżącym statusem, właścicielem, metadanymi i krawędziami zależności. Użyj, gdy podsumowanie zwrócone przez `TaskList` nie wystarcza, aby działać na zadaniu.
 
-Pobiera pełne szczegóły zadania na podstawie jego ID.
+## Kiedy używać
 
-## Parametry
-
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `taskId` | string | Tak | ID zadania do pobrania |
-
-## Zwracana zawartość
+- Wybrałeś zadanie z `TaskList` i potrzebujesz pełnego opisu przed rozpoczęciem pracy.
+- Zaraz oznaczysz zadanie jako `completed` i chcesz ponownie sprawdzić kryteria akceptacji.
+- Musisz sprawdzić, jakie zadania to blokuje lub przez co jest `blockedBy`, aby zdecydować o kolejnym ruchu.
+- Badasz historię — kto jest właścicielem, jakie metadane zostały dołączone, kiedy zmienił się stan.
+- Współpracownik lub wcześniejsza sesja odwołała się do ID zadania i potrzebujesz kontekstu.
 
-- `subject` — tytuł zadania
-- `description` — szczegółowe wymagania i kontekst
-- `status` — status: `pending`, `in_progress` lub `completed`
-- `blocks` — lista zadań zablokowanych przez to zadanie
-- `blockedBy` — lista zadań poprzedzających, które blokują to zadanie
+Preferuj `TaskList`, gdy potrzebujesz tylko przeglądu wysokiego poziomu; zarezerwuj `TaskGet` dla konkretnego rekordu, który zamierzasz dokładnie przeczytać lub zmodyfikować.
 
-## Scenariusze użycia
+## Parametry
 
-**Odpowiednie zastosowanie:**
-- Pobranie pełnego opisu i kontekstu zadania przed rozpoczęciem pracy
-- Zrozumienie zależności zadania
-- Pobranie pełnych wymagań po przydzieleniu zadania
+- `taskId` (string, wymagany): Identyfikator zadania zwrócony przez `TaskCreate` lub `TaskList`. Identyfikatory są stałe przez cały okres życia zadania.
 
-## Uwagi
+## Przykłady
 
-- Po pobraniu zadania należy sprawdzić, czy lista `blockedBy` jest pusta, zanim rozpocznie się pracę
-- Użyj TaskList, aby zobaczyć podsumowanie wszystkich zadań
+### Przykład 1
 
-## Tekst oryginalny
+Wyszukaj zadanie, które właśnie zobaczyłeś na liście.
 
-<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
+Typowe pola odpowiedzi: `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
+### Przykład 2
 
-## Output
+Rozwiąż zależności przed rozpoczęciem.
 
-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...")
+# Inspect blockedBy — if any referenced task is still pending
+# or in_progress, work on the blocker first.
+```
 
-## Tips
+## Uwagi
 
-- After fetching a task, verify its blockedBy list is empty before beginning work.
-- Use TaskList to see all tasks in summary form.
-</textarea>
+- `TaskGet` jest tylko do odczytu i bezpieczne w powtarzalnych wywołaniach; nie zmienia statusu ani własności.
+- Jeśli `blockedBy` jest niepuste i zawiera zadania, które nie są `completed`, nie zaczynaj tego zadania — najpierw rozwiąż blokady (lub koordynuj z ich właścicielem).
+- Pole `description` może być długie. Przeczytaj je w całości przed działaniem; pobieżne czytanie prowadzi do pominiętych kryteriów akceptacji.
+- Nieznany lub usunięty `taskId` zwraca błąd. Uruchom ponownie `TaskList`, aby wybrać bieżący ID.
+- Jeśli zamierzasz edytować zadanie, najpierw wywołaj `TaskGet`, aby uniknąć nadpisania pól, które współpracownik właśnie zmienił.

package/concepts/pl/Tool-TaskList.md

@@ -1,56 +1,62 @@
 # TaskList
 
-## Definicja
+Zwraca każde zadanie w bieżącym zespole (lub sesji) w formie podsumowania. Użyj, aby przejrzeć zaległe prace, zdecydować, co podjąć dalej, i uniknąć tworzenia duplikatów.
 
-Wyświetla listę wszystkich zadań na liście zadań, umożliwiając przegląd ogólnego postępu i dostępnej pracy.
+## Kiedy używać
+
+- Na początku sesji, aby zobaczyć, co jest już śledzone.
+- Przed wywołaniem `TaskCreate`, aby potwierdzić, że praca nie jest już uchwycona.
+- Przy decydowaniu, które zadanie roszczyć jako współpracownik lub podagent.
+- Aby szybko zweryfikować relacje zależności w zespole.
+- Okresowo podczas długich sesji, aby ponownie zsynchronizować się ze współpracownikami, którzy mogli rościć, ukończyć lub dodać zadania.
+
+`TaskList` jest tylko do odczytu i tani; wywołuj swobodnie, gdy potrzebujesz przeglądu.
 
 ## Parametry
 
-Brak parametrów.
+`TaskList` nie przyjmuje parametrów. Zawsze zwraca pełny zbiór zadań dla aktywnego kontekstu.
 
-## Zwracana zawartość
+## Kształt odpowiedzi
 
-Podsumowanie każdego zadania:
-- `id` — identyfikator zadania
-- `subject` — krótki opis
-- `status` — status: `pending`, `in_progress` lub `completed`
-- `owner` — odpowiedzialny (ID agenta), puste oznacza nieprzydzielone
-- `blockedBy` — lista ID nieukończonych zadań blokujących to zadanie
+Każde zadanie na liście to podsumowanie, a nie pełny rekord. Oczekuj około:
 
-## Scenariusze użycia
+- `id` — stabilny identyfikator do użycia z `TaskGet` / `TaskUpdate`.
+- `subject` — krótki tytuł w trybie rozkazującym.
+- `status` — jeden z `pending`, `in_progress`, `completed`, `deleted`.
+- `owner` — uchwyt agenta lub współpracownika, lub pusty, gdy nieroszczony.
+- `blockedBy` — tablica ID zadań, które muszą ukończyć się najpierw.
 
-**Odpowiednie zastosowanie:**
-- Sprawdzanie dostępnych zadań (status pending, brak owner, niezablokowane)
-- Sprawdzanie ogólnego postępu projektu
-- Wyszukiwanie zablokowanych zadań
-- Wyszukiwanie następnego zadania po ukończeniu bieżącego
+Dla pełnego opisu, kryteriów akceptacji lub metadanych konkretnego zadania, kontynuuj z `TaskGet`.
 
-## Uwagi
+## Przykłady
 
-- Preferuj przetwarzanie zadań w kolejności ID (najniższe ID najpierw), ponieważ wcześniejsze zadania zazwyczaj dostarczają kontekst dla późniejszych
-- Zadania z `blockedBy` nie mogą być podjęte przed usunięciem zależności
-- Użyj TaskGet, aby uzyskać pełne szczegóły konkretnego zadania
+### Przykład 1
 
-## Tekst oryginalny
+Szybkie sprawdzenie statusu.
 
-<textarea readonly>Use this tool to list all tasks in the task list.
+```
+TaskList()
+```
 
-## When to Use This Tool
+Przeskanuj wyjście pod kątem wszystkiego `in_progress` bez `owner` (praca zastała) oraz wszystkiego `pending` z pustym `blockedBy` (gotowe do podjęcia).
 
-- 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
+### Przykład 2
 
-## Output
+Współpracownik wybierający następne zadanie.
 
-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()
+# Filter to: status == pending AND blockedBy is empty AND owner is empty.
+# Among those, prefer the lower ID (tasks are typically numbered in
+# creation order, so lower IDs are older and usually higher priority).
+TaskGet(taskId: "<chosen id>")
+TaskUpdate(taskId: "<chosen id>", status: "in_progress", owner: "<your handle>")
+```
+
+## Uwagi
 
-Use TaskGet with a specific task ID to view full details including description and comments.
-</textarea>
+- Heurystyka dla współpracowników: gdy wiele zadań `pending` jest odblokowanych i nieroszczonych, wybierz najniższy ID. To utrzymuje kolejność FIFO i unika sytuacji, w której dwóch agentów chwyta to samo głośne zadanie.
+- Szanuj `blockedBy`: nie rozpoczynaj zadania, którego blokery są nadal `pending` lub `in_progress`. Najpierw rozwiąż blokera lub koordynuj z jego właścicielem.
+- `TaskList` to jedyny mechanizm odkrywania zadań. Nie ma wyszukiwania; jeśli lista jest długa, skanuj strukturalnie (po statusie, potem po właścicielu).
+- Usunięte zadania mogą nadal pojawiać się na liście ze statusem `deleted` dla celów śledzenia. Ignoruj je przy planowaniu.
+- Lista odzwierciedla aktualny stan zespołu, więc współpracownicy mogą dodawać lub roszczyć zadania między wywołaniami. Wylistuj ponownie przed roszczeniem, jeśli minął czas.

package/concepts/pl/Tool-TaskOutput.md

@@ -1,40 +1,50 @@
 # TaskOutput
 
-## Definicja
+Pobiera zgromadzone wyjście działającego lub ukończonego zadania w tle — polecenia powłoki w tle, lokalnego agenta lub zdalnej sesji. Użyj, gdy musisz sprawdzić, co długo działające zadanie dotychczas wytworzyło.
 
-Pobiera wynik działającego lub zakończonego zadania w tle. Dotyczy powłok w tle, asynchronicznych agentów i sesji zdalnych.
+## Kiedy używać
+
+- Zdalna sesja (na przykład sandbox w chmurze) działa i potrzebujesz jej stdout.
+- Lokalny agent został wysłany w tle i chcesz częściowego postępu, zanim zwróci.
+- Polecenie powłoki w tle działa wystarczająco długo, że chcesz sprawdzić jego stan bez zatrzymywania go.
+- Musisz potwierdzić, że zadanie w tle faktycznie robi postępy, zanim poczekasz dłużej lub wywołasz `TaskStop`.
+
+Nie sięgaj po `TaskOutput` odruchowo. Dla większości pracy w tle istnieje bardziej bezpośrednia ścieżka — zobacz uwagi poniżej.
 
 ## Parametry
 
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `task_id` | string | Tak | ID zadania |
-| `block` | boolean | Tak | Czy blokować do zakończenia zadania, domyślnie `true` |
-| `timeout` | number | Tak | Maksymalny czas oczekiwania (milisekundy), domyślnie 30000, maks. 600000 |
+- `task_id` (string, wymagany): Identyfikator zadania zwrócony, gdy praca w tle została uruchomiona. Nie jest taki sam jak `taskId` z listy zadań; jest to uchwyt czasu wykonania dla konkretnego wykonania.
+- `block` (boolean, opcjonalny): Gdy `true` (domyślnie), czekaj, aż zadanie wyprodukuje nowe wyjście lub zakończy się, przed powrotem. Gdy `false`, wróć natychmiast z tym, co jest zbuforowane.
+- `timeout` (liczba, opcjonalny): Maksymalna liczba milisekund blokowania przed powrotem. Znaczący tylko, gdy `block` to `true`. Domyślnie `30000`, maksymalnie `600000`.
 
-## Scenariusze użycia
+## Przykłady
 
-**Odpowiednie zastosowanie:**
-- Sprawdzanie postępu agenta w tle uruchomionego przez Task (`run_in_background: true`)
-- Pobieranie wyników poleceń Bash uruchomionych w tle
-- Oczekiwanie na zakończenie zadania asynchronicznego i pobranie wyniku
+### Przykład 1
 
-**Nieodpowiednie zastosowanie:**
-- Zadania na pierwszym planie — zadania na pierwszym planie zwracają wynik bezpośrednio, to narzędzie nie jest potrzebne
+Zajrzyj do zdalnej sesji bez blokowania.
 
-## Uwagi
+```
+TaskOutput(task_id: "sess_01HXYZ...", block: false)
+```
+
+Zwraca wszelkie stdout/stderr wyprodukowane od rozpoczęcia zadania (lub od ostatniego wywołania `TaskOutput`, w zależności od środowiska uruchomieniowego).
 
-- `block: true` blokuje do zakończenia zadania lub upływu limitu czasu
-- `block: false` służy do nieblokującego sprawdzenia bieżącego stanu
-- ID zadania można znaleźć za pomocą polecenia `/tasks`
-- Dotyczy wszystkich typów zadań: powłoki w tle, asynchroniczne agenty, sesje zdalne
+### Przykład 2
 
-## Tekst oryginalny
+Poczekaj krótko, aż lokalny agent wyprodukuje więcej wyjścia.
+
+```
+TaskOutput(
+  task_id: "agent_01ABCD...",
+  block: true,
+  timeout: 10000
+)
+```
+
+## Uwagi
 
-<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>
+- Polecenia bash w tle: `TaskOutput` jest praktycznie przestarzały dla tego przypadku użycia. Gdy rozpoczynasz zadanie powłoki w tle, wynik już zawiera ścieżkę do jego pliku wyjściowego — odczytaj tę ścieżkę bezpośrednio narzędziem `Read`. `Read` daje dostęp losowy, offset wierszy i stabilny widok; `TaskOutput` nie.
+- Lokalni agenci (narzędzie `Agent` wysłane w tle): gdy agent zakończy, wynik narzędzia `Agent` już zawiera jego końcową odpowiedź. Użyj jej bezpośrednio. Nie wywołuj `Read` na symlinkowanym pliku transkryptu — zawiera pełny strumień wywołań narzędzi i przepełni okno kontekstu.
+- Zdalne sesje: `TaskOutput` to poprawny i często jedyny sposób na strumieniowanie wyjścia. Preferuj `block: true` ze skromnym `timeout` nad ciasne pętle pollingu.
+- Nieznany `task_id` lub zadanie, którego wyjście zostało zebrane przez śmieciarkę, zwraca błąd. Wyślij pracę ponownie, jeśli nadal jej potrzebujesz.
+- `TaskOutput` nie zatrzymuje zadania. Użyj `TaskStop`, aby zakończyć.

package/concepts/pl/Tool-TaskStop.md

@@ -1,32 +1,45 @@
 # TaskStop
 
-## Definicja
+Zatrzymuje działające zadanie w tle — polecenie powłoki, wysłanego agenta lub zdalną sesję — po jego uchwycie czasu wykonania. Użyj, aby odzyskać zasoby, anulować pracę, która nie jest już użyteczna, lub wybrnąć, gdy zadanie utknęło.
 
-Zatrzymuje działające zadanie w tle.
+## Kiedy używać
+
+- Polecenie powłoki w tle działa dłużej niż oczekiwano i nie potrzebujesz już jego wyniku.
+- Lokalny agent wpadł w pętlę lub się zawiesił i trzeba go skrócić.
+- Użytkownik zmienił kierunek, a praca w tle dla poprzedniego kierunku powinna zostać porzucona.
+- Zdalna sesja zaraz przekroczy limit czasu lub trzyma zasób, którego potrzebujesz.
+- Potrzebujesz czystej karty przed rozpoczęciem nowego uruchomienia tego samego zadania.
+
+Preferuj pozostawienie krótkotrwałej pracy w tle, aby zakończyła się sama. `TaskStop` jest dla przypadków, gdy dalsze wykonanie nie ma wartości lub jest aktywnie szkodliwe.
 
 ## Parametry
 
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `task_id` | string | Nie | ID zadania w tle do zatrzymania |
-| `shell_id` | string | Nie | Przestarzały, użyj `task_id` zamiast tego |
+- `task_id` (string, wymagany): Uchwyt czasu wykonania zwrócony, gdy zadanie w tle zostało uruchomione. To ten sam identyfikator akceptowany przez `TaskOutput`, nie `taskId` z listy zadań.
 
-## Scenariusze użycia
+## Przykłady
 
-**Odpowiednie zastosowanie:**
-- Zakończenie długo działającego zadania, które nie jest już potrzebne
-- Anulowanie błędnie uruchomionego zadania w tle
+### Przykład 1
 
-## Uwagi
+Zatrzymaj wymknięte spod kontroli polecenie powłoki w tle.
+
+```
+TaskStop(task_id: "bash_01HXYZ...")
+```
 
-- Zwraca status powodzenia lub niepowodzenia
-- Parametr `shell_id` jest przestarzały, należy używać `task_id`
+Polecenie otrzymuje sygnał terminacji; zbuforowane wyjście dotychczas zapisane pozostaje czytelne pod jego ścieżką wyjściową.
 
-## Tekst oryginalny
+### Przykład 2
+
+Anuluj wysłanego agenta po korekcie kursu przez użytkownika.
+
+```
+TaskStop(task_id: "agent_01ABCD...")
+```
+
+## Uwagi
 
-<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` żąda terminacji; nie gwarantuje natychmiastowego wyłączenia. Dobrze zachowujące się zadania wychodzą szybko, ale proces wykonujący blokujące I/O może chwilę rozwijać stos.
+- Zatrzymanie zadania nie usuwa jego wyjścia. Dla zadań powłoki w tle plik wyjściowy na dysku jest zachowany i nadal czytelny przez `Read`. Dla agentów i sesji cokolwiek wyjścia zostało przechwycone przed zatrzymaniem, jest nadal dostępne przez `TaskOutput`.
+- Nieznany `task_id` lub zadanie, które już się zakończyło, zwraca błąd lub no-op. Jest to bezpieczne — możesz wywoływać `TaskStop` obronnie bez sprawdzania statusu.
+- Jeśli zamierzasz zrestartować tę samą pracę, zatrzymaj stare zadanie przed wysłaniem nowego, aby uniknąć dwóch równoległych uruchomień ścigających się o współdzielone zasoby (pliki, porty, wiersze bazy danych).
+- `TaskStop` nie wpływa na wpisy w liście zadań zespołu. Aby anulować śledzone zadanie, zaktualizuj jego status na `deleted` przez `TaskUpdate`.