К основному содержанию
скилл CX Codex

agent-context-isolation — скилл для Claude Code: изоляция контекста

Скилл agent-context-isolation для Claude Code учит передавать работу фоновых агентов через файлы. Он помогает не загружать их полные транскрипты в основной контекст.

MIT ★ 3 951 обновлён 2026-01-26

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add parcadei/Continuous-Claude-v3 --skill agent-context-isolation -a claude-code
Открыть на GitHub

Что делает agent-context-isolation

Скилл задаёт файловый способ координации фоновых агентов: каждый записывает результат в файл, а следующий читает этот файл. Для промежуточных результатов используются каталоги .claude/cache/agents/; за ходом работы следят по системным напоминаниям и появлению файлов, а не через TaskOutput.

После работы агента скилл предлагает запускать bun test и проверять результат по тестам. В примере конвейера исследование, планирование и проверка передаются между агентами через отдельные файлы, а реализация читает проверенный план. Команда TaskOutput возвращает полный транскрипт агента и может занять контекст основного диалога.

Какие задачи решает

  • передать результаты фонового агента через файл
  • не загружать полный транскрипт агента в основной контекст
  • связать этапы исследования, планирования и реализации файлами
  • проверить работу агента запуском тестов

Примеры запросов агенту

  • Передай исследование фоновому агенту и сохрани результат в файл.
  • Организуй планирование и проверку так, чтобы каждый агент читал файл предыдущего.
  • Проверь результат работы агента с помощью bun test, не загружая его транскрипт.

Как установить agent-context-isolation

1Через Skills CLI (Vercel)

npx skills add parcadei/Continuous-Claude-v3 --skill agent-context-isolation -a claude-code

2Вручную: положить файлы

~/.claude/skills/agent-context-isolation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/agent-context-isolation/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об agent-context-isolation

Как установить agent-context-isolation в Claude Code?

Выполни npx skills add parcadei/Continuous-Claude-v3 --skill agent-context-isolation -a claude-code. Файл скилла устанавливается по пути ~/.claude/skills/agent-context-isolation/SKILL.md.

Что делает agent-context-isolation?

Он задаёт правила координации фоновых агентов через файлы вместо передачи полных транскриптов в основной контекст. Также предлагает проверять результат запуском bun test.

Почему скилл не рекомендует использовать TaskOutput?

TaskOutput возвращает полный транскрипт агента. Его чтение может заполнить основной контекст и вытеснить сведения о первоначальном запросе.

Исходный текст

SKILL.md · MIT
---
name: agent-context-isolation
description: Agent Context Isolation
user-invocable: false
---

# Agent Context Isolation

Prevent agent output from polluting the main context window.

## Rules

### 1. Use Background Agents with File-Based Coordination
```
# RIGHT - background agent writes to file, main reads file
Task(subagent_type="...", run_in_background=true, prompt="... Output to: /path/to/file.md")

# WRONG - foreground agent dumps full transcript into main context
Task(subagent_type="...", run_in_background=false)
```

Background agents with `run_in_background=true` isolate their context. Have them write results to files in `.claude/cache/agents/<agent-type>/`.

### 2. Never Use TaskOutput to Retrieve Results
```
# WRONG - dumps entire transcript (70k+ tokens) into context
TaskOutput(task_id="<id>")
TaskOutput(task_id="<id>", block=true)

# RIGHT - check expected output files
Bash("ls -la .claude/cache/agents/<agent-type>/")
Bash("bun test")  # verify with tests
```

TaskOutput returns the full agent transcript. Always use file-based coordination instead.

### 3. Monitor Agent Progress via System Reminders
```
# System reminders come automatically:
# "Agent a42a16e progress: 6 new tools used, 88914 new tokens"

# To detect completion:
# - Watch for progress reminders to stop arriving
# - Poll for expected output files: find .claude/cache/agents -name "*.md" -mmin -5
# - Check task output file size growth: wc -c /tmp/claude/.../tasks/<id>.output
```

**Stuck agent detection:**
1. Progress reminders stop arriving
2. Task output file size stops growing
3. Expected output file not created after reasonable time

### 4. Verify with Tests, Not Output
After agent work:
1. Run the test suite directly: `bun test`
2. Report pass/fail counts
3. Only investigate failures if tests fail

