cyberseo

name	Полный запуск CyberSEO
description	Общий навык CyberSEO для развёртывания WordPress, развёртывания CyberSEO, подготовки профиля, промптов, поиска тем и финального импорта. Работает только через один файл cyberseo.project.yml.

Полный запуск CyberSEO

Это общий входной навык.

Он не должен делать всё одним большим действием. Его задача:

• найти или создать cyberseo.project.yml;
• хранить служебные данные в блоке state внутри cyberseo.project.yml;
• понять, что нужно сейчас: развёртывание или темы;
• передать работу нужному внутреннему навыку;
• не спрашивать повторно то, что уже есть в файле;
• после каждого шага обновить файл и коротко сказать, что готово.

Что читать

1. cyberseo.project.yml в текущем проекте клиента.
2. Если cyberseo.project.yml нет, создать его по шаблону assets/cyberseo.project.yml.
3. Для развёртывания читать Развёртывание CyberSEO.
4. Для тем читать Поиск и импорт тем CyberSEO.

Отдельный .cyberseo.state.yml не создавать. Если такой файл уже есть от старого запуска, перенести нужные значения в cyberseo.project.yml -> state и больше его не использовать.

Как обновлять cyberseo.project.yml

В файле должны сохраняться комментарии-подсказки. Нельзя читать YAML в объект и затем записывать его обратно обычным YAML-сохранением, потому что так стираются комментарии.

Правило:

• менять только нужные значения в существующем файле;
• использовать точечную правку строк или apply_patch;
• не пересобирать весь cyberseo.project.yml с нуля, если файл уже существует;
• перед большой правкой сделать копию файла;
• после правки проверить, что в файле остались комментарии #;
• если комментарии уже были стёрты, восстановить файл из assets/cyberseo.project.yml и перенести туда текущие значения.

Как выбрать шаг

Если пользователь просит создать файл проекта — только создать cyberseo.project.yml и остановиться.

Если пользователь просит заполнить профиль сайта до развёртывания — обновить поля site.*, topics.main_topic, topics.language и prompts.* в cyberseo.project.yml, ничего не разворачивать.

Если пользователь просит развернуть WordPress — поставить WordPress только из стека, который лежит внутри этого навыка: assets/wordpress/cyberseo-publisher-stack. Это специализированная сборка под CyberSEO, а не общий WordPress-стек. WordPress-доступы записать в state.wordpress внутри cyberseo.project.yml.

При запуске WordPress-стека передать в setup.sh значения из cyberseo.project.yml:

• site.site_title -> COMANDOS_WP_SITE_TITLE;
• site.site_description -> COMANDOS_WP_SITE_DESCRIPTION;
• site.blog_title -> COMANDOS_WP_BLOG_TITLE;
• site.blog_description -> COMANDOS_WP_BLOG_DESCRIPTION;
• site.about_blog -> COMANDOS_WP_ABOUT_BLOG.

Установщик сам запишет стандартные опции WordPress и отдельные поля темы Comandos AI Blog: blog_title, blog_description, about_blog. Не оставлять эти поля на ручную правку в кастомайзере.

При развёртывании WordPress установщик также должен закрыть архив администратора от индексации в Yoast SEO. Это та галочка в профиле пользователя: “Не разрешайте поисковым системам отображать архивы этого автора в результатах поиска”. В базе это user meta wpseo_noindex_author = on.

Не ставить WordPress вручную с официального сайта, не использовать wp-next-stack и не использовать общий stacks/wp для CyberSEO. Источник WordPress-стека:

cyberseo-full/assets/wordpress/cyberseo-publisher-stack

При установке навыка эта папка копируется вместе с cyberseo-full. Для развёртывания скопировать папку assets/wordpress/cyberseo-publisher-stack на сервер и запускать её setup.sh.

Если пользователь просит развернуть CyberSEO — использовать cyberseo-deploy. Панель CyberSEO не должна показывать заранее вписанные логин и пароль. Созданные логин, пароль, адрес панели, адрес API и админ-токен записывать в cyberseo.project.yml -> state.cyberseo. Тот же ключ из license.cyberseo_key должен быть сразу подключён через локальный API CyberSEO, чтобы после входа в панель лицензия уже была активна.

Если пользователь просит найти темы, собрать план публикаций, сделать 20-50 тем, убрать дубли или импортировать темы — использовать cyberseo-topic-research.

Если неясно, сначала посмотреть cyberseo.project.yml:

• если нет cyberseo.project.yml — создать шаблон и остановиться;
• если профиль сайта пустой, а WordPress ещё не развёрнут — предложить сначала заполнить SEO/GEO-профиль сайта;
• если WordPress ещё не развёрнут — предложить команду развёртывания WordPress;
• если CyberSEO ещё не развёрнут — предложить команду развёртывания CyberSEO;
• если есть адрес API и токен в state.cyberseo — можно идти к темам;
• если человек прямо сказал “только темы”, не запускать развёртывание.

Правила

• Все пользовательские секреты брать только из cyberseo.project.yml или спрашивать у пользователя.
• Технические секреты, созданные агентом, хранить только в cyberseo.project.yml -> state.
• Сразу добавить cyberseo.project.yml в .gitignore, выставить права 0600 и никогда не печатать его секреты в чат, логи или Git.
• Не создавать второй YAML-файл для состояния.
• Полные ключи и токены не печатать в ответах и логах.
• Если обязательного поля нет, спросить коротко.
• Если поле полезное, но не обязательное, спросить один раз.
• Если пользователь сказал “без этого”, оставить поле пустым или записать понятную отметку и больше не спрашивать.
• Не менять сервер и живой CyberSEO без понятного подтверждения перед опасным действием.
• Не импортировать темы без предварительного списка для проверки, если пользователь не сказал “импортируй сразу”.
• Не выдумывать адреса API, токены, оферы и ID.

Общий файл

cyberseo.project.yml хранится у клиента локально. Его нельзя коммитить в открытый репозиторий с реальными ключами.

В нём должны жить:

• лицензия;
• данные сервера и доменов;
• ключи KIE, Perplexity, Firecrawl и Telegram;
• страна, город, язык статей, основная тема и число тем;
• промпт писателя;
• промпт художника;
• ссылка на референс изображения.
• служебный блок state с созданными доступами и статусами.

Выход

В конце каждого запуска дать короткий отчёт:

• что сделано;
• какие данные сохранены в cyberseo.project.yml;
• какие служебные данные сохранены в блоке state;
• что не заполнено;
• какой один следующий шаг имеет смысл.