Жұмыс циклдары

Файлдан дағды қосу

Дайын дағдыны инвентарьға қосу үшін:

aiman add skill path/to/skill.md

Егер осындай атаулы файл инвентарьда басқа мазмұнмен бұрыннан болса:

aiman add skill path/to/skill.md --overwrite    # қайта жазу
aiman add skill path/to/skill.md --name new-name  # басқа атаумен сақтау

Stdin-нен:

cat skill.md | aiman add skill -

Қосқаннан кейін өзгерісті жариялау үшін aiman push іске қосыңыз.

Файлдан MCP сервері қосу

MCP сервері конфигурациясын инвентарьға қосу үшін:

aiman add mcp path/to/server.yaml

Егер осындай атаулы файл инвентарьда басқа мазмұнмен бұрыннан болса:

aiman add mcp path/to/server.yaml --overwrite    # қайта жазу
aiman add mcp path/to/server.yaml --name new-name  # басқа атаумен сақтау

Stdin-нен:

cat server.yaml | aiman add mcp -

Кіріс файлда env блогінде value өрістері болса, AIM оларды автоматты түрде aim.local.yaml-ға жылжытады және mcp/<name>.yaml-ға жазбайды. Бұл секреттердің Git-ке түспейтінін қамтамасыз етеді.

Қосқаннан кейін өзгерісті жариялау үшін aiman push іске қосыңыз.

AI ортасынан дағдыны импорттау

Дағды AI орталарының бірінде орнатылып қойған болса, оны тікелей импорттауға болады:

aiman import skill hello --from claude-code
aiman import skill review-code --from codex

Жазбасыз мазмұнды қарау:

aiman import skill hello --from claude-code --print

Қолдау көрсетілетін көздер: claude-code, cursor, codex.

Cursor дағдыларды нативті сақтамайды — --from cursor әрдайым бос нәтиже қайтарады.

Қосқаннан кейін өзгерісті жариялау үшін aiman push іске қосыңыз.

AI ортасынан MCP серверін импорттау

MCP сервері AI орталарының бірінде бұрыннан бапталған болса, оны тікелей импорттауға болады:

aiman import mcp context7 --from claude-code
aiman import mcp jira --from cursor

Жазбасыз мазмұнды қарау:

aiman import mcp context7 --from claude-code --print

Барлық үш AI ортасын нысана ретінде импорттау және орнату:

aiman import mcp context7 --from claude-code --targets all

Қолдау көрсетілетін көздер: claude-code, cursor, codex.

AIM көрсетілген ортаның тірі конфигурациясын оқиды, MCP сервер дескрипторын шығарады және env-strip қолданады: env айнымалыларының нақты мәндері aim.local.yaml-ға жазылады, инвентарьға және Git-ке тек секретсіз дескрипторлар түседі.

Егер инвентарьда осы атаумен сервер басқа мазмұнмен бұрыннан болса, команда қатемен аяқталады. Қайта жазу үшін --overwrite пайдаланыңыз:

aiman import mcp context7 --from claude-code --overwrite

Қосқаннан кейін өзгерісті жариялау үшін aiman push іске қосыңыз.

Жергілікті итерация: edit -> apply -> test

Жариялауға дейін өзгерісті тексергіңіз келсе aiman apply пайдаланыңыз.

$EDITOR skills/review-code.md
aiman apply

apply не жасайды:

• жергілікті skills/ мен mcp/ оқиды;
• элементтерді валидациялайды;
• жарамды элементтерді анықталған AI орталарына қолданады;
• commit жасамайды;
• remote-қа жүгінбейді;
• published_hash пен synced_hash-ті жаңартпайды.

Бұл цикл дағдылар әзірлеуге арналған: өңдеу, қолдану, AI-құралда тексеру, қайта өңдеу. AI орталарының көпшілігі дағдыларды сессия іске қосылуы кезінде оқиды — aiman apply кейін өзгерістердің тиімді болуы үшін агент сессиясын қайта іске қосыңыз.

