mcpField
A
agent-context-isolation

agent-context-isolation

github.com/parcadeiAgent 工作流3.9k514 次安装39 周前更新
代码仓库

关于 agent-context-isolation

agent-context-isolation 是一项 Claude Agent 技能，通过后台任务和文件协调，避免子 Agent 输出占用主对话上下文；并建议直接运行测试验证工作。

主要功能

  1. 01后台 Agent 与文件协调
  2. 02将结果写入指定文件
  3. 03避免读取完整 TaskOutput
  4. 04通过提醒和文件监控进度
  5. 05直接运行测试验证工作

适用场景

  1. 01运行研究 Agent，避免主上下文膨胀
  2. 02通过文件协调多阶段 Agent 流程
  3. 03不加载完整记录即可检查任务完成情况

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/parcadei/continuous-claude-v3 --skill agent-context-isolation

安装后在 Claude Code 中输入/agent-context-isolation确认已加载。

详细介绍

Agent 上下文隔离

防止 Agent 输出污染主上下文窗口。

规则

1. 使用后台 Agent 进行基于文件的协作
# 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)

通过 run_in_background=true 运行的后台 Agent 会隔离其上下文。让它们将结果写入 .claude/cache/agents/<agent-type>/ 中的文件。

2. 切勿使用 TaskOutput 获取结果
# 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 会返回 Agent 的完整对话记录。始终使用基于文件的协作方式。

3. 通过系统提醒监控 Agent 进度
# 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

检测卡住的 Agent：

  1. 不再收到进度提醒
  2. 任务输出文件大小不再增长
  3. 经过合理等待后，预期的输出文件仍未创建
4. 通过测试验证，而非查看输出

Agent 完成工作后：

  1. 直接运行测试套件：bun test
  2. 报告通过和失败的数量
  3. 只有测试失败时才调查问题
5. 基于文件的 Agent 流水线模式
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)

每个 Agent 都读取前一个 Agent 的文件输出，而不是 TaskOutput。

为什么这很重要

Agent 上下文隔离可以保留主对话的上下文预算。通过 TaskOutput 读取 Agent 输出会让上下文被大量内容淹没，导致：

  • 对话中途压缩上下文
  • 丢失用户原始请求的上下文
  • 需要反复解释

来源

  • 使用 TaskOutput 时，超过 70k 个 Token 被灌入主上下文的会话
  • 2026-01-01 会话：成功使用后台 Agent 和基于文件的协作完成 SDK 第 3 阶段

评论

支持 Markdown