Создавайте вместе с кодинг-агентом

Прохождение для начинающих

Предварительные требования: прочитайте два руководства для начинающих ниже и завершите локальную настройку Desktop. Агент кодирования — это инструмент ИИ — Cursor, Claude Code, Devin или подобный помощник — который читает ваш проект, редактирует файлы и запускает команды. Всё на этой странице применяется к любому из них.

Коротко о терминах: промпт — это текст инструкции, который вы вставляете агенту. Diff — список предлагаемых им изменений файлов. Корень репозитория — верхняя папка, содержащая package.json, — агент всегда должен начинать оттуда.

1. Откройте .agents/skills/ в корне репозитория и скопируйте навык, наиболее близкий к вашей задаче — add-a-desktop-capability — хорошая первая попытка.

2. Вставьте его агенту и опишите изменение, затем добавьте одну строку: Прочитайте llms.txt, затем AGENTS.md, затем .ai/PROJECT_CONTEXT.md перед тем как трогать код.

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

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

• Прежде чем начать
• Основные сведения о терминале
• Локальная настройка рабочего стола

Файлы, которые читает ваш агент

Репозиторий поставляет небольшой набор файлов, написанных для агентов, а не только для людей. Вы никогда не вставляете этот контекст вручную — укажите агенту на llms.txt, и остальное он прочитает сам.

Порядок чтения важен: llms.txt — карта, AGENTS.md задаёт границы, а .ai/PROJECT_CONTEXT.md несёт то, что узнали предыдущие сессии. Агент, пропускающий границы, производит код, который вы не сможете выпустить.

Поставляемые навыки

Каждый файл под .agents/skills/ — это полное описание: вставьте его или позвольте агенту прочитать, и правила набора передаются с ним — интерфейс продукта остаётся в веб-приложении, только поведение ОС идёт в Rust.

Библиотека prompts/ для вставки поставляется только в репозитории Web; этот checkout несёт вместо неё навыки. Для автономной настройки используйте готовый промпт в руководстве agent-setup.

• Пусть агент выполнит настройку

• add-a-desktop-capability — изменения окна, трея, ярлыка, обновления или сборки
• adding-a-dependency — безопасно добавить, обновить или переместить зависимость npm
• reviewing-a-pr — проверить diff на корректность, изоляцию workspace и секреты
• upgrading-from-upstream — перенести более новый выпуск набора в вашу оболочку
• verify-changes — выбрать и выполнить правильные проверки перед сдачей

Как агент помнит между сессиями

У агентов нет памяти между сессиями — папка .ai/ и есть память. .ai/PROJECT_CONTEXT.md фиксирует, что недавно изменилось и почему. Рядом зеркальный документ, такой как .ai/apps/desktop/src-tauri/src/lib.md, объясняет решения за apps/desktop/src-tauri/src/lib.rs, которые код сам по себе не показывает.

Контракт прост: читайте зеркало файла перед его редактированием и обновляйте зеркало, когда изменение принято. Записи Open Threads фиксируют незавершённую работу, чтобы следующая сессия продолжила, а не начала заново. Устаревшее зеркало хуже его отсутствия — просматривая diff агента, проверьте, что зеркала изменённых файлов сдвинулись вместе с ним.

Честно проверяйте работу агента

Завершённая задача — это доказательства, а не пересказ. Прежде чем оставить работу агента, проверьте её так, как docs/agent-security.md проверяет развёртывание:

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

• Проверочные шлюзы и набор тестов

• Он действительно выполнил проверки, которые заявляет — cargo test, cargo check или предполётная проверка выпуска — запросите команду и её вывод, а не вывод.
• Секреты оставались только на сервере — ни один ключ подписи или сертификат не был напечатан в отчёте или коммите, и оболочка по-прежнему не несёт учётных данных провайдеров.
• Поведение продукта оставалось в веб-приложении — diff не добавляет параллельный интерфейс, аутентификацию или логику чата в Rust.
• Зеркало .ai/ каждого изменённого файла сдвинулось вместе с кодом.
• Публикация, выпуск установщиков и вызовы платных провайдеров остались отдельными шагами, которые вы одобрили — агент никогда не делал слияние, push или выпуск самостоятельно.
• Если шаг упал дважды, он остановился и доложил упавшую команду вместо импровизации вокруг неё.