GitHub Actions 에이전트형 워크플로 개발

Introduction

GitHub Agentic Workflows Markdown에서 리포지토리 자동화를 정의하고 이를 실행하는 AI 코딩 에이전트를 선택할 수 있습니다. gh aw 확장은 각 에이전트 워크플로를 GitHub Actions 워크플로로 컴파일합니다.

전체 워크플로 수명 주기, 즉 작성, 디버깅 및 최적화는 그 자체로 에이전트적입니다. 자연어로 원하는 내용을 설명하고 코딩 에이전트가 워크플로를 만들고, 구체화하고, 문제를 해결해 드립니다.

이 자습서에서는 코딩 에이전트를 사용하여 변경 내용이 적절하게 테스트되었는지 여부를 확인하는 자동화된 풀 리퀘스트 검토기를 만듭니다.

사전 요구 사항

시작하기 전에 다음을 확인합니다.

GitHub Actions이(가) 활성화되어 있고 쓰기 액세스 권한이 있는 리포지토리
GitHub CLI 버전 2.0.0 이상 설치 및 인증
지원되는 코딩 에이전트(예: 클로드 코드 또는 OpenAI CodexGoogle Gemini CLI 또는 Copilot CLI) 및 해당 필수 자격 증명에 대한 액세스

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

gh auth login --scopes repo,workflow

`gh aw` 확장 프로그램 설치하기

GitHub CLI용 GitHub Agentic Workflows 확장을 설치합니다:

gh extension install github/gh-aw

에이전트 선택 및 인증 구성

워크플로에 가장 적합한 에이전트 CLI를 선택합니다. 클로드 코드 또는 OpenAI CodexGoogle Gemini CLI, and Copilot CLI는 모두 GitHub Agentic Workflows를 실행할 수 있습니다.

이 문서에서는 에이전트의 자격 증명을 리포지토리 비밀로 추가하는 간단한 설정을 안내합니다. 클로드 코드 또는 OpenAI CodexGoogle Gemini CLI를 사용하는 경우 에이전트의 API 키를 리포지토리 비밀로 저장합니다.

| 에이전트 CLI | engine 값 | 리포지토리 시크릿 | | --- | --- | --- | | 클로드 코드 | claude | ANTHROPIC_API_KEYAnthropic API 키 포함 | | OpenAI Codex | codex | OPENAI_API_KEY OpenAI API 키를 포함하는 | | Google Gemini CLI | gemini | GEMINI_API_KEY Google AI Studio API 키를 포함하는 | | Copilot CLI(기본값) | copilot | 조직 리포지토리에 비밀이 필요하지 않습니다(아래 참조). 개인 리포지토리의 경우, COPILOT_GITHUB_TOKEN에는 Copilot Requests가 Read로 설정된 세분화된 personal access token가 포함되어 있습니다. |

Pi(실험적)와 같은 다른 엔진도 지원됩니다. 전체 목록은 GitHub Agentic Workflows 인증 참조 문서를 확인하세요.

GitHub Copilot에 대한 조직 청구

조직 소유 리포지토리에서 GitHub Copilot를 사용하는 경우 personal access token 대신 GitHub Actions의 기본 제공 GITHUB_TOKEN를 사용할 수 있습니다. 워크플로 프런트매터에 copilot-requests: write 추가하고 permissions 별도의 시크릿은 필요하지 않습니다. 설치 단계는 GitHub 에이전트 워크플로 만들기을 참조하세요.

GitHub UI에 비밀을 저장

클로드 코드 또는 OpenAI CodexGoogle Gemini CLI의 비밀 또는 GitHub Copilot 개인 리포지토리에 대한 비밀을 추가하려면 다음을 수행합니다.

GitHub에서 리포지토리로 이동합니다.
리포지토리 이름 아래에서 설정을 클릭합니다****.
사이드바에서 Secrets and variables를 클릭한 다음 작업을 클릭합니다.
새 리포지토리 비밀을 선택합니다.
이름 필드에 위 표의 비밀 이름을 입력하세요.
비밀 필드에 값을 입력합니다.
비밀 추가를 클릭합니다.

워크플로 만들기

코딩 에이전트를 사용하여 자연어 설명을 바탕으로 워크플로를 만듭니다.

리포지토리 루트에서 에이전트형 저작을 위해 리포지토리를 초기화합니다. 그러면 코딩 에이전트가 워크플로를 만들고 편집하는 데 도움이 되는 기술 및 지침이 추가됩니다.
```
gh aw init
```
리포지토리의 컨텍스트에서(예: 클로드 코드 또는 OpenAI CodexGoogle Gemini CLI, Copilot CLI 또는 VS Code 에이전트 모드를 사용하여) 코딩 에이전트 세션을 시작합니다.
agentic-workflows 스킬을 사용하고 원하는 워크플로를 설명하세요.
Copilot prompt
```
/agentic-workflows create a pr reviewer that ensure the changes are tested.
```
```
/agentic-workflows create a pr reviewer that ensure the changes are tested.
```
에이전트는 .github/workflows/에 워크플로 Markdown 파일을 만들고, 해당 .lock.ymlGitHub Actions 워크플로 파일을 컴파일하고, 두 파일을 모두 검토하고 커밋하도록 요청합니다.
생성된 워크플로를 검토한 다음 에이전트에 파일을 커밋하고 푸시하도록 요청합니다.

팁

동일한 에이전트 접근 방식을 사용하여 워크플로가 실행된 후 워크플로를 업데이트하고 개선할 수 있습니다. 에이전트에 자연어로 검토 조건을 구체화하거나, 검사를 더 추가하거나, 실패한 실행을 디버그하도록 요청합니다. 나중에 워크플로 프런트매터를 편집하는 경우 변경 내용을 커밋하기 전에 gh aw compile를 실행합니다.

워크플로 실행하기

생성된 워크플로는 풀 리퀘스트에서 자동으로 트리거되므로 다음에 리포지토리에서 풀 리퀘스트를 열거나 업데이트할 때 실행됩니다.

리포지토리에서 끌어오기 요청을 엽니다.
GitHub에서 리포지토리로 이동하고 작업 탭을 클릭합니다.
왼쪽 사이드바에서 에이전트가 만든 워크플로를 선택합니다.
실행이 완료되면 워크플로는 변경 내용에 충분한 테스트가 포함되어 있는지 여부를 나타내는 풀 리퀘스트 검토를 남깁니다.

다음 단계

주간 이슈 활동 보고서를 생성하는 워크플로를 만들려면 GitHub 에이전트 워크플로 만들기을 참조하세요.
고급 엔진 구성, 안전한 출력 및 더 많은 워크플로 예제에 대해서는 GitHub Agentic Workflows 설명서 사이트를 참조하세요.