Жариялау: status -> push

Жергілікті өзгеріс дайын болғанда:

aiman status
aiman push

status origin/main-ге қатысты репозиторий позициясын, AI орталарының күйін және skills/ мен mcp/-дегі өзгерістер тізімін көрсетеді.

status — желілік команда: позицияны есептеу алдында Git fetch орындайды, сондықтан позиция ескірген жергілікті ref-ті емес, remote-тың нақты күйін береді. Fetch-ке кеткен қысқа кідіріс — күтілетін мінез-құлық. git status-тан айырмашылығы туралы — Концепцияларда.

TODO: fetch кезінде спиннер қосу

Жарияланбаған өзгерістер болғандағы шығару мысалы:

Repository:   git@github.com:you/aim-loadout.git
Position:     2 commits ahead of origin/main
Environments: needs sync (2 commits not applied)

Changes not yet published (origin/main → working tree):
  A skills/new-skill.md
  M skills/existing.md

  run aiman push to publish

push инвентарьды валидациялайды, commit жасайды және оны қашықтағы репозиторийге жібереді. Жарияланғаннан кейін жарияланған өзгерістердің құрамын көрсетеді:

published: 96e091b · 19 skills, 1 MCP server
  M skills/review-code.md
  A mcp/jira.yaml

push --dry-run Git-ке жазбастан жариялау жоспарын көрсетеді:

aiman push --dry-run

Басқа машинаға тасымалдау: init -> sync

Жаңа машинада:

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

sync Git fetch орындайды, тарихты тексереді, жарияланған күйді алады және оны жергілікті AI орталарына қолданады. Қолданғаннан кейін алынған өзгерістердің құрамын көрсетеді:

synced: 67451fc · 21 skills, 1 MCP server → 3 environments
  M skills/commit-message.md
  A skills/refactor-helper.md

Нәтиже жолындағы санауыштар — операция көлемі (барлығы қолданылды), ал төмендегі блок — өзгерістер құрамы. Remote-тан ештеңе келмесе, блок басылмайды.

Өзгерістерді жоғалудан қорғау

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

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

aiman sync
# error: untracked file conflicts with remote: skills/my-skill.md

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

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

aiman push
aiman sync

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

aiman sync --force

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

--force файлдарды үнсіз жоймайды: күй қолданылмас бұрын AIM не жойғанын тізімдейді:

discarded untracked files (--force):
  skills/draft.md
  mcp/local-only.yaml
synced: 67451fc · 21 skills, 1 MCP server → 3 environments

Тарих күйлері

Fetch кейін AIM бірнеше жағдайды ажыратады:

Күй	Мінез-құлық
Жергілікті remote-қа тең	reset-сіз инвентарьды қолдану
Жергілікті remote-тан қалып жатыр	fast-forward reset және қолдану
Жергіліктіде жарияланбаған commit-тер бар	тоқтап, aiman push сұрау
Тарих айырылып кетті	тоқтап, Git-ті қолмен қалпына келтіруді сұрау

Қай команданы қашан пайдалану

Міндет	Команда
Файлдан дағды қосу	aiman add skill <file>
Файлдан MCP сервері қосу	aiman add mcp <file>
AI ортасынан дағды импорттау	aiman import skill <name> --from <env>
Жазбасыз дағды мазмұнын тексеру	aiman import skill <name> --from <env> --print
AI ортасынан MCP серверін импорттау	aiman import mcp <name> --from <env>
Жазбасыз MCP дескрипторын тексеру	aiman import mcp <name> --from <env> --print
Жариялаусыз жергілікті дағдыны тексеру	aiman apply
Нені өзгерткенді қарау	aiman status
Дайын инвентарьды жариялау	aiman push
Жарияланған инвентарьды машинаға қолдану	aiman sync
Ортаны және конфигтерді тексеру	aiman doctor