Claude Code Guide: как использовать технические требования из Notion в коде
Узнайте, как с помощью искусственного интеллекта создавать технические задания для автоматизации работы кураторов и других IT-проектов. Пошаговый разбор процесса, примеры декомпозиции задач и советы по эффективному взаимодействию с ИИ для генерации кода.
В этом руководстве мы узнаем, как формировать техническое задание для автоматизации работы с помощью ИИ, используя пример отчета кураторов. Мы рассмотрим, как собирать требования от разных отделов, структурировать их и превращать в понятные задачи для генерации кода. Такой подход помогает упростить процесс разработки и сделать его более прозрачным для всех участников.
Давайте начнем
Да, привет. Я хочу показать, как я начал работать с техническими заданиями для генерации кода через ИИ для вайб кодинга.
И как это может в целом облегчить жизнь всем. Вот смотри, что у нас есть в наушнике.
У нас есть витрина заказов.
Я ее сделал, чтобы люди из других отделов своим языком объяснили, чего они хотят. Будем разбирать пример автоматизации отчета кураторов.
Задача сложная, потому что там много разных метрик, логик и так далее.
Я пошел к Алёне и Кате, собрал эти требования. Вот они мне что-то написали, очень много всего. У меня есть некоторые вводные данные. Вот. Далее я беру эти данные.
То есть у меня появилась общая картинка, что делать. Потом я перехожу к нашим IT проектам.
IT проекты. Создаю новый проект — "Автоматизация работы куратора".
Так, он не открывается?
М-м-м.
Что-то не открывается.
Ну?
Нууу? О, господи. Хм, хм, хм, хм, хм, хм.
О, ура!
Ну давай, интернет, работай, пожалуйста.
Вот, и у нас уже есть техническое задание, настоящее техническое задание.
То есть в первом случае мы собирали верхнеуровневые требования, что хотят люди, да? А дальше я пытаюсь описать большой промпт Клодкоду.
Я формирую этапы разработки. Каждый этап — это отдельный план, отдельная задача для Клодкода, отдельная часть документации.
Вот. Ну, не важно, как я делил. Суть в том, что мы декомпозируем задачу, чтобы не давать Клодкоду слишком большой объем кода, иначе он начнет галлюцинировать и делать ошибки. Вот. Мы делим это на этапы. Огонь!
Я здесь все записываю, сижу и пишу, что хочу. То есть я пишу промпт Клодкоду. Вот. Пишу требования: где что находим, как считаем и так далее. Вот тут получилось очень много.
Вот. А дальше у меня есть логика разработки. Затем я объясняю Клодкоду, как мы будем с ним работать.
Я ему объясняю, что у нас есть три подзадачи. Каждая подзадача будет находиться в своей папке.
И далее я описываю ему архитектуру.
Вот в этой папке ты пишешь UI, и в этой папке ты пишешь UI для этого. А для такой задачи будет сервис, такие классы и их функции.
Тут пиши крон-задачу. Здесь указывай креды. Там показывай ссылки на документацию.
Потому что у нас, например, уже написание различных, создание новых табличек. У нас есть отдельная документация по этому вопросу, и он сам все сделает. Просто скажи, какие колонки нужны. Он сам знает, как все это делать, как прописывать креды и так далее. То есть ему нужно прямо указать, что делать.
И после этого, когда все готово, я пойду к Кате и Алене, отдам им это ТЗ. У меня есть комментарии, они ответят на мои вопросы. Я пойму то, что сейчас не понимаю, и после этого беру следующий шаг.
Ммм.
Ну что с интернетом, мамочка родная? Ну ладно. В общем, здесь должно быть три точки. Не знаю, не загружает. Я выгружаю всю эту историю в формате маркдауна. Затем перехожу в кодовую базу, где у меня есть документы докс.
Все, компьютер вообще не справляется, ни компьютер, ничего.
Да, это ужасно. В общем, есть папка "докс", там есть "таскс".
Я назвал этот проект "метрики клиентов" и туда положу этот маркдаун файл. Открываю Клодкод и начинаю писать. Давай составим большое техническое задание в нормальном формате. Вот по моему черновику технического задания. Он создает для тебя огромное техническое задание. По сути, он перепишет то же самое.
Ты можешь сразу проанализировать код и задать мне вопросы, если что-то непонятно.
И вы будете сидеть с ним и общаться. И в конечном счете у вас получится такое же ТЗ, но более четкое, понятное, структурированное, без грамматических ошибок и лишних слов.
И после этого ты говоришь, что у нас есть техническое задание. Давай начнем декомпозировать. У нас первый этап — формирование UI для привязки кураторов к минте.
Давай реализовывать.
Он уже знает, что нужно создать отдельный документ и провести его ревью с тобой. После этого он начнет писать код.
Он пишет код, а ты тестируешь его. Все окей, делаешь комментарий. Потом говоришь: давай перейдем к следующему этапу.
И мне кажется, такие процессы, возможно, сейчас займут больше времени на составление этого ТЗ, чем на написание самого кода. Ну, посмотрим. Вот, возможно, что-то из этого будет полезно.