Communitygithub.com

컨텍스트 엔지니어링

컨텍스트 사용 한도 확인, 남은 시간 모니터링, 토큰 소비 최적화, 컨텍스트 장애 디버깅을 수행합니다. 컨텍스트 비율, 속도 제한, 사용 경고, 컨텍스트 최적화, 에이전트 아키텍처, 메모리 시스템에 대해 물어볼 때 사용하세요.

컨텍스트 엔지니어링란 무엇인가요?

이 스킬은 LLM 기반 에이전트 시스템에서 컨텍스트 윈도우 사용을 최적화하고 모니터링하기 위한 포괄적인 지침과 실용적인 도구를 제공합니다. 핵심 원칙은 '컨텍스트 품질이 양보다 중요하다'는 것으로, 고신호 토큰을 선별하여 최대한의 추론 품질을 유지하면서 토큰 사용량을 최소화하는 데 중점을 둡니다. Claude Code, Cursor, Codex 등 주요 AI 에이전트 플랫폼에서 사용할 수 있으며, 런타임 인식을 통해 PostToolUse 훅으로 컨텍스트 윈도우 사용량과 사용 한도를 자동으로 주입합니다. 주요 기능으로는 4-버킷 전략(쓰기, 선택, 압축, 격리), 구체적인 임계값(70% 경고, 80% 최적화 트리거, 90% 즉시 조치 필요), 안티 패턴 목록, 그리고 컨텍스트 건강 분석과 압축 품질 평가를 위한 파이썬 스크립트가 포함됩니다. 이 스킬은 멀티 에이전트 조정, 메모리 시스템, 파이프라인 개발, 도구 설계 등 다양한 시나리오에 적용 가능한 참조 문서 모음과 함께 제공됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/majiayu000/claude-skill-registry/tree/HEAD/skills/context-management/context-engineering-hoanghd218-landing-page-ai-kien

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

컨텍스트 엔지니어링은(는) 무엇을 하나요?

컨텍스트 엔지니어링은 LLM 작업에 필요한 가장 작은 고신호 토큰 집합을 선별합니다. 목표: 토큰 사용량을 최소화하면서 추론 품질을 극대화합니다.

활성화 시기

  • 에이전트 시스템 설계/디버깅
  • 컨텍스트 제한이 성능을 저하시킬 때
  • 비용/지연 시간 최적화
  • 멀티 에이전트 조정 구축
  • 메모리 시스템 구현
  • 에이전트 성능 평가
  • LLM 기반 파이프라인 개발

핵심 원칙

  1. 컨텍스트 품질 > 양 - 고신호 토큰이 방대한 내용보다 낫습니다.
  2. 주의는 유한합니다 - U자형 곡선은 시작/끝 위치를 선호합니다.
  3. 점진적 공개 - 정보를 적시에 로드합니다.
  4. 격리는 성능 저하를 방지합니다 - 작업을 하위 에이전트에 분할합니다.
  5. 최적화 전에 측정하세요 - 기준선을 파악하세요.

중요:

  • 간결함을 위해 문법을 희생하세요.
  • 높은 품질을 유지하면서 토큰 효율성을 보장하세요.
  • 이 규칙을 하위 에이전트에 전달하세요.

빠른 참조

주제사용 시기참고 자료
기본컨텍스트 구조, 주의 메커니즘 이해context-fundamentals.md
성능 저하장애 디버깅, 중간 손실, 오염context-degradation.md
최적화압축, 마스킹, 캐싱, 분할context-optimization.md
압축긴 세션, 요약 전략context-compression.md
메모리세션 간 지속성, 지식 그래프memory-systems.md
멀티 에이전트조정 패턴, 컨텍스트 격리multi-agent-patterns.md
평가에이전트 테스트, LLM-as-Judge, 메트릭evaluation.md
도구 설계도구 통합, 설명 엔지니어링tool-design.md
파이프라인프로젝트 개발, 배치 처리project-development.md
런타임 인식사용 한도, 컨텍스트 윈도우 모니터링runtime-awareness.md

주요 메트릭

  • 토큰 활용률: 70%에서 경고, 80%에서 최적화 트리거
  • 토큰 변동성: 에이전트 성능 변동의 80%를 설명
  • 멀티 에이전트 비용: 단일 에이전트 기준 대비 ~15배
  • 압축 목표: 50-70% 감소, 품질 손실 <5%
  • 캐시 적중 목표: 안정적인 작업 부하에서 70%+

