Чтобы правильно программировать с помощью средств AI IDE, необходимо составить набор технических документов и подробных требований.

Как ребенок, который умный, но не понимает лучших практик работы с кодом.

Вы должны четко объяснить ИИ, чего вы хотите:

• Это веб-приложение?
• Какие функции необходимы?
• Какова структура?
  И так далее.

Вот как сделать ИИ своим полнофункциональным разработчиком:

Контекст имеет решающее значение!

Для ИИ нужен сильный контекстный барьер.

Цель: не позволяйте ИИ делать какие-либо предположения. Вся информация предоставляется вами.

Таким образом, ИИ будет работать с вами, а не против вас.

Далее обсуждается, какую документацию необходимо приложить, чтобы обеспечить максимальную контекстную поддержку.

1. документ с требованиями к проекту

Этот документ описывает проект в целом:

• Профиль проекта
• Изложение проблемы
• Рецепт
• целевой пользователь
• стек технологий
• основная функциональность
• Объем работ

Этот документ представляет собой краткое описание вашего проекта.

Затем добавьте более конкретную документацию, чтобы провести ИИ через каждый шаг.

2. документация по процессам и функциональности приложений

Представьте, что вы объясняете свое приложение другу:

"Когда пользователь регистрируется, он переходит на приборную панель. На приборной панели есть 4 раздела: раздел метрик, раздел аналитики и т. д.".

В этом документе представлен полный сквозной поток выполнения приложения.

привлекать внимание к чему-л.: МА предлагается включить в документ Не используйте пули.

Этот документ важен, потому что он предоставляет ИИ схему/план для планирования выполнения каждой страницы.

3. документация по технологическому стеку и пакету зависимостей

Теперь обеспечиваем техническую базу для ИИ.

Использует ли ваш проект Python или Nextjs? Supabase или Firebase для бэкенда?

В этом документе подробно описывается стек технологий, который AI должен использовать для создания вашего приложения.

Убедитесь, что вы выбрали широко используемый технологический стек, потому что такие вещи, как Клод и LLM, такие как GPT-4, в основном обучаются на основе широко используемых фреймворков.

Я использую Nextjs 14, TaliwindCSS, shadcnUI и radixUI для фронтенда и Supabase для бэкенда.

Следующие платформы предпочитают этот технологический стек:

• v0.dev
• болт
• Клод
• Курсор
• Replit

Python также отлично подходит для высокопроизводительных приложений, которым не нужен современный пользовательский интерфейс.

4. Документирование структуры документа

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

ИИ может создавать дубликаты файлов, сохранять их в неправильном месте или даже удалять готовый код.

Чтобы решить эту проблему, пожалуйста, заранее предоставьте структуру документа.

привлекать внимание к чему-л.: Убедитесь, что от AI требуется создание файловой структуры в формате ASCII.

Сделайте снимок экрана, чтобы сохранить структуру файла и прикрепить его к документу.

5. Документация по API

ИИ по умолчанию не знает, как настроены API той или иной платформы.

Нам нужно приложить документацию ко всем API, которые будут использоваться в приложении.

Например, API OpenAI, документация по API Claude, документация Supabase и т.д.

Скопируйте инструкции с их сайта и вставьте их в свой документ, а затем прикрепите этот документ к AI.

6. проектная документация по архитектуре back-end

Архитектура - это, по сути, чертеж вашей внутренней части.

Он содержит все таблицы базы данных, ведра хранения и таблицы информации о пользователях (аутентификация), которые необходимо создать.

Я использую Supabase, потому что искусственный интеллект способен генерировать SQL-запросы, которые можно выполнять непосредственно в Supabase за считанные секунды.

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

яркое пятно: Клод отлично разбирается в проектировании внутренних архитектур, и если вы создадите правильную документацию, ИИ будет легко следовать указаниям.

7. файл .cursorrules

Многие люди не используют этот инструмент. Он похож на ChatGPT пользовательских команд.

Файл .cursorrules должен быть привязан к конкретному проекту, а не к общему запросу "Правила AI".

В зависимости от технологического стека и требований проекта, ИИ предлагается создать файл .cursorrules.

Этот документ подскажет ИИ, где находится каждый документ (навигационная карта курсора).

Помогите ИИ ориентироваться более эффективно с помощью этого файла.

8. документация по компоновке пользовательского интерфейса

Этот документ сделает ваш внешний интерфейс более эстетичным. При использовании с v0 он создает компоненты фронтэнда с единым стилем.

Большинство людей недооценивают силу чистого пользовательского интерфейса (UI).

"Первое впечатление имеет значение".

Этот документ должен содержать следующую информацию: используемые пакеты пользовательского интерфейса, шрифты, цветовые схемы, иконки, эффекты и так далее.

9. Системные сигналы

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

Это помогает взаимодействовать с инструментом и избавляет от необходимости каждый раз предоставлять более длинный контекст.

Знаете, почему Клод лучше работает на их платформе, чем через API? Это потому, что их системные подсказки превосходны.

Сделайте то же самое для своего проекта, и вы станете лучшим другом ИИ.

Я потратил 80% своего рабочего времени на создание документации и добился отличных результатов за оставшиеся 20%.

Введение: codeguide.dev

Приложение, которое поможет вам провести мозговой штурм и написать все важные документы для прикрепления к AI.

✅ Слово системного оповещения
✅ Документ PRD
✅ Архитектурный дизайн
✅ Документация по процессу применения
✅ Документация по макету пользовательского интерфейса
Подождите!

ссылка (на веб-сайте)::http://codeguide.dev