Гайд №01 • Хардкодинг PRO

Как устроен ИИ-агент-технарь

Claude Code, Codex, ZCode, OpenCode, Kimi, Antigravity и другие coding-среды выглядят по-разному, но внутри решают одну и ту же задачу. Разберём универсальную систему: модель → среда → инструкции → контекст → Skills → Tools/MCP → автодействия → проверка результата.

Универсальная архитектура Без привязки к бренду Skills MCP Теория → практика

1. Главная схема: модель → среда → система

Самая частая путаница — считать Claude Code, Codex или другую coding-среду самим «интеллектом». На деле это разные слои.

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

СредаРабочее место агента: файлы проекта, терминал, редактор, браузер, Git и интерфейс взаимодействия.

Система вокруг агентаПостоянные инструкции, контекст, Skills, инструменты, MCP, hooks, разрешения и правила проверки результата.

Главная мысль: сильный ИИ-технарь — это не «лучшая модель» и не «лучшая программа». Это правильно собранная система вокруг модели.

2. Из каких слоёв состоит ИИ-агент-технарь

Названия файлов и кнопок могут отличаться, но смысл почти везде один.

📄 Инструкции

Постоянные правила: как работать, что проверять, какой стиль соблюдать, чего нельзя делать.

🧠 Контекст и память

Что агент должен знать о проекте, текущей задаче, твоих предпочтениях и уже принятых решениях.

🧩 Skills

Готовые рабочие методики для повторяемых задач: debugging, deploy, лендинг, Telegram, безопасность и так далее.

🔌 Tools / MCP

Доступ к реальному миру: GitHub, терминал, база, браузер, API, файлы, серверы и другие инструменты.

⚡ Hooks / автодействия

То, что срабатывает автоматически по событию: перед действием, после действия, при старте или завершении работы.

✅ Проверка и ограничения

Критерии «готово», тесты, подтверждения, запреты на опасные действия и доказательства результата.

Не зубри названия. Тебе важно понимать назначение слоя. Конкретная среда сама подскажет, каким файлом, папкой или настройкой он реализован.

3. Что куда класть: фильтр на 10 секунд

Должно действовать всегда→ Инструкция.

Есть повторяемый процесс из нескольких шагов→ Skill.

Нужно получить данные или выполнить действие снаружи→ Tool / MCP.

Должно сработать само при событии→ Hook / автодействие.

Нужно помнить факт о проекте или текущей работе→ Контекст / память.

Нужно доказать, что задача реально закончена→ Проверка / критерии приёмки.

Ошибка новичка: складывать всё в один огромный файл инструкций. Тогда постоянные правила, рабочие процессы и временный контекст начинают мешать друг другу.

4. Как все слои работают вместе

Представь задачу: «Найди причину бага, исправь её и подготовь релиз».

Задача→Инструкции→Skill→Tools→Hooks→Проверка

ИнструкцияНе менять production вслепую. Сначала собрать факты и сделать минимальное изменение.

КонтекстКакой репозиторий открыт, что уже проверено, какая ошибка воспроизводится.

SkillПодключается методика системной диагностики.

Tool / MCPАгент читает код, запускает тесты, смотрит GitHub или серверные логи.

HookНапример, не даёт случайно отправить секрет или запускает проверку перед завершением.

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

Вот в чём сила системы: модель не должна каждый раз «догадываться», как правильно работать. Правильное поведение уже разложено по слоям.

5. Почему конкретная coding-среда — не главное

Сегодня ты можешь работать в Claude Code, завтра в Codex, ZCode, OpenCode или другой среде. Интерфейс и названия отличаются, архитектура остаётся. (Cline как расширение для VS Code — устаревший вариант, на старте он не нужен.)

Постоянные правилаУ среды есть свой способ хранить инструкции проекта или пользователя.

SkillsУ среды может быть собственный формат навыков или папок с рабочими методиками.

Tools / MCPСпособ подключить внешние системы и действия может отличаться, задача слоя остаётся той же.

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

Правильный вопрос не «где в этой программе кнопка X?», а «каким способом эта среда реализует нужный мне слой?»

Попроси своего агента показать устройство текущей среды

Проанализируй текущую coding-среду, в которой ты работаешь.

Ничего пока не меняй и не устанавливай.

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

1. постоянные инструкции;
2. контекст и память;
3. Skills;
4. Tools / MCP;
5. hooks или другие автодействия;
6. разрешения и ограничения;
7. проверка результата.

Если какого-то слоя среда не поддерживает напрямую — так и скажи и предложи ближайший безопасный аналог.

В конце покажи короткую схему:
Модель → Среда → Система агента.

6. Что решаешь ты, а что агент может настроить сам

Ты определяешь

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

Агент может сделать сам

определить текущую среду;
положить инструкции в правильное место;
установить совместимые Skills;
подключить доступные hooks и инструменты;
сделать backup перед изменениями;
запустить smoke-проверки и показать результат.

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

7. Частые ошибки настройки

Копировать чужую среду один в один

Файлы и возможности отличаются. Переносить нужно смысл слоя, а не название кнопки.

Один гигантский файл правил

Постоянные инструкции смешиваются со Skills и временным контекстом.

Skill для одноразовой мелочи

Skill нужен, когда процесс повторяется и его выгодно стандартизировать.

Слишком много инструментов

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

Автоматизация без ограничений

Hooks и автономность должны знать, что можно делать автоматически, а где нужен человек.

Нет проверки «готово»

Если агент сказал «сделано», это ещё не доказательство. Нужны тесты, readback или другой проверяемый результат.

8. Проверка понимания

Не проверяем, запомнил ли ты названия файлов. Проверяем, понял ли сам принцип.

0 / 8 выполнено

Я понимаю разницу между моделью, coding-средой и системой вокруг агента. Я могу объяснить, зачем нужны постоянные инструкции. Я понимаю, когда нужен Skill, а когда достаточно инструкции. Я понимаю, зачем агенту Tools / MCP. Я понимаю, чем hook или автодействие отличается от Skill. Я понимаю, что контекст проекта и постоянная инструкция — не одно и то же. Я знаю, что среда может называться как угодно, а слои системы останутся примерно теми же. Я готов перейти к практике и поставить готовую систему своему агенту.

9. Теперь практика: «Обучи своего ИИ-агента»

Теорию закончили. Собирать всё это вручную не будем.

В практическом гайде ты подключишь готовый Agent Kit к своей coding-среде. Агент сам установит подходящие инструкции, 19 Skills, доступные автодействия и проверки, а затем адаптирует систему под твои задачи.

Результат практики: не «я прочитал про Skills», а «у меня есть настроенный ИИ-агент-технарь, и я проверил, что система работает».

Перейти к практике →

Дай агенту набор. Обучи своего агента.