GitHub Copilot Custom Agents를 사용하여 더 나은 앱 구축 | James Montemagno

dimohy · 11월 3, 2025, 5:51오후

github-copilot 커스텀-에이전트 #WinForms #코드 품질 개발 생산성

첫 번째 요약: 핵심 인사이트

GitHub Copilot의 새로운 커스텀 에이전트 기능이 WinForms 개발의 코드 품질을 극적으로 향상시키는 방법을 보여줍니다. 표준 Copilot 에이전트와 WinForms 전문가 에이전트로 동일한 기능을 구현했을 때, 같은 시간에 더 나은 코드, 더 나은 아키텍처, 더 나은 사용자 경험을 얻을 수 있습니다. 개발자의 도메인 지식을 증폭하고 프레임워크 특정 패턴을 자동으로 적용하는 방식으로, 개발 속도와 품질을 동시에 높일 수 있다는 실제 사례입니다.

두 번째 요약: 상세 분석

커스텀 에이전트란 무엇인가?

개념:

GitHub Copilot 코딩 에이전트의 특화된 버전으로, 팀의 특정 워크플로우와 코딩 규칙에 맞게 커스터마이징 가능
마크다운 파일(에이전트 프로필)로 정의되는 "맞춤 팀원"과 같은 존재
반복적인 지시사항을 매번 제공할 필요 없이, 팀의 표준과 도구를 자동으로 적용

에이전트 프로필의 구성 요소:

이름과 설명 - 에이전트의 전문 영역
커스텀 프롬프트 - 에이전트의 행동과 전문성을 정의하는 상세 지시사항
도구 - 에이전트가 접근 가능한 특정 도구 (선택사항)
MCP 서버 - Model Context Protocol 서버 구성으로 에이전트 강화

커스텀 에이전트 사용 가능 위치

다양한 플랫폼에서 일관된 지원:

GitHub.com: 에이전트 탭, 패널, 이슈 할당, 풀 리퀘스트
Visual Studio Code: 에디터의 채팅 모드
GitHub Copilot CLI: 커맨드라인 인터렉션

각 인터렉션은 에이전트의 정의된 프로필을 기반으로 일관성을 유지하여, 특정 요구사항에 맞춤화된 지원을 제공합니다.

커스텀 에이전트 구성 위치

다층 레벨의 구성:

저장소 레벨: .github/agents/ 디렉토리에 .md 파일 배치 (프로젝트 특정 에이전트)
조직 레벨: 더 넓은 팀 범위의 사용
엔터프라이즈 레벨: 회사 전체 표준화

에이전트 프로필 예시:

---
name: readme-creator
description: README 파일 생성 및 개선을 전문으로 하는 에이전트
---

당신은 README 파일에 중점을 둔 문서 전문가입니다. 
당신의 범위는 README 파일 또는 관련 문서 파일만 제한됩니다. 
코드 파일을 수정하거나 분석하지 마십시오.

지시사항 포커스:
- 명확한 프로젝트 설명을 포함한 README.md 파일 생성 및 업데이트
- README 섹션을 논리적으로 구조화: 개요, 설치, 사용, 기여
- 제목과 포매팅이 있는 스캔 가능한 콘텐츠 작성
- 적절한 배지, 링크, 네비게이션 요소 추가

WinForms 전문가 에이전트의 특징

깊이 있는 도메인 지식:

WinForms 개발의 고유한 문제들을 이해하고 해결하는 전문화된 에이전트입니다.

