GitHub Actions에서 에이전틱 워크플로우 개발하기

GitHub Agentic Workflows를 사용해서 Markdown 지침을 제3자 코딩 에이전트가 실행하는 자동화로 바꿔 보세요. 자연어로 원하는 것을 설명하면 코딩 에이전트가 워크플로우를 만들고 다듬고 문제를 해결해 줘요.

출처: 문서

본문

[!NOTE] GitHub Agentic Workflows는 공개 미리 보기(public preview) 상태이며 변경될 수 있어요.

Introduction

GitHub Agentic Workflows를 사용하면 저장소 자동화를 Markdown으로 정의하고 이를 실행할 AI 코딩 에이전트를 선택할 수 있어요. gh aw 확장 프로그램은 각 에이전틱 워크플로우를 GitHub Actions 워크플로우로 컴파일해요.

워크플로우 수명 주기 전체—작성, 디버깅, 최적화—가 그 자체로 에이전틱해요. 원하는 것을 자연어로 설명하면 코딩 에이전트가 워크플로우를 만들고, 다듬고, 문제를 해결해 줘요.

이 튜토리얼은 코딩 에이전트를 사용해서 변경 사항이 충분히 테스트되었는지 확인하는 자동화된 풀 리퀘스트 리뷰어를 만드는 방법을 보여줍니다.

Prerequisites

시작하기 전에 다음이 준비되어 있는지 확인하세요.

GitHub Actions가 활성화되어 있고 쓰기 권한이 있는 저장소
설치 및 인증된 GitHub CLI 버전 2.0.0 이상
Claude Code, OpenAI Codex, Google Gemini CLI, Copilot CLI 같은 지원되는 코딩 에이전트와 필요한 자격 증명에 대한 접근 권한

GitHub CLI를 인증하려면 다음을 실행하세요.

gh auth login --scopes repo,workflow

Installing the `gh aw` extension

GitHub CLI용 GitHub Agentic Workflows 확장 프로그램을 설치하세요.

gh extension install github/gh-aw

Choosing an agent and configuring authentication

워크플로우에 가장 잘 맞는 에이전트 CLI를 선택하세요. Claude Code, OpenAI Codex, Google Gemini CLI, Copilot CLI 모두 GitHub Agentic Workflows를 실행할 수 있어요.

이 문서는 에이전트의 자격 증명을 저장소 secret으로 추가하는 간단한 설정을 안내해요. Claude Code, OpenAI Codex, Google Gemini CLI를 사용한다면 에이전트의 API 키를 저장소 secret으로 저장하세요.

Agent CLI	`engine` value	Repository secret
Claude Code	`claude`	`ANTHROPIC_API_KEY` containing an Anthropic API key
OpenAI Codex	`codex`	`OPENAI_API_KEY` containing an OpenAI API key
Google Gemini CLI	`gemini`	`GEMINI_API_KEY` containing a Google AI Studio API key
Copilot CLI (default)	`copilot`	No secret needed for organization repositories (see below). For personal repositories, `COPILOT_GITHUB_TOKEN` containing a fine-grained personal access token with Copilot Requests set to Read.

Pi(실험적) 같은 다른 엔진도 지원돼요. 전체 목록은 GitHub Agentic Workflows authentication reference를 참고하세요.

Organization billing for GitHub Copilot

조직이 소유한 저장소에서 GitHub Copilot을 사용한다면, 개인 액세스 토큰 대신 GitHub Actions의 기본 제공 GITHUB_TOKEN을 사용할 수 있어요. 워크플로우 frontmatter permissions에 copilot-requests: write를 추가하면 별도의 secret이 필요 없어요. 설정 단계는 Creating GitHub Agentic Workflows 문서를 참고하세요.

Storing a secret in the GitHub UI

Claude Code, OpenAI Codex, Google Gemini CLI, 또는 GitHub Copilot 개인 저장소용 secret을 추가하려면:

GitHub에서 저장소로 이동하세요.
저장소 이름 아래에서 Settings을 클릭하세요.
사이드바에서 Secrets and variables를 클릭한 다음 Actions를 클릭하세요.
New repository secret을 클릭하세요.
Name 필드에 위 표의 secret 이름을 입력하세요.
Secret 필드에 값을 입력하세요.
Add secret을 클릭하세요.

Creating the workflow

코딩 에이전트를 사용해서 자연어 설명으로 워크플로우를 만들어 보세요.

저장소 루트에서 에이전틱 작성(authoring)을 위해 저장소를 초기화하세요. 이렇게 하면 코딩 에이전트가 워크플로우를 만들고 편집하는 데 도움이 되는 스킬과 지침이 추가돼요.
```
gh aw init
```
저장소 컨텍스트에서 코딩 에이전트 세션을 시작하세요. 예를 들어 Claude Code, OpenAI Codex, Google Gemini CLI, Copilot CLI, 또는 VS Code 에이전트 모드를 사용할 수 있어요.
agentic-workflows 스킬을 사용해서 원하는 워크플로우를 설명하세요.
```
/agentic-workflows create a pr reviewer that ensure the changes are tested.
```
에이전트가 .github/workflows/에 워크플로우 Markdown 파일을 만들고, 해당 .lock.yml GitHub Actions 워크플로우 파일을 컴파일한 다음, 두 파일을 검토하고 커밋하도록 요청해요.
생성된 워크플로우를 검토한 다음 에이전트에게 파일을 커밋하고 푸시하도록 요청하세요.

[!TIP] 워크플로우가 실행된 후에도 같은 에이전틱 방식을 사용해서 워크플로우를 업데이트하고 개선할 수 있어요. 에이전트에게 리뷰 기준을 다듬거나, 더 많은 검사를 추가하거나, 실패한 실행을 디버그하도록 요청하세요—모두 자연어로요. 나중에 워크플로우 frontmatter를 편집한다면 변경 사항을 커밋하기 전에 gh aw compile을 실행하세요.

Running the workflow

생성된 워크플로우는 풀 리퀘스트에서 자동으로 트리거되므로, 저장소에서 다음에 풀 리퀘스트를 열거나 업데이트할 때 실행돼요.

저장소에서 풀 리퀘스트를 여세요.
GitHub에서 저장소로 이동하고 Actions 탭을 클릭하세요.
왼쪽 사이드바에서 에이전트가 만든 워크플로우를 선택하세요.
실행이 완료되면 워크플로우가 변경 사항에 충분한 테스트가 포함되었는지 기록한 풀 리퀘스트 리뷰를 남겨요.

Next steps

주간 이슈 활동 보고서를 만드는 워크플로우를 만들려면 Creating GitHub Agentic Workflows 문서를 참고하세요.
고급 엔진 구성, 안전한 출력, 더 많은 워크플로우 예시는 GitHub Agentic Workflows documentation site을 참고하세요.

GitHub Actions에서 에이전틱 워크플로우 개발하기