02 Install.ru

Установка

Требуется Python 3.11 или новее (проверено на 3.13.15). Ни pip install, ни сборки, ни системных пакетов.

Из репозитория

git clone https://github.com/paulmann/github-agent.git
cd github-agent

python tools/ghagent.py --version
python tools/ghagent.py selftest

selftest запускает тесты пакета и печатает selftest: PASS при коде 0. Если тесты падают — работать этой копией нельзя, нужно взять чистую.

Первый аудит

cd <ваш репозиторий>
python <путь>/github-agent/tools/ghagent.py audit .

Команда печатает оценку гигиены, список пунктов со статусом и находки с файл:строка.

Код возврата	Значение
0	блокирующих находок нет
1	есть находки уровня error
2	ошибка вызова: неверный путь, нет файла

Установка навыка агенту

python tools/ghagent.py install --profile autoclaw --write   # AutoClaw2
python tools/ghagent.py install --profile harness  --write   # HARNESS
python tools/ghagent.py install --target <каталог> --write   # SagaAI

Команда копирует пакет в каталог навыков, пишет манифест .install.json с sha256 каждого файла и печатает блок правил для AGENTS.md. Подробности — Импорт в другой агент.

Проверка установки

python tools/ghagent.py verify-install --profile autoclaw

verify.ok и код 0 означают, что установленная копия совпадает с проверенной. Любое расхождение печатается с именем файла.

Требования к окружению

Что	Требование
Python	3.11+
git	нужен для changelog suggest и wiki publish
gh CLI или GITHUB_TOKEN	нужен только для audit --repo, meta, wiki publish
Сеть	только для команд, работающих с GitHub

Остальные команды работают без сети: doc, audit ., changelog check, changelog release, wiki build, wiki verify.

Дальше

• Контракты файлов — что проверяется.
• Работа с вики — сборка и публикация.