claude-env-setup

Установка и обновление окружения агента

Ставит набор из этого репозитория и связанные с ним инструменты. Два сценария - чистая машина и дозагрузка на рабочей - обслуживаются одним и тем же путем: сперва опись, потом план, потом установка выбранного. Режим не спрашивается у пользователя, а выводится из описи.

Главное правило: не сломать то, что уже работает. На рабочей машине у пользователя есть свои скилы, свои правки в наших, свои MCP-серверы и запущенные сеансы. Ни один шаг не имеет права перезаписать чужое молча. Механика защиты - references/safety.md, она обязательна к прочтению перед первой записью в любой файл конфигурации.

Порядок работы

Шаг 1. Опись

Снять фактическое состояние машины. Не спрашивать пользователя о том, что можно посмотреть.

# что уже установлено из набора
ls ~/.claude/skills ~/.claude/rules ~/.claude/commands 2>/dev/null | head -50
# конфигурация MCP: два разных файла, оба важны
python -c "import json,pathlib;p=pathlib.Path.home/'.claude'/'settings.json';print(sorted(json.loads(p.read_text(encoding='utf-8')).get('mcpServers',{}))) if p.exists else print('нет settings.json')"
python -c "import json,pathlib;p=pathlib.Path.home/'.claude.json';print(sorted(json.loads(p.read_text(encoding='utf-8')).get('mcpServers',{}))) if p.exists else print('нет .claude.json')"
# что реально отвечает
docker ps --format "{{.Names}}|{{.Image}}|{{.Ports}}|{{.Status}}" 2>/dev/null
# инструменты
node --version; python --version; git --version; ffmpeg -version 2>/dev/null | head -1

Занятость портов (Windows):

foreach ($p in 8002,8003,8004,8007,8008,8009,8765,6003,1234) {
 $c = Get-NetTCPConnection -LocalPort $p -State Listen -ErrorAction SilentlyContinue | Select-Object -First 1
 if ($c) { "{0}: занят, PID {1} ({2})" -f $p, $c.OwningProcess, (Get-Process -Id $c.OwningProcess -EA SilentlyContinue).ProcessName }
 else { "$p : свободен" }
}

Критерий завершения шага: по каждому компоненту из references/components.md состояние известно - одно из: нет, есть и отвечает, есть, но не отвечает, есть, версия отличается, конфликт (порт или имя занято чужим). Компонент без определенного состояния - не "нет", а повод посмотреть внимательнее.