GitHub Copilot CLI 및 Claude Code용 WinUI 에이전트 플러그 인

winui@awesome-copilot 플러그인은 GitHub Copilot CLI와 Claude Code에 WinUI 3 및 Windows 앱 SDK에 대한 정확하고 최신 정보를 제공합니다. 여기에는 8개의 특수 기술 및 전체 개발 루프(스캐폴드, 빌드, 실행, 테스트, 패키지 및 마이그레이션)를 통해 AI를 안내하는 전용 winui-dev 에이전트가 포함되어 있습니다.

메모

이 플러그 인은 GitHub Copilot CLI(터미널 도구) 및 Claude Code 함께 작동합니다. 현재 VS Code Copilot Chat 통합되지 않습니다. 플러그 인이 없는 VS Code 기반 AI 지원은 빠른 시작을 참조하세요.

이 플러그 인이 필요한 이유는 무엇인가요?

플러그 인이 없으면 AI 코딩 에이전트는 Windows 개발을 위해 오래된 UWP 패턴을 자주 제안합니다. UWP에는 WinUI 3보다 훨씬 많은 학습 데이터(Stack Overflow 답변, GitHub 샘플, 자습서)가 있으므로 에이전트는 기본적으로 사용되지 않는 API를 사용합니다.

플러그 인이 없는 경우 플러그 인 포함
Windows.UI.Xaml.Controls Microsoft.UI.Xaml.Controls
CoreDispatcher DispatcherQueue
MessageDialog ContentDialog
Windows.UI.Xaml.Window Microsoft.UI.Xaml.Window

플러그 인은 에이전트의 학습 데이터 기본값을 재정의하는 사용자 지정 지침으로 명시적 WinUI 3 규칙을 삽입하여 이 문제를 해결합니다.

플러그 인 설치

필수:Windows 앱 Development CLI(winget install Microsoft.winappcli --source winget).

GitHub Copilot 명령 줄 인터페이스 (CLI)

Requires:GitHub Copilot CLI(winget install GitHub.Copilot).

gh copilot plugin install winui@awesome-copilot

그러면 플러그인이 ~\.copilot\installed-plugins\에 사용자 전역으로 설치됩니다. 다음으로 확인:

gh copilot plugin list

클로드 코드

Claude Code는 자체 플러그 인 레지스트리를 사용합니다.

claude plugin marketplace add microsoft/win-dev-skills
claude plugin install winui@win-dev-skills

GitHub Copilot CLI와 함께 사용

GitHub Copilot CLI는 터미널에서 실행됩니다. 프롬프트에 @winui-dev 에이전트를 포함해 사용하세요.

gh copilot -p "@winui-dev Build me a WinUI 3 app that shows a list of files in a folder"

후속 질문을 할 수 있는 대화형 세션의 경우:

copilot -i

그런 다음 요청을 직접 입력합니다(예: @winui-dev 내 파일 목록 앱에 검색 상자 추가).

WinUI 3 개발을 위해 머신을 설정하려면 먼저 기술을 winui-setup 실행합니다.

gh copilot -p "/winui-setup"

Claude Code와 함께 사용

플러그 인을 설치한 후 Claude Code의 채팅 인터페이스에서 에이전트를 동일한 방식으로 사용합니다 @winui-dev . 즉, 요청에 접두사를 추가 @winui-dev합니다.

winui-dev 에이전트

에이전트는 winui-dev 전체 개발 루프를 오케스트레이션합니다. 각 단계를 구동하고, 제네릭 에이전트가 루프에 갇혀 있는 일반적인 실패 패턴을 인식하고, 성공적인 WinUI 3 패턴을 향해 조종하는 방법을 알고 있습니다.

에이전트는 기본적으로 winui-designwinui-dev-workflow를 로드하며, 이를 통해 "WinUI 3 앱을 만들어 줘"와 같은 요청 대부분을 엔드 투 엔드로 처리할 수 있습니다. 요청에 따라 필요한 경우 다른 기능을 불러옵니다.

8 기술

플러그 인에는 8 가지 특수 기술이 포함되어 있습니다. 에이전트는 winui-dev 요청에 따라 자동으로 적절한 기술을 선택합니다.

기술 용도
winui-setup .NET SDK, WinApp CLI, WinUI 3 템플릿, 개발자 모드 등 시스템 필수 구성 요소를 설치하고 확인합니다. /winui-setup로 명시적으로 실행하세요; 에이전트가 이를 자동으로 로드하지 않습니다.
winui-dev-workflow 스캐폴드 → 빌드 → 실행 → 반복 루프를 안내합니다.
winui-design WinUI 3 컨트롤과 Fluent Design을 사용하여 XAML 레이아웃을 생성합니다. WinUI Gallery 및 Community Toolkit 카탈로그를 기반으로 하는 컨트롤 조회 도구 포함
winui-code-review WinUI 3 정확성 및 안티 패턴에 대한 코드 검토
winui-ui-testing Windows UI 자동화 사용하여 UI 테스트 생성
winui-packaging MSIX 패키징, 서명 및 스토어 제출 가이드
winui-wpf-migration API 수준 매핑을 사용하여 WPF 코드를 WinUI 3으로 마이그레이션
winui-session-report 세션에서 빌드된 내용을 요약하고 다음 단계를 제안합니다.

더 많은 플러그 인 찾아보기 및 검색

Awesome Copilot 확장을 사용하여 VS Code에서 직접 Copilot 플러그 인을 찾아 설치할 수 있습니다. 이를 통해 커뮤니티 리포지토리에서 작업 영역으로 리소스를 미리 확인하고 설치할 수 있습니다.