Практика фундамента

Во время подготовки курса агенту дали задачу от «Кодиума»: утилита, которая читает выгрузку заявок CSV и печатает отчёт по курсам. Плюс CLAUDE.md, README и проверки. Агент сделал 33 хода за 466 секунд, около 8 минут: написал код, 14 проверок, сам их запустил, нашёл ошибку и починил. Все 14 прошли. С баланса CloseRouter ушло 0,0307 $. Теперь эту работу повторяешь ты, на школе или на своём заказчике.

Чему научишься в этом уроке:
• собрать небольшую утилиту для заказчика от пустой папки до проверенной версии;
• применить вместе CLAUDE.md, .env, git, формулу задачи и проверки;
• откатить неудачную правку агента;
• посчитать, во сколько обошлась работа.

Что собираем

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

Проверки (тесты) это маленькие программы, которые запускают твою утилиту на известных данных и сверяют ответ. Например, «в файле три заявки на курс Python, отчёт должен показать 3». Писать их будет агент, твоя задача попросить и убедиться, что они запускаются. Запуск проверок заканчивается строкой итога: passed показывает, сколько прошло, failed показывает, сколько упало. Работа принята, только когда failed нет.

Как понять, что работа принята. Представь, что администратор школы получила от тебя папку и README. Она открывает терминал, вводит одну команду из README и видит отчёт по своим заявкам. Если для этого ей нужно звонить тебе, утилита ещё не готова. Проверь это сам: закрой все окна, открой новый терминал в папке проекта и пройди по README слово в слово. Всё, что пришлось додумать, допиши в README или попроси агента поправить.

Шаги

1. Папка и история. Создай папку проекта и сделай её репозиторием, как в уроке «git и GitHub».
2. CLAUDE.md. Опиши проект по шаблону из урока «CLAUDE.md и формула задачи»: что за утилита, на чём написана, где лежат данные, как запускать проверки.
3. Секреты. Ключи этой утилите не нужны, но заведи .env.example и .gitignore со строкой .env, как в уроке «Секреты и .env». Это привычка для всех следующих проектов.
4. Задача. Поставь её агенту по формуле: цель, данные, результат, ограничения, как проверить. Пример ниже.
5. Проверки и коммит. Агент запускает проверки сам. Когда все прошли, сохрани версию в git.
6. Правка. Попроси доработку: например, отдельной строкой показывать заявки без телефона. Если агент что-то сломал, откати к прошлой версии.
7. Стоимость. Посмотри списание в кабинете CloseRouter или, на дорожке Pro, запиши время работы агента.

Цель: утилита для онлайн-школы, отчёт по заявкам из CSV.
Данные: файл data/zayavki.csv, колонки: имя, телефон, курс, дата. Сделай пример на 10 строк с выдуманными данными.
Результат: команда py report.py data/zayavki.csv печатает число заявок по каждому курсу и общий итог.
Ограничения: только стандартная библиотека Python плюс pytest для проверок; не меняй исходный CSV.
Проверка: напиши проверки pytest на пустой файл, файл с одним курсом и файл с тремя курсами, запусти их и покажи результат. Обнови README: как запустить.

Как запустить: в терминале в папке проекта py report.py data/zayavki.csv. Проверки: py -m pytest. Если pytest не установлен, агент поставит его сам, разреши команду установки.

Если не получилось

• Русский текст в выводе превратился в кракозябры. В прогоне курса так было при запуске в Git Bash: это кодировка консоли, а не ошибка программы. Запусти ту же команду в PowerShell или Windows Terminal.
• Проверки падают, а агент говорит «готово». Попроси: «запусти py -m pytest и покажи вывод целиком». Агент должен закончить, когда всё зелёное.
• После правки отчёт сломался. Не проси агента «верни как было» словами: откати файл к последнему коммиту через git и поставь задачу заново, точнее.
• Модели перестали отвечать, ошибка 402. Закончился баланс или лимит ключа CloseRouter, разбор в уроке «Расходы».

Контрольный вопрос. Агент написал проверки и сообщил, что всё работает. Ты запускаешь py -m pytest и видишь 12 passed, 2 failed. Что делать?

АПринять работу, 12 из 14 это почти всё

БУдалить две упавшие проверки

ВПопросить агента пометить две упавшие проверки как пропущенные

ГВернуть агенту вывод pytest и попросить починить код, пока все проверки не пройдут

Подсказка: Зачем вообще нужны проверки, если упавшие можно убрать?

На курсе задания проверяются автоматически. Решить первое задание бесплатно →  ·  Подобрать курс

Контрольный вопрос. После просьбы показывать заявки без телефона отчёт перестал считать итог. Последний рабочий коммит у тебя есть. Как быстрее всего вернуться к рабочей версии?

АПопросить агента вспомнить, каким был файл

БОткатить файл к последнему коммиту в git и поставить задачу заново

ВНачать проект с нуля в новой папке

ГИсправить отчёт вручную по памяти

Подсказка: Где хранится точная копия версии, которая работала?

На курсе задания проверяются автоматически. Решить первое задание бесплатно →  ·  Подобрать курс

Задание. МИССИЯ «Утилита для заказчика». Собери утилиту отчёта по заявкам (или аналог для своего заказчика) по семи шагам урока. Приложи: (1) ссылку на репозиторий GitHub или архив папки проекта без .env; (2) скриншот git log, где не меньше трёх версий, включая правку после первой сборки; (3) скриншот вывода py -m pytest, где все проверки прошли; (4) файл CLAUDE.md; (5) скриншот расхода в кабинете CloseRouter или, на дорожке Pro, время работы агента; (6) два-три предложения: где агент ошибся и как ты это заметил. Принято, если: утилита запускается командой из README и печатает отчёт по курсам; все проверки проходят; в истории git не меньше трёх версий; CLAUDE.md описывает проект и способ запуска проверок; в репозитории или архиве нет .env, ключей и настоящих персональных данных; расход указан по кабинету или указано время работы.

Подсказка: Если GitHub открывается с перебоями, сдай архив папки проекта вместе с папкой .git: история версий будет видна и так.

✅ Готово, если: программа запускается без ошибок и выводит то, что просят в задании.

На курсе задания проверяются автоматически. Решить первое задание бесплатно →  ·  Подобрать курс

Что дальше

Модуль «Фундамент Claude» пройден. Следующий модуль про первый продукт для заказчика: Telegram-бот приёма заявок. Начнём с того, зачем он бизнесу и где искать первых клиентов.

Итог:
• утилита собрана от пустой папки до версии, на которой проходят все проверки;
• CLAUDE.md, .gitignore, история в git и проверки работают вместе;
• неудачная правка откатывается к коммиту, а не уговорами агента;
• стоимость работы видна в кабинете: в прогоне курса такая утилита обошлась в 0,0307 $.

← Назад  ·  ↑ В начало урока  ·  ⌂ В начало курса  ·  Вперёд →