От реализации к теории
Исследуй от программы к модели; объясняй от исходных принципов к программе.
Результат — воспроизводимое инженерное руководство: читатель может проследить
каждое преобразование, вычислить промежуточные величины и найти соответствующую
операцию в коде. Язык и глубину выбирай по запросу; «для школьника» означает
раскрыть необходимые математические понятия, а не заменить вывод аналогиями.
Границы задачи
- Сохраняй выбранный пользователем формат. По умолчанию подходит Markdown;
не переходи к PDF ради обхода ошибок разметки.
- Документирование само по себе не разрешает рефакторинг, исправление solver-а,
запуск дорогих расчётов, изменение точности или публикацию. Найденную ошибку
объясни и отдели от описания фактически реализованного поведения.
- Уточни рассматриваемый путь: входная задача, активный provider/режим,
состав компонентов, готовые и экспериментальные ветви. Не смешивай ветви
только потому, что их файлы находятся рядом.
- При параллельной работе дай одному исполнителю текст, другому непересекающиеся
рисунки, исследователям — чтение исходников. Передавай автору проверенные
факты; не позволяй нескольким исполнителям одновременно править документ.
Сначала восстанови фактический вычислительный путь
- Прочитай применимые правила и описание текущей реализации. Зафиксируй
ревизию/состояние рассмотренных файлов и используемые входные артефакты.
- Найди путь от входного формата через математические владельцы к результату.
Используй доступные MCP, граф кода и языковой сервер, проверяя свежесть
индекса. Если индекс не покрывает путь или возвращает посторонние совпадения,
используй текущие исходники и назови это ограничение.
- Извлеки соглашения: координаты, ориентации, единицы, знаки, фазоры,
нормировку, порядок индексов, расположение элементов матриц, масштабирование,
граничные условия и область применимости.
- Отдели доказанные свойства программы от математических предпосылок и
наблюдённых результатов тестов. Название
physical, комментарий exact
или сообщение PASS не заменяет проверку определения и вычисления.
- Для внешних формул используй первичный источник с номером уравнения/раздела.
Покажи перевод обозначений источника в обозначения программы. Не используй
общий известный метод как доказательство того, что именно он реализован.
Строй непрерывный вывод
Каждый содержательный этап должен связывать:
исходное уравнение → предпосылки → преобразование → вычислимая формула →
дискретизация → массивы/индексы → функция программы → следующий потребитель.
- Начинай с законов или определяющих уравнений и исходных данных, нужных
именно этой реализации. Укажи, что задано и что требуется найти.
- Показывай промежуточные шаги: подстановку, интегрирование по частям,
преобразование координат, исключение неизвестных, переход от интеграла
к сумме и от суммы к элементу матрицы. Не прячь ключевой переход за
«после преобразований» или «далее вызывается функция».
- Если закрытая формула громоздка, выпиши воспроизводимую систему уравнений
с неизвестными, коэффициентами и условиями вместо неподтверждённого упрощения.
- Различай непрерывную модель, конечную дискретную задачу и способ её
вычисления. Небольшая невязка не доказывает сходимость к непрерывной задаче.
- Не выдавай формальное обращение матрицы на бумаге за явное обращение в коде,
если программа использует факторизацию и решение систем.
- Объясняй школьному читателю впервые встреченные операции (комплексное
сопряжение, градиент, ротор, интеграл, базис, норма, собственное значение)
по их роли в текущем шаге. Короткие учебные примеры маркируй как вымышленные,
не как результаты solver-а.
Полнота обозначений: проверяй каждую формулу
У каждой величины, включая индексы, вспомогательные коэффициенты и допуски,
должны быть раскрыты:
- смысл и единицы; для массива — размер и смысл осей;
- происхождение: вход, физическая константа, вычисленный результат, неизвестная
системы или параметр численного алгоритма;
- выражение или конкретный способ получения;
- область допустимых значений и условие допустимости деления/обращения;
- место следующей подстановки и соответствующий объект кода.
Давай определения рядом с первым использованием; словарь в конце служит
указателем, а не заменой локальных объяснений. Повторно поясняй символ,
если его смысл меняется. Предпочитай разные обозначения для перегруженных
понятий: ток I и единичная матрица; волновое число и обусловленность;
слоистый коэффициент и интегральное действие на базис.
Особенно проверяй поглощённые множители преобразований, безразмерные координаты,
произвольный масштаб собственных векторов и последующую нормировку. Не назначай
коэффициенту единицы СИ по его имени. Если владелец не определяет абсолютную
шкалу, явно покажи эту свободу и этап, который её устраняет. Не изобретай
«недостающий» множитель ради красивого вывода.
Численные проблемы и алгоритмы
Для каждого этапа объясни: какая проблема возникает; какой алгоритм фактически
использован; почему он решает эту проблему; входы и выходы; условие остановки;
метрики ошибки; отказы и ограничения; конкретные функции и тесты.
Включай только относящиеся к пути вопросы: сингулярности, усечение рядов,
квадратуры, поиск корней и выбор ветви, обусловленность, вычитание близких чисел,
переполнение, рабочая точность, порядок суммирования, параллелизм и стоимость.
Различай физическую ошибку, дискретизационную ошибку и ошибку арифметики.
Объясняй значения допусков и кто ими управляет; не представляй параметры
конкретного теста универсальными константами метода.
Иллюстрации инженера
- Используй реальные встроенные изображения с относительными ссылками.
Для точных схем предпочитай SVG; ASCII-вставки и исходник Mermaid не являются
готовыми рисунками, если пользователь просит изображения.
- Выбирай рисунки по переходам вывода: геометрия/координаты, граничные условия,
базис, дискретизация, направления/знаки, матричные блоки, алгоритм, передача
результатов. Количество определяется полезностью, а не фиксированной квотой.
- На рисунке нужны обозначения, оси, единицы, направления, границы, легенда
и связь с формулой/разделом. Подписывай схематические кривые и учебные данные.
Декоративная инфографика не заменяет техническую схему.
- Не рисуй сетку, поле, проводник или готовый путь, которых нет в постановке.
Проектируемую ветвь визуально отличай и подписывай как нереализованную.
- Рендерь и лично просматривай каждый итоговый рисунок: наложения текста,
обрезка, контраст, знаки, направления и соответствие обозначениям документа.
Формат и проверка результата
- Для Markdown используй
$...$ и отдельные блочные $$...$$ с пустыми строками.
Не помещай длинные формулы и многошаговые выводы в таблицы; символ | может
разбить ячейки. Для норм и модулей применяй \lVert, \rVert, \lvert, \rvert.
- Проверь все выражения реальным KaTeX/MathJax, соответствующим целевому
просмотрщику, если доступен. Подсчёт пар разделителей не доказывает рендер.
Не меняй корректную математику ради обхода синтаксической ошибки.
- Пройди документ последовательно как читатель: известны ли все входы
следующего шага? Можно ли получить каждый коэффициент без скрытой ссылки?
Совпадают ли индексы и соглашения с реальным кодом?
- Проверь ссылки на файлы/символы, встроенные изображения, актуальность
утверждений о реализации и результатах. Укажи предел проверок честно.
- Заверши словарём обозначений/сокращений и компактной картой реализации.
Основные ссылки на код остаются рядом с соответствующими формулами.
- Сохрани документ и связанные рисунки единым пакетом. Убери собственные
отвергнутые варианты из публикуемого дерева. Git commit выполняй только
при наличии пользовательского поручения и с обычными проверками проекта.
Готовность означает связность вывода, полноту обозначений, проверенную связь
с кодом и читаемые рисунки/формулы. Если существенный шаг не восстановлен,
назови точный пробел; не объявляй руководство полным.
1---2name: implementation-to-theory3description: 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.4metadata:5 source: https://skillmd.com/skills/applicate2628/implementation-to-theory6---78# От реализации к теории910Исследуй от программы к модели; объясняй от исходных принципов к программе.11Результат — воспроизводимое инженерное руководство: читатель может проследить12каждое преобразование, вычислить промежуточные величины и найти соответствующую13операцию в коде. Язык и глубину выбирай по запросу; «для школьника» означает14раскрыть необходимые математические понятия, а не заменить вывод аналогиями.1516## Границы задачи1718- Сохраняй выбранный пользователем формат. По умолчанию подходит Markdown;19 не переходи к PDF ради обхода ошибок разметки.20- Документирование само по себе не разрешает рефакторинг, исправление solver-а,21 запуск дорогих расчётов, изменение точности или публикацию. Найденную ошибку22 объясни и отдели от описания фактически реализованного поведения.23- Уточни рассматриваемый путь: входная задача, активный provider/режим,24 состав компонентов, готовые и экспериментальные ветви. Не смешивай ветви25 только потому, что их файлы находятся рядом.26- При параллельной работе дай одному исполнителю текст, другому непересекающиеся27 рисунки, исследователям — чтение исходников. Передавай автору проверенные28 факты; не позволяй нескольким исполнителям одновременно править документ.2930## Сначала восстанови фактический вычислительный путь31321. Прочитай применимые правила и описание текущей реализации. Зафиксируй33 ревизию/состояние рассмотренных файлов и используемые входные артефакты.342. Найди путь от входного формата через математические владельцы к результату.35 Используй доступные MCP, граф кода и языковой сервер, проверяя свежесть36 индекса. Если индекс не покрывает путь или возвращает посторонние совпадения,37 используй текущие исходники и назови это ограничение.383. Извлеки соглашения: координаты, ориентации, единицы, знаки, фазоры,39 нормировку, порядок индексов, расположение элементов матриц, масштабирование,40 граничные условия и область применимости.414. Отдели доказанные свойства программы от математических предпосылок и42 наблюдённых результатов тестов. Название `physical`, комментарий `exact`43 или сообщение PASS не заменяет проверку определения и вычисления.445. Для внешних формул используй первичный источник с номером уравнения/раздела.45 Покажи перевод обозначений источника в обозначения программы. Не используй46 общий известный метод как доказательство того, что именно он реализован.4748## Строй непрерывный вывод4950Каждый содержательный этап должен связывать:5152**исходное уравнение → предпосылки → преобразование → вычислимая формула →53дискретизация → массивы/индексы → функция программы → следующий потребитель.**5455- Начинай с законов или определяющих уравнений и исходных данных, нужных56 именно этой реализации. Укажи, что задано и что требуется найти.57- Показывай промежуточные шаги: подстановку, интегрирование по частям,58 преобразование координат, исключение неизвестных, переход от интеграла59 к сумме и от суммы к элементу матрицы. Не прячь ключевой переход за60 «после преобразований» или «далее вызывается функция».61- Если закрытая формула громоздка, выпиши воспроизводимую систему уравнений62 с неизвестными, коэффициентами и условиями вместо неподтверждённого упрощения.63- Различай непрерывную модель, конечную дискретную задачу и способ её64 вычисления. Небольшая невязка не доказывает сходимость к непрерывной задаче.65- Не выдавай формальное обращение матрицы на бумаге за явное обращение в коде,66 если программа использует факторизацию и решение систем.67- Объясняй школьному читателю впервые встреченные операции (комплексное68 сопряжение, градиент, ротор, интеграл, базис, норма, собственное значение)69 по их роли в текущем шаге. Короткие учебные примеры маркируй как вымышленные,70 не как результаты solver-а.7172## Полнота обозначений: проверяй каждую формулу7374У каждой величины, включая индексы, вспомогательные коэффициенты и допуски,75должны быть раскрыты:7677- смысл и единицы; для массива — размер и смысл осей;78- происхождение: вход, физическая константа, вычисленный результат, неизвестная79 системы или параметр численного алгоритма;80- выражение или конкретный способ получения;81- область допустимых значений и условие допустимости деления/обращения;82- место следующей подстановки и соответствующий объект кода.8384Давай определения рядом с первым использованием; словарь в конце служит85указателем, а не заменой локальных объяснений. Повторно поясняй символ,86если его смысл меняется. Предпочитай разные обозначения для перегруженных87понятий: ток I и единичная матрица; волновое число и обусловленность;88слоистый коэффициент и интегральное действие на базис.8990Особенно проверяй поглощённые множители преобразований, безразмерные координаты,91произвольный масштаб собственных векторов и последующую нормировку. Не назначай92коэффициенту единицы СИ по его имени. Если владелец не определяет абсолютную93шкалу, явно покажи эту свободу и этап, который её устраняет. Не изобретай94«недостающий» множитель ради красивого вывода.9596## Численные проблемы и алгоритмы9798Для каждого этапа объясни: какая проблема возникает; какой алгоритм фактически99использован; почему он решает эту проблему; входы и выходы; условие остановки;100метрики ошибки; отказы и ограничения; конкретные функции и тесты.101102Включай только относящиеся к пути вопросы: сингулярности, усечение рядов,103квадратуры, поиск корней и выбор ветви, обусловленность, вычитание близких чисел,104переполнение, рабочая точность, порядок суммирования, параллелизм и стоимость.105Различай физическую ошибку, дискретизационную ошибку и ошибку арифметики.106Объясняй значения допусков и кто ими управляет; не представляй параметры107конкретного теста универсальными константами метода.108109## Иллюстрации инженера110111- Используй реальные встроенные изображения с относительными ссылками.112 Для точных схем предпочитай SVG; ASCII-вставки и исходник Mermaid не являются113 готовыми рисунками, если пользователь просит изображения.114- Выбирай рисунки по переходам вывода: геометрия/координаты, граничные условия,115 базис, дискретизация, направления/знаки, матричные блоки, алгоритм, передача116 результатов. Количество определяется полезностью, а не фиксированной квотой.117- На рисунке нужны обозначения, оси, единицы, направления, границы, легенда118 и связь с формулой/разделом. Подписывай схематические кривые и учебные данные.119 Декоративная инфографика не заменяет техническую схему.120- Не рисуй сетку, поле, проводник или готовый путь, которых нет в постановке.121 Проектируемую ветвь визуально отличай и подписывай как нереализованную.122- Рендерь и лично просматривай каждый итоговый рисунок: наложения текста,123 обрезка, контраст, знаки, направления и соответствие обозначениям документа.124125## Формат и проверка результата126127- Для Markdown используй `$...$` и отдельные блочные `$$...$$` с пустыми строками.128 Не помещай длинные формулы и многошаговые выводы в таблицы; символ `|` может129 разбить ячейки. Для норм и модулей применяй `\lVert`, `\rVert`, `\lvert`, `\rvert`.130- Проверь все выражения реальным KaTeX/MathJax, соответствующим целевому131 просмотрщику, если доступен. Подсчёт пар разделителей не доказывает рендер.132 Не меняй корректную математику ради обхода синтаксической ошибки.133- Пройди документ последовательно как читатель: известны ли все входы134 следующего шага? Можно ли получить каждый коэффициент без скрытой ссылки?135 Совпадают ли индексы и соглашения с реальным кодом?136- Проверь ссылки на файлы/символы, встроенные изображения, актуальность137 утверждений о реализации и результатах. Укажи предел проверок честно.138- Заверши словарём обозначений/сокращений и компактной картой реализации.139 Основные ссылки на код остаются рядом с соответствующими формулами.140- Сохрани документ и связанные рисунки единым пакетом. Убери собственные141 отвергнутые варианты из публикуемого дерева. Git commit выполняй только142 при наличии пользовательского поручения и с обычными проверками проекта.143144Готовность означает связность вывода, полноту обозначений, проверенную связь145с кодом и читаемые рисунки/формулы. Если существенный шаг не восстановлен,146назови точный пробел; не объявляй руководство полным.