1c-ai-agent-cli

1c-ai-agent CLI — 1c-ai-agent-cli.py

Правила работы с CLI 1C BSL Agent Framework. Команды: clone (получение репозитория) и install (установка компонентов в проект).

Команда clone — получение фреймворка

Репозиторий: https://github.com/SteelMorgan/1c-agent-based-dev-framework

Требование: Git должен быть установлен.

Базовое клонирование

python tools/1c-ai-agent-cli.py clone

Клонирует в ./1c-agent-based-dev-framework (текущая директория).

С указанием целевой директории

python tools/1c-ai-agent-cli.py clone -t ./my-framework
python tools/1c-ai-agent-cli.py clone --target /path/to/dir

Shallow clone (быстрее, только последний коммит)

python tools/1c-ai-agent-cli.py clone --depth 1

Конкретная ветка

python tools/1c-ai-agent-cli.py clone -b agent-framework-bootstrap-20260211

Клонирование + установка

python tools/1c-ai-agent-cli.py clone -t ./fw --install

После клонирования автоматически запускается установщик в интерактивном режиме.

Справка по clone

python tools/1c-ai-agent-cli.py clone --help

Альтернатива: ручное клонирование

Если CLI недоступен (например, первый запуск):

git clone https://github.com/SteelMorgan/1c-agent-based-dev-framework.git
cd 1c-agent-based-dev-framework
python tools/1c-ai-agent-cli.py

ZIP (без git): скачать архив с GitHub и распаковать.

Команда install — установка компонентов

Интерактивный установщик компонентов фреймворка в проект, с учётом целевой IDE.

Запуск: из корня репозитория фреймворка (или после clone):

python tools/1c-ai-agent-cli.py [опции]
python tools/1c-ai-agent-cli.py install [опции]   # явно

Базовый вызов

Поддерживаемые IDE

--ide принимает одно или несколько значений через пробел (установка сразу в несколько IDE):

python tools/1c-ai-agent-cli.py --ide claude-code codex --all

⚠ IDE с ручным импортом правил (claude-code, codex, kilocode): после установки инсталлер выведет напоминание с конкретными строками для добавления в CLAUDE.md / AGENTS.md.

Флаги

Требования

• Python 3.7+
• Без внешних зависимостей (стандартная библиотека)

Когда применять

Сценарии

Сценарий 1: Первый запуск фреймворка

Вариант A (есть Git, с нуля):

git clone https://github.com/SteelMorgan/1c-agent-based-dev-framework.git
cd 1c-agent-based-dev-framework
python tools/1c-ai-agent-cli.py   # интерактивно, или python tools/1c-ai-agent-cli.py --ide cursor --all

Вариант B (уже есть репозиторий, клонировать в другой каталог):

cd 1c-agent-based-dev-framework
python tools/1c-ai-agent-cli.py clone -t ../другой-проект/fw --install

Вариант C (установка в текущий проект):

python tools/1c-ai-agent-cli.py --ide cursor --all

Сценарий 2: Установка в существующий проект

1. Клонировать фреймворк в отдельную папку (или использовать уже существующую).
2. Указать целевой проект: python tools/1c-ai-agent-cli.py --ide cursor --project-dir /path/to/project --include agent/developer workflow/full-cycle
3. При необходимости: --dry-run для проверки.

Сценарий 3: Восстановление симлинков

После перемещения фреймворка в другое место:

cd /path/to/project
python /path/to/framework/tools/1c-ai-agent-cli.py --relink

См. также

• agent-development — создание агентов
• skill-creator — создание навыков

depends_on: [] metadata: category: framework-meta version: "1.0"