Руководство по настройке ИИ-ассистентов
Это модульное и интерактивное руководство, созданное для эффективной настройки и использования современных ИИ-ассистентов, таких как OpenCode и Zed Editor. Проект охватывает ключевые концепции, лучшие практики и пошаговые инструкции для максимально продуктивной работы с искусственным интеллектом в вашей разработке.
****
Особенности проекта
- Модульная структура: Контент разбит на независимые HTML-файлы (секции), что упрощает навигацию, редактирование и масштабирование.
- Динамическая загрузка (Pseudo-SPA): Основная страница (
index.html) динамически подгружает содержимое секций с помощью JavaScript, обеспечивая плавный пользовательский опыт без перезагрузки всей страницы. - Автоматическая навигация: Специальный скрипт
build.jsавтоматически сканирует папкуsections/и генерирует навигационное меню, избавляя вас от ручного обновления ссылок. - Актуальный контент: Подробно рассматриваются:
* MCP (Model Context Protocol): Открытый стандарт для интеграции ИИ с внешними системами. * AGENTS.md / Rules: Создание пользовательских правил и инструкций для ИИ. * Skills: Разработка и использование переиспользуемых навыков для агентов. * Настройка OpenCode и Zed Editor: Практические рекомендации. * Работа с GitHub: Приватные репозитории и GitHub Pages.
- Легкость развертывания: Идеально подходит для хостинга на GitHub Pages.
Разделы руководства
В руководстве вы найдете следующие основные разделы:
- Ключевые концепции
- Настройка Zed Editor
- История чатов в Zed
- Настройка OpenCode
- Работа с GitHub
- Эффективная работа с ИИ
- Рекомендуемые MCP серверы
- Полезные ссылки
Как пользоваться
1. Клонирование репозитория
Для начала склонируйте репозиторий на ваш локальный компьютер:
git clone https://github.com/ВАШ_НИКНЕЙМ/ВАШ_РЕПОЗИТОРИЙ.git
cd ВАШ_РЕПОЗИТООРЙ2. Первая сборка навигации
После клонирования обязательно запустите скрипт build.js из корневой папки проекта. Это создаст файл со списком всех секций и сгенерирует навигационное меню:
node build.js*Вам потребуется установленный , чтобы выполнить эту команду.*
3. Локальный просмотр (Опционально)
Для просмотра сайта на вашем компьютере (перед отправкой на GitHub), рекомендуется использовать простой локальный сервер, чтобы JavaScript работал корректно (из-за ограничений безопасности браузера при открытии файлов по протоколу file://).
Рекомендуемый способ: Установите расширение "Live Server" для VS Code. Затем просто откройте проект в VS Code, кликните правой кнопкой мыши по index.html и выберите "Open with Live Server" (или нажмите на кнопку Go Live в нижней строке редактора).
4. Публикация на GitHub Pages
- Убедитесь, что ваш репозиторий публичный.
- Перейдите в Settings вашего репозитория на GitHub, затем в раздел Pages.
- В секции "Build and deployment" выберите "Deploy from a branch".
- Выберите ветку
main(илиmaster) и папку/root. - Нажмите Save.
- Ваш сайт будет доступен по адресу
https://ВАШ_НИКНЕЙМ.github.io/ВАШ_РЕПОЗИТОРИЙ/через несколько минут.
Рабочий процесс: Добавление и обновление контента
- Создайте или отредактируйте файл-секцию: Добавьте новый HTML-файл в папку
sections/(например,09-новая-секция.html) или отредактируйте существующий. Используйте числовой префикс для правильной сортировки в навигации. - Запустите
build.js: В терминале, находясь в корневой папке проекта, выполните:
node build.jsЭто обновит навигацию на сайте, включив новые или измененные секции.
- Сохраните и опубликуйте изменения в Git:
git add .
git commit -m "Добавлена новая секция: Название Секции" # Или другое описание изменений
git push