🇹🇷 Репетитор турецкого своими руками. Часть 1: как это устроено
Немного учу турецкий язык (защита от деменции в старости)): грамматика, словарь, ежедневная практика. Приложения дают либо геймификацию без грамматики, либо учебник без тренировки. Хотелось третьего – ежедневный урок, который помнит вчерашнее и сам подтягивает то, что я забываю (в общем такой себе Skyeng, но для другого языка)
Первая версия работала в Claude Cowork. Два элемента. • Проект — папка с материалами и инструкциями к проекту. Инструкции это, по сути, системный промпт: кто ты, чему учишь, по какой методике • Задача по расписанию. Её скилл был буквально в три строки: • name: new_lesson • description: Ежедневная тренировка по турецкому. Каждый день запускай новую тренировку по турецкому языку, согласно инструкций и плана в описании проекта.
Как работал проект • Каждое утро в папке проекта появлялся HTML-файл. Открываешь в браузере – 20–25 минут работы: кликаешь, вписываешь, проверяешь себя
Что лежало в проекте • Курс. Готовый курс на 36 уроков — от алфавита до относительных придаточных. Изначально жил в папке Google Drive (остался мне в наследство от занятий с преподавателем), модель ходила туда за конспектами. Позже я выгрузил их в 32 markdown-файла: гарантия, что материал никуда не денется и читается одинаково каждый раз. • Промпт тьютора — 239 строк. Разделы: роль, описание курса списком (все 36 тем с описанием грамматики), методика преподавания, правила подачи объяснений, стиль обратной связи и отдельный блок «чего ты никогда не делаешь». • Правила генерации — состав тренировки таблицей с точными числами • Состояние – записи о моем прогрессе Вот состояние — самая недооценённая часть. Без него это генератор случайных уроков. С ним — «дай урок, зная, что это слово я выучил девять дней назад, а на этом валюсь третий раз».
Модель и деньги • На этом этапе — $20 в месяц, самая дешёвая подписка. Счётчика токенов я не видел вообще: сколько ни генерь, цена фиксированная. Удобно и одновременно ловушка. Ты не знаешь настоящей цены своей штуки, пока не переедешь на прямые вызовы API. У меня прогрессия вышла такая: • Cowork, $20/мес — плоский тариф, стоимость невидима • После переезда на API, до оптимизации — около $0.30 за тренировку, примерно $9 в месяц. Модель тогда писала весь HTML целиком на claude-sonnet-4-6 ($3 за миллион входных токенов, $15 за выходные) • После оптимизации — около $0.03 за тренировку, меньше доллара в месяц. Генерация переехала на claude-haiku-4-5 ($1/$5)
Именно переезд на API и сделал стоимость видимой, а видимая стоимость запустила оптимизацию. Пока платишь фикс, оптимизировать нечего – и незачем. Как я срезал десятикратно, разберу в части 4.
Правила, которые дописывались по факапам • Слов в день. 10 → не закреплялись → 5 → мало → в итоге 8. Из восьми минимум четыре глагола, и не любые, а из приоритетного пула ТОП-200 глаголов курса. Остальные четыре — частотная разговорная лексика. • Что делать, когда курс кончился. На 33-м уроке материалы закончились. Появился отдельный режим: код сам его включает, и модель дальше выбирает темы по уровню ученика — каузатив, плюсквамперфект, косвенная речь. В инструкции написано прямым текстом: «никаких “у меня закончились уроки”» • Дата. Модель не считает «сегодня» сама – день передаётся явно, с часовым поясом. Одна строка, но без неё тренировки уезжали на сутки.
Все эти правила я не придумал заранее. Каждое — заплатка после конкретного дня, когда что-то пошло не так. Инструкция проекта это не спека, написанная на старте, а журнал факапов, оформленный как требования. Кажется, переносится и на рабочие задачи. Полезная инструкция агенту растёт снизу, из разборов «почему сегодня получилось не то», а не сверху из представлений о прекрасном.
В части 2 расскажу как переезжал из Claude Cowork в Telegram и какие проблемы встретил там. Надеюсь, что количество деталей реализации не сильно утомило)
