Community코딩 & 개발github.com

opc2026-lin/codex-context-pollution-prevention

Codex 스킬로서 컨텍스트 표류, 오래된 작업, 거짓 진행 및 재시도 루프를 방지합니다.

codex-context-pollution-prevention란 무엇인가요?

이 스킬은 Codex AI 에이전트(예: Claude Code, Cursor)가 개발 작업 중 발생할 수 있는 컨텍스트 표류(context drift), 오래된 작업 참조(stale work), 착각에 의한 잘못된 진행(false progress), 그리고 무한 재시도 루프(infinite retry loops) 문제를 방지하기 위해 설계되었습니다. 에이전트가 현재 컨텍스트를 지속적으로 검증하고, 작업 상태를 명확히 추적하며, 변경 사항을 안전하게 적용할 수 있도록 가이드합니다. Codex 플랫폼에서 재사용 가능한 스킬 형태로 제공되며, 에이전트의 추론 품질을 높이고 예상치 못한 루프나 오작동을 줄여줍니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add opc2026-lin/codex-context-pollution-prevention

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

문서

codex-context-pollution-prevention은(는) 무엇을 하나요?

Codex 에이전트(예: Claude Code, Cursor)에서 컨텍스트 표류, 오래된 작업, 거짓 진행 및 재시도 루프를 방지하기 위한 재사용 가능한 스킬입니다.

주요 기능

  • 컨텍스트 표류 방지: 에이전트가 작업 중 현재 목표와 일치하는지 주기적으로 확인합니다.
  • 오래된 작업 참조 방지: 작업 상태가 변경되었거나 만료된 경우, 에이전트가 이를 인지하고 무시합니다.
  • 거짓 진행 방지: 실제 진행 상황과 다른 추론을 하지 않도록 검증 단계를 추가합니다.
  • 재시도 루프 방지: 동일한 실패 패턴을 반복하지 않도록 중단 조건을 설정합니다.

사용 방법

Codex 환경에서 이 스킬을 활성화하려면 다음 명령어를 사용하세요:

codex skill enable opc2026-lin/codex-context-pollution-prevention

또는 에이전트 설정 파일에 추가합니다:

{
  "skills": ["opc2026-lin/codex-context-pollution-prevention"]
}

동작 방식

  1. 에이전트가 작업을 시작할 때 CONTEXT.md 파일을 확인하여 현재 목표를 검증합니다.
  2. 작업 중간에 PROGRESS.md 파일을 업데이트하여 실제 진행 상황을 기록합니다.
  3. 오래된 작업 참조는 STALE.md 태그로 표시되어 에이전트가 무시합니다.
  4. 재시도 루프가 감지되면 RETRY_LIMIT 환경 변수에 지정된 횟수만큼만 시도하고 중단합니다.

지원 플랫폼

  • Claude Code
  • Cursor
  • Codex CLI

참고 사항

  • 이 스킬은 모든 Codex 호환 에이전트에서 동작합니다.
  • 추가 환경 변수: CONTEXT_CHECK_INTERVAL, STALE_THRESHOLD 등이 있습니다. 자세한 내용은 공식 문서를 참조하세요.

관련 스킬