GitHub

slopcode интегрируется с вашим рабочим процессом GitHub. Упомяните /slopcode или /sc в своем комментарии, и slopcode выполнит задачи в вашем средстве выполнения действий GitHub.

Возможности

Триаж задач (Issue Triage). Попросите slopcode разобраться в проблеме и объяснить ее вам.
Исправление и реализация. Попросите slopcode исправить проблему или реализовать функцию. Он будет работать в новой ветке и создаст PR со всеми изменениями.
Безопасность: slopcode запускается внутри ваших GitHub Runners.

Установка

Запустите следующую команду в проекте, который находится в репозитории GitHub:

slopcode github install

Это поможет вам установить приложение GitHub, создать рабочий процесс и настроить secrets (секреты).

Ручная настройка

Или вы можете настроить его вручную.

Установите приложение GitHub

Перейдите на github.com/apps/slopcode-agent. Убедитесь, что он установлен в целевом репозитории.

Добавьте рабочий процесс

Добавьте следующий файл рабочего процесса в .github/workflows/slopcode.yml в своем репозитории. Обязательно установите соответствующий model и необходимые ключи API в env.

name: slopcode

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  slopcode:
    if: |
      contains(github.event.comment.body, '/sc') ||
      contains(github.event.comment.body, '/slopcode')
    runs-on: ubuntu-latest
    permissions:
      id-token: write
    steps:
       - name: Checkout repository
         uses: actions/checkout@v6
         with:
           fetch-depth: 1
           persist-credentials: false

       - name: Run SlopCode
        uses: grappeggia/slopcode/github@latest
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        with:
          model: anthropic/claude-sonnet-4-20250514
          # share: true
          # github_token: xxxx

Храните ключи API в секрете

В настройках вашей организации или проекта разверните Секреты и переменные слева и выберите Действия. И добавьте необходимые ключи API.

Настройка

model: модель для использования с slopcode. Принимает формат provider/model. Это обязательно.
agent: используемый агент. Должен быть основным агентом. Возвращается к default_agent из конфигурации или к "build", если не найден.
share: следует ли предоставлять общий доступ к сеансу slopcode. По умолчанию true для общедоступных репозиториев.
prompt: дополнительный настраиваемый запрос для переопределения поведения по умолчанию. Используйте это, чтобы настроить обработку запросов slopcode.
token: дополнительный токен доступа GitHub для выполнения таких операций, как создание комментариев, фиксация изменений и открытие запросов на включение. По умолчанию slopcode использует токен доступа к установке из приложения slopcode GitHub, поэтому фиксации, комментарии и запросы на включение отображаются как исходящие из приложения.

Кроме того, вы можете использовать встроенный GITHUB_TOKEN средства запуска действий GitHub без установки приложения slopcode GitHub. Просто не забудьте предоставить необходимые разрешения в вашем рабочем процессе:
```
permissions:
  id-token: write
  contents: write
  pull-requests: write
  issues: write
```
Вы также можете использовать токены личного доступа(PAT), если предпочитаете.

Поддерживаемые события

slopcode может быть запущен следующими событиями GitHub:

Тип события	Инициировано	Подробности
`issue_comment`	Комментарий к проблеме или PR	Упомяните `/slopcode` или `/sc` в своем комментарии. slopcode считывает контекст и может создавать ветки, открывать PR или отвечать.
`pull_request_review_comment`	Комментируйте конкретные строки кода в PR.	Упоминайте `/slopcode` или `/sc` при просмотре кода. slopcode получает путь к файлу, номера строк и контекст сравнения.
`issues`	Issue открыт или изменен	Автоматически запускать slopcode при создании или изменении проблем. Требуется ввод `prompt`.
`pull_request`	PR открыт или обновлен	Автоматически запускать slopcode при открытии, синхронизации или повторном открытии PR. Полезно для автоматических обзоров.
`schedule`	Расписание на основе Cron	Запускайте slopcode по расписанию. Требуется ввод `prompt`. Вывод поступает в журналы и PR (комментариев нет).
`workflow_dispatch`	Ручной триггер из пользовательского интерфейса GitHub	Запускайте slopcode по требованию на вкладке «Действия». Требуется ввод `prompt`. Вывод идет в логи и PR.

Пример: Расписание

Запускайте slopcode по расписанию для выполнения автоматизированных задач:

name: Scheduled SlopCode Task

on:
  schedule:
    - cron: "0 9 * * 1" # Every Monday at 9am UTC

