Community연구 & 데이터 분석github.com

mohamedzhioua/agent-done-or-not

AI 에이전트가 "완료"라고 거짓말하는 것을 잡아냅니다. Claude Code, Cursor 및 Codex를 위한 단일 파일 검증 게이트입니다. 작업을 마치기 전에 반드시 증명을 통과해야 합니다.

agent-done-or-not란 무엇인가요?

이 스킬은 AI 코딩 에이전트가 작업 완료를 주장할 때 실제로 검증 가능한 증거를 제시하도록 강제하는 경량화된 증명 게이트(Skill)입니다. Claude Code, Cursor, Codex와 같은 인기 있는 에이전트 플랫폼과 함께 사용할 수 있으며, 쉘 명령어 기반으로 작동합니다. 에이전트가 "완료"라고 말하기 전에 테스트, 빌드, 타입 검사, 린트, 또는 실행 중인 엔드포인트에 대한 `curl`과 같은 검증 명령어를 수행하고 그 결과(종료 코드, 출력 SHA-256)를 `done-gate.sh` 스크립트로 기록합니다. 게이트는 명령어가 실패하면 에이전트가 턴을 종료하지 못하도록 차단하여, 증명되지 않은 완료를 보고하는 행위를 원천적으로 방지합니다. 개발자는 이 스킬을 통해 에이전트가 생산한 결과물의 신뢰성을 크게 높일 수 있으며, "그냥 된 것처럼" 넘어가는 환각(Hallucination) 문제를 완화할 수 있습니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor
npx skills add mohamedzhioua/agent-done-or-not

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

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

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

문서

done-or-not

사용 시점

이 스킬은 사용자에게 작업, 빌드, 테스트, 수정, 또는 검증 단계가 완료되었다고 보고하기 직전에 사용하십시오. 완료 주장에는 기억이나 자신감이 아닌 게이트의 증명이 필요합니다.

사용 방법

  1. 작업을 증명하는 명령어를 식별하십시오. 주장을 실제로 검증하는 가장 작은 검사를 선택하십시오: 테스트, 빌드, 타입 검사, 린트, 실행 중인 엔드포인트에 대한 curl, 또는 의미 있는 성공/실패 동작을 가진 다른 명령어.

  2. 검증 명령어를 증명 게이트를 통해 실행하십시오:

    bash done-gate.sh capture --label check -- <검증할 명령어>
    

    게이트는 명령어, 종료 코드 및 출력의 SHA-256 해시를 기록합니다. 명령어 자체의 종료 코드로 종료되므로, 실패한 검사는 캡처를 실패하게 만듭니다.

  3. 새로운 PASSING 영수증이 존재할 때만 작업 완료를 보고하십시오.

  4. 검사가 실패하면 문제를 수정하고 다시 캡처하십시오. 실패한 검사에서 성공을 절대 보고하지 마십시오.

정지 게이트는 지원되는 환경에서 이 규칙을 강제합니다: 새로운 통과 영수증이 존재할 때까지 에이전트가 턴을 종료하는 것을 차단합니다. 게이트를 우회하지 말고 증명을 생성하십시오.

관련 스킬