AI 빌드 진단

Native Build 로그는 깁니다. iOS(Xcode/Fastlane) 또는 Android(Gradle/Fastlane) 빌드가 실패하면 Capgo가 AI 빌드 엔지니어에게 로그를 넘겨 무엇이 잘못됐고 어떻게 고쳐야 하는지 짚어줍니다. — 수천 줄의 로그를 직접 스크롤할 필요가 없습니다.

활성화하기

추가 --ai-analytics 빌드에 적용하세요:

bunx @capgo/cli@latest build request com.example.app --platform android --ai-analytics

진단 기능은 빌드가 실패할 때만 작동합니다 — 성공한 빌드는 그대로 유지됩니다.

실행 시

빌드 실패 시 동작은 실행 위치와 플래그 전달 여부에 따라 달라집니다:

환경	--ai-analytics	동작 방식
인터랙티브 터미널	예	실패를 즉시 진단합니다
인터랙티브 터미널	아니요	먼저 물어본 후 진단을 제공합니다
CI / 비대화형	예	자동으로 실행되며 진단을 stderr에 출력합니다
CI / 비대화형	아니요	건너뜀 — 아무것도 전송되지 않음

따라서 CI에서는 다음으로 옵트인해야 합니다 --ai-analytics; 터미널에서는 플래그로 미리 옵트인하지 않는 한 항상 먼저 물어봅니다.

제공되는 기능

간결하고 핵심을 짚는 마크다운 리포트:

• 예상 원인 — 한 문장.
• 증빙 — 로그에서 가장 관련이 높은 1~3줄 인용.
• 권장 수정 사항 — 변경할 numbered steps 여러분의 project (서명 설정, 누락된 capability, Gradle 또는 CocoaPods 문제, 플러그인 충돌 등).

로그가 모호하면 그렇게 명시하고, 상위의 가설을 나열합니다. 존재하지 않는 오류를 지어내지 않습니다.

로그, 원하는 방식으로

AI 진단은 선택적(opt-in)입니다 — 다음을 전달하거나 프롬프트를 확인하지 않는 한 아무것도 전송되지 않습니다 --ai-analytics 또는 프롬프트를 확인해야 합니다.

• Capgo AI (기본값): 빌드 로그가 잘려서 Capgo의 분석 엔드포인트(Cloudflare Workers AI에서 실행됨)로 전송되며, 진단을 생성하는 데 필요한 최소 시간만 유지됩니다. 빌드 로그는 일반 저장소의 일부가 아니므로 빌드 중 터미널로 스트리밍됩니다.
• 로그를 로컬에 유지하려면: 인터랙티브 터미널에서는 CLI 로 로컬 프롬프트 파일을 작성하도록 할 수 있습니다 — 동일한 진단 지침과 로그를 포함하여, 이를 직접 LLM에 붙여넣을 수 있습니다. 로그는 기기를 떠나지 않습니다.

참고

분석은 빌드 로그를 신뢰할 수 없는 데이터로 취급하므로, 지시문처럼 보이는 로그 줄(프롬프트 인젝션 시도)이 진단을 탈취하지 못합니다.