Community코딩 & 개발github.com

BreakingGap

AI 에이전트가 작업 중일 때 인간이 할 수 있는 유용한 단계(현재 작업, 미완료 작업, 관련 학습)를 제안하고 체크포인트를 두어 쉽게 복귀할 수 있도록 돕습니다. “이게 실행되는 동안 뭘 하지?” 또는 “에이전트가 작업하는 동안 10분 생겼어” 상황에 적합합니다.

BreakingGap란 무엇인가요?

BreakingGap은 AI 에이전트가 작업을 수행하는 동안 인간이 생산적으로 참여할 수 있는 작은 단위의 작업을 제안하는 스킬입니다. 이 스킬은 현재 진행 중인 작업에 인간의 판단, 예시 수용, 짧은 초안 작성, 비교 등 즉시 적용 가능한 단계를 제안하거나, 이미 승인된 미완료 작업 이어받기, 혹은 실제 소스를 바탕으로 한 개념 학습 등으로 구성됩니다. 시간 예산은 사용자가 직접 명시하며, 추정치에는 복귀 시간 2분이 포함됩니다. 제안된 단계는 구체적이고 탐구적이며, 사용자가 요청하지 않은 장기적인 작업 계획이나 에이전트 모니터링, 방대한 스캔을 시작하지 않습니다. 선택 사항으로 제공되는 로컬 파일 기반 세션 헬퍼(`scripts/gap.py`)와 브라우저 기반 오프라인 컴패니언(`assets/companion.html`)을 통해 체크포인트 저장 및 복원이 가능하지만, 이들은 독립적이며 프로젝트 파일을 다시 읽거나 에이전트를 모니터링하지는 않습니다. 이 스킬은 Python 계정이나 통합 없이 대화만으로도 사용 가능합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/m1nga/breakinggap/tree/HEAD/skills/breakinggap

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

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

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

문서

BreakingGap은(는) 무엇을 하나요?

작은 틈. 조금 더 나아가기.

에이전트가 작업하는 동안 사용자가 작지만 의미 있는 기여를 할 수 있도록 돕습니다. 결과는 더 명확해진 결정, 몇 개의 유용한 문장, 재개된 아이디어, 또는 더 잘 이해된 개념 하나일 수 있습니다. 틈을 비워두는 것도 유효한 선택입니다. 대화의 언어를 따르며, 번들로 제공되는 컴패니언 인터페이스는 영어입니다.

여기에 해당하는 단계 찾기

먼저 현재 대화와 프로젝트의 기존 상태를 활용하세요. 주요 작업과 복귀 지점을 항상 보이게 유지하세요. 현재 에이전트 상태는 승인된 상태 도구나 사용자의 보고를 통해서만 확인하고, 자체적인 실시간 모니터링을 만들어내지 마세요. 주요 에이전트가 사용자를 필요로 하거나 완료되었다면, 다른 활동을 제안하기 전에 그 결과로 복귀하세요.

사용자가 명시한 시간 예산을 사용하세요. 시간 예산이 없으면, 사용 가능한 시간과 현재 작업에 대해 한 가지 간단한 질문을 하세요. 10분 에이전트 ETA를 가정하지 마세요. 시간이 불확실하다면 명시적으로 추정된, 쉽게 중단 가능한 2분 단계를 제안하세요. 단지 제안을 찾기 위해 대규모 스캔을 시작하거나 모든 에이전트가 끝날 때까지 기다리지 마세요.

요청에서 유용한 의도를 추론하세요. 그렇지 않으면 현재 작업을 우선시합니다.

  • 진전시키기: 현재 작업을 개선하지만 보류 중인 출력에 의존하지 않는 인간의 판단, 수용 예시, 짧은 초안, 비교.
  • 이어받기: 이미 승인된, 구체적인 저장된 다음 작업이 있는 미완료 항목. 여전히 열려 있는지 다시 확인하고, 일시 중단된 작업이나 다른 소유자의 할당을 재개하지 마세요.
  • 하나 배우기: 현재 프로젝트의 실제 소스에서 하나의 개념. 사용자에게 예측, 설명, 비교를 요청한 후 짧은 소스 기반 확인을 제공하세요. 응답이 없으면 학습이 입증되지 않은 것입니다. 생성된 예시와 해결되지 않은 질문은 정직하게 표시하세요.

선택한 작업을 지원하는 데 필요한 만큼의 현재 소스만 읽으세요. 그것이 여전히 유용하고, 승인되었으며, 보류 중인 출력에 독립적이고, 활성 작업과 충돌하지 않는지 확인하세요. 작은 작업을 보류를 넘거나, 에이전트 소유 파일을 변경하거나, 메시지를 보내거나, 게시하는 허가로 취급하지 마세요. 동시 편집보다는 비공개 스크래치 응답을 선호하세요. 맥락이 부족하면 현재 목표를 묻거나 사용자가 제공한 텍스트를 사용하세요. 백로그, 소스 위치, 완료 상태 또는 권한을 절대 만들어내지 마세요.

