run-gemini-cli

Обзор

run-gemini-cli — это GitHub Action, который интегрирует [Gemini] в ваш рабочий процесс разработки через [Gemini CLI]. Он выступает как автономный агент для критических рутинных задач кодирования, а также как коллаборатор по запросу, которому можно быстро делегировать работу.

Используйте его для проведения ревью пулл-реквестов GitHub, триажа задач, анализа и модификации кода и многого другого с помощью [Gemini] в диалоговом режиме (например, @gemini-cli fix this issue) прямо внутри ваших репозиториев GitHub.

• run-gemini-cli
  • Обзор
  • Возможности
  • Быстрый старт
    • 1. Получите ключ API Gemini
    • 2. Добавьте его как секрет GitHub
    • 3. Обновите .gitignore
    • 4. Выберите рабочий процесс
    • 5. Попробуйте!
  • Рабочие процессы
    • Gemini Dispatch
    • Триаж задач
    • Ревью пулл-реквестов
    • Gemini CLI Assistant
  • Конфигурация
    • Входные данные
    • Выходные данные
    • Переменные репозитория
    • Секреты
  • Аутентификация
    • Аутентификация Google
    • Аутентификация GitHub
  • Наблюдаемость
  • Расширения
  • Лучшие практики
  • Настройка
  • Участие в разработке

Возможности

• Автоматизация: Запуск рабочих процессов на основе событий (например, открытие задачи) или по расписанию (например, каждую ночь).
• Сотрудничество по запросу: Запуск рабочих процессов в комментариях к задачам и пулл-реквестам с упоминанием [Gemini CLI] (например, @gemini-cli /review).
• Расширяемость с помощью инструментов: Используйте возможности вызова инструментов моделей [Gemini] для взаимодействия с другими CLI, такими как [GitHub CLI] (gh).
• Настраиваемость: Используйте файл GEMINI.md в вашем репозитории для предоставления проектных инструкций и контекста [Gemini CLI].

Быстрый старт

Начните работу с Gemini CLI в вашем репозитории всего за несколько минут:

1. Получите ключ API Gemini

Получите свой ключ API в [Google AI Studio] с щедрыми бесплатными квотами.

2. Добавьте его как секрет GitHub

Сохраните свой ключ API как секрет с именем GEMINI_API_KEY в вашем репозитории:

• Перейдите в Настройки > Секреты и переменные > Действия вашего репозитория.
• Нажмите Новый секрет репозитория.
• Имя: GEMINI_API_KEY, Значение: ваш ключ API.

3. Обновите .gitignore

Добавьте следующие записи в файл .gitignore:

# gemini-cli settings
.gemini/

# GitHub App credentials
gha-creds-*.json

4. Выберите рабочий процесс

У вас есть два варианта настройки рабочего процесса:

Вариант A: Использовать команду настройки (рекомендуется)

1. Запустите Gemini CLI в вашем терминале:

   gemini
   

2. В Gemini CLI в вашем терминале введите:

   /setup-github
   

Вариант B: Вручную скопировать рабочие процессы

1. Скопируйте готовые рабочие процессы из каталога examples/workflows в каталог .github/workflows вашего репозитория. Примечание: рабочий процесс gemini-dispatch.yml также необходимо скопировать, так как он запускает выполнение остальных рабочих процессов.

5. Попробуйте!

Ревью пулл-реквестов:

• Откройте пулл-реквест в вашем репозитории и дождитесь автоматического ревью.
• Прокомментируйте @gemini-cli /review на существующем пулл-реквесте, чтобы запустить ревью вручную.

Триаж задач:

• Откройте задачу и дождитесь автоматического триажа.
• Прокомментируйте @gemini-cli /triage на существующих задачах, чтобы запустить триаж вручную.

Общая помощь AI:

• В любой задаче или пулл-реквесте напишите @gemini-cli, а затем ваш запрос.
• Примеры:
  • @gemini-cli explain this code change
  • @gemini-cli suggest improvements for this function
  • @gemini-cli help me debug this error
  • @gemini-cli write unit tests for this component

Рабочие процессы

Этот action предоставляет несколько готовых рабочих процессов для различных сценариев использования. Каждый рабочий процесс можно скопировать в каталог .github/workflows вашего репозитория и настроить по своему усмотрению.

Gemini Dispatch

Этот рабочий процесс выступает в роли центрального диспетчера для Gemini CLI, направляя запросы в соответствующий рабочий процесс в зависимости от триггерного события и команды, указанной в комментарии. Подробное руководство по настройке рабочего процесса диспетчера см. в документации по рабочему процессу Gemini Dispatch.

Триаж задач

Этот action можно использовать для автоматического триажа задач GitHub или по расписанию. Подробное руководство по настройке системы триажа задач см. в документации по рабочему процессу GitHub Issue Triage.

Ревью пулл-реквестов

Этот action можно использовать для автоматического ревью пулл-реквестов при их открытии. Подробное руководство по настройке системы ревью пулл-реквестов см. в документации по рабочему процессу GitHub PR Review.

Gemini CLI Assistant

Этот action можно использовать для вызова универсального, диалогового AI-ассистента Gemini внутри пулл-реквестов и задач для выполнения широкого круга задач. Подробное руководство по настройке универсального рабочего процесса Gemini CLI см. в документации по рабочему процессу Gemini Assistant.

Конфигурация

Входные данные

• gcp_location: (Опционально) Местоположение Google Cloud.

• gcp_project_id: (Опционально) Идентификатор проекта Google Cloud.

• gcp_service_account: (Опционально) Адрес электронной почты сервисного аккаунта Google Cloud.

• gcp_workload_identity_provider: (Опционально) Провайдер удостоверений рабочей нагрузки Google Cloud.

• gcp_token_format: (Опционально, по умолчанию: access_token) Формат токена для аутентификации. Установите "access_token" для генерации токенов доступа (требует сервисный аккаунт) или оставьте пустой строкой для прямого WIF. Может принимать значения "access_token" или "id_token".

• gcp_access_token_scopes: (Опционально, по умолчанию: https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/userinfo.email,https://www.googleapis.com/auth/userinfo.profile) Области токена доступа при использовании token_format "access_token". Список областей OAuth 2.0, разделённых запятыми.