디자이너 코드 vs. 일반 코드 분리
- WinForms의 두 가지 고유한 코드 컨텍스트 관리
- 각 컨텍스트에서 허용되는 C# 기능 구분
현대적 .NET 패턴 (NET 8-10)
- MVVM 데이터 바인딩 패턴 + Community Toolkit
- Async/await 패턴과 올바른 InvokeAsync 오버로드 선택
- DarkMode 지원 및 고-DPI 인식
- Nullable 참조 타입(NRTs)의 적절한 사용
레이아웃 모범 사례
- TableLayoutPanel과 FlowLayoutPanel을 사용한 반응형, DPI 인식 레이아웃
- 다양한 화면 크기와 스케일링에 대응
CodeDOM 직렬화 관리
- WinForms 디자이너의 속성 직렬화에 대한 핵심 규칙
- [DefaultValue] 속성 및 ShouldSerialize*() 메서드의 일반적인 함정 방지
예외 처리
- Async 이벤트 핸들러에 대한 적절한 패턴
- 프로세스 충돌을 방지하는 애플리케이션 레벨 예외 처리

에이전트의 특성:

제어 명명 규칙부터 접근성 요구사항까지 모든 것을 다루는 상세한 지시사항
시니어 WinForms 아키텍트가 코드의 모든 라인을 검토하는 것과 같은 수준

Awesome-Copilot 저장소 발견

GitHub가 관리하는 큐레이션된 커스텀 에이전트 컬렉션으로, C#, WinForms, ARM 마이그레이션, Dynatrace, LaunchDarkly, Neon, PagerDuty 등 다양한 프레임워크와 기술을 위한 전문화된 에이전트를 포함합니다.

실제 사례: 다중 스니펫 기능 구현

프로젝트 소개: Hotkey Typer

Windows Forms 애플리케이션으로, 핫키를 통해 미리 정의된 텍스트 스니펫을 자동으로 입력합니다.

새로운 기능 요구사항:

단일 고정 텍스트 대신 여러 개의 재사용 가능한 스니펫 관리
드롭다운에서 활성 스니펫 선택
New/Copy/Rename/Delete 작업 및 유효성 검사
기존 단일 텍스트 형식에서의 하위 호환성 마이그레이션
settings.json에 모든 데이터 영속성

PR #7: 커스텀 에이전트 없이 (표준 Copilot)

구현 성과:

Snippet 클래스를 사용한 데이터 모델 생성
CRUD 작업 구현
ComboBox와 관리 버튼이 있는 UI
단위 테스트 추가
설정 직렬화 작동

문제점:

레이아웃 비효율: WinForms 모범 사례에 최적화되지 않음
제어 배치 부족: 반응형 리사이징을 위해 앵커/도킹이 제대로 설정되지 않음
WinForms 패턴 누락: 대화 상자 처리에 대한 프레임워크 특정 패턴 미흡
코드 스타일 불일치: 기존 WinForms 규칙과 완벽하게 정렬되지 않음
DPI 스케일링 무시: 접근성 및 고해상도 디스플레이 고려 없음

평가:
일반적인 C# 능력이 있지만 WinForms에 깊이 있는 경험이 없는 개발자가 작성한 코드처럼 보임.

PR #8: WinForms 전문가 에이전트 포함 (커스텀 에이전트)

극적인 개선 사항:

1. 향상된 UI 구성

Snippet: [────────Dropdown (300px)────────▼]
         [New] [Copy] [Rename] [Delete]
         
[Text Editor (460x135)]

[Speed slider, checkboxes, file options]

[Save] [Minimize] [Stop]        Status: Active

적용된 WinForms 모범 사례:

논리적 그룹화: 스니펫 관리 작업의 의미 있는 그룹화
적절한 간격: 최소 3px 마진
반응형 제어: 모든 제어가 반응형 동작을 위해 제대로 앵커됨
DPI 스케일링 고려: 다양한 디스플레이 설정에 대응

2. 향상된 사용자 경험

팝업 대화 상자: New/Copy/Rename 작업에 InputDialog 사용
유효성 검사 피드백: 의미 있는 오류 메시지 제공
중복 감지: 대소문자를 구분하지 않는 중복 검사
보호: 마지막 스니펫 삭제 방지
시각적 피드백: 작업에 대한 더 나은 시각적 피드백

