Back to Details

context-agent

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Context Agent

Context Agent

Overview

概述

Agente de contexto para continuidade entre sessoes. Salva resumos, decisoes, tarefas pendentes e carrega briefing automatico na sessao seguinte.
用于Claude Code会话间实现完美上下文延续的Context Agent。自动捕获、压缩和恢复上下文——包括主题、决策、任务、错误、修改的文件和技术发现。

When to Use This Skill

适用场景

  • When the user mentions "salvar contexto" or related topics
  • When the user mentions "salva o contexto" or related topics
  • When the user mentions "proxima sessao" or related topics
  • When the user mentions "briefing sessao" or related topics
  • When the user mentions "resumo sessao" or related topics
  • When the user mentions "continuidade sessao" or related topics
  • 当用户提及“保存上下文”或相关话题时
  • 当用户提及“上下文保存”或相关话题时
  • 当用户提及“下次会话”或相关话题时
  • 当用户提及“会话简报”或相关话题时
  • 当用户提及“会话摘要”或相关话题时
  • 当用户提及“会话延续”或相关话题时

Do Not Use This Skill When

不适用场景

  • The task is unrelated to context agent
  • A simpler, more specific tool can handle the request
  • The user needs general-purpose assistance without domain expertise
  • 任务与Context Agent无关
  • 更简单、更具体的工具可以处理该请求
  • 用户需要无领域专业性的通用协助

How It Works

工作原理

Continuidade perfeita entre sessões do Claude Code. Captura, comprime e restaura contexto automaticamente — tópicos, decisões, tarefas, erros, arquivos modificados e descobertas técnicas.
在Claude Code的会话间实现完美的上下文延续。自动捕获、压缩和恢复上下文——包括主题、决策、任务、错误、修改的文件和技术发现。

Localização

目录结构

C:\Users\renat\skills\context-agent\
├── SKILL.md
├── scripts/
│   ├── config.py               # Paths e constantes
│   ├── models.py               # Dataclasses
│   ├── session_parser.py       # Parser JSONL do Claude Code
│   ├── session_summary.py      # Gerador de resumos
│   ├── active_context.py       # Gerencia ACTIVE_CONTEXT.md
│   ├── project_registry.py     # Registro de projetos
│   ├── compressor.py           # Compressão e arquivamento
│   ├── search.py               # Busca FTS5
│   ├── context_loader.py       # Carrega contexto
│   └── context_manager.py      # CLI entry point
├── references/
│   ├── context-format.md       # Especificação de formatos
│   └── compression-rules.md    # Regras de compressão
└── data/
    ├── sessions/               # session-001.md, session-002.md, ...
    ├── archive/                # Sessões arquivadas
    ├── ACTIVE_CONTEXT.md       # Contexto consolidado (max 150 linhas)
    ├── PROJECT_REGISTRY.md     # Status de todos os projetos
    └── context.db              # SQLite FTS5 para busca
C:\Users\renat\skills\context-agent\
├── SKILL.md
├── scripts/
│   ├── config.py               # 路径与常量
│   ├── models.py               # 数据类
│   ├── session_parser.py       # Claude Code的JSONL解析器
│   ├── session_summary.py      # 摘要生成器
│   ├── active_context.py       # 管理ACTIVE_CONTEXT.md
│   ├── project_registry.py     # 项目注册表
│   ├── compressor.py           # 压缩与归档
│   ├── search.py               # FTS5搜索
│   ├── context_loader.py       # 加载上下文
│   └── context_manager.py      # CLI入口点
├── references/
│   ├── context-format.md       # 格式规范
│   └── compression-rules.md    # 压缩规则
└── data/
    ├── sessions/               # session-001.md, session-002.md, ...
    ├── archive/                # 已归档会话
    ├── ACTIVE_CONTEXT.md       # 合并后的上下文（最多150行）
    ├── PROJECT_REGISTRY.md     # 所有项目状态
    └── context.db              # 用于搜索的SQLite FTS5数据库

Inicialização (Primeira Vez)

初始化（首次使用）

bash
python C:\Users\renat\skills\context-agent\scripts\context_manager.py init
bash
python C:\Users\renat\skills\context-agent\scripts\context_manager.py init

Salvar Contexto Da Sessão Atual

保存当前会话上下文

Quando a sessão está terminando ou antes de uma tarefa longa, salvar o contexto:
bash
python C:\Users\renat\skills\context-agent\scripts\context_manager.py save
O que faz:
  1. Encontra o arquivo JSONL mais recente da sessão
  2. Analisa todas as mensagens, tool calls e resultados
  3. Gera resumo estruturado (session-NNN.md)
  4. Atualiza ACTIVE_CONTEXT.md com novas informações
  5. Sincroniza com MEMORY.md (carregado no system prompt)
  6. Indexa para busca full-text
当会话即将结束或开始长任务前，保存上下文：
bash
python C:\Users\renat\skills\context-agent\scripts\context_manager.py save
执行操作：
  1. 找到最新的会话JSONL文件
  2. 解析所有消息、工具调用和结果
  3. 生成结构化摘要（session-NNN.md）
  4. 使用新信息更新ACTIVE_CONTEXT.md
  5. 与MEMORY.md同步（已加载到系统提示词中）
  6. 建立全文搜索索引

Carregar Contexto (Briefing)

