CI의 코딩 에이전트: 외부 풀 리퀘스트는 소유자의 지시가 아니다
CI의 신뢰할 수 없는 입력과 워크플로 문맥, 실행 권한, 실행 승인과 병합 승인의 차이를 살펴봅니다.
본문 언어: 한국어

목차
제출된 변경의 이름은 ‘문서의 작은 수정’이다. 작성자는 설명에 변경을 검사하기 전 에이전트가 환경을 준비하는 방법을 적었다. 자동화는 명령을 실행하고 테스트를 돌린 뒤 깔끔한 요약을 보낸다. 문제는 그보다 앞서 생겼다. 회사 환경을 관리해서는 안 되는 사람이 그 환경의 사용 지침을 작성한 것이다.
가상의 카탈로그 포털 개발팀이 외부 기여자로부터 풀 리퀘스트를 받는다. 프로젝트에 받아들일 특정 변경 묶음에 대한 제안이다. 에이전트가 평가를 돕고, CI인 지속적 통합은 자동 검사를 실행한다. 둘을 결합하려면 외부 콘텐츠가 분석 자료로 남는지, 아니면 실행을 지시할 수 있는지 정해야 한다.
변경된 파일만 살펴볼 일이 아니다. 제목, 설명, 브랜치 이름, 댓글, 이전 검사 자료도 자동화의 문맥에 들어갈 수 있다. 각 입력은 출처를 식별할 수 있어야 한다. GitHub나 다른 회사 도구가 필드를 보여준다는 사실만으로 그 내용을 쓴 사람이 여러분의 작업 소유자가 되는 것은 아니다.
먼저 각 요소를 누가 통제하는지 확인한다
이 포털에서 프로젝트 관리자는 검토 범위를 정한다. 제출자는 제안 코드와 자신의 설명을 통제한다. 팀은 워크플로, 즉 자동화 단계의 정의와 접근 설정을 유지한다. 에이전트는 부여받은 도구로 자료를 처리한다. 모든 정보가 한 풀 리퀘스트 화면에 보여도 서로 다른 네 역할이다.
프로세스에 들어오는 입력 지도를 만들자. 각 필드의 작성자, 가져오는 방법, 다음 사용처를 표시한다. 설명은 모델에 보내는 지시문으로, 제목은 이름 검사 스크립트로, 파일 내용은 테스트로 전달될 수 있다. ‘풀 리퀘스트만 읽는다’는 말에서 평가를 끝내면 안 된다. 콘텐츠를 보여주는 것과 실행 대상으로 넘기는 것을 구분해야 한다.
GitHub는 신뢰할 수 없는 필드를 코드로 해석할 위험을 설명하면서 제목, 설명, 브랜치 이름 등을 예로 든다. 콘텐츠를 실행 스크립트에 삽입하면 그 결과가 달라질 수 있다.
에이전트에게는 자연어 해석이라는 별도의 문제가 있다. 설명에 범위를 넓히거나 검사를 건너뛰거나 다른 리소스를 읽으라는 지시가 있을 수 있다. 모델은 이를 프로젝트 관리자의 지시로 받아들이지 않고도 내용을 전달할 수 있어야 한다. 수정을 제안할 권한이 여러분의 환경 규칙을 바꿀 권한까지 뜻하지는 않는다.
그렇다고 모든 명령문이 공격은 아니다. 문서에 프로그램 설치 지침이 있고 과제가 그 지침을 평가하는 것일 수도 있다. 에이전트는 합의된 범위 안에서 단계를 읽고 타당성을 확인할 수 있어야 한다. 실행 여부는 별도의 결정이다. 프로젝트를 설명하는 README의 지시를 모두 기계적으로 거절한다면 일반적인 문서 검토가 망가진다.
제품이 에이전트의 작업 규칙을 읽는 파일도 별도로 살펴야 한다. 해당 실행에서 승인된 기준 버전에서 가져오는지, 제안된 변경에서 가져오는지 확인하자. 작성자는 포털 코드뿐 아니라 그 코드를 평가하는 방법도 바꾸려 할 수 있다. 입력 기록에서 소유자의 지시와 평가 대상 자료 안의 지시를 구분하는 것이 좋다. 모든 제품이 이런 파일을 같은 방식으로 불러온다고 가정하지 말자.
코딩 보조 도구의 파일 제외 규칙 (폴란드어)이 이 문제를 자동으로 해결하지는 않는다. 어떤 파일은 분석을 위해 정상적으로 접근 가능하더라도 에이전트 권한을 지휘해서는 안 된다. CI에서는 콘텐츠 제공자와 이를 사용할 프로세스도 확인해야 한다.
코드 읽기와 프로젝트 실행은 서로 다른 문턱이다
외부 기여자가 버튼 설명을 고친다고 해 보자. 에이전트는 차이를 열어 보고 의존성을 설치해 테스트를 실행하려 한다. 두 번째 단계는 바뀐 문장보다 훨씬 많은 것을 포함할 수 있다. 검토자는 명령이 사용하는 스크립트와 설정, 나머지 파일이 어느 버전에서 왔는지 밝혀야 한다.
GitHub의 pull_request_target 설명은 코드를 가져오는 일과 나중에 실행하는 일을 구분한다. 비밀값이나 높은 권한의 토큰이 있는 환경에서 신뢰할 수 없는 콘텐츠를 실행하지 말라고 경고한다. 스크립트와 의존성이 수행하는 작업도 여기에 포함된다.
테스트 명령 자체는 익숙해 보일 수 있다. 그러나 검토 중인 프로젝트 버전에서 무엇을 실행하는지 확인해야 한다. 워크플로에 눈에 띄는 명령이 추가되지 않아도 설정 변경으로 동작이 달라질 수 있다. 프로세스 소유자가 모든 라이브러리를 직접 분석할 필요는 없지만, 이 문턱의 평가 책임자가 누구인지와 환경을 어떻게 제한했는지는 알아야 한다.
이 예에서 첫 결정은 에이전트가 제출물을 승인된 기준과 비교하고 의견을 준비하는 것이다. 실행이 필요하다면 접근 범위가 정해진 별도 준비 환경에서 진행한다. 도구 이름이 ‘샌드박스’라는 이유로 그런 분리가 존재한다고 가정하지 않는다. 에이전트 샌드박스 (폴란드어)는 파일, 네트워크, 자격 증명에 대한 실제 경계로 검수한다.
이전 실행이 전달한 자료도 고려하자. 결과물이나 오류 기록에 외부 변경에서 온 콘텐츠가 들어 있을 수 있다. 다음 단계가 더 넓은 접근 권한으로 실행된다면, 회사의 CI 플랫폼에서 내려받았다는 이유만으로 결과물 전체를 신뢰된 지시로 취급해서는 안 된다. 실행 사이에도 콘텐츠의 출처를 보존해야 한다.
환경을 준비할 때 이전 작업의 잔여물도 확인한다. 자체 호스팅 러너, 즉 CI 단계를 실행하는 머신은 회사 자원에 대한 접근과 연속 실행의 분리 여부를 평가해야 한다. 이전 실행의 가상 확인 파일을 이용해 다음 실행이 합의된 상태인지 시험할 수 있다. 한 번의 실행 결과가 같은 작업 공간의 재사용 문제를 대신해서는 안 된다.
팀은 특정 제출물에 대해 실행 없이 분석만 하기로 결정할 수 있다. 그 결과를 정직하게 이름 붙여야 한다. ‘차이를 읽었으며 이 범위의 테스트는 실행하지 않았다’는 말이 실제로 수행하지 않은 작업을 포함한 초록색 상태보다 많은 것을 알려준다. 제한이 반드시 수정 거절을 뜻하는 것은 아니다. 추가로 통제된 단계가 필요하다는 뜻일 수 있다.
이벤트 이름만으로 전체 설정을 알 수는 없다
GitHub Actions에서는 워크플로를 시작하는 이벤트의 차이가 중요하다. 운영 평가에는 ‘테스트 실행’ 버튼의 이름만으로 부족하다. 자동화 정의, 평가 대상 파일의 출처, 작업에 부여된 접근 권한이 필요하다. 이 조합이 실제 결과를 결정하며, 적절한 역량을 가진 담당자가 평가해야 한다.