3. 코드 품질 개선

현대적 C# 11-14: 비즈니스 로직에서 최신 기능 활용
코드 분리: 디자이너 코드와 일반 코드의 명확한 구분
파일 범위 네임스페이스: 모던 네임스페이스 선언
Target-typed new: new() 표현식 사용
Nullable 참조 타입: 적절한 위치에 NRT 적용
예외 처리: ArgumentNullException.ThrowIfNull 사용

4. 향상된 문서화

PR 설명에 UI 레이아웃의 상세한 다이어그램 포함으로 구현이 즉시 이해 가능함.

핵심 코드 차이점: Before & After

1. InputDialog 헬퍼 클래스

PR #7 (에이전트 없음):

각 버튼 핸들러에서 반복적인 인라인 대화 상자 생성 코드

PR #8 (WinForms 전문가):

internal class InputDialog : Form
{
    private readonly TextBox txtInput;
    private readonly Button btnOK;
    private readonly Button btnCancel;
    
    public string InputText => txtInput.Text;
    
    public InputDialog(string prompt, string title, string defaultValue = "")
    {
        Text = title;
        FormBorderStyle = FormBorderStyle.FixedDialog;
        StartPosition = FormStartPosition.CenterParent;
        MaximizeBox = false;
        MinimizeBox = false;
        ClientSize = new Size(350, 120);
        
        // 컨트롤 설정...
        
        // 대화 상자가 열릴 때 모든 텍스트 선택
        Load += (s, e) => txtInput.SelectAll();
    }

    public static string? Show(string prompt, string title, string defaultValue = "")
    {
        using var dialog = new InputDialog(prompt, title, defaultValue);
        return dialog.ShowDialog() == DialogResult.OK ? dialog.InputText : null;
    }
}

특징:

재사용 가능한 전용 클래스
using 선언으로 적절한 리소스 해제
Nullable 반환 타입
Static 팩토리 메서드 패턴
WinForms 교과서적 대화 상자 구성

2. 설정 마이그레이션 패턴

PR #7 (에이전트 없음):

로드 실패 시 기존 설정을 무시하는 “처음부터 시작” 접근

PR #8 (WinForms 전문가):

// 마이그레이션: 기존 단일 PredefinedText를 스니펫으로 변환 (스니펫이 없으면)
if (settings.Snippets == null || settings.Snippets.Count == 0)
{
    string contentToMigrate = !string.IsNullOrEmpty(settings.PredefinedText) 
        ? settings.PredefinedText 
        : DefaultSnippetContent;
    snippets = new List<TextSnippet>
    {
        new TextSnippet
        {
            Id = DefaultSnippetId,
            Name = DefaultSnippetName,
            Content = contentToMigrate,
            LastUsed = DateTime.Now
        }
    };
    activeSnippetId = DefaultSnippetId;
}
else
{
    snippets = settings.Snippets;
    activeSnippetId = settings.ActiveSnippetId;
    
    // 활성 스니펫 존재 여부 검증
    if (string.IsNullOrEmpty(activeSnippetId) || 
        !snippets.Any(s => s.Id == activeSnippetId))
    {
        activeSnippetId = snippets.FirstOrDefault()?.Id;
    }
}

특징:

사용자 데이터를 폐기하지 않고 업그레이드 경로를 우아하게 처리
오래된 형식과 새로운 형식 모두 지원
강력한 마이그레이션 논리

3. UI 레이아웃 (디자이너 코드)

PR #7 (에이전트 없음):

var btnNewSnippet = new Button
{
    Text = "New",
    Location = new Point(335, 82),
    Size = new Size(35, 25),  // 답답한 버튼 크기
    Font = new Font("Segoe UI", 8F)
};

문제: 절대 위치 배치, 좁은 간격

PR #8 (WinForms 전문가):

