## 📘 Инструкция для генерации Python-кода

### 1. Общие правила

* Используй **Python 3.10+**.

* Соблюдай **четкий, читаемый и однозначный стиль** кодирования.

* **Каждая функция, метод и класс** должны иметь:

* Аннотацию типов (`type hints`)

* Полную и корректную документацию в формате `docstring` (см. раздел 3)

* Внутренние комментарии (`#`), где необходимо

---

### 2. Комментарии

* Комментарии должны быть **точными** и описывать **что делает код**, а не «что мы делаем».

* **Запрещено** использовать местоимения: `делаем`, `возвращаем`, `отправляем`, `переходим` и т.п.

* **Разрешены** только термины: `извлечение`, `выполнение`, `вызов`, `замена`, `проверка`, `отправка`, `Функция выполняет`, `Функция изменяет значение` и т.д.

#### ❌ Пример неправильного комментария:

```python

# Получаем значение параметра

✅ Пример правильного комментария:

# Функция извлекает значение параметра

3. Docstring (формат документации)

Каждая функция/метод/класс должна содержать docstring в следующем формате:

def function(param: str, param1: Optional[str | dict | str] = None) -> dict | None:

"""

Args:

param (str): Описание параметра `param`.

param1 (Optional[str | dict | str], optional): Описание параметра `param1`. По умолчанию `None`.

Returns:

dict | None: Описание возвращаемого значения. Возвращает словарь или `None`.

Raises:

SomeError: Описание ситуации, в которой возникает исключение `SomeError`.

Example:

>>> function('param', 'param1')

{'param': 'param1'}

"""

Все параметры и возвращаемые значения должны быть описаны.

Формулировки должны быть лаконичными, точными и однозначными.

Не допускается пропуск описания параметров/возвращаемых значений/исключений.

4. Аннотация типов

Все переменные, параметры и возвращаемые значения должны быть аннотированы.

Используй синтаксис Python 3.10+: list[int], dict[str, Any], str | None и т.д.

Примеры корректных аннотаций:

✅ Простые типы:

name: str = "John"

count: int = 42

flag: bool = True

✅ Коллекции и сложные типы:

from typing import Any, Optional, Callable, TypeAlias

coordinates: tuple[float, float] = (55.75, 37.61)

metadata: dict[str, Any] = {"debug": True}

UserId: TypeAlias = int

✅ Функции и методы:

def get_user_name(user_id: int) -> str:

"""Возвращает имя пользователя по его идентификатору."""

...

✅ Асинхронные функции:

async def fetch_users() -> AsyncIterator[dict[str, int | str]]:

...

✅ Обобщённые типы:

from typing import TypeVar, Generic

T = TypeVar("T")

class Container(Generic[T]):

def __init__(self, value: T) -> None:

self.value = value

def get(self) -> T:

return self.value

5. Прочее

Используй default_factory в dataclass для изменяемых значений (list, dict).

Для Optional значений указывай T | None (Python 3.10+) или Optional[T].

Для сложных структур — используй TypeAlias.

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

Для удобства создадим директорию `game`, в которой будут храниться файлы проекта, и директорию `scenarios`, где будут храниться сценарии для Gemini CLI.

файл scenarios/life-create-code.md будет содержать инструкции для создания кода игры "Жизнь",

файл scenarios/life-create-test.md — инструкции для создания тестов,

а файл scenarios/life-create-doc.md — инструкции для создания документации.

life-create-code.md:

Внутри директории `game` Создай файл life.py.

Внутри напиши реализацию "Игры Жизнь" Конвея на Python, используя объектно-ориентированный подход.

используй библиотеки: `numpy`, `pygame` (для графики).

Требования:

1. Создай класс `Game`.

2. В `__init__` класс должен принимать размеры сетки (ширину, высоту) и создавать случайное начальное поле.

3. Создай метод `step()`, который обновляет состояние игры на один шаг в соответствии с правилами:

- Живая клетка с < 2 живыми соседями умирает (одиночество).

- Живая клетка с 2 или 3 живыми соседями выживает.

- Живая клетка с > 3 живыми соседями умирает (перенаселение).

- Мёртвая клетка с ровно 3 живыми соседями становится живой (рождение).

4. Создай метод `display()` или переопредели `__str__`, чтобы выводить поле в консоль. Используй символы, например '■' для живой клетки и ' ' для мертвой.

5. Используй библиотеку `numpy` для эффективной работы с сеткой.

6. В блоке `if __name__ == '__main__':` добавь пример, который создает игру, и в цикле запускает симуляцию с небольшой задержкой между шагами.

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

life-create-test.md:

Внутри директории `game` используя контекст из файла @life.py, создай файл с тестами test_life.py. Используй фреймворк pytest. Тест должен проверять правильность эволюции простого осциллятора "Блинкер" (три клетки в ряд).
Сценарий теста:
1. Импортируй класс `Game` из `life`.
2. Создай функцию теста, например `test_blinker_oscillation`.
3. Внутри теста создай экземпляр `Game` с фиксированным размером (например, 5x5).
4. Вручную установи начальное состояние поля так, чтобы в центре была горизонтальная линия из трех живых клеток (Блинкер).
5. Вызови метод `game.step()`.
6. С помощью `assert` и `numpy.array_equal` проверь, что поле изменилось на вертикальную линию из трех клеток.
7. Вызови метод `game.step()` еще раз.
8. Проверь, что поле вернулось в исходное горизонтальное состояние.

life-create-doc.md:

Проанализируй файлы @life.py и @test_life.py внутри директории `game` и на их основе создай файл документации doc.md. Структура документации должна быть следующей: - **Заголовок:**
# Проект "Игра Жизнь" -
**Краткое описание:** Объяснение, что это за проект (реализация клеточного автомата Конвея). -
**Структура файлов:** Краткое описание назначения файлов `life.py` и `test_life.py`. - **Как запустить симуляцию:** Раздел с командой для запуска основного файла (`python life.py`). -
**Как запустить тесты:** Раздел с командой для запуска тестов (`pip install pytest numpy`, а затем `pytest`).

Структура директорий будет выглядеть следующим образом:

Шаг 2: Создание кода игры "Жизнь"

Запускаем gemini-cli в терминале:

Важно! Убедитесь, что вы находитесь в директории, где находится файл GEMINI.md.

После этого gemini-cli сгенерирует файл life.py в директории game:

Продолжаем:

Создай виртуальную среду venv, установи необходимые зависимости и запусти испонение кода игры

и наконец gemini-cli запускает игру:

Шаг 3: Создание тестов

Ошибка

gemini-cli пытается решить проблему

Последний шаг — создание документации

Вуаля! Документация создана:

Проект на github

Полезно? Подпишись.
Понравилось — ставь «+»
Удачи! 🚀

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

Вы никогда не сталкивались с такой ситуацией, что при подаче питания на электроприбор, то есть при его включении, после длительного перерыва в работе, например, более года, он внезапно выходит из строя? Хотя до последнего выключения он работал исправно. А это имеет место быть. И чем больше был перерыв в работе электроприбора, тем больше вероятность его выхода из строя при включении. Нет, я не утверждаю, что при включении электроприбора в данной ситуации он обязательно выйдет из строя. Но! Вероятность этого события при этом  увеличится.

Давайте разберемся, почему это происходит. Почти все электроприборы, от компьютера, до стиральной машины содержат в своем составе электролитические конденсаторы. И в этой статье речь пойдет о них, как об основных виновниках выхода из строя электроприборов. Чтобы понять физические процессы происходящие при этом в электролитических конденсаторах, рассмотрим их устройство.

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

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

При длительном перерыве в работе, то есть при отсутствии на конденсаторе напряжения в течении этого времени, происходит постепенное разрушение диэлектрика (оксида алюминия) при его взаимодействии с электролитом в отсутствии напряжения на обкладках конденсатора. Это приводит к утончению диэлектрического слоя, к увеличению тока утечки и как следствие, увеличению вероятности пробоя конденсатора при подаче на него номинального напряжения. Этот эффект начинает проявляться при перерыве в работе конденсатора длительностью более года.

Специалисты в таких случаях рекомендуют проводить тренировку (формовку) конденсаторов, суть которой заключается в подаче на конденсатор в течении длительного времени постепенно увеличивающегося напряжения, с контролем тока утечки. При этом, подача в начале тренировки малого значения напряжения, не приведет к пробою конденсатора, и начнется процесс восстановления диэлектрического слоя (оксида алюминия) благодаря процессу электролиза. И по мере восстановления диэлектрического слоя, напряжение на конденсаторе увеличивается до номинального. Скорость увеличения напряжения определяется по значению тока утечки.

Рекомендации одного из производителей электролитических конденсаторов по проведению тренировки (риформинга).

Еще выдержка из технической документации производителя конденсаторов EPCOS.

Проведем практическую проверку этого эффекта. В качестве подопытного возьму недавно купленный на радиорынке электролитический конденсатор на 3300 мкФ., с номинальным напряжением 25 В., дата изготовления сентябрь 2016 года.

Предполагаю, что с даты изготовления, и до сегодняшнего дня на него никто не подавал напряжение. И потому для эксперимента он подходит, как нельзя лучше. Подам на него с лабораторного источника питания 25 В., и после его заряда в разрыв включу амперметр (прибор Ц-43101) для измерения тока утечки.

Отсюда видно, что ток утечки составил 35 мкА. (вся шкала прибора 250 мкА). Оставляю его под напряжением на 1 час, и повторю измерение.

В этом случае, как мы видим, ток утечки составил 7 мкА. Итого ток утечки уменьшился в 5 раз. Отсюда вывод, вышеизложенное явление подтверждено на практике.

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

Во время моей учебы, мой преподаватель по предмету «радиокомпоненты» как то спросил у нас: так на чем работает вся электроника? Многие начали отвечать, что работает на упорядоченном движении заряженных частиц, и так далее. На что преподаватель в шутку сказал, что вся электроника работает на белом дыме. Пока белый дым находится в электронике, она работает. Как только белый дым выходит из электроники, она перестает работать. Так и в данном случае с нашими электролитическими конденсаторами, подобное может произойти.

Кроме того, электролитические конденсаторы подвержены высыханию. И это их основная проблема, каждый второй ремонт электроники по моему опыту заканчивается заменой именно этой детали. Высыхание происходит из-за плохой герметизации корпуса. Вследствие чего электролит постепенно испаряется, а поскольку он является одной из обкладок конденсатора, то и получается, что испаряется одна обкладка конденсатора. И емкость уменьшается до нуля. Опять же это зависит от качества конденсаторов. С качественными конденсаторами вероятность подобного значительно меньше. Но, к сожалению, при покупке электроники возможности изучить применяемую в ней элементную базу, какие там стоят конденсаторы не всегда возможно.

Подобных недостатков лишены полимерные конденсаторы.

Поэтому, выбирая комплектующие компьютерной техники, старайтесь выбирать комплектующие, выполненные на полимерных конденсаторах. Тем более, что во многих комплектующих визуально открыт доступ к используемой элементной базе. И легко, например, увидеть на материнской плате, какие конденсаторы применяются.

Кроме прохождения независимых аудитов, например, в России уже несколько лет существует подписанный 900 организациями Кодекс этики ИИ и действует декларация об ответственной разработке и использовании сервисов на основе генеративного ИИ.

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

Отличный результат, с которым команду Яндекса можно поздравить! Двигаемся дальше!