@iola_adm/iola-cli 0.2.32 → 0.2.34

package/README.md

@@ -90,6 +90,7 @@ iola agent
 
 ```bash
 iola skills list
+iola skills create mail-digest --description "Сводка почты" --instructions "Когда пользователь просит сводку почты, найди непрочитанные письма и кратко сгруппируй их по отправителям." --allowed-tools yandex_mail_list,yandex_mail_read --enable
 iola tools toolsets
 iola files mode read-only
 iola files tree .
@@ -201,7 +202,7 @@ Yandex Connector использует две встроенные OAuth-груп
 
 В `/yandex` функции выбираются номерами через запятую, как в мастере настройки. Там же есть пункт `Удалить подключение-коннектор`, который чистит локальные токены и настройки Yandex Connector. Мастер считает коннектор готовым только после токенов обеих групп.
 
-Первый набор Yandex tools уже доступен: профиль Yandex ID, список/поиск/папки/ссылки Яндекс Диска, статус/список/поиск/чтение/отправка Яндекс Почты, события Календаря, Контакты и подготовка встречи через календарь. Отправка письма, удаление файлов, публикация ссылок и создание событий требуют явного подтверждения.
+Yandex tools уже доступны: профиль Yandex ID, расширенная работа с Яндекс Диском (место, список, поиск, карточка, чтение текста, папки, загрузка, скачивание, ссылки, QR-коды к публичным ссылкам, отправка ссылки и QR по почте, перемещение, копирование, переименование, корзина), статус/список/поиск/чтение/отправка Яндекс Почты, события Календаря, расширенные Яндекс Контакты (поиск, создание, обновление, удаление, импорт/экспорт, дубликаты, backup на Диск, дни рождения в календарь, регулярная contacts-maintenance проверка) и комбинированные сценарии: письмо контакту, ссылка+QR контакту, папка контакта на Диске, встреча/Телемост с контактом. Отправка письма, удаление/перемещение файлов, публикация ссылок, изменение контактов и создание событий требуют явного подтверждения.
 
 Инструкция: [Yandex Connector](https://github.com/adm-iola/iola-cli/wiki/Yandex-Connector).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iola_adm/iola-cli",
-  "version": "0.2.32",
+  "version": "0.2.34",
   "description": "CLI и AI-агент городского округа Йошкар-Ола.",
   "license": "MIT",
   "homepage": "https://github.com/adm-iola/iola-cli#readme",
@@ -42,5 +42,8 @@
   ],
   "engines": {
     "node": ">=22.5.0"
+  },
+  "dependencies": {
+    "qrcode": "^1.5.4"
   }
 }

package/skills/user-skills/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: user-skills
+description: Создание и управление пользовательскими skills на базе встроенных tools iola-cli.
+---
+
+Используй этот skill, когда пользователь просит создать, добавить, изменить, включить, выключить или удалить пользовательский skill/скилл/навык.
+
+Пользовательские skills могут описывать любые сценарии работы CLI, но должны опираться на встроенные безопасные механизмы `iola-cli`: открытые данные, локальные файлы, Яндекс-сервисы, календарь, почту, контакты, Диск, browser runtime, cron, MCP, отчеты и память.
+
+Не создавай произвольный исполняемый JavaScript/PowerShell/Python-код внутри skill. Skill должен быть инструкцией и правилами использования существующих tools.
+
+Доступные tools:
+
+- `user_skill_list` - показать пользовательские skills.
+- `user_skill_create` - создать пользовательский skill в `~/.iola/skills`.
+- `user_skill_enable` - включить skill.
+- `user_skill_disable` - выключить skill.
+- `user_skill_delete` - удалить пользовательский skill.
+
+Схема `user_skill_create`:
+
+```json
+{
+  "name": "short-skill-name",
+  "description": "Короткое описание",
+  "instructions": "Что skill должен делать, когда включается, какие уточнения задавать, какие tools использовать.",
+  "tools": ["yandex_mail_search", "yandex_disk_save_text"],
+  "enable": true,
+  "confirm": true
+}
+```
+
+Правила:
+
+- Создавай skill только по явной просьбе пользователя.
+- Для `user_skill_create` и `user_skill_delete` всегда передавай `confirm=true`.
+- Если пользователь описал идею нечетко, сначала уточни, что является триггером, какие данные использовать и какое действие выполнить.
+- В инструкциях skill явно указывай, какие действия считаются опасными и требуют подтверждения пользователя.
+- Если skill должен писать файлы, отправлять письма, удалять данные, публиковать ссылки или менять внешние сервисы, в инструкциях обязательно требуй явного подтверждения пользователя.
+- Не сохраняй в skill OAuth-токены, API-ключи, пароли и другие секреты.

package/skills/yandex-services/SKILL.md

@@ -14,12 +14,24 @@ description: Сервисы Яндекса через Yandex Connector: ID, Ди
 - `yandex_disk_ls` - показать папку на Яндекс Диске.
 - `yandex_disk_mkdir` - создать папку на Яндекс Диске.
 - `yandex_disk_find` - найти файл или папку на Яндекс Диске.
+- `yandex_disk_stat` - получить карточку файла или папки: тип, размер, даты, публичная ссылка.
+- `yandex_disk_exists` - проверить, есть ли файл или папка.
+- `yandex_disk_read_text` - прочитать небольшой текстовый файл с Диска.
 - `yandex_disk_save_text` - сохранить текстовый результат в файл на Яндекс Диске.
 - `yandex_disk_upload` - загрузить локальный файл на Яндекс Диск.
 - `yandex_disk_download` - скачать файл с Яндекс Диска.
+- `yandex_disk_move` - переместить файл или папку.
+- `yandex_disk_copy` - скопировать файл или папку.
+- `yandex_disk_rename` - переименовать файл или папку.
 - `yandex_disk_share` - сделать публичную ссылку.
+- `yandex_disk_share_qr` - сделать публичную ссылку, создать локальный QR-код из ссылки, сохранить QR PNG на Диск и опубликовать QR.
+- `yandex_disk_share_email` - сделать публичную ссылку, QR-код и отправить ссылку + QR по Яндекс Почте email-адресу или контакту.
+- `yandex_disk_package_share_email` - создать/подготовить папку, перенести или скопировать в нее файлы из другой папки, сделать ссылку + QR и отправить по почте.
 - `yandex_disk_unshare` - снять публичную ссылку.
 - `yandex_disk_delete` - удалить файл или папку.
+- `yandex_disk_trash_list` - показать корзину Диска.
+- `yandex_disk_restore` - восстановить объект из корзины.
+- `yandex_disk_empty_trash` - очистить корзину.
 - `yandex_mail_status` - проверить доступ к Яндекс Почте.
 - `yandex_mail_folders` - показать папки Яндекс Почты.
 - `yandex_mail_list` - показать последние письма.
@@ -42,16 +54,55 @@ description: Сервисы Яндекса через Yandex Connector: ID, Ди
 - `yandex_calendar_create_event` - создать событие.
 - `yandex_contacts_status` - проверить доступ к Яндекс Контактам.
 - `yandex_contacts_list` - показать контакты.
-- `yandex_contacts_search` - найти контакт.
-- `yandex_contacts_create` - создать новый контакт.
+- `yandex_contacts_search` - найти контакт по имени, email, телефону, организации, адресу или заметке.
+- `yandex_contacts_get` - открыть карточку контакта.
+- `yandex_contacts_create` - создать новый контакт с email или телефоном.
+- `yandex_contacts_update` - обновить имя, email, телефон, адрес, заметку, день рождения, организацию или должность.
+- `yandex_contacts_delete` - удалить контакт.
 - `yandex_contacts_add_email` - добавить email в существующий контакт.
+- `yandex_contacts_add_phone` - добавить телефон.
+- `yandex_contacts_add_address` - добавить адрес.
+- `yandex_contacts_add_note` - добавить заметку.
+- `yandex_contacts_add_birthday` - добавить день рождения.
+- `yandex_contacts_add_org` - добавить организацию и должность.
+- `yandex_contacts_remove_email` - удалить email из карточки.
+- `yandex_contacts_remove_phone` - удалить телефон из карточки.
+- `yandex_contacts_export_vcard` - экспортировать контакты в vCard.
+- `yandex_contacts_export_csv` - экспортировать контакты в CSV.
+- `yandex_contacts_import_vcard` - импортировать контакты из vCard.
+- `yandex_contacts_import_csv` - импортировать контакты из CSV.
+- `yandex_contacts_find_incomplete` - найти неполные контакты.
+- `yandex_contacts_find_duplicates` - найти дубликаты.
+- `yandex_contacts_backup_to_disk` - сохранить резервную копию контактов на Яндекс Диск.
+- `yandex_contacts_birthdays_to_calendar` - создать события дней рождения в календаре.
+- `yandex_contact_send_mail` - отправить письмо контакту по имени.
+- `yandex_contact_send_disk_link_qr` - отправить контакту ссылку и QR-код на объект Яндекс Диска.
+- `yandex_contact_create_disk_folder` - создать папку контакта на Диске и сохранить туда vCard/README.
+- `yandex_contact_create_calendar_event` - создать встречу с контактом.
+- `yandex_contact_create_telemost_event` - создать календарное событие для Телемоста с контактом.
+- `yandex_contact_from_public_entity` - создать контакт из открытого городского слоя, если у организации есть email или телефон.
 - `yandex_telemost_create_event` - создать календарное событие для встречи.
+- Регулярная проверка контактов включается командой `iola yandex contacts-maintenance on --days 7`, выключается `iola yandex contacts-maintenance off`, ручная проверка `iola yandex contacts-maintenance tick`. Флаг `--backup` включает backup контактов на Диск при tick.
+
+Комбинированные сценарии:
+
+- Если пользователь просит "сделай ссылку и QR", используй `yandex_disk_share_qr`.
+- Если пользователь просит "отправь ссылку/QR по почте" или "отправь ссылку контакту", используй `yandex_disk_share_email`.
+- Если пользователь просит "перенеси/скопируй файлы из папки, создай ссылку/QR и отправь", используй `yandex_disk_package_share_email`.
+- Если получатель указан именем, сначала ищи его в контактах. Если контактов несколько или email не найден, попроси уточнение.
+- Если пользователь просит отправить письмо контакту, создать встречу с контактом или отправить ссылку контакту, используй специализированные `yandex_contact_*` tools, а не ручную цепочку из нескольких tools.
+- Если пользователь просит создать папку для контакта на Яндекс Диске, используй `yandex_contact_create_disk_folder`.
+- Если пользователь просит резервную копию контактов, используй `yandex_contacts_backup_to_disk`.
+- Если пользователь просит регулярную проверку контактов, дубликатов или неполных карточек, используй `iola yandex contacts-maintenance ...`.
+- Если пользователь просит импорт/экспорт контактов, используй CSV или vCard по расширению файла или явному формату.
+- QR-код создается локально из публичной ссылки Яндекс Диска, сохраняется PNG-файлом на Яндекс Диск рядом с исходным объектом и публикуется отдельной ссылкой.
+- REST API Яндекс Диска не отдает отдельное поле готового QR-кода, поэтому CLI не вытаскивает QR из API, а создает QR локально без сторонних QR-сервисов.
 
 Безопасность:
 
-- Для отправки письма, ответа на письмо, удаления письма, удаления файлов, публикации ссылки и создания событий нужен явный запрос пользователя и `confirm=true`.
+- Для отправки письма, ответа на письмо, удаления письма, удаления файлов, перемещения/копирования/переименования объектов, восстановления/очистки корзины, публикации ссылки, создания QR-ссылки, отправки ссылки по почте и создания событий нужен явный запрос пользователя и `confirm=true`.
 - Для пересылки письма, создания контакта, создания события из письма и добавления отправителя в контакты также нужен явный запрос пользователя и `confirm=true`.
-- Не отправляй письма, не отвечай на письма, не пересылай письма, не создавай контакты/события, не удаляй письма/файлы и не публикуй ссылки по косвенному намерению.
+- Не отправляй письма, не отвечай на письма, не пересылай письма, не создавай контакты/события, не удаляй письма/файлы, не перемещай/копируй/переименовывай объекты и не публикуй ссылки по косвенному намерению.
 - Список писем и поиск не должны помечать письма прочитанными. Чтение письма по просьбе пользователя помечает письмо прочитанным.
 - Если пользователь просит отправить письмо по имени контакта, сначала ищи контакт. Если контактов несколько, покажи варианты и попроси уточнить. Если контакта нет или у него нет email, скажи прямо.
 - Если пользователь отправил письмо на введенный email и указал имя контакта, можно предложить добавить email в найденный контакт без email.