Яндекс.Директ: единый рабочий навык

Этот навык задаёт порядок работы. Узкие навыки yandex-wordstat, roistat-reports-api и amocrm-api-control уточняют свои программные интерфейсы, но не заменяют этот порядок.

Перед началом

1. Пройти общий поиск навыков по теме задачи.
2. Прочитать references/main-workflow.md и references/decision-rules.md.
3. Для семантики прочитать references/keyword-collection-runbook.md.
4. Для изменения самого навыка прочитать references/source-map.md.
5. Для действующего кабинета, авторизации или любой записи пройти references/workflow-supervisor.md.

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

Неподвижные правила

• Сначала определить клиента, кабинет и разрешённый объём; затем читать данные.
• Доступ подтверждается свежим запросом к нужной службе, а не наличием файла с токеном.
• В поставке есть общие приложения авторизации для Директа и Метрики. Пользователю не требуется создавать собственное приложение.
• Авторизация Директа и Метрики раздельна. Токен, код подтверждения и секрет приложения не передаются в аргументах процесса и не печатаются.
• Чтение и запись разделены. Любая запись, запуск, модерация, бюджет или остановка трафика требуют отдельного явного разрешения.
• Имена кампаний и групп показываются пользователю раньше служебных номеров.
• Сырые данные Wordstat и поисковых фраз не являются готовой семантикой.
• Автоматические сценарии не принимают смысловые решения за человека или проверяющего агента.
• Секреты и клиентские выгрузки хранятся только вне каталога навыка.

Результат

Каждый запуск оставляет проверяемые входы, исходные ответы, решения, план изменения и чтение после изменения. Если обязательного доказательства нет, статус — BLOCKED с конкретной причиной, а не предположение о готовности.