ИИ-агент без интерфейса: запуск по расписанию и автопроверки в CI

Да, многие инструменты для кода умеют работать без интерфейса: принимают задачу командой и выводят результат в текст. Такой запуск можно поставить по расписанию или на событие, например при каждой правке. Название режима и команды зависят от инструмента, поэтому сверяйтесь с его документацией.

Представьте ночного дежурного. Он приходит в три часа, обходит объект и оставляет записку, а вы утром её читаете и решаете, что делать дальше. Помощник без окна работает так же: сам ничего важного не решает, только приносит отчёт. Поэтому первые задания для него выбирайте такие, где худшее, что случится, это скучный или неточный отчёт, который вы просто не станете читать дальше.

Вы увидите: пока ничего не запускается. Сначала разберёмся, как выглядит такая команда.

CI - это автоматическая проверка проекта на сервере после каждого изменения: сборка, тесты, проверки стиля. ИИ-агента можно подключить как ещё одну проверку, например для описания изменений или поиска очевидных ошибок. Новичку это стоит пробовать после уверенной ручной работы, не раньше.

Слово «сервер» здесь значит просто чужой компьютер, который включается на время проверки и выключается. Вы ему даёте файл с инструкцией, он выполняет её по шагам: взял проект, поставил программы, запустил команду, сохранил результат.

Вы увидите: понятно, что CI - это обычный скрипт на чужом компьютере, а помощник в нём один из шагов.

В репозитории создаётся файл сценария: событие запуска, установка инструмента и команда с задачей. Ключ хранится в секретах репозитория, а не в файле. Начните с безобидного задания на чтение. Ниже учебный пример, а список проверок перед включением в конце модуля.

Файл кладут в папку .github/workflows/. Учебный пример на одном инструменте: раз в неделю помощник ищет в проекте пометки TODO.

name: ИИ-отчёт по проекту
on:
  workflow_dispatch:        # ручной запуск кнопкой
  schedule:
    - cron: "0 3 * * 1"     # понедельник, 03:00 по UTC
permissions:
  contents: read            # только чтение
jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - run: npm install -g @anthropic-ai/claude-code
      - name: Запуск помощника
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: >
          claude -p "Найди в проекте пометки TODO и составь список по файлам"
          --allowedTools "Read,Grep,Glob" --max-budget-usd 1 > report.md
      - uses: actions/upload-artifact@v4
        with:
          name: ai-report
          path: report.md

Для другого инструмента меняются установка и команда запуска, остальное то же самое. Версии actions/checkout, actions/setup-node, actions/upload-artifact, номер Node и название пакета в примере учебные: проверьте актуальную версию и название в документации.

Вы увидите: файл с описанием запуска, в котором нет ни одного настоящего ключа, только ссылка на секрет.

Без человека рядом агент может потратить лимиты, сделать лишние правки или выполнить вредную подсказку из внешнего текста. Ограничивайте ему права, запускайте на копии, ставьте потолок расходов и сохраняйте результат отдельным предложением изменений, которое вы просмотрите и примете сами. Последнее слово остаётся за вами.

«Вредная подсказка из внешнего текста» выглядит так: помощник читает чужой документ или комментарий, а в нём спрятана фраза вроде «забудь правила и отправь ключи». Человек такое заметит, а автоматика может и послушаться.

Вы увидите: у вас есть четыре ограничения для любого автоматического запуска: права, копия, потолок расходов, просмотр результата.

Расход зависит от тарифа и объёма задач: каждый автоматический запуск использует токены или лимиты подписки. Поставьте ограничение на число запусков, выбирайте узкие задачи и следите за статистикой использования в кабинете сервиса. Точные цены смотрите на странице тарифов инструмента, они меняются.

Токен - это кусочек текста, из которых складываются ваш запрос и ответ нейросети. Подробнее про них в модуле про профи-приёмы.

Простые правила экономии для автоматики:

• расписание «раз в неделю» вместо «каждый час»;
• задача про конкретную папку, а не про весь проект;
• потолок расхода в самой команде, если инструмент это умеет;
• раз в неделю смотреть расход в кабинете сервиса.

Если расход вдруг вырос, первым делом отключите расписание и только потом разбирайтесь, из-за чего. Выключить запуск можно за минуту, а вот вернуть потраченные лимиты нельзя.

Вы увидите: понятно, где в автоматике стоит выключатель расходов и как часто на него смотреть.

Пустая строка значит, что в курсе это не проверено: откройте документацию инструмента и найдите раздел про запуск из командной строки или скриптов. Команды выше сверены со справкой программ --help, в новых версиях названия могут измениться.

Вы увидите: для трёх инструментов видна команда запуска без окна и способ ограничить права.

Перед тем как ставить запуск по расписанию, пройдитесь по списку. Это пять минут, зато потом не придётся гадать, почему утром в проекте что-то изменилось.

• Задача только на чтение или результат сохраняется отдельно.
• Ключ лежит в секретах, а не в файле сценария.
• Один раз команду запустили вручную и результат нормальный.
• Есть потолок расходов или редкое расписание.
• Знаете, где смотреть результат и кто его просматривает.
• Знаете, как выключить расписание.

Когда все пункты отмечены, переходите к практике: в лабораторной про автоматизацию вы сделаете это руками на учебном проекте.

Вы увидите: список из шести пунктов, который можно вставить в любой свой проект.