github/gh-aw

자연어 마크다운(Markdown)으로 에이전트 워크플로(Agentic Workflows)를 작성하고, 이를 GitHub Actions에서 실행하세요.

참고

Releases 0.68.4부터 0.71.3 버전은 과금(Billing)에 영향을 주는 버그로 인해 중단(Retired)됩니다. 만약 이 버전 중 하나를 사용 중이라면, 가능한 한 빨리 최신 릴리스로 업그레이드하시기 바랍니다.

• 빠른 시작 (Quick Start)
• 개요 (Overview)
• 가드레일 (Guardrails)
• 문서 (Documentation)
• 자주 묻는 질문 (FAQ)
• 기여하기 (Contributing)
• 커뮤니티 기여 (Community Contributions)
• 피드백 공유 (Share Feedback)
• Peli's Agent Factory
• 관련 프로젝트 (Related Projects)

첫 번째 에이전트 워크플로를 실행할 준비가 되셨나요? 단계별 빠른 시작 가이드를 따라 확장을 설치하고, 샘플 워크플로를 추가하여 실제로 작동하는 모습을 확인해 보세요.

에이전트 워크플로의 이면에 있는 개념을 배우고, 사용 가능한 워크플로 유형을 탐색하며, AI가 어떻게 저장소(Repository) 작업을 자동화할 수 있는지 이해해 보세요. 작동 방식(How It Works)을 확인해 보세요. GitHub Copilot, Claude (Anthropic), Codex (OpenAI), 그리고 Gemini (Google)를 지원합니다 — 이미 보유하고 있는 AI 계정을 무엇이든 선택하세요.

가드레일(Guardrails), 안전성 및 보안은 GitHub Agentic Workflows의 근간입니다. 워크플로는 기본적으로 읽기 전용(Read-only) 권한으로 실행되며, 쓰기 작업은 정제된 safe-outputs를 통해서만 허용됩니다.

시스템은 샌드박스 실행(Sandboxed execution), 입력값 정제(Input sanitization), 네트워크 격리(Network isolation), 공급망 보안(Supply chain security, SHA-pinned dependencies), 도구 허용 목록(Tool allow-listing), 그리고 컴파일 타임 검증(Compile-time validation)을 포함한 다중 보호 계층을 구현합니다. 액세스는 팀 구성원에게만 제한될 수 있으며, 중요한 작업에 대해서는 인간의 승인 게이트(Human approval gates)를 두어 AI 에이전트가 통제된 경계 내에서 안전하게 작동하도록 보장합니다. 위협 모델링(Threat modeling), 구현 가이드라인 및 모범 사례에 대한 자세한 내용은 보안 아키텍처(Security Architecture)를 참조하세요.

저장소에서 에이전트 워크플로를 사용하는 것은 보안 고려 사항에 대한 세심한 주의와 신중한 인간의 감독을 필요로 하며, 그럼에도 불구하고 문제가 발생할 수 있습니다. 주의해서 사용하시기 바라며, 모든 책임은 사용자 본인에게 있습니다.

전체 문서, 예시 및 가이드는 문서(Documentation)를 참조하세요. 만약 당신이 에이전트라면, llms.txt 또는 전체 코퍼스(Corpus)인 llms-full.txt를 다운로드하세요.

만약 0.68.4에서 0.71.3 사이의 버전을 실행 중이라면, 빌링 (Billing)에 영향을 미치는 버그가 있으므로 업그레이드를 강력히 권장합니다.

개발 환경 설정 및 기여 가이드라인은 CONTRIBUTING.md를 참조하세요.

저장소의 커스텀 린터 (Linters)를 빌드하고 테스트하려면:

go test ./pkg/linters/<linter-name>/...

go build ./cmd/linters

make golint-custom

make golint-custom은

cmd/linters를 빌드하고

./cmd/... 및 ./pkg/...에 대해 커스텀 분석기 (Analyzers)를 실행합니다.

이 프로젝트에서 이슈 리포트가 해결된 커뮤니티 멤버분들께 감사드립니다! 이 목록은 자동으로 업데이트되며 모든 귀속된 기여를 반영합니다.

