# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

ЭКСПОРТ — сценарии экспорта DB-to-Markdown
=======================================

ОПИСАНИЕ
============

BACH экспортирует содержимое базы данных в файлы Markdown для упрощения
Читабельность и управление версиями. Сценарии экспорта считываются из bach.db и
создайте структурированные файлы .md в каталоге data/. Дополнительно
Существует экспорт навыков для автономных пакетов.

Все скрипты находятся в инструментах/ и могут выполняться напрямую.


ОБЗОР
==========

  Скрипт создает источник (таблицы БД)
  ---------------------- ----------------------- ----------------------- ----------------------
  агенты_export.py data/AGENTS.md агенты, агент_синергии
  Chains_export.py data/CHAINS.md инструменты (bach.db)
  Partners_export.py data/PARTNERS.md Delegation_rules,
                                                    Partner_recognition
  workflows_export.py data/WORKFLOWS.mdskills/workflows/ (Сканирование)
  usecases_export.py data/USECASES.md варианты использования (bach.db)
  Skill_export.py ZIP-пакет навыки/ (файловая система)


ИНДИВИДУАЛЬНЫЕ ОПИСАНИЯ
====================

AGENTS_EXPORT
-------------
Экспортирует всех зарегистрированных агентов с синергией. Читает из
таблица агентов и агент_синергия создают форматированный обзор
с именем, типом, статусом и взаимосвязями.

  инструменты Python/agents_export.py
  Вывод: data/AGENTS.md

CHAINS_EXPORT
-------------
Экспортирует цепочки инструментов (связанные вызовы инструментов). Читает из
Таблица цепочек инструментов, показывает определение цепочки, триггеры и
История выполнения.

  инструменты Python/chains_export.py
  Вывод: data/CHAINS.md

PARTNERS_EXPORT
---------------
Экспортирует конфигурацию нескольких партнеров LLM. Читает делегирование_правил
и Partner_recognition из БД. Показывает профили партнеров, сильные стороны,
Правила делегирования и шаблоны распознавания.

  инструменты Python/partners_export.py
  Вывод: data/PARTNERS.md

WORKFLOWS_EXPORT
----------------
Сканирует навыки/рабочие процессы/ на наличие файлов рабочих процессов (.md) и создает их.
Обзор. Извлекает метаданные (заголовок, цель, шаги) с помощью регулярного выражения.
из содержимого файла.

  инструменты Python/workflows_export.py
  Вывод: data/WORKFLOWS.md

USECASES_EXPORT
---------------
Экспортирует варианты использования из таблицы вариантов использования. Показывает название сценария,
Описание, задействованные обработчики и уровень успеха.

  инструменты Python/usecases_export.py
  Вывод: data/USECASES.md

SKILL_EXPORT
------------
Экспортирует один навык в виде отдельного ZIP-пакета с
Разрешение зависимости. Копирует SKILL.md, инструменты, рабочие процессы и
создает файл требований.txt.

  инструменты Python/skill_export.py <имя навыка> [--output <path.zip>]
  Результат: ZIP-файл с полной структурой навыков

  Примечание. Для более обширного экспорта (агент, ОС) см. Exporter.py.
  и builder.txt (справочный сборщик bach).


ПРИМЕРЫ
=========

# Обновить весь экспорт БД одновременно
инструменты Python/agents_export.py
инструменты Python/chains_export.py
инструменты Python/partners_export.py
инструменты Python/workflows_export.py
инструменты Python/usecases_export.py

# Экспорт одного навыка
инструменты python/skill_export.py recherche --output recherche_v1.zip

# Проверить экспортированные файлы Markdown
ls data/*.md


ФАЙЛЫ
=======

tools/agents_export.py Экспорт агента
инструменты/chains_export.py Экспорт цепочки инструментов
инструменты/partners_export.py Экспорт партнеров
инструменты/workflows_export.py Экспорт рабочего процесса
инструменты/usecases_export.py Экспорт вариантов использования
Tools/skill_export.py Автономный экспорт навыков

data/AGENTS.md Обзор созданного агента
data/CHAINS.md Обзор сгенерированной цепочки инструментов
data/PARTNERS.md Сгенерированный обзор партнеров
data/WORKFLOWS.md Обзор созданного рабочего процесса
data/USECASES.md Обзор созданного варианта использования


СМОТРИТЕ ТАКЖЕ
==========

builder Создание и экспорт навыков/агентов (конструктор справки bach)
инструменты/экспортер Расширенный экспорт: навык, агент, os-fresh, os-reset
система дистанционного распределения
синхронизировать синхронизацию БД (Файлы -> БД, обратное направление)
