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

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

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

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 --dry-run

Қолдау көрсетілетін көздер: 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 --dry-run

Барлық үш 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 басқарылатын файлдардың күйін көрсетеді. push инвентарьды валидациялайды, commit жасайды және оны қашықтағы репозиторийге жібереді.

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 орталарына қолданады.

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

sync жергілікті өзгерістер жоғалуы мүмкін болса бұғатталады.

aiman sync
# error: local changes detected ...

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

• aiman push арқылы өзгерістерді жариялау;
• жергілікті өзгерістерді қолмен сақтау немесе жою;
• жергілікті өзгерістерді жоғалтуға болса aiman sync --force пайдалану.

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

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> --dry-run
AI ортасынан MCP серверін импорттау	aiman import mcp <name> --from <env>
Жазбасыз MCP дескрипторын тексеру	aiman import mcp <name> --from <env> --dry-run
Жариялаусыз жергілікті дағдыны тексеру	aiman apply
Нені өзгерткенді қарау	aiman status
Дайын инвентарьды жариялау	aiman push
Жарияланған инвентарьды машинаға қолдану	aiman sync
Ортаны және конфигтерді тексеру	aiman doctor