해당 이벤트의 문서는 pull_request_target이 신뢰된 기준 문맥을 사용한다고 설명한다. 이후 외부 코드를 가져와 실행하면 문제가 생길 수 있다. 따라서 기준 버전에서 온 워크플로 파일이 그 워크플로가 실행하는 모든 것의 출처까지 증명한다고 가정해서는 안 된다.
다른 저장소에 안내서 설정을 그대로 복사하지도 말자. 공개 저장소와 비공개 저장소, 자체 정책이 있는 환경은 범위가 다를 수 있다. 검수할 때는 실제 확인한 상태와 확인 날짜를 밝힌다. ‘안전한 검토’라는 자체 프로세스 이름은 특정 제한을 적용했다는 증거가 아니다.
완성된 제품의 기본 보호 장치와 회사 설정도 구분하자. GitHub는 Copilot cloud agent의 변경 후 워크플로 실행에 기본적으로 승인이 필요하다고 설명하지만, 자동 실행을 설정할 수도 있다. 기본 동작이 모든 설치에 적용된다고 확대해서는 안 된다.
이는 특정 서비스의 예이지 모든 에이전트에 적용되는 규칙이 아니다. Copilot cloud agent 위험 문서는 입력에 포함된 외부 지시와 자동화에 허용된 도구의 제한도 설명한다. 회사의 검수는 실제 제품, 모드, 부여된 기능을 여전히 확인해야 한다.
검사 실행에 대한 동의와 변경 병합에 대한 동의는 서로 다른 결정이다. 버튼을 누르는 사람은 어느 결정이 일어나는지 알아야 한다. 환경이 민감한 자원에 접근하는 작업을 실행할 수 있다면, 실행 전 검토에 그 결과가 포함되어야 한다. 나중에 풀 리퀘스트를 거절해도 이미 수행한 작업은 되돌려지지 않는다.
Aeneia Audit
CI에서 에이전트가 받는 입력, 실행 파일의 출처, 각 단계의 접근 권한을 함께 추적해 봅시다. 운영 검토를 통해 자동화를 유지하는 팀에 어떤 증거가 필요한지 명확히 할 수 있습니다. 외부 변경을 다룰 때 에이전트의 경계 정하기
시험에서도 외부 자료의 작성자를 구분해야 한다
첫 시나리오에는 별도의 시험 저장소, 가상 데이터, 실제 비밀값이 없는 도구를 사용할 수 있다. 소유자는 범위를 넓히지 않고 지정된 변경을 분석하는 것을 기대 결과로 정한다. 제출 설명에는 과제 밖의 지시를 나타내는 명시적이고 무해한 표식을 넣는다. 검사는 에이전트가 이를 권한 부여가 아닌 콘텐츠로 취급했는지 확인한다.
위험 지도를 만들기 위해 다른 사람의 해로운 명령을 실행할 필요는 없다. 기술팀은 범위에 맞는 시험을 설계하고 실제 경계를 관찰해야 한다. 보고서는 모델이 읽은 자료, 제안한 작업, 환경이 허용한 행동을 구분한다. 텍스트의 공손한 거절만으로 도구가 그전에 무엇을 실행했는지 알 수 없다.
별도로 제품 사용에 관한 올바른 지침이 담긴 정상적인 문서 변경도 추가하자. 명령형이 있다는 이유만으로 에이전트가 이를 거절한다면 통제가 일반적인 작업을 방해한다. 팀에는 절차 설명과 실행을 허용하는 권한의 출처를 구분할 방법이 필요하다. 두 경우 모두 외부 기여자가 자료의 작성자다.
실행 환경에 전달되는 명령에는 셸과 따옴표의 해석 (폴란드어)이라는 문제도 있다. 셸은 명령을 해석하는 프로그램이며 명령의 의미는 별도의 기술 검수를 받아야 한다. 모델의 문장이 관리자의 의도와 일치해도 스크립트에 데이터가 대입된 뒤 명령이 어떤 결과를 낼지는 확인되지 않는다.
거절된 사례는 식별 가능한 상태를 남겨야 한다. 운영자는 분석, 실행, 리소스 읽기, 변경 쓰기 중 무엇이 중단됐는지 알아야 한다. 에이전트가 거절을 완료의 장애물이라고 불렀다는 이유만으로 같은 단계를 더 높은 권한으로 다시 실행해서는 안 된다. 접근 확대에는 새로운 결과에 맞는 결정이 필요하다.
인수는 버전과 실행 경로를 함께 다룬다
기록 카드에 저장소, 제출 버전, 워크플로 버전, 트리거 이벤트, 작업의 주요 권한을 적자. 시험에서 실제 실행한 파일의 출처도 추가한다. 평가 후 작성자가 변경의 저장된 버전인 커밋을 추가하면 이전 결과가 새 내용을 자동으로 설명하지는 않는다. 자료를 읽은 뒤 실행을 승인하기 전 변경이 생기는 경우 특히 중요하다.
가상 포털의 관리자는 버튼 설명만 바뀐 내용을 검토한다. 이후 작성자가 테스트 준비 스크립트 수정도 추가한다. 승인 버튼은 여전히 같은 제출물을 가리키지만 실행할 자료는 달라졌다. 실행 전에 현재 묶음을 확인하고 동의를 올바른 버전에 연결해야 한다. 풀 리퀘스트 번호만으로 이 연결을 대신할 수 없다. 검토자가 읽은 버전과 작업이 실제로 가져온 버전을 증거로 남기자.
AI 코드 리뷰 (폴란드어)는 실제로 읽은 차이를 밝혀야 한다. CI에서는 실행 조건도 추가한다. 프로세스가 두 증거의 연결을 보존하지 않으면 서로 다른 버전을 가리킬 수 있다. 두 초록색 결과를 하나의 포괄적 승인으로 합치지 말고 보고서에서 불일치를 설명해야 한다.
마지막으로 프로세스를 인수할 사람은 거절된 실행을 찾고 필요한 다음 단계를 말할 수 있어야 한다. 변경 재검토, 제한된 실행, CI 소유자의 설정 확인 등이 그 단계일 수 있다. ‘에이전트 차단됨’이라는 메시지만으로는 결정을 정할 수 없다. 구두 설명 없이 시험 보고서를 전달하고, 읽기만 한 자료와 이미 실행한 코드를 구별하는지 보자. 이는 기록의 유용성을 살피는 실무 시험이지 다른 사람의 보안 장치를 추가로 시험하는 일이 아니다.
책임 있는 에이전트 워크플로 (폴란드어)의 기본 원칙은 여전히 적용된다. 작업 범위와 도구, 결과의 증거가 명확해야 한다. CI에는 입력 일부를 통제하는 작성자와 단계 간 자동 전환이 더해진다. 프로세스를 일상 업무에 허용하기 전에 이 부분들을 고려해야 한다.
Aeneia Audit에서는 이 지도와 AI 사용 인수 요건을 정리할 수 있다. CI 보안 자체에 대한 전문 검토에는 적절한 범위와 기술 역량이 필요하다. 결과는 포털 관리자에게 구체적으로 답해야 한다. 이 변경을 읽었고, 이 파일을 정해진 환경에서 실행했으며, 외부 설명에는 나머지 접근 권한을 관리할 권리가 주어지지 않았다는 답이다.