• @abillingsley: #23736
  (직접 이슈) - @adamhenson: #25345
  (직접 이슈), #24282*(직접 이슈)* - @ahmadabdalla: #27473
  (직접 이슈) - @ajfeldman6: #23924
  (직접 이슈) - @AlexDeMichieli: #26645
  (직접 이슈) - @alexsiilvaa: #20781
  (직접 이슈), #20664*(직접 이슈)* - @alondahari: #21207
  (직접 이슈) - @anthonymastreanvae: #30897
  (직접 이슈), #30841*(직접 이슈)* - @apenab: #25626
  (직접 이슈) - @app/github-actions: #31288
  (직접 이슈), #30740*(직접 이슈), #29561(직접 이슈), #29343(직접 이슈), #26257(직접 이슈), #26256(직접 이슈), #26255(직접 이슈), #26254(직접 이슈), #26253(직접 이슈)* - @arezero: #20515
  (직접 이슈), #20514*(직접 이슈), #20513(직접 이슈), #20512(직접 이슈), #20511(직접 이슈), #20510(직접 이슈)* - @arthurfvives: #30356
  (직접 이슈), #30088*(직접 이슈), #26223(직접 이슈), #25993(직접 이슈), #25294(직접 이슈)* - @askpaisa: #29240
  (직접 이슈) - @b2pacific: #28720
  (직접 이슈) - @bartul: #29499
  (직접 이슈) - @bbonafed: #29174

(직접 이슈), #29173*(직접 이슈), #29172(직접 이슈), #29171(직접 이슈), #27670(직접 이슈), #27472(직접 이슈), #26719(직접 이슈), #26045(직접 이슈), #26043(직접 이슈), #25646(직접 이슈), #25224(직접 이슈), #24949(직접 이슈), #24918(직접 이슈), #24896(직접 이슈), #24323(직접 이슈), #23900(직접 이슈), #23724(직접 이슈), #23566(직접 이슈), #22564(직접 이슈), #21990(직접 이슈), #20801(직접 이슈), #20378(직접 이슈)* - @benvillalobos: #25717
(직접 이슈), #20885*(직접 이슈)* - @bmerkle: #31689
(직접 이슈), #26621*(직접 이슈), #20646(직접 이슈)* - @bryanchen-d: #30866
(직접 이슈), #30704*(직접 이슈), #30695(직접 이슈), #30472(직접 이슈), #28774(직접 이슈), #26696(직접 이슈), #26487(직접 이슈), #25719(직접 이슈), #23265(직접 이슈)* - @bryanknox: #25351
(직접 이슈) - @Calidus: #33188
(직접 이슈), #26923*(직접 이슈)* - @camposbrunocampos: #23726
(직접 이슈), #22897*(직접 이슈)* - @carlincherry: #22017
(직접 이슈) - @chepa92: #20322
(직접 이슈) - @chrisfregly: #25349
(직접 이슈), #23963*(직접 이슈)* - @chrizbo: #31399
(직접 이슈), #28158*(직접 이슈), #22510(직접 이슈), #21863(직접 이슈)* - @CiscoRob: #20416
(직접 이슈) - @clementbolin: #28888
(직접 이슈) - @cogni-ai-ee: #32803
(직접 이슈), #32741*(직접 이슈)* - @Corb3nik: #21306
(직접 이슈) - @corygehr: #31577
(직접 이슈), #27638*(직접 이슈), #26539(직접 이슈), #26270(직접 이슈), #26268(직접 이슈), #25680(직접 이슈), #24355(직접 이슈), #23944(직접 이슈), #23753(직접 이슈)* - @corymhall: #19839
(직접 이슈) - @dagecko: #24743
(직접 이슈) - @Daidanny008: #27402
(직접 이슈) - @Dan-Co: #22707
(직접 이슈) - @danielmeppiel: #29076

