Как я первый раз в жизни написал научную статью в LaTeX с помощью ИИ-Агента за полдня

—

от автора

Аннотация: Рассказ о том, как обычному физику-теоретику, не знающему ни слова о LaTeX, удалось за полдня установить дистрибутив, освоить строгий формат научных статей и подготовить публикацию для журнала «Письма в ЖЭТФ» — полностью с помощью ИИ-агента в GigaCode.


Вступление: проблема, которая знакома каждому

Если вы когда-нибудь пытались написать научную статью, то знаете: самое сложное — это не идеи, а оформление.

У меня была теория. Обобщённый формализм физики, который я разрабатывал годами. Формулы, аналогии, выводы. Но всё это лежало в обычных текстовых файлах, Word-документах и HTML-страницах.

А нужно было получить красивый .pdf по строгим правилам журнала «Письма в ЖЭТФ» (JETP Letters) — с нумерованными формулами, автоматическими ссылками, правильными шрифтами и библиографией.

Для этого нужен LaTeX. И если для программиста это может показаться простым инструментом, то для человека, который никогда не компилировал документы из командной строки, — LaTeX выглядит как портал в другой мир.

«Подождите, мне нужно написать не просто текст, а откомпилировать его через консоль? С несколькими проходами? С BibTeX?» — именно такие мысли были у меня.

За полдня я сделал всё:

  • Установил LaTeX с нуля

  • Создал новую обзорную статью в строгом научном стиле

  • Преобразовал свои статьи из обычных форматов в .tex

  • Получил готовый PDF по стандартам журнала

Работало всё это прямо в GigaCode — и это важно: я не мучился с настройкой VS Code, не ставил LaTeX Workshop и не разбирался с кучей расширений. GigaCode взял на себя всё.


Что такое LaTeX и почему программисты его не любят, а физики — боготворят

LaTeX — это не текстовый процессор. Это система вёрстки, в которой вы описываете структуру документа, а не его внешний вид.

\documentclass{article}\usepackage{amsmath}\begin{document}Вот формула Гаусса:\begin{equation}    \oint_S \mathbf{E} \cdot d\mathbf{A} = \frac{Q}{\varepsilon_0}\end{equation}\end{document}

Затем вы запускаете компилятор, и он выдаёт вам идеально отформатированный PDF.

Почему физики его обожают:

  • Формулы выглядят как в настоящей научной статье

  • Нумерация уравнений автоматическая

  • Ссылки на формулы через \label и \eqref — никогда не сбиваются

  • Библиография управляется автоматически

Почему я его ненавидел до этого:

  • Нужно устанавливать дистрибутив через консоль

  • Нужно понимать, что такое pdflatex, bibtex, .aux файлы

  • Нужно запустить компиляцию несколько раз, чтобы всё сошлось

  • Ошибки компиляции читаются как древние заклинания


Шаг 1: Установка LaTeX

Первое, что мне нужно было сделать — установить LaTeX на Windows.

Я спросил у ИИ-Агента в GigaCode:

Мне нужно установить LaTeX на Windows 11/10. Я никогда этого не делал.Моя задача — писать научные статьи по физике и компилировать их в PDF.Какой дистрибутив выбрать и как его установить пошагово?

Агент предложил MiKTeX — дистрибутив, который автоматически подтягивает недостающие пакеты. И дал пошаговую инструкцию:

  1. Скачать miktex.org

  2. Установить MiKTeX

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


Шаг 2: Описание репозитория для ИИ

Спера я загрузил в репозиторий (в созданную папку docs/original) все мои старые статьи и наработки. И прежде чем писать статью, мне нужно было «вгрузить» в контекст ИИ-Агента всю структуру моего проекта. Я начал с описания репозитория:

Ты — мой научный ассистент. Изучи структуру моего проекта.Я работаю в директории C:/!A/!Dima/!НАУКА/ermolaev_fizik/Мой проект — это теоретический физический формализм.У меня есть:- docs/ — документы, руководства, шаблоны для статей- docs/original/ — мои исходные материалы, черновики, публикации- WORK/ — рабочие файлыМне нужно, чтобы ты понимал структуру проекта и мог помогать мнес написанием и оформлением научных статей.Создай краткое описание структуры проекта, чтобы мы моглиэффективно работать вместе.

