Алғашқы инвентарь

Бұл нұсқаулықта нөлден инвентарь жасайсыз: бос 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) — skills/ каталогындағы Markdown файлы. Бір файл — бір дағды.

skills/git-commit.md файлын жасаңыз:

---
name: git-commit
description: Conventional Commits бойынша commit хабарламаларын жазады
targets:
  - claude-code
---

# Рөл

Сен commit хабарламаларын жазуға көмектесесің.

Әр сұранымда:
- 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-нің толық спецификациясы
• Репозиторий құрылымы — не және қайда сақталады
• Жылдам бастау — бірнеше машинаға синхрондаумен толық сценарий
• Жұмыс циклдары — инвентарьмен жұмыстың типтік үлгілері