GitHub Copilot 캔버스 확장 만들기: /create-canvas 요청 작성법과 팀 공유 범위 정하기

에이전트와 사람이 같은 화면을 함께 고치는 작업판을, 언제 만들고 어디에 저장하고 어떻게 검토할지

Copilot 캔버스 확장 만들기 썸네일

핵심 요약

  1. 캔버스 확장은 사람과 에이전트가 같은 작업 상태를 양방향으로 고치는 화면이다.
  2. /create-canvas 요청은 워크플로우, 사람의 동작, 에이전트의 동작, 하지 않을 일로 나눠 쓴다.
  3. Project 범위는 .github/extensions에 커밋되고, User 범위는 ~/.copilot/extensions에 저장된다.
  4. Project 범위 캔버스는 에이전트 생성 코드이므로 의존성·기능 목록·상태 파일을 리뷰한 뒤 커밋한다.

에이전트에게 여러 단계짜리 일을 맡기면 진행 상황이 대화 로그 속에 흩어진다. 어떤 이슈를 누가 맡았는지, 릴리스 체크리스트 중 무엇이 끝났는지를 확인하려면 대화를 거슬러 올라가야 한다. GitHub Copilot 앱의 캔버스 확장은 이 상태를 사람과 에이전트가 함께 보는 화면으로 꺼내는 기능이다. 이 글은 공식 문서(2026-10-07 확인)를 기준으로 캔버스를 만드는 요청 작성법과 저장 범위, 팀에 공유하기 전 검토 항목을 정리한다.

캔버스 확장이 하는 일

문서는 캔버스 확장을 계획, 트리아지 보드, 브라우저 세션, 릴리스 체크리스트, 대시보드, 장애 대응, 스프레드시트 같은 작업 결과물을 위한 공유·대화형 화면으로 설명한다. 핵심은 양방향이라는 점이다. 에이전트는 작업하면서 캔버스를 갱신하고, 사람은 같은 화면에서 클릭과 편집으로 상태를 바꾼다. 사람은 UI 조작으로, 에이전트는 캔버스가 노출한 기능(capability)을 호출해 같은 상태를 다룬다.

작업대화만으로 할 때캔버스를 쓸 때
이슈 트리아지분류 결과가 대화 메시지로 쌓인다보드에서 카드를 옮기면 에이전트도 같은 상태를 본다
릴리스 체크리스트완료 여부를 매번 다시 물어야 한다항목 상태가 화면에 남고 에이전트가 갱신한다
여러 에이전트 세션 추적세션마다 로그를 따로 연다한 화면에서 세션을 시작하고 진행 상황을 본다

반대로 한 번 묻고 끝나는 질문, 결과가 파일 하나로 끝나는 작업에는 캔버스가 필요 없다. 같은 형식의 작업이 반복되고, 진행 상태를 사람이 중간에 고쳐야 하는 일에 맞는다.

/create-canvas 요청 쓰기

캔버스는 에이전트 세션에서 /create-canvas 스킬로 만든다. 문서는 요청에 지원할 워크플로우, 사람이 할 수 있어야 하는 일, 에이전트가 할 수 있어야 하는 일을 함께 적으라고 안내한다. 세 가지를 분리해 쓰면 결과물의 범위가 명확해진다.

  1. 워크플로우: 캔버스가 다룰 작업 단위와 상태를 적는다. 예: "열린 Dependabot PR을 위험도별 열(patch, minor, major)로 보여 준다."
  2. 사람의 동작: 클릭·편집으로 할 일을 적는다. 예: "카드를 다른 열로 옮기고, 보류 사유를 메모로 남긴다."
  3. 에이전트의 동작: 에이전트가 호출할 기능을 적는다. 예: "새 PR이 생기면 카드를 추가하고, CI 상태를 갱신한다."
  4. 하지 않을 일: 병합·삭제처럼 되돌리기 어려운 동작은 캔버스 기능에서 빼거나 사람 확인을 거치게 한다고 명시한다.
  5. 만들어진 캔버스를 실제 작업에 한두 번 쓰고, 부족한 동작을 같은 세션에서 추가로 요청해 다듬는다.
/create-canvas Dependabot PR 트리아지 보드를 만들어 줘.
- 워크플로우: 열린 Dependabot PR을 patch / minor / major / 확인 필요 네 열로 보여 준다.
  카드에는 패키지 이름, 버전 변화, CI 상태를 표시한다.
- 사람: 카드를 다른 열로 옮기고, 카드에 보류 사유 메모를 남길 수 있다.
- 에이전트: 새 PR을 카드로 추가하고 CI 상태를 갱신한다. 열 이동은 제안만 하고 직접 옮기지 않는다.
- 하지 않을 일: PR 병합, 닫기, 브랜치 삭제 기능은 만들지 않는다.

