Жылдам бастау

Бірнеше минут ішінде — орнатудан инвентарьды алғаш қолдануға дейін.

Не қажет

• Git (орнатылған және бапталған)
• Кем дегенде бір қолдау көрсетілетін AI ортасы: Claude Code, Cursor немесе Codex CLI

1. aiman орнату

ОЖ-ңызға арналған нұсқауды орындаңыз: Орнату.

Орнату сәтті өткенін тексеріңіз:

aiman --version
aiman doctor

doctor анықталған AI орталарын және назар аударуды қажет ететін барлық мәселені көрсетеді. Бірдеңе дұрыс болмаса — Ақауларды жою бөлімін қараңыз.

2. Инвентарь репозиторийін дайындау

Inventory — сіздің дағдыларыңыз бен MCP серверлеріңіз сақталатын қарапайым Git репозиторийі. AIM оны оқып, мазмұнын AI орталарыңызға қолданады.

Репозиторий жоқ па? GitHub немесе басқа Git хостингінде бос репозиторий жасап, URL-ді көшіріңіз — ол келесі қадамда қажет болады. Ішкі құрылымды AIM өзі жасайды.

Дағдылары бар репозиторий бар ма? aiman init aim.yaml жасап, репозиторийді автоматты түрде жалғайды. skills/ қалтасындағы дағдылардың дұрыс frontmatter-лі жарамды Skill Item ретінде ресімделуі маңызды — әйтпесе aiman apply және aiman sync оларды өткізіп жіберіпді. Толығырақ: репозиторий құрылымы.

3. Репозиторийді жалғау

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

Мұнда git@github.com:... — SSH мекенжайы. SSH бапталған кілтті талап етеді және жеке репозиторийлер үшін міндетті. Жалпы репозиторий үшін HTTPS мекенжайын пайдалануға болады: https://github.com/you/aim-loadout.git.

--path флагын бермесеңіз, команда клондау үшін жергілікті жол ұсынады — әдепкі бойынша ағымдағы қалтадағы репозиторий атымен каталог. Ұсынылған жолды қабылдау үшін Enter басыңыз немесе басқасын енгізіңіз. Жолды алдын ала белгілеу үшін: aiman init git@github.com:you/aim-loadout.git --path ~/projects/aim-loadout.

Репозиторий бос болса, AIM негізгі құрылым жасайды:

skills/
mcp/
aim.yaml
.gitignore

Репозиторий AIM арқылы бұрын инициализацияланған болса, ол қайта жалғанып, aiman sync іске қосуды ұсынады.

4. Инвентарьды синхрондау

aiman sync

AIM Git-тен жарияланған күйді алып, дағдылар мен MCP серверлерін AI орталарыңызға қолданады. Егер MCP серверіне API кілттер немесе басқа секреттер қажет болса, AIM оларды интерактивті сұрайды — мәндер жергілікті сақталады және Git-ке түспейді.

5. Дағды жасау немесе өзгерту

Дағдыны редактордан ашыңыз:

$EDITOR skills/my-skill.md

Дағды файлының минималды форматы:

---
name: my-skill
description: Дағдының қысқаша сипаттамасы
targets:
  - claude-code
---

Дағды промптының мәтіні — AI агентіне арналған рөл, міндет немесе нұсқаулар.

name .md жоқ файл атымен сәйкес болуы керек. targets өрісі міндетті емес — онсыз дағды барлық анықталған AI орталарына қолданылады. Толық формат: Инвентарь форматы.

Жариялаусыз өзгерістерді жергілікті қолдану:

aiman apply

Дағдыны AI ортасында тексеріңіз. Өзгерістердің тиімді болуы үшін агент сессиясын қайта іске қосу қажет болуы мүмкін — AI орталарының көпшілігі дағдыларды іске қосылу кезінде оқиды. edit → apply → қайта іске қосу циклін дайын болғанша қайталаңыз.

6. Жариялау

aiman status   # жарияланбаған өзгерістерді көрсетеді
aiman push     # валидациялайды, commit жасайды және қашықтағы репозиторийге жібереді

7. Басқа машинаны синхрондау

Жаңа машинада aiman орнатыңыз, содан кейін:

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

Жарияланған дағдылар мен MCP серверлері sync кейін бірден қолданылады.

---

Одан әрі

• Концепциялар — инвентарь, дағдылар және адаптерлер дегеніміз не
• Жұмыс циклдары — типтік сценарийлер
• Репозиторий құрылымы — инвентарьдың толық форматы
• CLI анықтамалығы — барлық командалар