muaco Tech Note

GitHub Copilotgithub.blog

GitHub Copilot 앱 캔버스 사용법말로 설명해 나만의 업무 화면 만들기

GitHub Copilot 앱에서 /create-canvas로 칸반 보드나 체크리스트 같은 업무 화면을 말로 만들고, 저장해 팀과 함께 다시 쓰는 방법을 따라 합니다.

안녕하세요, muaco입니다.

이 글로 할 수 있는 일

이 글을 끝까지 따라 하면 GitHub Copilot 앱 안에 나만의 업무 화면을 하나 만들 수 있습니다. 칸반 보드, 이슈 분류판, 출시 체크리스트 같은 화면입니다. 코드를 직접 짤 필요는 없습니다.

원하는 화면을 평소 말투로 설명하면 에이전트가 만들어 줍니다. 에이전트는 사람 대신 여러 단계를 알아서 처리하는 AI 도우미입니다. 다 만든 화면은 저장해 두었다가 다음에도 쓰고, 팀과 나눌 수도 있습니다.

캔버스는 함께 쓰는 화면입니다

보통 AI와는 채팅으로만 대화합니다. 할 일 목록을 부탁하면 긴 글이 돌아오고 고치고 싶으면 다시 말로 부탁해야 합니다. 번거롭습니다.

캔버스는 여기에 화면을 하나 더 얹습니다. GitHub 블로그는 캔버스를 "나와 에이전트가 함께 쓰는, 입맛대로 바꿀 수 있는 인터페이스"라고 설명합니다. 칸반 보드, 대시보드, 입력 양식, 스프레드시트까지 모두 캔버스로 만들 수 있습니다.

핵심은 양쪽에서 고칠 수 있다는 점입니다. 에이전트는 일하면서 화면을 갱신하고 나는 버튼이나 카드, 필터로 직접 바꿉니다. 내가 카드를 옮기면 별도의 저장이나 동기화 없이 에이전트도 같은 변화를 봅니다.

미리 갖춰야 할 준비물

  • GitHub Copilot 요금제: 공식 문서는 GitHub Copilot 앱을 모든 Copilot 요금제에서 쓸 수 있다고 밝힙니다.
  • 회사 계정이라면 관리자 설정: Business나 Enterprise 요금제는 조직의 "GitHub Copilot app" 정책이 켜져 있어야 합니다. 이 설정은 관리자만 바꿀 수 있습니다.
  • 운영체제: macOS, Windows, Linux를 지원합니다.
  • GitHub 저장소 하나: 저장소는 프로젝트 파일을 모아 두는 GitHub의 폴더입니다. 캔버스를 만들 때 어느 저장소에서 작업할지 고릅니다.

앱 설치와 로그인은 공식 시작 안내서 기준으로 다음 순서입니다.

  1. GitHub Copilot 앱 소개 페이지에서 내 운영체제에 맞는 설치 파일을 받아 설치합니다.
  2. 앱을 열고 Sign in to GitHub를 눌러 안내대로 로그인하세요. 회사가 GitHub Enterprise 서버를 쓴다면 Use GitHub Enterprise를 고르고 서버 주소를 넣습니다.
  3. Copilot 요금제를 묻는 화면이 나오면 구독하거나 따로 쓰는 모델 제공사를 고릅니다.
  4. 최근 활동을 바탕으로 저장소를 고르라고 하면 쓸 저장소를 선택합니다. 건너뛰고 나중에 추가해도 됩니다.
  5. 테마를 고르고 안내를 마치면 앱이 열립니다.

따라 하기: 캔버스 만들기부터 다시 쓰기까지

1단계. 준비된 캔버스 먼저 열어 보기

처음이라면 남이 만든 캔버스부터 열어 보기를 권합니다. 완성품을 한 번 보면 무엇을 부탁할지 감이 잡힙니다.

따라 하기
  1. GitHub Copilot 앱을 열고 왼쪽 사이드바에서 Customize를 누르세요. 앱을 입맛대로 바꾸는 메뉴가 열리면 제대로 된 상태입니다.
  2. Canvas를 누르고 추천 캔버스 목록을 둘러보세요. 칸반 보드나 출시 노트 같은 예시가 보입니다.
  3. 골라 둔 캔버스에 필요한 플러그인이 있으면 먼저 설치합니다. 플러그인이 없으면 캔버스가 제대로 돌지 않습니다.
  4. New session을 눌러 캔버스를 여세요. 세션은 에이전트와 나누는 대화 한 판을 가리킵니다.

2단계. 말로 새 캔버스 만들기