공식 블로그의 예시는 "/create-canvas Create a release notes canvas for tracking new feature work completed across GitHub Copilot app sessions."처럼 한 문장이다. 한 문장으로도 캔버스는 만들어지지만, 위처럼 역할과 금지 동작을 나눠 쓰면 에이전트가 의도하지 않은 기능까지 만드는 일을 줄일 수 있다. 위 예시 보드에 들어갈 분류 규칙은 Dependabot PR 자동 트리아지에서 스크립트로 구현했다.

저장 범위와 파일 구성

범위저장 위치용도
Project.github/extensions (저장소에 커밋)팀이 함께 쓰는 캔버스
User~/.copilot/extensions (내 컴퓨터)개인 작업용 캔버스

문서에 따르면 캔버스 확장은 보통 메타데이터와 의존성을 담는 package.json, 캔버스 동작과 기능을 정의하는 진입 파일(예: extension.mjs), 상태를 저장하는 선택적 JSON 결과물(예: artifacts 폴더 아래 파일)로 구성된다. 처음에는 User 범위로 만들어 혼자 써 보고, 팀에 쓸모가 확인되면 Project 범위로 옮겨 커밋하는 순서가 안전하다.

.github/extensions/
└─ dependabot-triage/
   ├─ package.json      # 이름, 의존성
   ├─ extension.mjs     # 화면과 에이전트가 호출할 기능 정의
   └─ artifacts/        # 보드 상태(JSON) — 커밋 여부를 팀에서 정한다

Project 범위로 커밋하기 전 검토 항목

Project 범위 캔버스는 저장소의 코드가 되고, 팀원 모두의 Copilot 앱에서 쓰인다. 에이전트가 생성한 코드이므로 일반 코드와 같은 기준으로 PR 리뷰를 거친다.

  • package.json에 추가된 의존성이 필요한 것인지, 출처가 확실한지 확인한다.
  • 에이전트가 호출할 수 있는 기능 목록을 읽고, 병합·삭제·외부 전송처럼 되돌리기 어려운 동작이 없는지 본다.
  • artifacts에 개인 메모나 내부 정보가 저장되는지 확인하고, 커밋 대상에서 뺄지 정한다(.gitignore).
  • PR 본문에 캔버스의 용도, 사람·에이전트 동작, 생성에 쓴 요청 문장을 남긴다. 리뷰 규칙은 AI 생성 코드 리뷰 규칙을 따른다.

여러 에이전트에게 일을 나눠 맡길 때 각자의 역할과 출력 형식을 고정하는 방법은 멀티 에이전트 역할 나누기에서 다룬다. 캔버스는 그 결과를 사람이 확인하는 화면으로 쓰기 좋다.

초보자가 자주 실수하는 포인트

  • 한 번 묻고 끝나는 작업에도 캔버스를 만들어 관리할 화면만 늘린다.
  • 에이전트 동작에 병합·삭제 기능까지 넣어 확인 없이 실행되게 만든다.
  • 개인 메모가 들어간 상태 파일을 그대로 저장소에 커밋한다.
  • 처음부터 Project 범위로 만들어 검증 안 된 캔버스를 팀 전체에 배포한다.

체크리스트

  • 캔버스가 필요한 반복 작업인지 확인했다.
  • 요청에 사람·에이전트 동작과 금지 동작을 나눠 적었다.
  • User 범위에서 실제 작업에 써 본 뒤 Project 범위로 옮긴다.
  • 커밋 전에 의존성과 에이전트 기능 목록을 리뷰했다.
  • artifacts 커밋 여부를 정했다.

자주 묻는 질문

캔버스를 만들려면 코드를 직접 짜야 하나요?

아닙니다. /create-canvas에 원하는 워크플로우를 설명하면 에이전트가 확장 파일을 만듭니다. 다만 결과물은 코드이므로 팀에 공유하기 전에 일반 코드처럼 검토해야 합니다.

캔버스 레이아웃 종류가 정해져 있나요?

공식 블로그는 정해진 레이아웃 메뉴가 없고, 설명할 수 있는 워크플로우라면 캔버스로 만들 수 있다고 설명합니다. 칸반, 체크리스트, 대시보드, 스프레드시트 형태가 예시로 소개됩니다.

참고 자료 · 검증 기준

위 자료와 내용을 대조한 날짜: . 도구·서비스 정책은 이후 바뀔 수 있으므로 적용 전 공식 문서를 다시 확인하세요.

이 글은 실제 실무 환경 테스트 및 검증된 기술 자료를 바탕으로 작성되었으며, 환경 변화에 따라 지속적으로 갱신됩니다.