加载上下文（简报）

No início de uma nova sessão, carregar o contexto:
bash
python C:\Users\renat\skills\context-agent\scripts\context_manager.py load
Gera briefing com: projetos ativos, tarefas pendentes (por prioridade), bloqueadores, decisões recentes, convenções e resumo das últimas sessões.
在新会话开始时，加载上下文：
bash
python C:\Users\renat\skills\context-agent\scripts\context_manager.py load
生成包含以下内容的简报：活跃项目、待办任务（按优先级排序）、阻塞问题、近期决策、约定规范和最近会话摘要。

Status Rápido

快速状态查看

bash
python C:\Users\renat\skills\context-agent\scripts\context_manager.py status
Resumo em poucas linhas: projetos, pendências críticas, bloqueadores.
bash
python C:\Users\renat\skills\context-agent\scripts\context_manager.py status
简短摘要：项目、关键待办事项、阻塞问题。

Buscar No Histórico

历史记录搜索

bash
python C:\Users\renat\skills\context-agent\scripts\context_manager.py search "rate limit"
Busca full-text (SQLite FTS5) em todas as sessões — tópicos, decisões, erros, arquivos, etc.
bash
python C:\Users\renat\skills\context-agent\scripts\context_manager.py search "rate limit"
在所有会话中进行全文搜索（SQLite FTS5）——包括主题、决策、错误、文件等。

Manutenção

维护

bash
python C:\Users\renat\skills\context-agent\scripts\context_manager.py maintain
Arquiva sessões antigas, comprime arquivo, ressincroniza MEMORY.md, reconstrói índice de busca.
bash
python C:\Users\renat\skills\context-agent\scripts\context_manager.py maintain
归档旧会话、压缩文件、重新同步MEMORY.md、重建搜索索引。

Fluxo De Trabalho

工作流程

[Sessão termina]
  → save → session-NNN.md + ACTIVE_CONTEXT.md + MEMORY.md

[Nova sessão começa]
  → MEMORY.md já está no system prompt (automático)
  → load → briefing detalhado com tudo que precisa saber

[Contexto cresce demais]
  → maintain → arquiva sessões antigas, comprime, otimiza
[会话结束]
  → save → session-NNN.md + ACTIVE_CONTEXT.md + MEMORY.md

[新会话开始]
  → MEMORY.md已自动包含在系统提示词中
  → load → 加载包含所有必要信息的详细简报

[上下文过大时]
  → maintain → 归档旧会话、压缩、优化

O Que É Capturado Em Cada Sessão

每次会话捕获的内容

  • Tópicos: assuntos discutidos
  • Decisões: escolhas técnicas e de arquitetura
  • Tarefas concluídas: o que foi feito
  • Tarefas pendentes: o que falta (com prioridade)
  • Arquivos modificados: quais arquivos foram editados/criados
  • Descobertas: insights técnicos importantes
  • Erros resolvidos: problemas e suas soluções
  • Questões em aberto: perguntas sem resposta
  • Métricas: tokens consumidos, mensagens, tool calls
  • 主题：讨论的议题
  • 决策：技术和架构选择
  • 已完成任务：已执行的工作
  • 待办任务：未完成的工作（含优先级）
  • 修改的文件：已编辑/创建的文件
  • 技术发现：重要的技术见解
  • 已解决错误：问题及其解决方案
  • 未解决问题：尚未解答的疑问
  • 指标：消耗的Token数、消息数、工具调用数

Integração Com Memory.Md

与Memory.Md的集成

O ACTIVE_CONTEXT.md é automaticamente copiado para: 
C:\Users\renat\.claude\projects\C--Users-renat-skills\memory\MEMORY.md
Como o MEMORY.md é incluído no system prompt de toda sessão, o Claude sempre começa sabendo o estado atual dos projetos, tarefas pendentes e decisões tomadas — sem precisar de nenhuma ação manual.
ACTIVE_CONTEXT.md会自动复制到： 
C:\Users\renat\.claude\projects\C--Users-renat-skills\memory\MEMORY.md
由于MEMORY.md会被包含在所有会话的系统提示词中，Claude始终会知晓项目的当前状态、待办任务和已做出的决策——无需任何手动操作。

Referências

参考资料

  • Para formato detalhado dos arquivos: 
    references/context-format.md
  • Para regras de compressão e arquivamento: 
    references/compression-rules.md
  • 有关文件的详细格式：
    references/context-format.md
  • 有关压缩和归档规则：
    references/compression-rules.md

Best Practices

最佳实践

  • Provide clear, specific context about your project and requirements
  • Review all suggestions before applying them to production code
  • Combine with other complementary skills for comprehensive analysis
  • 提供关于项目和需求的清晰、具体的上下文
  • 在将建议应用到生产代码前审核所有内容
  • 结合其他互补技能进行全面分析

Common Pitfalls

常见误区

  • Using this skill for tasks outside its domain expertise
  • Applying recommendations without understanding your specific context
  • Not providing enough project context for accurate analysis
  • 将此技能用于其领域专长之外的任务
  • 在不了解具体上下文的情况下应用建议
  • 未提供足够的项目上下文以确保分析准确

Related Skills

相关技能

  • context-guardian
    - Complementary skill for enhanced analysis
  • context-guardian
    - 用于增强分析的互补技能