Загрузка...
Смарт-конспекты YouTube-видео — ключевые идеи и инсайты без необходимости смотреть часовые ролики
Практический гайд по использованию AI-агента AMP для миграции Python проектов и автоматического создания технической документации.
🎯 О чём этот конспект: Разбор практического кейса использования нового AI-агента AMP для миграции проекта с одного фреймворка на другой (FastHTML -> Air) и создания технической документации. Автор тестирует возможности агента по работе с кодом, который не входит в обучающую выборку (библиотеки в стадии альфа-версии).
👤 Кому будет полезно: Вайбкодерам, разработчикам на Python (FastAPI/FastHTML) и тем, кто ищет замену стандартным AI-чатам для комплексных задач по рефакторингу и документированию.
✨ Что получите: Понимание того, как AMP справляется с автономными задачами, как исправляет ошибки в реальном времени и насколько качественную документацию генерирует «из коробки».
Контекст: Автор поставил задачу переписать существующее приложение (To-Do App) с фреймворка FastHTML на новый фреймворк Air. Сложность в том, что Air находится в стадии альфа-тестирования и отсутствует в обучающих данных большинства LLM. Агент AMP должен был самостоятельно изучить исходный код библиотеки Air в рабочем пространстве, понять её архитектуру и переписать логику приложения, включая работу с базой данных и маршрутизацию.
Выгода: Экономия времени на изучении нового API. Агент выполнил миграцию за 2-3 минуты, что значительно быстрее ручного переписывания.
Как применить:
Пример промпта для миграции:
Amp
CursorI have a project in [Folder A] built with FastHTML.
I want you to rewrite it into a new project in [Folder B] using the Air framework (source code is in the workspace).
Maintain the same functionality: project-based to-do list, SQLite backend, and HTMX interactions.Результат: Полностью рабочее приложение на новом стеке с корректной структурой папок и инициализацией БД.
Контекст: AMP самостоятельно принял решение переписать ORM-запросы (FastLight) на чистый SQL. Хотя это сделало код более «прозрачным», агент использовал индексацию строк (row indexing), что является хрупким подходом. Однако агент успешно добавил функции, которых не было в оригинале, например, автоматическую генерацию тестовых данных и логирование с использованием эмодзи.
Выгода: Получение чистого, функционального кода, который работает сразу после исправления одной ошибки в логах.
Как применить:
database.py. Если агент использовал сырой SQL, убедитесь, что порядок столбцов в SELECT совпадает с индексами в коде.Refactor the database logic to use SQLAlchemy instead of raw SQL strings for better type safety and maintainability.Результат: Код с четким разделением ответственности (функции get_todo, create_todo, update_todo) и встроенными механизмами отладки.
Контекст: После написания кода автор использовал AMP для создания раздела документации «Layouts and Concepts». Агент проанализировал написанный им же код и создал структурированное руководство в формате Markdown. Результат потребовал ручной чистки, так как AI склонен добавлять лишнюю информацию («salesy stuff») и не относящиеся к теме разделы (обработка ошибок, формы).
Выгода: Создание 80% черновика документации за один промпт. Намного проще удалять лишнее, чем писать структуру с нуля.
Как применить:
Результат: Готовый Pull Request с документацией, который был успешно принят в open-source проект.
В: Чем AMP отличается от обычного чата в Cursor? О: AMP действует как агент: он может самостоятельно просматривать файлы в разных папках, сопоставлять их и выполнять действия без постоянного подтверждения каждого шага (хотя это требует осторожности).
В: Как AMP справляется с библиотеками, которых нет в базе знаний AI? О: Он анализирует исходный код библиотеки, если она открыта в вашем рабочем пространстве (Workspace). Это позволяет ему понимать синтаксис и паттерны даже самых новых инструментов.
В: Какие есть минусы в коде, который генерирует AMP? О: Агент может использовать упрощенные или «хрупкие» решения, такие как обращение к данным из БД по индексам (row[0]), а не по именам колонок. Также он может добавлять лишний «шум» в документацию.
В: Сколько стоит использование AMP? О: В видео упоминается наличие бесплатного уровня (free tier) на $10. На выполнение задачи по миграции и написанию доков ушло около $4.10.
В: Нужно ли давать AMP специальные разрешения? О: Автор отметил, что агент начал работать с файлами сразу после описания задачи, не запрашивая дополнительных разрешений на чтение/запись в Workspace. Стоит следить за его действиями в реальном времени.
Конспект создан на основе видео «AMP Tool Review» канала Isaac Harris-Holt. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=rWGGPJSnxI0