// 스니펫 선택 ComboBox - 넓고 두드러짐
var cmbSnippets = new ComboBox
{
    Name = "cmbSnippets",
    Location = new Point(85, 82),
    Size = new Size(300, 23),  // 가독성을 위한 300px 폭
    DropDownStyle = ComboBoxStyle.DropDownList,
    Font = new Font("Segoe UI", 9F)
};

// 스니펫 관리 버튼 - 드롭다운 아래로 논리적 그룹화
var btnNewSnippet = new Button
{
    Name = "btnNewSnippet",
    Text = "New",
    Location = new Point(85, 110),
    Size = new Size(70, 25),  // 적절한 버튼 크기
    Font = new Font("Segoe UI", 9F)
};

이해도:

ComboBox는 의미 있는 이름을 표시할 충분한 너비 필요
관련 버튼은 시각적으로 함께 그룹화
Font 8F는 현대 디스플레이에서 너무 작음
제어는 유지 관리성을 위해 설명적 이름 필요

4. 유효성 검사 로직

PR #7 (에이전트 없음):

if (string.IsNullOrWhiteSpace(name)) return;
if (snippets.Any(s => s.Name.Equals(name, StringComparison.OrdinalIgnoreCase)))
{
    MessageBox.Show("A snippet with this name already exists.", 
        "Duplicate Name", MessageBoxButtons.OK, MessageBoxIcon.Warning);
    return;
}

문제: 사용자 입력 정리 부재, 오류 메시지 불명확

PR #8 (WinForms 전문가):

// 유효성 검사: 정리 및 고유성 확인 (대소문자 구분 안함)
name = name.Trim();
if (string.IsNullOrEmpty(name))
{
    MessageBox.Show("Snippet name cannot be empty.", 
        "Invalid Name", MessageBoxButtons.OK, MessageBoxIcon.Warning);
    return;
}

if (snippets.Any(s => string.Equals(s.Name, name, StringComparison.OrdinalIgnoreCase)))
{
    MessageBox.Show("A snippet with this name already exists.", 
        "Duplicate Name", MessageBoxButtons.OK, MessageBoxIcon.Warning);
    return;
}

WinForms 전문가의 이해:

사용자 입력 정리 (일반적인 WinForms 패턴)
서로 다른 실패 모드에 대한 구체적인 오류 메시지
명확성을 위해 확장 메서드 대신 string.Equals 사용

5. 현대적 C# 기능 (비즈니스 로직)

PR #8의 일관된 적용:

// 파일 범위 네임스페이스
namespace HotkeyTyper;

// Target-typed new
private List<TextSnippet> snippets = new();

// 표현식 본문 멤버
public string InputText => txtInput.Text;

// Nullable 참조 타입
public static string? Show(string prompt, string title, string defaultValue = "")

// Using 선언 (적절한 리소스 해제)
using var dialog = new InputDialog(prompt, title, defaultValue);

특징:

현대적 기능을 일관되고 적절하게 적용
PR #7도 일부 현대적 기능을 가지고 있지만, PR #8은 이를 체계적으로 적용

6. 포괄적 단위 테스트

PR #8에 포함 (PR #7에는 부재):

[Fact]
public void OldSettings_MigratesToSnippets()
{
    // Arrange - 단일 PredefinedText를 가진 기존 설정 형식
    string oldSettingsJson = """
    {
        "PredefinedText": "Hello, World!",
        "TypingSpeed": 7,
        "HasCode": true
    }
    """;
    
    var oldSettings = JsonSerializer.Deserialize<AppSettings>(oldSettingsJson);
    
    // Act & Assert - 설정이 마이그레이션되어야 함
    Assert.NotNull(oldSettings);
    Assert.Null(oldSettings.Snippets);
    Assert.Equal("Hello, World!", oldSettings.PredefinedText);
}

중요성:

하위 호환성이 정확하게 작동함을 보장
프로덕션 애플리케이션에 필수적인 세부 사항

시각적 차이

