Ақауларды жою

Жалпы күйді тексеру

aiman status
aiman doctor

status «не өзгерді және не жарияланды» деген сұраққа жауап береді. doctor «жергілікті машина инвентарьды қолдануға дайын ба» деген сұраққа жауап береді.

AI ортасы табылмады

Симптом:

environment codex not found

Не жасау керек:

1. AI-құрал орнатылғанын тексеріңіз.
2. Ортаның стандартты каталогын тексеріңіз.
3. Жол стандартты емес болса, aim.local.yaml-да белгілеңіз.

environments:
  codex: ~/.codex

aiman sync файл қақтығысы қатесімен тоқтайды

sync тек skills/ немесе mcp/ папкасындағы бақылаусыз файл remote-тағы файлмен атауы сәйкес келгенде блокталады. Атауы сәйкес келмейтін бақылаусыз файлдарға sync тиіспейді.

Қақтығыс болса, sync тоқтайды және проблемалық файлдар тізімін шығарады.

Мүмкін іс-қимылдар:

• қақтығысатын файлды жариялау:

aiman push
aiman sync

• файлды қолмен қайта атау немесе жылжыту;
• қақтығысатын файлдарды жойып жарияланған күйді қолдану:

aiman sync --force

Назар аударыңыз: sync --force атауы сәйкес келген файлдарды біржола жояды.

Қашықтағы репозиторий жергілікті күйден жаңа

Егер push қашықтағы репозиторий алға кеткенін хабарласа, алдымен жарияланған күйді қолданыңыз:

aiman sync

Одан кейін жергілікті өзгерістерді қайталаңыз немесе ағымдағы күйді жариялаңыз.

Міндетті MCP env айнымалысы белгіленбеген

Симптом:

required env variable API_KEY is missing

aiman sync іске қосыңыз — AIM мәнді интерактивті сұрайды. Немесе мәнді aim.local.yaml-да тікелей белгілеңіз:

mcp_env:
  context7:
    API_KEY: "..."

aim.local.yaml-ды commit жасамаңыз.

Жарамсыз Skill немесе MCP Item

Тексеріңіз:

• файл атауы name-мен сәйкес келеді;
• Skill-де frontmatter-дан кейін бос емес дене бар;
• MCP Item-де name, description, command, args, targets, env бар;
• YAML жарамды.

Форматтар Инвентарь форматында сипатталған.

Қашықтағы репозиторийге қол жоқ

Тексеріңіз:

• SSH кілті немесе HTTPS аутентификациясы;
• репозиторийге қол жеткізу құқықтары;
• origin remote бар екені;
• желілік қосылым.

Git тарихы айырылып кетті

AIM пайдаланушы үшін merge орындауды әдейі жасамайды.

Тарих айырылып кетсе, стандартты Git командаларымен репозиторийді қолмен қалпына келтіріңіз, содан кейін қайталаңыз:

aiman status
aiman sync