설정 + 인간 작업 + 마무리를 추정하고, 사용자의 예산 내에 복귀를 위한 2분을 남겨두세요. 추정치는 측정된 시간이나 에이전트 완료 예측이 아닙니다. 너무 큰 작업은 의미 있는 중단점으로 축소하세요. 불명확하거나 깊이 몰입하게 하는 작업은 편리한 숫자로 기본값을 정하기보다는 제외하세요.

하나의 작은 단계 제안하기

하나의 권장 사항을 간결한 대화형 카드로 제공하세요.

시도: 하나의 구체적인 행동과 명확한 첫 단계. 적합한 이유: 사용자의 작업이나 호기심과의 연결고리, 추정된 설정/작업/마무리 및 복귀 여유. 지금은 여기까지: 작은 산출물이나 답변, 그리고 안전하게 멈출 수 있는 지점. 복귀할 곳: 주요 작업과 재개할 위치.

실제 소스를 명명하거나 링크하세요. 일반적인 생산성 조언 대신 사용자의 맥락을 사용하세요. 다른 단계를 요청받으면 권장 사항을 교체하세요. 긴 큐를 쏟아내지 마세요. 선택적인 장난기 있는 제약이 작업을 매력적으로 만들 수 있습니다(“세 문장으로 설명하세요”, “두 개의 헤드라인을 시도하세요”). 단, 작업에 적합해야 합니다. 연속 기록, 긴박감, 조작된 성취, 모든 틈을 채우라는 압박을 추가하지 마세요.

사용자가 인간 단계를 수행하도록 두세요. 학습 과제를 조용히 완료하거나 다른 자율 작업 흐름을 시작하지 마세요. 요청받은 도움은 기존 권한 내에서 수행하세요. 맞는 것이 없으면 간단히 그렇게 말하고 틈을 열어두세요.

깔끔하게 멈추고 복귀하기

사용자가 에이전트가 준비되었다고 말하거나 중단하고 싶어하면 복귀를 우선시하세요. 대화에 이미 있는 작업은 보존하세요. 필요한 경우 “내가 어디까지 했는지 / 다음 단계”에 대한 짧은 메모를 요청하세요. 단, 그 메모가 복귀를 가로막는 관문이 되어서는 안 됩니다. 갭 타이머가 만료되었다고 해서 에이전트가 완료된 것은 아닙니다.

실제 작업은 계획된 작업과 별도로 기록하세요. 업데이트가 승인된 경우 프로젝트의 일반 노트를 재사용하세요. 세션 체크포인트가 정식 작업 완료를 표시하지는 않습니다. 쓰기 성공 후에만 "저장됨"이라고 말하세요. 저장에 실패하면 채팅으로 메모를 제공하고 저장되지 않았음을 명시하세요. 재개 시, 해당 소스와 현재 상태를 다시 읽은 후 저장된 단계를 다시 제공하세요.

선택적 로컬 도구

대화 전용 사용에는 Python, 계정, 작업 폴더, 통합, 컴패니언이 필요하지 않습니다. 사용자 입력과 기존 프로젝트 기록을 권위 있는 것으로 유지하세요.

반복 가능한 파일 기반 선택과 복구 가능한 로컬 세션을 위해 번들로 제공되는 표준 라이브러리 헬퍼를 사용하세요. 정확한 입력과 명령어는 references/session-format.md를 참조하세요. 어시스턴트는 실제 증거에서 JSON을 구축합니다. 사용자에게 내부 필드를 관리하도록 요청하지 마세요. 설치된 scripts/gap.py를 절대 경로로 실행하고, --root는 이 설치 디렉터리가 아닌 사용자의 기존 프로젝트를 가리키도록 하세요. 헬퍼는 소스 해시와 제공된 적격성 주장을 확인하지만, 소유권, 권한, 상태, 또는 충돌 부재를 독립적으로 증명할 수는 없습니다. 시작하기 전에 이를 다시 확인하세요.

선택적 오프라인 컴패니언은 타이머와 체크포인트 흐름을 제공합니다. assets/logo.png와 함께 열어주세요. 시작할 때 눈에 띄게 가상의 예시로 시작합니다. 실제 작업을 사용하려면 어시스턴트가 승인된 로컬 소스에서 스키마-1 입력 번들을 준비하여 가져올 수 있습니다. 페이지는 제공된 필드를 검증할 수 있지만, 프로젝트 파일을 다시 읽거나, 해시를 확인하거나, 에이전트를 모니터링하거나, 헬퍼 저널과 동기화할 수 없습니다. 로컬 브라우저 저장소와 내보내기는 별도의 복사본입니다. 체크포인트 내보내기는 현재 소스를 확인한 후 조정하기 위한 증거이며, 실행 명령이 아닙니다. Python이나 브라우저 저장소를 사용할 수 없는 경우, 채팅을 계속하거나 메모를 내보내세요. 이 스킬을 사용하기 위해 의존성을 설치하지 마세요.

관련 스킬