Мелочи ИИ-шной жизни. Как GitHub Copilot Hook может помочь совершенствовать ваш английский параллельно с вайбкодингом

Вы, читатель, как и автор, тоже досадуете, когда в промтах проскакивают досадные опечатки или грамматические конструкции, которые заставляют даже терпеливую LLM «задумчиво» переспрашивать: «What do you mean?»

Если да, то эта статья для вас. Мы разберем, как с помощью минимума кода получить автоматический анализ ваших языковых ляпов и рекомендации по прокачке профессионального английского, не отрываясь от процесса создания кода.

О первой части названия

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

Это одиночество в сети и подтолкнуло меня (после долгого перерыва в публикациях на Хабре) запустить серию мини-статей о разных «мелочах», связанных с ИИ. Окончательно концепция оформилась, когда под руку попалась одна из моих любимых книг Николая Семеновича Лескова — «Мелочи архиерейской жизни». Если вы цените сочный русский язык и тонкую иронию — искренне советую почитать. А мы пока перейдем к мелочам нашей, «айтишной» жизни.

Проблема: варварский английский

Должен признаться: мой английский хоть и понимается Copilot-агентами весьма сносно, но иногда возникают недопонимания. А порой становится стыдно (да, уши краснеют!), когда агенты начинает между собой рассуждать, что же именно я имел в виду под этой кучей опечаток.

Захотелось убить двух зайцев: и работу работать, и английский подтягивать. План созрел быстро:

1. Шаг 1: Собираем в одном месте всё, что я наговорил агенту за день.

2. Шаг 2: Скармливаем этот лог отдельному агенту-корректору, который анализирует мой «варварский» английский и выдает вердикт: как это должно было звучать на самом деле.

Для первого шага нашлось элегантное решение — хуки (Hooks).

Реализация: Хуки как «уши» системы

Вообще, то, что этот механизм назван «хуком» (hook) — я считаю ошибкой его создателей. Правильнее было бы называть это Event Listener (слушатель событий). По сути, перед нами классическая событийная модель: система «слушает» происходящее в GitHub Copilot и позволяет нам вклиниться в процесс.

На сегодняшний день хуки — это пары, которые «окружают» ключевые события при работе ИИ-агента. Согласно официальной документации GitHub, мы можем подписываться на следующие типы событий:

• Отправка промта пользователем (userPromptSubmitted) — срабатывает в тот момент, когда вы нажали Enter в чате.

• Завершение ответа агента (agentResponseCompleted) — когда ИИ закончил генерировать код или текст.

• Обнаружение обращения к инструменту (toolCallDetected) — если агент решил вызвать какую-то внешнюю функцию.

• Завершение вызова инструмента (toolCallCompleted) — результат работы этой функции.

Для нашей задачи идеально подходит первое событие. Нам нужно просто «подслушать» самих себя.

Код

Создаем конфигурационный файл по адресу .github/hooks/log-prompts.json:

{ "version": 1, "hooks": { "userPromptSubmitted": [ { "type": "command", "bash": "scripts/log-user-prompt.sh", "cwd": ".", "timeoutSec": 5 } ] } }

И сам скриптик scripts/log-user-promt.sh, который будет складывать наши мысли в копилку, выглядит вот так:

#!/bin/bash # Читаем JSON из стандартного ввода input=$(cat) # Извлекаем текст промта с помощью jq prompt=$(echo "$input" | jq -r '.prompt // empty') # Если промт не пустой, дописываем его в файл if [ -n "$prompt" ]; then echo "--- $(date) ---" >> TMP/user-commands.txt echo "$prompt" >> TMP/user-commands.txt fi

Теперь в конце рабочего дня у вас есть файл user-commands.txt.

Осталось только передать его примерно такому агенту, которого мы располагаем по адресу .github/agents/lang-tutor.agent.md:

--- name: lang-tutor description: Language tutor that analyzes writing quality and grammar. Automatically reads TMP/user-commands.txt and writes corrections to TMP/user-commands.md. tools: ["read", "edit"] target: vscode --- You are a professional language tutor and writing quality specialist. **Task**: Analyze `TMP/user-commands.txt` and generate a detailed quality report in `TMP/user-commands.md`. **Analysis focus**: - Grammar mistakes, spelling errors, punctuation issues - Awkward phrasing and clarity problems - Professional tone consistency - Sentence structure and readability **Report format for `TMP/user-commands.md`**: 1. **Overview**: Brief summary of text quality and main findings 2. **Issues Table**: | Issue Type | Original Sentence | Corrected Sentence | |---|---|---| 3. **Recommendations**: General improvement tips 4. **Cleanup suggestion**: Include this shell command: ```bash rm TMP/user-commands.txt ``` **Guidelines**: Be constructive, specific, and encouraging. Acknowledge strengths while suggesting improvements. Include context for each correction.

Агент должен появиться в меню агентов вашего GItHub Copilot.

Не магией единой

Глядя на фантастические достижения индустрии (например, недавнюю статью Anthropic о том, как они строили C-компилятор), легко впасть в иллюзию. Кажется, что крутой программист просто пишет один гениальный промт, после чего LLM уходит в астрал на неделю и выдает готовую систему.

Но это не так. «Под капотом» у лидеров отрасли работает большое количество «обмазок» вокруг LLM. Агенты, скиллы, MCPs, CLI, функции и те самые хуки. Инструменты автоматизации взаимодействия с моделью изобретаются с бешеной скоростью. Сначала они обкатываются внутри лабораторий, а затем предоставляются нам — «широким программистским массам».

Хуки — это как раз один из таких свежих инструментов, позволяющий превратить магию в управляемый инженерный процесс. И если попутно они помогут нам перестать писать "fix this bug plz" вместо грамотного технического задания — это ли не победа?