jobs:
  slopcode:
    runs-on: ubuntu-latest
    permissions:
      id-token: write
      contents: write
      pull-requests: write
      issues: write
    steps:
      - name: Checkout repository
        uses: actions/checkout@v6
        with:
          persist-credentials: false

      - name: Run SlopCode
        uses: grappeggia/slopcode/github@latest
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        with:
          model: anthropic/claude-sonnet-4-20250514
          prompt: |
            Review the codebase for any TODO comments and create a summary.
            If you find issues worth addressing, open an issue to track them.

Для запланированных событий вход prompt обязателен, поскольку нет комментария, из которого можно было бы извлечь инструкции. Запланированные рабочие процессы выполняются без пользовательского контекста для проверки разрешений, поэтому рабочий процесс должен предоставлять contents: write и pull-requests: write, если вы ожидаете, что slopcode будет создавать ветки или PR.

Пример: Pull Request

Автоматически просматривать PR при их открытии или обновлении:

name: slopcode-review

on:
  pull_request:
    types: [opened, synchronize, reopened, ready_for_review]

jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      id-token: write
      contents: read
      pull-requests: read
      issues: read
    steps:
      - uses: actions/checkout@v6
        with:
          persist-credentials: false
      - uses: grappeggia/slopcode/github@latest
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
          model: anthropic/claude-sonnet-4-20250514
          use_github_token: true
          prompt: |
            Review this pull request:
            - Check for code quality issues
            - Look for potential bugs
            - Suggest improvements

Если для событий pull_request не указан prompt, slopcode по умолчанию проверяет запрос на включение.

Пример: Сортировка Issue

Автоматически сортируйте новые проблемы. В этом примере фильтруется аккаунты, созданные более 30 дней назад, чтобы уменьшить количество спама:

name: Issue Triage

on:
  issues:
    types: [opened]

jobs:
  triage:
    runs-on: ubuntu-latest
    permissions:
      id-token: write
      contents: write
      pull-requests: write
      issues: write
    steps:
      - name: Check account age
        id: check
        uses: actions/github-script@v7
        with:
          script: |
            const user = await github.rest.users.getByUsername({
              username: context.payload.issue.user.login
            });
            const created = new Date(user.data.created_at);
            const days = (Date.now() - created) / (1000 * 60 * 60 * 24);
            return days >= 30;
          result-encoding: string

      - uses: actions/checkout@v6
        if: steps.check.outputs.result == 'true'
        with:
          persist-credentials: false

      - uses: grappeggia/slopcode/github@latest
        if: steps.check.outputs.result == 'true'
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        with:
          model: anthropic/claude-sonnet-4-20250514
          prompt: |
            Review this issue. If there's a clear fix or relevant docs:
            - Provide documentation links
            - Add error handling guidance for code examples
            Otherwise, do not comment.

Для событий issues вход prompt обязателен, поскольку нет комментария, из которого можно было бы извлечь инструкции.

Пользовательские промпты

Переопределите приглашение по умолчанию, чтобы настроить поведение slopcode для вашего рабочего процесса.

- uses: grappeggia/slopcode/github@latest
  with:
    model: anthropic/claude-sonnet-4-5
    prompt: |
      Review this pull request:
      - Check for code quality issues
      - Look for potential bugs
      - Suggest improvements

Это полезно для обеспечения соблюдения конкретных критериев проверки, стандартов кодирования или приоритетных областей, имеющих отношение к вашему проекту.

Примеры

Вот несколько примеров того, как вы можете использовать slopcode в GitHub.

Объяснение проблемы

Добавьте этот комментарий в выпуск GitHub.
```
/slopcode explain this issue
```
slopcode прочитает всю ветку, включая все комментарии, и ответит с четким объяснением.
Исправление проблемы

В выпуске GitHub скажите:
```
/slopcode fix this
```
А slopcode создаст новую ветку, внедрит изменения и откроет PR с изменениями.
Проверка Pull Request и внесение изменений

Оставьте следующий комментарий к PR на GitHub.
```
Delete the attachment from S3 when the note is removed /sc
```
slopcode внедрит запрошенное изменение и зафиксирует его в том же PR.
Проверка отдельных строк кода

Оставляйте комментарии непосредственно к строкам кода на вкладке «Файлы» PR. slopcode автоматически определяет файл, номера строк и контекст различий, чтобы предоставить точные ответы.
```
[Comment on specific lines in Files tab]
/sc add error handling here
```
При комментировании определенных строк slopcode получает:
- Точный файл, который просматривается
- Конкретные строки кода
- Окружающий контекст различий
- Информация о номере строки
Это позволяет выполнять более целевые запросы без необходимости вручную указывать пути к файлам или номера строк.