google-labs-code/jules-action

Jules는 Gemini 3 Pro를 기반으로 하는 Google Labs의 원격 AI 코딩 에이전트입니다. 이는 클라우드 VM에서 자율적으로 작동하여, 사용자가 중요한 일에 집중할 수 있도록 코드베이스 분석, 기능 구현, 버그 수정 및 풀 리퀘스트 생성을 수행합니다. 이 액션을 사용하면 이슈(issues), 풀 리퀘스트(pull requests), 스케줄(schedules) 또는 워크플로우 디스패치(workflow dispatches) 등 모든 GitHub 이벤트에서 Jules를 트리거할 수 있습니다. 자동 버그 수정, 성능 개선 등 Jules 워크플로우를 사용하는 아이디어를 얻으려면 예제 워크플로우를 확인해 보세요! - jules.google.com에서 GitHub 인증을 수행합니다. - 계정 설정에서 API 키를 생성합니다. - 자세한 내용은 API 문서를 참조하세요. - Settings → Secrets and variables → Actions로 이동하여 New repository secret을 클릭하고, 이름(Name)에 JULES_API_KEY, 값(Value)에 사용자의 키를 입력합니다. 그리고 .github/workflows/security-agent.yml 파일을 생성합니다: name: Daily Security Scan on: schedule: ... 이제 저장소에는 매일 취약점을 탐지하는 보안 에이전트가 생겼습니다! 🛡️ | Input | Description | Default | prompt | 필수 항목. Jules가 수행할 작업입니다. | — | jules_api_key | 필수 항목. 사용자의 Jules API 키(secrets 사용). | — | starting_branch | Jules가 시작할 브랜치입니다. | main | include_last_commit | 마지막 커밋의 diff를 컨텍스트에 포함할지 여부입니다. | false | include_commit_log | 최근 커밋 기록을 컨텍스트에 포함할지 여부입니다. | false | 이 항목들을 .github/workflows/에 복사하여 사용자 정의하세요: | Example | Trigger | Description | weekly-cleanup | Scheduled (cron) | 자동 코드 유지보수 및 리팩토링 | ... | 구조화된 프롬프트를 사용하여 버그 진단 및 수정(또는 기능 구현) | ci-failure-fix | CI 워크플로우 실패 시 | 실패한 빌드를 자동으로 수정합니다. | unblocked-issues | 이슈가 닫혔을 때 | 닫힌 이슈로 인해 차단되었던 이슈 작업을 수행합니다. | 자세한 설정 지침은 examples/README.md를 참조하세요. Jules는 명확한 사양이나 검증 가능한 측정 가능한 목표가 주어질 때 탁월합니다. 이는 지속적으로 실행되는 스케줄 워크플로우에 특히 강력합니다.}<tool_call|>```json
{

예시: 주간 성능 에이전트 (Weekly Performance Agent)

name: Performance Improvement Agent
on:
schedule:
...

작동 원리: Jules는 벤치마크를 실행하고, 솔루션을 반복하며, 자체 성공을 검증할 수 있습니다. 측정 가능한 목표를 Jules에게 제공하면, 지속적인 개선 루프가 됩니다.

주기적 에이전트 추가 아이디어:

• 보안 감사 에이전트 (Security audit agent): npm audit 실행 및 취약점 수정 - 종속성 업데이트 에이전트 (Dependency updater): 의존성 업데이트, 테스트 실행, 성공 시 PR 생성
• 문서 업데이트 에이전트 (Docs updater agent): 최근 변경 사항을 기반으로 문서 업데이트
• 테스트 커버리지 개선기 (Test coverage improver): 누락된 부분 찾기, 테스트 추가, 90% 목표 설정

⚠️ 중요: 이슈 트리거 워크플로우는 신뢰할 수 없는 사용자가 이슈를 열어 악용할 수 있습니다. GitHub 이슈와 같은 출처에 대해 Jules를 누가 트리거할 수 있는지 항상 제한해야 합니다. 이슈의 경우 종종 누구나 이슈를 생성할 수 있으므로, Jules 트리거를 위한 허용 목록(allowlist) 조건을 갖는 것이 유용합니다.

단계에 허용 목록 조건 추가하기:

- name: Invoke Jules
# 사용자가 허용 목록에 있는 경우에만 실행됨
if: ${{ contains(fromJSON('[