03 Install.ru

Установка

Один установщик, три рантайма и одно честное правило: шаг, который может сделать только человек, записан как шаг человека, а не как «агент сделал».

git clone https://github.com/paulmann/agent-prompt-kit.git
cd agent-prompt-kit
python tools/install.py --runtime autoclaw2 --check    # ничего не пишет, сообщает состояние
python tools/install.py --runtime autoclaw2 --write    # ставит навык и команду

Зависимостей, кроме стандартной библиотеки Python, нет.

Что делают два вызова

Вызов	Действие
--check	осматривает каталог навыка, файл команды и манифест ресурсов рантайма; печатает ревизию, число навыков и команд, разрешённые пути и вердикт
--write	копирует навык и записывает файл команды, сохраняя заменяемое в резервную копию
--runtime harness	создаёт каталог workspace для HARNESS вместо профиля AutoClaw2
--runtime sagai	отказывается: путь регистрации не измерен, и установщик не угадывает

Вердикт READY означает, что файлы есть и манифест их содержит. Важна вторая половина: файл, не попавший в ревизию ресурсов, для модели невидим.

По рантаймам

Рантайм	Команда	Что делает модель	Что делает человек
AutoClaw2	/agent-prompt-kit	пишет каталог навыка и файл команды в профиль	перезагружает, чтобы снимок ресурсов пересобрался
HARNESS	/agent-prompt-kit	создаёт весь каталог workspace с файлами	один клик: добавить каталог как workspace
SagaAI	—	вставляет тело PROMPT.ru.md как рабочий договор	то, что требует этот рантайм

Две замеренные детали, обе легко упустить:

• Снимок ресурсов фиксируется на старте сессии. После --write команда появится в палитре только в новой сессии (или после перезагрузки). В сессии, где вы установили, её нет — это не провал установки.
• Клик в HARNESS остаётся открытым после успешной установки. Установщик может создать каталог; зарегистрировать его может только приложение. То же с сохранённым агентом: агент, существующий как файлы и не зарегистрированный, — не окружение (M10, шаг 4; проверка 12 ворот).

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

python tools/install.py --runtime autoclaw2 --check    # ожидается READY (autoclaw2)

Затем в новой сессии:

1. команда /agent-prompt-kit есть в списке;
2. просьба «напиши карточку задачи для этого запроса» выдаёт карточку, а не описание карточек;
3. ответ на любую небольшую задачу заканчивается строкой ворот.

Если третий пункт не выполняется, установка в порядке, а промпт не загружен. Исправлять нужно второе, а не первое.

Ловушки

Ловушка	Симптом	Действие
установка в не тот профиль	--check говорит READY, команды нет	посмотреть разрешённый каталог навыка, который печатает --check
ожидание команды в той же сессии	палитра не изменилась сразу после --write	начать новую сессию
--write принят за регистрацию	файлы есть, ничего не видно	--check должен сказать READY, а не просто «записано»
установка для второго рантайма вручную	две расходящиеся копии навыка	запустить установщик для этого рантайма и отдать файлы ему
правка установленного навыка руками	репозиторий и профиль расходятся молча	править репозиторий, переустановить, перепроверить
предположение, что SagaAI устроен как остальные	каталог появился, регистрации нет	вставить промпт в поле системного промпта как договор

Удаление

Удалите каталог навыка и файл команды, которые назвал --check, затем перезагрузите. Больше на машине ничего не затрагивается: установщик пишет только в выбранный профиль рантайма.

Дальше: Окружение — та часть, которая превращает установку в более дешёвую повторную работу.