GitHub Docs: Copilot의 '러버덕' 에이전트로 두 번째 의견 받기
리퀘오 운영팀
이 글은 GitHub Docs의 안내 문서를 한국어로 옮긴 것으로, GitHub Copilot CLI와 Copilot 앱에서 제공되는 내장 에이전트 '러버덕'의 개념과 활용법을 다룬다. Copilot에게 계획이나 코드를 맡겨 두고 결과물의 품질이 걱정되는 개발자, 특히 복잡한 변경을 진행 중인 사용자에게 도움이 된다.
1. 러버덕 에이전트란
러버덕은 Copilot CLI와 GitHub Copilot 앱에 내장된 에이전트로, 건설적인 비평가 역할을 한다. 세션을 이끄는 메인 에이전트가 작업 도중 현재의 계획, 설계, 구현, 테스트를 러버덕 에이전트에 넘겨 검토를 요청할 수 있다. 러버덕 에이전트는 사각지대, 설계 결함, 실질적인 문제를 찾아 구체적이고 실행 가능한 피드백을 돌려주고, Copilot은 이를 반영한 뒤 작업을 이어간다. 러버덕 에이전트는 제안된 변경을 검토하는 용도로 설계되었으며 스스로 파일을 수정하지는 않는다. 피드백을 어떻게 반영할지는 세션의 메인 에이전트가 결정한다.
2. 이름의 유래
이 이름은 소프트웨어 공학의 오랜 기법인 '러버덕 디버깅'에서 왔다. 자신의 코드나 해결책을 무생물, 전통적으로는 고무 오리에 대고 설명하는 방식이다. 생각을 말로 풀어내는 과정에서 실수나 오해, 논리적 결함을 발견하게 된다는 발상이다. 러버덕 에이전트는 같은 아이디어를 Copilot에 적용한 것이다. 사소하지 않은 변경을 진행하기 전에 Copilot이 잠시 멈춰 현재 사고를 정리하고, 독립적인 검토자에게 이를 점검받는다. 진짜 고무 오리와 다른 점은 말을 되돌려준다는 것이다. Copilot이 활용할 수 있는 구조화된 비평을 돌려준다.
3. 다른 모델의 두 번째 의견
러버덕 에이전트의 핵심 설계는 세션을 구동하는 모델과 의도적으로 다른 AI 모델에서 동작한다는 점이다. Copilot은 현재 세션 모델과 대조되는 비평 모델을 고른다. 예를 들어 세션에 Claude 모델을 쓰고 있다면 러버덕 에이전트는 GPT 모델을 비평자로 쓸 수 있다. 유용한 비평을 줄 수 있는 적합한 모델이 있을 때만 러버덕 에이전트를 사용한다. 다른 모델을 쓰면 비평자가 작업을 만든 모델과 같은 사각지대, 편향, 실패 유형을 공유할 가능성이 낮아진다. 결과적으로 같은 문제에 대해 독립적인 두 관점을 얻게 된다. 적절한 비평 모델은 러버덕 에이전트가 호출될 때마다 현재 세션 모델을 기준으로 자동 선택된다. 세션 중 모델을 바꾸면 다음 호출부터 새 세션 모델에 맞는 비평자가 선택된다.
4. 러버덕 에이전트가 하는 일
호출되면 러버덕 에이전트는 다음을 수행한다.
- 맥락 속에서 작업을 읽는다. 코드, 설계, 제안이 무엇을 달성하려는지, 시스템의 나머지 부분과 어떻게 맞물리는지, 어떤 가정이 있는지 파악한다.
- 실제 문제를 찾는다. 버그, 논리 오류, 보안 취약점, 설계 결함, 안티패턴, 성능 병목 등 작업 성공에 실질적으로 영향을 주는 문제를 찾는다.
- 구체적인 수정을 제안한다. 발견한 문제마다 문제점, 영향, 구체적인 변경 제안을 제시한다.
- 피드백을 심각도로 분류한다. 차단 이슈는 작업 성공을 위해 반드시 고쳐야 하는 것, 비차단 이슈는 품질 향상을 위해 고치는 게 좋지만 성공을 막지는 않는 것, 제안은 우선순위는 낮지만 결과에 실질적 영향을 주는 개선 사항이다.
- 의미 있는 발견만 보고한다. 문제가 없으면 없다고 명확히 밝힌다. 러버덕 에이전트는 스타일, 서식, 명명 규칙, 주석 문법, 사소한 리팩터링, 실제 문제를 막지 않는 모범 사례에는 논평하지 않도록 설정되어 있다.
러버덕 에이전트는 표준 탐색 도구를 통해 코드베이스에 읽기 전용으로 접근한다. 파일을 편집하거나 환경을 바꾸는 명령을 실행할 수는 없다.
5. 러버덕 에이전트 직접 호출하기
기본적으로 러버덕 에이전트는 자동 호출되지 않는다. 비평이 필요할 때마다 Copilot에 명시적으로 요청해야 한다. 예를 들어 작업 계획을 만들게 한 뒤 다음과 같이 입력할 수 있다.
```copilot
Rubber duck your plan.
```
(뜻: 방금 세운 계획을 러버덕 에이전트에게 검토받아 줘.)
일련의 변경을 진행하다 중간에 다음과 같이 요청할 수도 있다.
```copilot
Get a critique of the changes you've made so far.
```
(뜻: 지금까지 한 변경에 대한 비평을 받아 줘.)
슬래시 명령으로도 호출할 수 있다.
```copilot
/rubber-duck What edge cases are missing?
```
(뜻: 빠진 경계 사례가 무엇인지 물어본다.)
6. 러버덕 에이전트 자동 호출하기
Copilot CLI에서 요청하지 않아도 Copilot이 먼저 러버덕 에이전트를 참고하게 하려면 /subagents 선택기에서 자동 호출을 켜면 된다.
- 대화형 Copilot CLI 세션에서 /subagents를 입력한다.
- 방향키로 러버덕 에이전트를 선택하고 Enter를 누른다.
- Proactive invocation을 선택하고 Enter로 설정을 켜고 끈다.
- Esc 키로 /subagents 선택기를 빠져나온다.
이렇게 자동 호출을 켜면 Copilot 설정 파일(보통 ~/.copilot/settings.json)이 갱신되어 이후 세션에도 설정이 유지된다.
```json
{
"subagents": {
"agents": {
"rubber-duck": {
"autoInvoke": true
}
}
}
}
```
자동 호출이 켜지면 Copilot은 막혔을 때만이 아니라 효과가 큰 시점에 러버덕 에이전트를 참고하도록 지시받는다. 대표적인 상황은 다음과 같다.
- 사소하지 않은 변경을 계획한 뒤, 구현 전에. 설계 결함을 잡기에 가장 효과가 큰 시점이며 방향 수정 비용도 아직 싸다.
- 구현 중간에, 복잡한 작업의 사각지대를 점검할 때.
- 테스트를 작성한 뒤, 테스트 커버리지가 충분한지, 동작이 원래 요청을 실제로 충족하는지 검증할 때.
- 반복적인 실패나 예상 밖의 결과가 나올 때, 같은 방식을 재시도하는 대신 독립적인 문제 분석을 얻고자 할 때.
작고 잘 이해된 변경이라면 Copilot은 보통 러버덕 에이전트를 건너뛴다. 러버덕 에이전트를 참고하면 Copilot은 나온 비평을 그대로 반복하지 않고 세션 출력에 요약해 전한다. 예를 들어 "비평에서 내 계획의 X 부분에 사각지대가 있다고 지적해 계획을 수정했다"는 식이다.
7. 러버덕 에이전트를 쓰면 좋은 점
- 문제를 일찍 잡는다. 실패하는 사소하지 않은 작업 대부분은 계획 단계에서 비평으로 잡을 수 있었던 문제를 안고 있다. 코드를 쓰기 전에 피드백을 받는 편이 나중에 고치는 것보다 낫다. 다만 러버덕 에이전트를 참고하면 별도 모델에서 추론을 한 번 더 돌리므로 지연이 늘고 모델 사용량도 추가된다. 대신 초반에 시간과 자원을 조금 더 써서 문제를 일찍 잡고 실패한 시도를 줄이면 전체적으로 시간과 모델 사용량을 아낄 수 있다.
- 단일 모델의 사각지대를 줄인다. 다른 계열의 모델을 쓰기 때문에 원래 작업을 만든 추론을 그대로 반복하는 대신 진짜 다른 관점을 제공한다.
- 복잡한 변경의 품질을 높인다. 아키텍처 결정, 여러 파일에 걸친 변경, 낯선 코드베이스는 Copilot이 방향을 확정하기 전에 두 번째 의견을 받으면 도움이 된다.
- 단순한 작업에서는 거치지 않는다. 사소하지 않은 작업에서만 러버덕 에이전트를 참고하므로 빠른 수정이나 명백한 수정 작업을 늦추지 않는다.
여러분은 러버덕 에이전트를 실제로 써 보면서 어떤 점이 유용했는지, 혹은 아쉬웠는지 경험을 댓글로 나눠 주세요.
---
출처: GitHub Docs 「러버덕 에이전트로 두 번째 의견 받기」 (GitHub)
https://docs.github.com/en/copilot/concepts/agent-capabilities/choosing-and-delegating-agent-work/getting-a-second-opinion
라이선스: CC BY 4.0 https://creativecommons.org/licenses/by/4.0/deed.ko
변경 사항: 리퀘오 운영팀이 2026-11-10에 한국어로 번역하고 일부 축약·재구성했습니다. 원문 작성자가 이 번역을 보증하지 않습니다.
도움돼요 0 로그인하면 누를 수 있습니다. 로그인하면 저장하고 새 답글 알림을 받을 수 있습니다.