For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/mobile/agents.md (or send Accept: text/markdown).
Создавайте вместе с кодинг-агентом
Передавайте задачи агенту кодирования: файлы, которые он читает, поставляемые навыки и обзор, сохраняющий вас у руля.
Прохождение для начинающих
Предварительные требования: прочитайте два руководства для начинающих ниже и завершите локальную настройку Mobile. Агент кодирования — это инструмент ИИ — Cursor, Claude Code, Devin или подобный помощник — который читает ваш проект, редактирует файлы и запускает команды. Всё на этой странице применяется к любому из них.
Коротко о терминах: промпт — это текст инструкции, который вы вставляете агенту. Diff — список предлагаемых им изменений файлов. Корень репозитория — верхняя папка, содержащая package.json, — агент всегда должен начинать оттуда.
1. Откройте .agents/skills/ в корне репозитория и скопируйте навык, наиболее близкий к вашей задаче — add-a-mobile-screen — хорошая первая попытка.
2. Вставьте его агенту и опишите изменение, затем добавьте одну строку: Прочитайте llms.txt, затем AGENTS.md, затем .ai/PROJECT_CONTEXT.md перед тем как трогать код.
3. Пусть агент перечислит файлы, которые он изменит, и проверки, которые он запустит, прежде чем редактировать. Когда он закончит, просмотрите diff — вы утверждаете реальные изменения своего продукта.
4. Публикация, отправка в магазин и вызовы платных провайдеров никогда не являются частью промпта задачи. Держите их отдельными шагами, которые вы явно утверждаете.
Файлы, которые читает ваш агент
Репозиторий поставляет небольшой набор файлов, написанных для агентов, а не только для людей. Вы никогда не вставляете этот контекст вручную — укажите агенту на llms.txt, и остальное он прочитает сам.
Порядок чтения важен: llms.txt — карта, AGENTS.md задаёт границы, а .ai/PROJECT_CONTEXT.md несёт то, что узнали предыдущие сессии. Агент, пропускающий границы, производит код, который вы не сможете выпустить.
| Файл | Что он даёт агенту |
|---|---|
| `llms.txt` | Входная карта репозитория, сгенерированная так, чтобы перечислять только то, что этот checkout действительно поставляет |
| `AGENTS.md` | Нерушимые границы: только локальная работа, пока вы не одобрите больше, ограничение по workspaceId, секреты только на сервере |
| `.ai/PROJECT_CONTEXT.md` | Память между сессиями — что недавно изменилось и почему; читается перед изменениями кода |
| зеркальные документы `.ai/` | Соответствующая заметка `.ai/<path>.md` рядом с важными файлами, фиксирующая решения по каждому файлу и открытые вопросы |
| `.agents/skills/` | Руководства по задачам, написанные для агентов — шесть навыков Mobile, перечисленных ниже |
| `docs/agent-security.md` | Контрольный список приёмки — аутентификация, проверки workspace и разрешений, зачищенные логи |
| `docs/mobile-store-submission.md` | Руководство по выпуску в магазине — аккаунты, сборки, заметки для проверки и порядок отправки |
| `.env.example` | Полный перечень окружения — агент никогда не выдумывает имя переменной, отсутствующее в этом файле |
Поставляемые навыки
Каждый файл под .agents/skills/ — это полное описание: вставьте его или позвольте агенту прочитать, и правила набора передаются с ним — данные сначала на сервере, секретов в бандле нет, офлайн только как откат при сбое сети.
Библиотека prompts/ для вставки поставляется только в репозитории Web; этот checkout несёт вместо неё навыки. Для автономной настройки используйте готовый промпт в руководстве agent-setup.
add-a-mobile-screen— добавить или изменить экран, его поток данных и офлайн-поведениеadding-a-dependency— безопасно добавить, обновить или переместить зависимость npmreviewing-a-pr— проверить diff на корректность, изоляцию workspace и секретыupgrading-from-upstream— перенести более новый выпуск набора в ваше приложениеverify-changes— выбрать и выполнить правильные проверки перед сдачейwriting-unit-tests— покрыть новую логику Vitest
Как агент помнит между сессиями
У агентов нет памяти между сессиями — папка .ai/ и есть память. .ai/PROJECT_CONTEXT.md фиксирует, что недавно изменилось и почему. Рядом зеркальный документ, такой как .ai/apps/mobile/src/ideas/index.md, объясняет решения за apps/mobile/src/ideas/index.ts, которые код сам по себе не показывает.
Контракт прост: читайте зеркало файла перед его редактированием и обновляйте зеркало, когда изменение принято. Записи Open Threads фиксируют незавершённую работу, чтобы следующая сессия продолжила, а не начала заново. Устаревшее зеркало хуже его отсутствия — просматривая diff агента, проверьте, что зеркала изменённых файлов сдвинулись вместе с ним.
Честно проверяйте работу агента
Завершённая задача — это доказательства, а не пересказ. Прежде чем оставить работу агента, проверьте её так, как docs/agent-security.md проверяет развёртывание:
Когда что-то не так, отправьте diff обратно — агент исправляет свою работу быстрее всего, когда вы называете упавшую проверку. О том, что ему никогда не следовало пытаться делать в одиночку, скажите явно один раз — граница действует до конца сессии.
- Он действительно запускал тесты, о которых заявляет, — попросите команду и её вывод, а не заключение.
- Секреты остались только на сервере — ничего нового не несёт префикс
NEXT_PUBLIC_илиEXPO_PUBLIC_, и ни один ключ не был напечатан в отчёт или коммит. - Каждое чтение и запись пользовательских данных осталось ограниченным
workspaceId— ни один запрос не доверяет id, присланному браузером. - Зеркало
.ai/каждого изменённого файла сдвинулось вместе с кодом. - Публикация, развёртывание и платные вызовы провайдеров остались отдельными шагами, которые вы одобрили, — агент никогда не сливал, не пушил и не развёртывал самостоятельно.
- Если шаг упал дважды, он остановился и доложил упавшую команду вместо импровизации вокруг неё.
Чтобы продолжить настройку, прочитайте Нативная аутентификация.