커스텀 에이전트 없음

기본 레이아웃, 기능적이지만 광택 부족
제어가 최적으로 배치되지 않음
WinForms 특정 개선사항 누락

WinForms 전문가 포함

깔끔하고 논리적인 구성
전문적인 간격과 정렬
적절한 제어 그룹화
올바르게 스케일되는 반응형 레이아웃

에이전트는 레이아웃 구조를 보여주는 시각적 다이어그램까지 제공하여, WinForms 디자인 패턴에 대한 깊은 이해를 입증합니다.

영향: 품질과 속도

더 나은 아키텍처

PR #8의 장점:

BindingSource 패턴의 올바른 사용 - 데이터 바인딩에 대한 WinForms 모범 사례
올바른 디자이너 코드 직렬화 패턴 - 코드 생성 및 유지 관리의 예방
올바른 컨텍스트의 현대적 C# 기능 - 성능과 가독성 최적화
확립된 WinForms 규칙 준수 - 팀 표준과의 일관성

적은 반복 필요

PR #7:

피드백과 수정을 위한 여러 라운드 필요
프레임워크 사용법에 대한 반복적인 조정

PR #8:

첫 시도에서 거의 완벽
코드 리뷰는 비즈니스 로직에 중점
프레임워크 사용 관련 의견 최소화

지식 이전

학습 효과:

에이전트의 구현을 보며 마스터하지 못했던 WinForms 패턴 학습
코드의 상세한 설명으로 "왜"를 이해
PR 설명이 문서 역할

시간 절감

개발 속도:

여러 날의 반복 작업을 몇 시간으로 단축
디자이너 코드 문제 디버깅 시간 감소
기능 개발에 더 많은 시간 할당 가능

누적 효과:
프로젝트가 진행될수록, 이러한 시간 절감은 더욱 누적되어 프로젝트 전체 일정에 상당한 영향을 미침.

커스텀 에이전트 시작하기

1. Awesome-Copilot 저장소 탐색

GitHub가 관리하는 curated 에이전트 모음 방문:

위치: awesome-copilot/agents at main · github/awesome-copilot · GitHub
포함 에이전트: C#, WinForms, ARM 마이그레이션, Dynatrace, LaunchDarkly, Neon, PagerDuty 등

2. 에이전트를 저장소에 추가

단계별 프로세스:

저장소에 .github/agents/ 디렉토리 생성
awesome-copilot에서 에이전트 .md 파일 복사
필요시 커스터마이징 (선택사항)
커밋 및 푸시

예시 (WinForms Expert):

WinFormsExpert.agent.md를 .github/agents/에 복사
커밋 후 즉시 저장소 전체에서 Copilot에 사용 가능

3. 에이전트 사용

다양한 방식:

GitHub 이슈: 요청에서 에이전트를 이름으로 언급
GitHub 풀 리퀘스트: Copilot 할당 시 에이전트 참조
VS Code: 채팅에서 드롭다운의 에이전트 사용

4. 커스텀 에이전트 생성

팀 특정 규칙을 인코딩한 에이전트 생성:

팀의 코딩 표준
프레임워크 특정 패턴
아키텍처 선호도
테스팅 전략
문서화 요구사항

리소스:

공식 문서: Creating custom agents - GitHub Docs

핵심 교훈

1. 특화가 중요

일반적인 AI 코딩 지원은 좋지만, 프레임워크 특정 패턴을 이해하는 전문화된 에이전트는 혁신적입니다. WinForms Expert 에이전트의 깊이는 ad-hoc 프롬프트로 전달할 수 없는 수준입니다.

2. 팀 전체의 일관성

커스텀 에이전트는 팀의 모든 구성원이 동일한 패턴과 모범 사례를 따르도록 보장합니다. 특정 프레임워크에 대해 경험이 적은 개발자도 전문가 수준의 코드를 생산할 수 있습니다.