(직접 이슈), #28678*(직접 이슈), #20663(직접 이슈), #20380(직접 이슈), #19810(직접 이슈)* - @danquirk: #30403
(직접 이슈) - @dbudym-cs: #22913
(직접 이슈) - @devantler: #25768
(직접 이슈), #25767*(직접 이슈)* - @deyaaeldeen: #28966
(직접 이슈), #26486*(직접 이슈), #25573(직접 이슈), #25359(직접 이슈), #23198(직접 이슈), #23024(직접 이슈), #23020(직접 이슈), #22957(직접 이슈), #19773(직접 이슈), #19770(직접 이슈)* - @dholmes: #29228
(직접 이슈), #23578*(직접 이슈)* - @DimaBir: #20483
(직접 이슈) - @dkurepa: #25511
(직접 이슈) - @DogeAmazed: #22703
(직접 이슈) - @doughgle: #23655
(직접 이슈) - @drehelis: #25304
(직접 이슈) - @dsyme: #23936
(직접 이슈), #22340*(직접 이슈), #20953(직접 이슈), #20952(직접 이슈), #20950(직접 이슈), #20787(직접 이슈), #20578(직접 이슈), #20420(직접 이슈), #20243(직접 이슈), #20241(직접 이슈), #20108(직접 이슈), #20103(직접 이슈), #19976(직접 이슈)* - @duncankmckinnon: #25944
(직접 이슈) - @eaftan: #23257
(직접 이슈), #20457*(직접 이슈)* - @edburns: #26920
(직접 이슈) - @edgeq: #28315
(직접 이슈), #28308*(직접 이슈)* - @ericchansen: #20222
(직접 이슈) - @ericstj: #30260
(직접 이슈), #23766*(직접 이슈)* - @Esomoire-consultancy-Company: #20207
(직접 이슈) - @ferryhinardi: #24128
(직접 이슈) - @flatiron32: #22469
(직접 이슈) - @fr4nc1sc0-r4m0n: #20657
(직접 이슈) - @G1Vh: #20308
(직접 이슈) - @glitch-ux: #24403
(직접 이슈) - @grahame-white: #23643
(직접 이슈), #23093*(직접 이슈), #23092(직접 이슈), #23088(직접 이슈), #23083(직접 이슈), #20868(직접 이슈), #20719(직접 이슈), #20629(직접 이슈), #20299(직접 이슈)* - @h3y6e: #27794
(직접 이슈) - @haavamoa: #30191
(직접 이슈) - @heiskr: #20394
(직접 이슈) - @hermanho: #32197

(직접 이슈) - @holwerda: #21243
(직접 이슈) - @IEvangelist: #33285
(직접 이슈), #33069*(직접 이슈), #33068(직접 이슈), #33060(직접 이슈), #33043(직접 이슈), #32536(직접 이슈), #32354(직접 이슈), #30848(직접 이슈), #26908(직접 이슈), #25467(직접 이슈)* - @Infinnerty: #21957
(직접 이슈) - @insop: #21686
(직접 이슈) - @j-srodka: #25199
(직접 이슈), #23485*(직접 이슈), #23484(직접 이슈), #23483(직접 이슈), #23482(직접 이슈), #23461(직접 이슈)* - @jamesadevine: #28957
(직접 이슈), #26407*(직접 이슈), #26406(직접 이슈)* - @JamesNK: #29310
(직접 이슈), #28867*(직접 이슈), #28704(직접 이슈)* - @JanKrivanek: #25656
(직접 이슈), #25439*(직접 이슈), #20187(직접 이슈)* - @jaroslawgajewski: #31678
(직접 이슈), #31658*(직접 이슈), #25593(직접 이슈), #24373(직접 이슈), #24372(직접 이슈), #24371(직접 이슈), #24259(직접 이슈), #24036(직접 이슈), #23779(직접 이슈), #23558(직접 이슈), #22647(직접 이슈), #21816(직접 이슈), #20813(직접 이슈), #20811(직접 이슈)* - @JasonYeMSFT: #27424
(직접 이슈) - @jbaruch: #30832
(직접 이슈) - @jeffhandley: #30232
(직접 이슈), #30204*(직접 이슈), #26799(직접 이슈), #26788(직접 이슈), #24384(직접 이슈)* - @jfomhover: #25420
(직접 이슈) - @johnpreed: #25687
(직접 이슈), #23777*(직접 이슈), #23212(직접 이슈), #21334(직접 이슈)* - @johnwilliams-12: #21205
(직접 이슈), #21074*(직접 이슈), #21071(직접 이슈), #21062(직접 이슈), #20821(직접 이슈), #20779(직접 이슈), #20697(직접 이슈), #20694(직접 이슈), #20658(직접 이슈), #20567(직접 이슈), #20508(직접 이슈)* - @jonathanpeppers: #30662
(직접 이슈) - @jsoref: #27230
(직접 이슈) - @jtracey93: #26176
(직접 이슈) - @kaovilai: #32596