4-버킷 전략

  1. 쓰기: 컨텍스트를 외부에 저장(스크래치패드, 파일)
  2. 선택: 관련 컨텍스트만 가져오기(검색, 필터링)
  3. 압축: 정보를 유지하면서 토큰 줄이기(요약)
  4. 격리: 하위 에이전트에 분할(분할)

안티 패턴

  • 선별된 컨텍스트 대신 방대한 컨텍스트
  • 중간 위치에 중요한 정보 배치
  • 제한 이전에 압축 트리거 없음
  • 병렬화 가능한 작업에 단일 에이전트 사용
  • 명확한 설명이 없는 도구

지침

  1. 중요한 정보는 컨텍스트의 시작/끝에 배치하세요.
  2. 70-80% 활용률에서 압축을 구현하세요.
  3. 컨텍스트 격리를 위해 역할극 대신 하위 에이전트를 사용하세요.
  4. 4-질문 프레임워크(무엇, 언제, 입력, 반환)로 도구를 설계하세요.
  5. 요청당 토큰이 아닌 작업당 토큰에 최적화하세요.
  6. 프로브 기반 평가로 검증하세요.
  7. 프로덕션에서 KV-캐시 적중률을 모니터링하세요.
  8. 최소한으로 시작하고, 필요할 때만 복잡성을 추가하세요.

런타임 인식

시스템은 PostToolUse 훅을 통해 사용 인식을 자동으로 주입합니다.

<usage-awareness>
Claude Usage Limits: 5h=45%, 7d=32%
Context Window Usage: 67%
</usage-awareness>

임계값:

  • 70%: 경고 - 최적화/압축 고려
  • 90%: 심각 - 즉시 조치 필요

데이터 소스:

  • 사용 한도: Anthropic OAuth API (https://api.anthropic.com/api/oauth/usage)
  • 컨텍스트 윈도우: 상태 표시줄 임시 파일 (/tmp/ck-context-{session_id}.json)

스크립트

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

majiayu000/claude-skill-registry

Builds, edit or validate Agent Skill through conversational discovery. Use when the user requests to "Create an Agent", "Optimize an Agent" or "Edit an Agent".

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Analyzes current state and user query to answer BMad questions or recommend the next workflow or agent. Use when user says what should I do next, what do I do now, or asks a question about BMad

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

majiayu000/claude-skill-registry

Create a hilarious and ultra-realistic video of an anthropomorphic animal acting like a human vlogger in a real-world setting.

majiayu000/claude-skill-registry

Speech-to-text transcription and translation via OpenAI Audio API -- models, response formats, timestamps, prompting, streaming, chunking, and diarization

majiayu000/claude-skill-registry

BlockRun works with Claude Code and Google Antigravity.

majiayu000/claude-skill-registry

This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.

majiayu000/claude-skill-registry

小省导购员数字人带货版即梦视频提示词生成系统,基于四大智能体协同(提示词生成师、质量管控师、知识库运维师、跨环节适配师),按照"主体+运动+场景+(镜头语言+光影+氛围)"公式输出中英文双版提示词,适配5s短视频。确保人物一致性、视觉连贯性、情绪连贯性,支持知识库智能复用和跨工具适配(Suno音乐、AI绘画),为数字人带货视频提供高质量提示词生成服务。

majiayu000/claude-skill-registry

Upload and manage files using Google Gemini File API via scripts/. Use for uploading images, audio, video, PDFs, and other files for use with Gemini models. Supports file upload, status checking, and file management. Triggers on "upload file", "file API", "upload image", "upload PDF", "upload video", "file management".

majiayu000/claude-skill-registry

CRITICAL: Use for MolyKit AI chat toolkit. Triggers on: BotClient, OpenAI, SSE streaming, AI chat, molykit, PlatformSend, spawn(), ThreadToken, cross-platform async, Chat widget, Messages, PromptInput, Avatar, LLM

majiayu000/claude-skill-registry

AI and machine learning workflow covering LLM application development, RAG implementation, agent architecture, ML pipelines, and AI-powered features.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

관련 스킬