개발자 문서Skill
Once Email 이메일 테스트 Skill
테스트마다 취약한 이메일 대기 로직을 다시 쓰지 마세요
소유하거나 승인된 앱에 전제 확인, 계획, 마감 대기, 고유 일치, 가려진 증거와 필수 정리를 포함한 검토된 흐름을 추가합니다.
오픈소스 Skill 후보 패키지 제공
해결하는 문제
이전: 각 프로젝트가 폴링, 일치, 오류, 정리를 다시 구현.
Skill: doctor, plan, 제한된 테스트와 명확한 복구.
결과: CI는 “이메일 없음” 대신 가려진 실제 원인을 받습니다.
일반적인 승인 흐름 3가지
인증 코드
확인 링크
알림 및 배송
doctor → plan → run → cleanup
$test-email-flows
doctor
plan
승인된 흐름 1개 실행
cleanup=cleaned 필수안전한 범위
격리 받은편지함을 만들고 마감 내 확인 후 삭제합니다.
모델 밖 데이터
키, 주소, 코드, 링크, 본문, 첨부는 Prompt나 Log에 넣지 않습니다.
Skill 책임
검토된 작업을 조정하고 가림 처리된 결과만 반환합니다.
신뢰할 수 있는 결과
마감, 모호성, 검증, 정리 실패를 구분하고 가려진 증거만 반환합니다.
권장 흐름
- 명시적으로 승인된 API 접근 권한과 필요한 최소 권한의 유효한 자격 증명을 이미 받은 경우에만 진행하세요. 자격 증명은 프로세스의 비밀 관리 기능에 보관하세요. 접근 권한이 없다면 문서와 다운로드 내용 검토까지만 진행하세요.
- 테스트당 받은편지함 하나 생성.
- 승인된 시스템에서 메일 전송.
- 마감 내 조회.
- 가림 처리된 결과만 반환.
- 항상 받은편지함 삭제.
전체 사용 가이드
고정 버전 로컬 패키지 다운로드
소유하거나 명시적으로 승인된 앱만 테스트하세요. Once Email은 수신 전용입니다.
문서와 소스는 공개, API는 통제되며 SDK와 Skill은 레지스트리 외 후보 버전입니다. 공개 문서나 프리릴리스 다운로드는 API 접근 권한을 부여하지 않습니다. API 키 생성과 실제 호출은 일반 공개되지 않았습니다.
압축 해제 전 SHA256SUMS를 확인하세요.
정확한 로컬 시작점
unzip test-email-flows-0.1.0-private.2.zip다운로드부터 정리까지
- 전체 Skill을 다운로드하고 검증합니다.
- test-email-flows 폴더 전체를 설치합니다.
- Agent를 다시 로드해 Skill을 확인합니다.
- 키와 메일을 채팅 밖에 두고 doctor, plan을 실행합니다.
- 명시적으로 승인된 API 접근 권한과 필요한 최소 권한의 유효한 자격 증명을 이미 받은 경우에만 진행하세요. 자격 증명은 프로세스의 비밀 관리 기능에 보관하세요. 접근 권한이 없다면 문서와 다운로드 내용 검토까지만 진행하세요. Trace, video, screenshot 없이 한 번 실행합니다.
- cleanup=cleaned를 요구하고 0600 Journal을 열지 않습니다.
실패 및 복구
400/401/403/404/413/429/503, 시간 초과, 모호성, 추출, 검증과 정리를 구분하고 마감 전까지만 재시도하세요.