ИНСТРУМЕНТЫ НАВЫКОВ BACH
-----------------

Инструменты для управления, мониторинга и проверки навыков BACH.

БЫСТРЫЙ СТАРТ
------------
  bach --maintain skills                    # Проверка работоспособности навыков
  bach skill list                          # Список навыков
  bach skill export NAME                   # Экспорт навыков

ЧТО ТАКОЕ НАВЫКИ?
----------------
Навыки — это повторно используемые модули навыков в BACH:
- _агенты/: агенты-боссы (ATI, налоговый агент и т. д.)
- _experts/: экспертные навыки (анализ данных и т. д.)
- _services/: Навыки обслуживания (коммуникация, повторяющиеся и т. д.)

МОНИТОР ЗДОРОВЬЯ НАВЫКОВ
--------------------
Отслеживает и проверяет все навыки.

Команды:
  инструменты Python/maintenance/skill_health_monitor.py проверка
  инструменты Python/maintenance/skill_health_monitor.py check --skills
  инструменты Python/maintenance/skill_health_monitor.py check --agents
  инструменты Python/maintenance/skill_health_monitor.py report

Что проверяется:
- Полнота SKILL.md (название, версия, описание)
- Манифест агента (manifest.json)
- Структура каталогов
- Потерянные или сломанные навыки

Интеграция в --startup:
Монитор состояния навыков запускается автоматически при запуске сеанса.
и сообщает о проблемах при запуске.

ЭКСПОРТ/ИМПОРТ НАВЫКОВ
-------------------
Навыки можно экспортировать и устанавливать в других системах.

Экспорт:
  bach skill export SKILLNAME
  -> Создан SKILLNAME.zip со всеми файлами + манифест.json

Импорт:
  bach skill install PFAD/skill.zip
  -> Распаковано и интегрировано в навыки/

ATI EXPORT (для конкретного агента):
  bach ati export
  -> Экспортирует агент ATI со всеми зависимостями

СТРУКТУРА КАТАЛОГ НАВЫКОВ
-------------------------
skills/
├── SKILL.md # основной SKILL.md (сам BACH)
├── AGENT_KONVENTION.md # Правила агента
├── SKILL_ANALYSE.md # Анализ покрытия
│
├── _агенты/ # Агенты-боссы
│ ├── ati/ # Агент разработчика программного обеспечения
│ ├── Tax-agent.txt # Налоговый агент
│ └── ...
│
├── _experts/ # Экспертные модули
│ └── анализ данных/ # эксперт по анализу данных
│
└── _services/ # Фоновые службы
    ├── communication.md # Партнерское общение
    └── recurring/ # Периодические задачи

SKILL.MD FORMAT
---------------
Каждый файл SKILL.md должен иметь заголовок YAML:

---
name: имя-навыка
версия: 1.0.0
описание: Краткое описание
Last_updated: 23.01.2026
---

# Название навыка

Содержимое и документация...

ПРОВЕРКА
-----------
Обязательные поля: имя, версия, описание
Рекомендуется: last_updated, автор, зависимости

Агентам также необходимо:
- манифест.json (ОБЯЗАТЕЛЬНО)
- README.md (рекомендуется)
- CHANGELOG.md (рекомендуется)

ИНТЕГРАЦИЯ БАЗ ДАННЫХ
---------------------
Навыки прописываются в bach.db:

  ВЫБРАТЬ * ИЗ навыков;                    # Все навыки
  ВЫБРАТЬ * ИЗ агентов;                    # Все агенты
  ВЫБЕРИТЕ * ИЗ агента_синергии;           # Взаимоотношения агентов

КОМАНДЫ CLI
-----------
  bach --maintain skills      # Проверка работоспособности (в --startup)
  bach skill list             # Список навыков из БД
  bach skill export NAME      # Экспорт навыков
  bach skill install PFAD     # Установить навык

СОВЕТЫ
-----
- Монитор работоспособности навыков запускается при каждом --startup
- О проблемах сообщается как о предупреждениях/ошибках.
- Для новых навыков: создайте SKILL.md с правильным вступительным словом.
- Всегда создавайте агенты с помощью файла манифеста.json

СМОТРИ ТАКЖЕ
----------
  bach --help agents           # Документация по агенту
  bach --help ati              # Подробности об агенте ATI
  bach --help maintain         # Инструменты обслуживания
  навыки/AGENT_KONVENTION.md # Правила агента

---
Версия: 1.0.0
Создано: 23 января 2026 г.
Часть: Документация по инструменту BACH