Это было важно, потому что ИИ-Агент не мог сам «увидеть» мой проект. Мне нужно было дать ему контекст — и он начал работать как полноценный участник процесса.


Шаг 3: Создание рекомендаций (Context Prompt)

После того как агент понял структуру проекта, я попросил его создать Context Prompt — документ, который описывает физические правила проекта и становится справочником для всех участников (включая ИИ):

Создай документ PROJECT_CONTEXT.md, который станет справочникомпо физическому формализму моего проекта.В него нужно включить:1. Базовый формализм — основные символы и определения   (Q — энергозаряд, U — энергонапряжение, E — энергия и т.д.)2. Коэффициенты накопления (C_U, C_I)3. Тепловой заряд theta4. Обобщённые законы Кирхгофа5. Междисциплинарные аналогии6. Словарь терминов7. Критические позиции (почему энтропия S не подходит)Используй строгий научный стиль, но так, чтобы было понятнодругим исследователям.

Результат — документ, который стал «единым источником правды» для всего проекта. И агент постоянно ссылался на него при работе со статьями.


Шаг 4: Преобразование статей в LaTeX

Самый объёмный этап. У меня были статьи в разных форматах:

  • HTML-файлы (!fizic для спутника-utf8.htm)

  • Текстовые черновики

  • Старые статьи в .doc и .docx

Нужно было превратить всё это в .tex-файл по шаблону журнала «Письма в ЖЭТФ».

Мой промт:

Изучи файл docs/original/sputnik/!fizic для спутника-utf8.htmи другие файлы в этой папке.Моя задача — написать статью для журнала «Письма в ЖЭТФ» (JETP Letters).Руководство по оформлению есть в docs/JETF-Letters-Guide.md.Шаблон LaTeX — в docs/template-jetp-letters.tex.Преобразуй мои материалы в формат .tex, соблюдая:1. Структуру журнала: заголовок, автор, аннотация (до 150 слов),   ключевые слова, введение, основной текст, заключение, список литературы2. Все формулы должны быть нумерованы через \begin{equation}3. Использовать обобщённые символы из PROJECT_CONTEXT.md   (Q, U, E, I в полужирном шрифте через \mathbf)4. Список литературы — 10-15 источников5. Объём — до 5 страницСперва предложи тему статьи, основанную на моих материалах.Какая тема будет наиболее интересна читателям ЖЭТФ?

Агент предложил несколько тем, я выбрал одну, и дальше мы итеративно дорабатывали статью.


Шаг 5: Итеративная доработка

LaTeX — это не «написал и готово». Обычно нужно несколько проходов компиляции, и каждый раз могут всплывать новые нюансы.

В GigaCode я открывал .tex файл, руками вносил небольшие правки в текст — например, перефразировал абзац, добавлял связку между разделами. А вот с формулами я уже не лез: просил ИИ-Агента.

Вот реальный пример моего промта после первого просмотра сгенерированного PDF:

В сгенерированном PDF файле почему-то обобщённый потенциалвсё ещё не выделен полужирным шрифтом...Или это только в PDF отображается неправильно?Проверь, правильно ли определены команды \Q, \U, \E в шаблоне.

Или:

В абзаце про Первый закон Кирхгофа (неразрывность токов),где формула 16 — нужно добавить мысль, что в узле, гдесходятся токи, обобщённое напряжение — единая величина.А значит, в формуле сложения энергий её можно не учитывать.Поэтому формула упрощается до суммы энерготоков.

Каждый раз агент находил проблему и исправлял .tex-файл. Я смотрел PDF, который GigaCode сам компилировал, находил неточности — и агент исправлял. Иногда это были мелкие нюансы — например, как именно обозначать полужирные символы в математическом режиме. Иногда — структурные правки.


Шаг 6: Компиляция — GigaCode делает всё сам