### 5. File-Based Agent Pipeline Pattern
```
Research agent → .claude/cache/agents/oracle/output.md
                          ↓
Plan agent → .claude/cache/agents/plan-agent/output.md (reads research)
                          ↓
Validate agent → .claude/cache/agents/validate-agent/output.md (reads plan)
                          ↓
Implement agent → src/module.ts (reads validated plan)
```

Each agent reads the previous agent's file output, not TaskOutput.

## Why This Matters

Agent context isolation preserves the main conversation's context budget. Reading agent outputs via TaskOutput floods context, causing:
- Mid-conversation compaction
- Lost context about user's original request
- Repeated explanations needed

## Source
- Session where TaskOutput flooded 70k+ tokens into main context
- Session 2026-01-01: Successfully used background agents with file-based coordination for SDK Phase 3

© parcadei · MIT · parcadei/Continuous-Claude-v3

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
context-discipline Rohit Ghumare Правило context-discipline для Claude Code задаёт порядок работы с файлами, тестами и инструментами: не перечитывать неизменённые файлы и остановиться после успешных тестов. CX Codex +1 ★ 2 966звёзд репо nemo-relay-instrument-context-isolation NVIDIA Corporation and Affiliates Скилл nemo-relay-instrument-context-isolation разделяет стеки контекста NeMo Relay между параллельными задачами и сохраняет правильную иерархию scope. CX Codex +1 211установок run-affected-test-file-in-isolation-and-in-co-run-with-its-test- ZaxbyHub Скилл run-affected-test-file-in-isolation-and-in-co-run-with-its-test- для Claude Code заставляет агента после правки моков запускать тесты отдельно и вместе с соседними файлами, чтобы проверить оба режима. CX Codex +1 ★ 539звёзд репо context-guard Gerui Lv Плагин context-guard для Claude Code и Codex сохраняет требования и подтверждения в длинных задачах Codex. Он восстанавливает открытый список после сжатия контекста и проверяет доказательства выполнения. CX Codex ★ 1 596звёзд репо bmad-project-context bmad-code-org Скилл bmad-project-context помогает составить, обновить или проверить блок инструкций в AGENTS.md для кодовых агентов. Фиксирует ошибки модели и выносит правила в файл проекта. CX Codex +1 17 200установок qa-project-context kindlmann Сканирует репозиторий и создаёт файл .agents/qa-project-context.md со стеком, тестами и рисками. Пригодится при настройке тестирования перед запуском других QA-скиллов. CX Codex +1 1 800установок

Из того же набора161

Весь набор →
proactive-delegation Правило proactive-delegation учит Claude Code делегировать задачи субагентам без лишних вопросов. Оно бережёт главный контекст, распознавая исследования, исправления багов и параллельные шаги. CX Codex +1 ★ 3 951звёзд репо search-hierarchy Скилл search-hierarchy подбирает способ поиска по типу вопроса: по структуре кода, смыслу или точному имени. Помогает найти нужный файл до чтения его содержимого. CX Codex +1 ★ 3 951звёзд репо channel-capacity Скилл channel-capacity для Claude Code считает пропускную способность канала и взаимную информацию, а также применяет алгоритм Блахута-Аримото в задачах теории информации и кодирования. CX Codex +1 ★ 3 951звёзд репо rudin-real-complex-analysis Скилл rudin-real-complex-analysis помогает решать задачи и проверять доказательства по учебнику Walter Rudin «Real and Complex Analysis» с помощью дерева теорем и Python-скриптов. CX Codex +1 ★ 3 951звёзд репо fields Скилл fields для работы с полями в абстрактной алгебре. Помогает проверить аксиомы поля, вычислить минимальные многочлены и решить алгебраические уравнения через встроенные инструменты Bash и Read. CX Codex +1 ★ 3 951звёзд репо opc-architecture Скилл opc-architecture объясняет Claude Code архитектуру Orchestrated Parallel Claude: работу хуков, запуск дочерних процессов и координацию агентов через PostgreSQL. CX Codex +1 ★ 3 951звёзд репо modular-code Скилл modular-code для Claude Code делит крупные Python-файлы на модули по смыслу и слоям. Разделяет файлы со смешанными задачами и кодом, который трудно читать и тестировать. CX Codex +1 ★ 3 951звёзд репо compactness Скилл compactness для решения задач на компактность в топологии. Помогает проверить, компактно ли пространство, и применить теоремы Хайне-Бореля, Тихонова и следствия компактности. CX Codex +1 ★ 3 951звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой