Первый инвентарь

В этом руководстве вы создадите инвентарь с нуля: подключите пустой Git-репозиторий, добавите первый навык и опубликуете его.

Предварительные требования

• aiman установлен (Установка)
• Git настроен
• Пустой репозиторий создан на GitHub или другом Git-хостинге

Репозиторий должен быть полностью пустым — без README, .gitignore и любых других файлов. Структуру внутри создаст AIM.

1. Подключите репозиторий

aiman init git@github.com:you/aim-loadout.git

AIM клонирует репозиторий и создаёт базовую структуру:

skills/
mcp/
aim.yaml
.gitignore

SSH-адрес требует настроенного ключа. Для публичного репозитория можно использовать HTTPS-адрес: https://github.com/you/aim-loadout.git.

2. Создайте навык

Навык (Skill Item) — это Markdown-файл в директории skills/. Один файл — один навык.

Создайте файл skills/git-commit.md:

---
name: git-commit
description: Пишет коммит-сообщения по Conventional Commits
targets:
  - claude-code
---

# Роль

Ты помогаешь писать коммит-сообщения.

При каждом запросе:
- используй формат Conventional Commits: `type(scope): message`;
- пиши на английском;
- первая строка — не длиннее 72 символов;
- если изменение нетривиальное — добавь тело с объяснением причины.

Поле name должно совпадать с именем файла без .md. Поле targets ограничивает применение конкретными AI-средами — если его не указать, навык будет применён во все обнаруженные среды. Полный список полей и допустимых значений: Формат инвентаря.

Перед первым push можно создать несколько навыков — добавьте нужные файлы в skills/, затем переходите к следующему шагу.

3. Примените локально

aiman apply

AIM прочитает содержимое skills/ и запишет навыки в конфигурационные файлы AI-сред. Изменения вступят в силу при следующем запуске агента. aiman apply не публикует ничего — изменения остаются только на вашей машине.

4. Опубликуйте

aiman push

AIM валидирует инвентарь, делает commit и отправляет его в удалённый репозиторий. Отдельные git add, git commit и git push не нужны. aiman push работает с пустым репозиторием — предварительная история Git не требуется.

Перед публикацией можно посмотреть, что изменилось:

aiman status

---

Дальше

• Формат инвентаря — полная спецификация Skill Item и MCP Item
• Структура репозитория — что и где хранится
• Быстрый старт — полный сценарий с синхронизацией на несколько машин
• Рабочие циклы — типовые паттерны работы с инвентарём