3. 실행 가능한 문서화

에이전트 프로필은 팀 코딩 표준의 실행 가능한 문서입니다. 단지 패턴을 설명하는 것이 아니라 그 패턴을 강제합니다.

4. 지식 증폭

전문화된 에이전트는 개발자의 코딩 능력을 증폭합니다. 첫 시도에서 고품질, 패턴 일관성 있는 코드를 반복적으로 보는 것만으로도 개발자들이 최고 사례를 내재화하도록 도움.

5. 속도와 품질의 동시 달성

올바른 커스텀 에이전트는 단순히 코드를 빠르게 생성하는 것이 아니라, 더 빨리 더 나은 코드를 생성합니다. 기술 부채가 감소하고 미래 유지보수 부담이 경감됩니다.

마무리: 미래는 이미 도래했다

PR #7(커스텀 에이전트 없음)과 PR #8(WinForms Expert 포함)의 차이는 AI 지원 개발의 미래를 명확히 보여줍니다. 이는 개발자 전문성을 대체하는 것이 아니라 도메인 특정 지식으로 증폭하는 방식입니다.

실제 효과

Hotkey Typer의 경우, WinForms Expert 에이전트는 업무 요구사항을 충족할 뿐만 아니라 다음을 제공합니다:

완벽하게 작동하는 기능
업계 모범 사례 준수
유지보수 가능성
접근성 고려
향후 확장을 위한 적절한 아키텍처

이 구현은 시니어 코드 리뷰를 최소 의견으로 통과할 수 있습니다.

권장사항

WinForms(또는 기타 특화된 프레임워크)로 작업하는 개발자라면:

Awesome-Copilot 저장소에서 커스텀 에이전트 탐색 강력 권장
팀 특정 에이전트 생성은 생각보다 쉬움

다음 단계:

Hotkey Typer 저장소에서 PR #7과 PR #8 비교 검토
자신의 프로젝트에서 커스텀 에이전트 시도
팀 표준을 인코딩한 에이전트 생성 고려

참고 자료

주요 링크:

Hotkey Typer 저장소: GitHub - jamesmontemagno/app-hotkeytyper
Issue #3 (다중 스니펫 기능): Multiple Saved Snippets & Quick Selection · Issue #3 · jamesmontemagno/app-hotkeytyper · GitHub
PR #7 (에이전트 없음): Multiple Saved Snippets & Quick Selection by Copilot · Pull Request #7 · jamesmontemagno/app-hotkeytyper · GitHub
PR #8 (WinForms Expert): Add multiple snippet management with dropdown selector and popup prompts by Copilot · Pull Request #8 · jamesmontemagno/app-hotkeytyper · GitHub
Awesome Copilot Agents: GitHub - github/awesome-copilot: Community-contributed instructions, prompts, and configurations to help you make the most of GitHub Copilot.
커스텀 에이전트 문서: Creating custom agents - GitHub Docs

실용적 팁 및 주의사항

팁

에이전트 선택:

작은 프로젝트부터 시작하여 에이전트의 효과 측정
팀의 기술 스택과 정확하게 일치하는 에이전트 선택

에이전트 커스터마이징:

기본 에이전트로 시작한 후, 팀 특정 요구사항에 맞게 조정
변경사항을 버전 제어에 유지하여 팀과 공유

지속적인 개선:

정기적으로 에이전트의 효과성을 평가
팀 피드백을 바탕으로 에이전트 프로필 업데이트

주의사항

초기 설정 시간:

에이전트 선택 및 구성에 약간의 초기 투자 필요
하지만 이 투자는 빠르게 회수됨

에이전트의 한계 이해:

커스텀 에이전트도 완벽하지 않음
코드 리뷰와 테스팅은 여전히 필수

팀의 맥락 유지:

에이전트는 도구이며, 팀의 판단과 경험을 대체할 수 없음
에이전트 제안을 항상 검토하고 검증