따라 하기
  1. 앱의 Home 화면에서 작업할 저장소가 맞게 선택됐는지 확인하세요. 캔버스가 엉뚱한 저장소에 저장되는 일을 막습니다.
  2. 에이전트 세션을 열고 입력창에 /create-canvas를 입력합니다. 앞에 빗금이 붙은 이 명령을 스킬이라고 부릅니다. 캔버스 만들기 전용 요령을 에이전트에게 쥐여 주는 셈입니다.
  3. 명령 뒤에 세 가지를 이어서 적으세요. 이 화면이 도울 업무, 내가 화면에서 할 수 있는 일, 에이전트가 할 수 있는 일입니다. 셋이 다 들어가야 양쪽이 쓸 수 있는 화면이 나옵니다.
  4. 이때 캔버스를 어디에 둘지도 정합니다. 팀과 나누려면 프로젝트 범위인 .github/extensions, 나만 쓰려면 사용자 범위인 ~/.copilot/extensions입니다. 캔버스는 확장 기능(앱에 끼워 쓰는 부품)으로 저장되어 두고두고 다시 쓸 수 있습니다.
  5. 에이전트가 화면을 다 만들 때까지 기다립니다. 공식 실습 자료는 몇 분 걸린다고 안내합니다. 앱 오른쪽 패널에 캔버스가 열리면 성공입니다.

GitHub 블로그는 출시 노트를 모아 정리하는 캔버스를 예로 듭니다. 우리말로 적어도 됩니다. 예를 들면 "이번 주 팀 업무를 할 일, 진행 중, 완료 세 칸으로 나누는 칸반 보드 캔버스를 만들어 주세요. 나는 카드를 옮기고, 에이전트는 새 카드를 추가하게 해 주세요." 정도면 충분합니다.

3단계. 쓰면서 다듬기

따라 하기
  1. 버튼을 누르거나 카드를 옮기며 화면을 직접 써 보세요. 그다음 대화창에 "지금 진행 중 칸에 있는 카드를 알려 주세요"라고 물어봅니다. 방금 옮긴 카드가 답에 들어 있으면 에이전트도 같은 화면을 보고 있습니다.
  2. 모자란 기능은 같은 세션에서 말로 덧붙입니다. "우선순위 필터를 추가해 주세요"처럼 한 번에 하나씩 부탁하면 결과를 확인하기 쉽습니다.
  3. 화면의 항목을 에이전트 작업에 넘기려면 항목에 붙은 Add to current context 버튼을 누르세요. 그 항목이 지금 대화의 재료로 들어갑니다.

4단계. 저장하고 다시 열기

따라 하기
  1. 팀과 나누려면 저장소에 저장해 달라고 부탁하세요. 공식 실습 자료의 예문은 아래와 같습니다. 저장소에 캔버스 파일이 추가되면 된 겁니다.
    Let's save this canvas definition to the repository so I can share it with my development team
  2. 팀 저장소의 기본 브랜치에 바로 합쳐도 되는 경우에만 이 단계를 진행합니다. Create PR 버튼 옆 드롭다운을 열고 Agent merge를 고르세요. 버튼 이름이 Agent merge로 바뀌면 눌러서 풀 리퀘스트(변경을 합쳐 달라는 요청서)를 만듭니다. 자동 검사(CI)가 통과하면 같은 드롭다운에서 Merge pull request를 누르세요. 한번 합치면 팀 전체 저장소에 반영됩니다.
  3. 다음번에는 새 세션에서 "Open the triage issues canvas"처럼 캔버스 이름을 넣어 열어 달라고 하세요. 오른쪽 패널에 같은 화면이 다시 뜨면 성공입니다.

막히기 쉬운 세 군데

명령을 넣었는데 한참 아무것도 안 뜰 때

무엇이 보이나. /create-canvas를 보냈는데 오른쪽 패널이 비어 있습니다. 왜 그런가. 에이전트가 화면 파일을 새로 짜는 중이라 공식 실습 자료도 몇 분이 걸린다고 적어 두었습니다. 어떻게 하나. 몇 분 기다려 보고 그래도 안 되면 대화창에 에이전트가 남긴 메시지부터 읽어 보세요.

동료가 내 캔버스를 못 찾을 때

무엇이 보이나. 나는 잘 쓰는데 같은 저장소를 여는 동료에게는 캔버스가 없습니다. 왜 그런가. 사용자 범위인 ~/.copilot/extensions에 저장하면 내 컴퓨터에만 남습니다. 문서가 팀 공유용으로 안내하는 곳은 .github/extensions입니다. 어떻게 하나. 에이전트에게 저장소에 저장해 달라고 부탁하고 변경이 저장소에 합쳐졌는지 확인하세요.

회사 계정으로는 앱을 쓸 수 없을 때

무엇이 보이나. 개인 계정에서는 되는데 회사 계정에서는 앱이 막힙니다. 왜 그런가. Business와 Enterprise 요금제는 조직의 GitHub Copilot app 정책이 켜져 있어야 앱을 쓸 수 있습니다. 정확한 오류 문구는 문서에 나와 있지 않습니다. 어떻게 하나. 조직 관리자에게 이 정책이 켜져 있는지 물어보세요.

여기서 더 나아가려면

다른 사람들이 만든 캔버스를 구경하면 부탁할 거리가 늘어납니다. Awesome Copilot의 캔버스 확장 모음에는 출시 노트 도구, 칸반 보드, 이슈 분류판이 올라와 있습니다. 마음에 드는 예시를 하나 열고 우리 팀 방식에 맞게 말로 고쳐 보세요.

이상으로 글 마치겠습니다.

출처

#GitHub Copilot#Canvases#캔버스#커스텀 UI#에이전트#업무 자동화#자연어

같은 분류의 글