# Implementation To Theory

> Write or improve an engineering explanation that reconstructs the theory, numerical algorithms, and derivation behind existing scientific code, tracing every equation to implementation. Use for requests such as "от реализации к теории", "объясни физику реализации", or a step-by-step mathematical guide with technical illustrations. Not for changing solver behavior or generic API documentation.

- Skill: `applicate2628/implementation-to-theory` (Agent Skill)
- Install (CLI): `npx get-skill add applicate2628/implementation-to-theory`
- Raw SKILL.md: https://api.skillmd.com/api/skills/applicate2628/implementation-to-theory/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: applicate2628 (https://skillmd.com/u/applicate2628)
- Updated: 2026-11-11
- Page: https://skillmd.com/skills/applicate2628/implementation-to-theory

---


# От реализации к теории

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

## Границы задачи

- Сохраняй выбранный пользователем формат. По умолчанию подходит Markdown;
  не переходи к PDF ради обхода ошибок разметки.
- Документирование само по себе не разрешает рефакторинг, исправление solver-а,
  запуск дорогих расчётов, изменение точности или публикацию. Найденную ошибку
  объясни и отдели от описания фактически реализованного поведения.
- Уточни рассматриваемый путь: входная задача, активный provider/режим,
  состав компонентов, готовые и экспериментальные ветви. Не смешивай ветви
  только потому, что их файлы находятся рядом.
- При параллельной работе дай одному исполнителю текст, другому непересекающиеся
  рисунки, исследователям — чтение исходников. Передавай автору проверенные
  факты; не позволяй нескольким исполнителям одновременно править документ.

## Сначала восстанови фактический вычислительный путь

1. Прочитай применимые правила и описание текущей реализации. Зафиксируй
   ревизию/состояние рассмотренных файлов и используемые входные артефакты.
2. Найди путь от входного формата через математические владельцы к результату.
   Используй доступные MCP, граф кода и языковой сервер, проверяя свежесть
   индекса. Если индекс не покрывает путь или возвращает посторонние совпадения,
   используй текущие исходники и назови это ограничение.
3. Извлеки соглашения: координаты, ориентации, единицы, знаки, фазоры,
   нормировку, порядок индексов, расположение элементов матриц, масштабирование,
   граничные условия и область применимости.
4. Отдели доказанные свойства программы от математических предпосылок и
   наблюдённых результатов тестов. Название `physical`, комментарий `exact`
   или сообщение PASS не заменяет проверку определения и вычисления.
5. Для внешних формул используй первичный источник с номером уравнения/раздела.
   Покажи перевод обозначений источника в обозначения программы. Не используй
   общий известный метод как доказательство того, что именно он реализован.

## Строй непрерывный вывод

Каждый содержательный этап должен связывать:

**исходное уравнение → предпосылки → преобразование → вычислимая формула →
дискретизация → массивы/индексы → функция программы → следующий потребитель.**

- Начинай с законов или определяющих уравнений и исходных данных, нужных
  именно этой реализации. Укажи, что задано и что требуется найти.
- Показывай промежуточные шаги: подстановку, интегрирование по частям,
  преобразование координат, исключение неизвестных, переход от интеграла
  к сумме и от суммы к элементу матрицы. Не прячь ключевой переход за
  «после преобразований» или «далее вызывается функция».
- Если закрытая формула громоздка, выпиши воспроизводимую систему уравнений
  с неизвестными, коэффициентами и условиями вместо неподтверждённого упрощения.
- Различай непрерывную модель, конечную дискретную задачу и способ её
  вычисления. Небольшая невязка не доказывает сходимость к непрерывной задаче.
- Не выдавай формальное обращение матрицы на бумаге за явное обращение в коде,
  если программа использует факторизацию и решение систем.
- Объясняй школьному читателю впервые встреченные операции (комплексное
  сопряжение, градиент, ротор, интеграл, базис, норма, собственное значение)
  по их роли в текущем шаге. Короткие учебные примеры маркируй как вымышленные,
  не как результаты solver-а.

## Полнота обозначений: проверяй каждую формулу

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

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

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

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

## Численные проблемы и алгоритмы

Для каждого этапа объясни: какая проблема возникает; какой алгоритм фактически
использован; почему он решает эту проблему; входы и выходы; условие остановки;
метрики ошибки; отказы и ограничения; конкретные функции и тесты.

Включай только относящиеся к пути вопросы: сингулярности, усечение рядов,
квадратуры, поиск корней и выбор ветви, обусловленность, вычитание близких чисел,
переполнение, рабочая точность, порядок суммирования, параллелизм и стоимость.
Различай физическую ошибку, дискретизационную ошибку и ошибку арифметики.
Объясняй значения допусков и кто ими управляет; не представляй параметры
конкретного теста универсальными константами метода.

## Иллюстрации инженера

- Используй реальные встроенные изображения с относительными ссылками.
  Для точных схем предпочитай SVG; ASCII-вставки и исходник Mermaid не являются
  готовыми рисунками, если пользователь просит изображения.
- Выбирай рисунки по переходам вывода: геометрия/координаты, граничные условия,
  базис, дискретизация, направления/знаки, матричные блоки, алгоритм, передача
  результатов. Количество определяется полезностью, а не фиксированной квотой.
- На рисунке нужны обозначения, оси, единицы, направления, границы, легенда
  и связь с формулой/разделом. Подписывай схематические кривые и учебные данные.
  Декоративная инфографика не заменяет техническую схему.
- Не рисуй сетку, поле, проводник или готовый путь, которых нет в постановке.
  Проектируемую ветвь визуально отличай и подписывай как нереализованную.
- Рендерь и лично просматривай каждый итоговый рисунок: наложения текста,
  обрезка, контраст, знаки, направления и соответствие обозначениям документа.

## Формат и проверка результата

- Для Markdown используй `$...$` и отдельные блочные `$$...$$` с пустыми строками.
  Не помещай длинные формулы и многошаговые выводы в таблицы; символ `|` может
  разбить ячейки. Для норм и модулей применяй `\lVert`, `\rVert`, `\lvert`, `\rvert`.
- Проверь все выражения реальным KaTeX/MathJax, соответствующим целевому
  просмотрщику, если доступен. Подсчёт пар разделителей не доказывает рендер.
  Не меняй корректную математику ради обхода синтаксической ошибки.
- Пройди документ последовательно как читатель: известны ли все входы
  следующего шага? Можно ли получить каждый коэффициент без скрытой ссылки?
  Совпадают ли индексы и соглашения с реальным кодом?
- Проверь ссылки на файлы/символы, встроенные изображения, актуальность
  утверждений о реализации и результатах. Укажи предел проверок честно.
- Заверши словарём обозначений/сокращений и компактной картой реализации.
  Основные ссылки на код остаются рядом с соответствующими формулами.
- Сохрани документ и связанные рисунки единым пакетом. Убери собственные
  отвергнутые варианты из публикуемого дерева. Git commit выполняй только
  при наличии пользовательского поручения и с обычными проверками проекта.

Готовность означает связность вывода, полноту обозначений, проверенную связь
с кодом и читаемые рисунки/формулы. Если существенный шаг не восстановлен,
назови точный пробел; не объявляй руководство полным.