(직접 이슈), #32587*(직접 이슈), #32482(직접 이슈), #32467(직접 이슈)* - @kbreit-insight: #24930
(직접 이슈), #23940*(직접 이슈), #23725(직접 이슈), #22430(직접 이슈), #21978(직접 이슈)* - @kkruel8100: #30867
(직접 이슈) - @kthompson: #25550
(직접 이슈) - @labudis: #30846
(직접 이슈) - @look: #23258
(직접 이슈) - @lpcox: #30634
(직접 이슈), #29353*(직접 이슈), #29191(직접 이슈), #22281(직접 이슈)* - @lukeed: #20552
(직접 이슈) - @lupinthe14th: #26542
(직접 이슈), #26441*(직접 이슈)* - @mark-hingston: #20335
(직접 이슈) - @mason-tim: #33084
(직접 이슈), #33074*(직접 이슈), #31489(직접 이슈), #30336(직접 이슈), #29301(직접 이슈), #21562(직접 이슈)* - @MatthewLabasan-NBCU: #26289
(직접 이슈) - @MattSkala: #24567
(직접 이슈), #21203*(직접 이슈)* - @MauroDruwel: #30178
(직접 이슈), #30169*(직접 이슈), #29379(직접 이슈), #29378(직접 이슈)* - @mcantrell: #20592
(직접 이슈) - @mdashrraf: #28657
(직접 이슈) - @MH0386: #20997
(직접 이슈) - @mhavelock: #22110
(직접 이슈) - @michen00: #31869
(직접 이슈) - @microsasa: #27715
(직접 이슈), #21103*(직접 이슈), #21098(직접 이슈), #20851(직접 이슈), #20833(직접 이슈), #20586(직접 이슈)* - @mlinksva: #22533
(직접 이슈) - @mnkiefer: #22409
(직접 이슈), #19836*(직접 이슈)* - @molson504x: #21834
(직접 이슈), #21615*(직접 이슈)* - @Mossaka: #21644
(직접 이슈), #21630*(직접 이슈)* - @mrjf: #32271
(직접 이슈), #32069*(직접 이슈), #31600(직접 이슈), #29152(직접 이슈), #28955(직접 이슈), #28471(직접 이슈), #28197(직접 이슈)* - @mvdbos: #20411
(직접 이슈), #20249*(직접 이슈)* - @neta-vega: #26447
(직접 이슈), #25895*(직접 이슈)* - @NicoAvanzDev: #21542
(직접 이슈), #20540*(직접 이슈), #20528(직접 이슈)* - @NicolasRannou: #31701

(직접 이슈) - @NikolajBjorner: #28812
(직접 이슈) - @norrietaylor: #33199
(직접 이슈), #32312*(직접 이슈), #32310(직접 이슈), #30733(직접 이슈), #30392(직접 이슈)* - @octatone: #31918
(직접 이슈) - @petercort: #28281
(직접 이슈) - @pethers: #28470
(직접 이슈) - @pgaskin: #26156
(직접 이슈) - @pholleran: #25313
(직접 이슈), #23572*(직접 이슈), #21313(직접 이슈)* - @polmichel: #32991
(직접 이슈) - @PureWeen: #28767
(직접 이슈), #27655*(직접 이슈), #23769(직접 이슈), #23567(직접 이슈)* - @rabo-unumed: #31660
(직접 이슈), #31578*(직접 이슈), #31513(직접 이슈), #20679(직접 이슈)* - @rhardouin: #30840
(직접 이슈), #30838*(직접 이슈)* - @romainh-betclic: #28143
(직접 이슈) - @rspurgeon: #26475
(직접 이슈) - @Rubyj: #31542
(직접 이슈), #21432*(직접 이슈), #20283(직접 이슈)* - @ruokun-niu: #24961
(직접 이슈) - @ryckmansm: #31501
(직접 이슈) - @salekseev: #25137
*(직접