Когда .tex-файл был готов, я просто попросил ИИ-Агента скомпилировать его в PDF.

Мой промт был простым:

Скомпилируй docs/article/article-kirchhoff-general.texв PDF и покажи результат.

Но прежде чем это заработало, агент объяснил, что происходит под капотом:

Объясни, как работает компиляция LaTeX:1. Почему нужно запустить pdflatex несколько раз2. Что такое .aux файлы и зачем они нужны3. Когда нужен bibtex

И объяснил, почему так: первый проход — текст и формулы, второй — ссылки и библиография, третий — финальная проверка. А в GigaCode это всё происходит автоматически — я просто открываю PDF и смотрю результат.


Что я узнал о LaTeX за этот день

LaTeX — это нестандартно

Да, я программист. Я привык к IDE, к автодополнению, к кнопке «Run». А тут — напиши текст в .tex файле, запусти компиляцию — и получи ошибки на латыни. Запусти ещё раз.

Но именно это делает LaTeX мощным:

  • Разделение контента и оформления — вы пишете структуру, а не пиксели

  • Стабильность — 100 ссылок на формулы? Не проблема. LaTeX сам всё обновит

  • Качество — шрифты, интервалы, формулы — всё выглядит профессионально

  • Версионирование — .tex файл это обычный текст, его можно хранить в Git

ИИ-Агент — это не «напиши за меня»

Важно понимать: ИИ-Агент не просто сгенерировал файл. Мы работали в тандеме:

  1. Я давал содержание и идеи — и руками правил текст в .tex файлах

  2. Агент трансформировал мои пожелания в правильный LaTeX-синтаксис

  3. GigaCode сам компилировал PDF — я просто открывал и смотрел

  4. Я находил неточности, агент исправлял

Это как работа с очень быстрым соавтором, который знает синтаксис, но не знает ваши идеи. А ещё — с редактором, который сам компилирует и показывает результат.


Примеры моих промтов (шпаргалка)

Вот подборка промтов, которые сработали лучше всего:

Установка и настройка

Установи LaTeX на Windows. Я новичок. Объясни каждый шаг.

Контекст проекта

Опиши структуру моего проекта для научного формализма.Я хочу, чтобы ты понимал контекст и мог помогать со статьями.

Создание документации

Создай справочник PROJECT_CONTEXT.md с определениямиобобщённых величин, формулами и правилами оформления.

Написание статьи

Преобразуй мои материалы из [формат] в LaTeX-статьюдля журнала [название]. Соблюдай требования из [руководство].

Отладка PDF

В PDF не отображается [проблема]. Проверь [файл].

Компиляция

Скомпилируй .tex в PDF и покажи результат.

Итог

За полдня я:

  • Установил LaTeX с нуля (MiKTeX)

  • Создал структурированный репозиторий научных материалов

  • Написал Context Prompt для проекта

  • Преобразовал черновики в .tex по стандартам ЖЭТФ

  • Получил готовый PDF через GigaCode

Без ИИ-Агента в GigaCode это заняло бы недели — а может, я бы вообще бросил на этапе установки MiKTeX.

Главный вывод: LaTeX перестал быть для меня «чёрным ящиком». Я не боюсь его больше. И если вы когда-нибудь задумаетесь написать научную статью — начните с ИИ-помощника. Он сделает порог входа гораздо мягче.


Ссылки


P.S. Весь проект — в открытом репозитории

Весь проект — от первого коммита до готовой статьи — лежит в открытом публичном репозитории:

👉 gitverse.ru/icreator/ermolaev_physics/commits/branch

Вы можете зайти и увидеть, как развивался проект — с датами, временем, по коммитам. Всё честно: и идеи, и ошибки, и правки. Если интересно — добро пожаловать!


Если вам интересна тема — могу рассказать подробнее о моём физическом формализме, обобщённых законах Кирхгофа или о том, как ИИ помогает в научных исследованиях. Пишите в комментариях!

ссылка на оригинал статьи https://habr.com/ru/articles/1102114/