# Оптимальное и эффективное использование AI Добро пожаловать в учебный курс по **эффективной работе с искусственным интеллектом** в среде разработки. Курс ориентирован на **Cursor IDE** и экосистему **ECC** (Everything Claude Code) — открытый набор навыков, правил, агентов и инструментов для агентной разработки. > **Как читать:** идите по разделам по порядку (`00` → `13`). Каждый раздел — папка с `README.md` (оглавление) и отдельными страницами. Время указано на чтение и базовую практику. Предполагается **нулевой** опыт работы с AI-ассистентами в IDE. --- ## Карта обучения (14 этапов) Общая оценка: **120–200 часов** (4–8 месяцев при 5–8 ч/нед). Темп зависит от вашего бэкграунда и глубины практики на реальных проектах. | Этап | Раздел | Фокус | Часы (ориентир) | |------|--------|-------|-----------------| | 0 | [00 — Карта пути](00-karta-puti/README.md) | План, навыки, контрольные точки | 3–6 | | 1 | [01 — Введение в AI](01-vvedenie-v-ai/README.md) | Ассистент vs агент, ментальные модели | 6–10 | | 2 | [02 — Эффективное использование](02-effektivnoe-ispolzovanie/README.md) | Контекст, итерации, безопасность | 10–15 | | 3 | [03 — Промпты](03-prompts/README.md) | Структура, техники, шаблоны | 12–18 | | 4 | [04 — Rules](04-rules/README.md) | Правила для агента, user vs project | 8–12 | | 5 | [05 — Skills](05-skills/README.md) | Навыки ECC, создание своих | 10–15 | | 6 | [06 — Agents](06-agents/README.md) | Субагенты, модели, режимы | 12–18 | | 7 | [07 — Commands](07-commands/README.md) | Slash-команды, ECC commands | 8–12 | | 8 | [08 — Hooks](08-hooks/README.md) | События сессии, автоматизация | 10–15 | | 9 | [09 — Templates и контекст](09-templates-i-kontekst/README.md) | Шаблоны, @-упоминания, MCP tools | 8–12 | | 10 | [10 — Cursor на практике](10-cursor-praktika/README.md) | Chat, Agent, Plan, MCP | 10–15 | | 11 | [11 — ECC](11-ecc/README.md) | Установка, структура, agent-sort | 12–18 | | 12 | [12 — Практикум](12-praktikum/README.md) | 4 лабораторные работы | 15–25 | | 13 | [13 — Pro-уровень](13-pro-uroven/README.md) | Команда, метрики, типичные ошибки | 10–15 | ```mermaid flowchart LR A[00 План] --> B[01-02 Основы] B --> C[03-06 Промпты и ECC-база] C --> D[07-09 Commands Hooks MCP] D --> E[10-11 Cursor и ECC] E --> F[12-13 Практика и Pro] ``` --- ## Глоссарий (основные термины) | Термин | Кратко | |--------|--------| | **LLM** | Large Language Model — большая языковая модель (Claude, GPT и др.) | | **Промпт (prompt)** | Текстовая инструкция пользователя для модели | | **Контекст (context)** | Всё, что модель «видит» в текущей сессии: файлы, история, правила | | **Контекстное окно (context window)** | Максимальный объём текста (в токенах), который модель обрабатывает за раз | | **Токен** | Единица текста для модели (~4 символа латиницы или ~1–2 символа кириллицы) | | **AI-ассистент** | Режим «спросил — получил ответ»; модель советует, но не действует сама | | **AI-агент** | Модель с доступом к инструментам: читает файлы, запускает команды, правит код | | **Cursor IDE** | Редактор кода со встроенным AI: Chat, Composer (Agent), Tab completion | | **Composer / Agent mode** | Режим Cursor, где AI выполняет многошаговые задачи с инструментами | | **Rule (правило)** | Постоянная инструкция для агента в `.cursor/rules/*.mdc` | | **Skill (навык)** | Структурированный workflow в `SKILL.md`; агент подключает по описанию | | **Agent (агент / субагент)** | Специализированная роль с отдельным промптом (code-reviewer, planner…) | | **Hook (хук)** | Скрипт на событие сессии: до/после правки файла, старт, стоп | | **MCP** | Model Context Protocol — стандарт подключения внешних API и сервисов к агенту | | **ECC** | Everything Claude Code — open-source экосистема skills/rules/agents/hooks | | **Harness** | «Среда агентного ИИ»: Cursor, Claude Code, Codex, OpenCode и др. | | **Субагент** | Дочерний агент с узкой задачей; родитель делегирует и собирает результат | | **Оркестрация** | Координация нескольких агентов или параллельных задач | | **Plan mode** | Режим только планирования без правок кода | | **@ упоминание** | Ссылка на файл, папку, skill или правило в промпте Cursor | | **Итерация** | Повторный запрос с уточнением после первого ответа агента | --- ## Экосистема ECC **ECC** — репозиторий с готовыми компонентами для агентной разработки: десятки агентов (`code-reviewer`, `planner`, `security-reviewer`), сотни skills (`tdd-workflow`, `django-patterns`), общие rules, hooks и MCP-конфигурации. Работает в Cursor и других harness. Типичная структура после установки ECC в проект: ``` .cursor/ ├── rules/ # правила стиля, безопасности, git ├── skills/ # навыки с SKILL.md └── (agents) # в ~/.claude/agents/ или через Task tool ``` Установка и тонкая настройка — в разделе [11 — ECC](11-ecc/README.md). ECC дополняет Cursor готовыми «рецептами» работы. --- ## Как пользоваться tree viewer После публикации документация доступна на **https://ai.nazeebo.site** (s3-md-browser). | Действие | Как | |----------|-----| | Дерево разделов | Левая панель — папки `00-`…`13-`, внутри — `.md` страницы | | Навигация по странице | Вверху: ссылка на раздел и на главную | | Локально | Откройте `nazeebo.site/docs/AI/` в IDE или md-viewer | | Обновление на сайте | `make upload-docs` из каталога `docs/AI` | **Совет:** нумерация папок задаёт порядок в дереве. Начните с [00 — Карта пути](00-karta-puti/README.md). --- ## Все разделы курса | № | Раздел | |---|--------| | 00 | [Карта пути](00-karta-puti/README.md) | | 01 | [Введение в AI](01-vvedenie-v-ai/README.md) | | 02 | [Эффективное использование](02-effektivnoe-ispolzovanie/README.md) | | 03 | [Промпты](03-prompts/README.md) | | 04 | [Rules](04-rules/README.md) | | 05 | [Skills](05-skills/README.md) | | 06 | [Agents](06-agents/README.md) | | 07 | [Commands](07-commands/README.md) | | 08 | [Hooks](08-hooks/README.md) | | 09 | [Templates и контекст](09-templates-i-kontekst/README.md) | | 10 | [Cursor на практике](10-cursor-praktika/README.md) | | 11 | [ECC](11-ecc/README.md) | | 12 | [Практикум](12-praktikum/README.md) | | 13 | [Pro-уровень](13-pro-uroven/README.md) | --- ## С чего начать 1. Прочитайте [00 — Карта пути](00-karta-puti/README.md) и составьте личный план на 4–8 недель. 2. Пройдите [01 — Введение в AI](01-vvedenie-v-ai/README.md) — без этого сложно понять разницу между чатом и агентом. 3. Параллельно откройте Cursor на **учебном** репозитории (не прод!) и повторяйте примеры из [03 — Промпты](03-prompts/README.md). Удачи на пути к уверенной работе с AI в разработке.