Адаптерлер анықтамалығы

Адаптер нақты AI ортасының форматын инкапсуляциялайды.

Жиынтық кесте

AI ортасы	Target ID	Әдепкі base dir	Дағдылар	MCP config
Claude Code	claude-code	~/.claude	skills/<name>/SKILL.md	~/.claude.json
Cursor	cursor	~/.cursor	skills/<name>/SKILL.md	mcp.json
Codex CLI	codex	~/.codex	skills/<name>/SKILL.md	config.toml

Claude Code

MCP сервері ~/.claude.json-ға, mcpServers JSON бөліміне жазылады — бұл Claude Code MCP серверлерінің анықтамаларын оқитын файл (settings.json емес: онда тек allowedMcpServers сияқты саясаттар):

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "env": {
        "API_KEY": "..."
      }
    }
  }
}

Cursor

Cursor mcp.json-да mcpServers JSON форматын пайдаланады.

Жазба құрылымы Claude Code-тікімен бірдей.

Cursor ~/.cursor/mcp.json файлын кез келген сервер конфигурацияланғанға дейін бос файл ретінде жасауы мүмкін. AIM бос конфиг файлын бос объект {} ретінде қарастырады — MCP серверлерін орнату дұрыс жалғасады.

Codex CLI

Codex CLI TOML пайдаланады:

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

[mcp_servers.context7.env]
API_KEY = "..."

Импорт кезінде ортаны оқу

Адаптер тек ортаға жазып қана қоймайды, aiman import skill және aiman import mcp кезінде оны оқи да алады.

AI ортасы	Дағдылар қайдан оқылады	MCP конфигурациясы қайдан оқылады
Claude Code	~/.claude/skills/<name>/SKILL.md және жалпақ ~/.claude/skills/*.md (жалпақ файл басым)	~/.claude.json, содан кейін онда жоқ атаулар үшін ~/.claude/settings.json
Cursor	~/.cursor/skills/<name>/SKILL.md	~/.cursor/mcp.json
Codex CLI	~/.codex/skills/<name>/SKILL.md	~/.codex/config.toml

Тек stdio-серверлер импортталады — command берілгендер. "type": "http", "type": "sse" немесе жалаң "url" арқылы жарияланған жазбаларды адаптер инвентарьға бермейді: мұндай сервер үшін aiman import mcp <name> себебін атайтын қатемен аяқталады (CLI анықтамалығы).

Элементтерді ортадан жою

Адаптер элементтерді орнатып қана қоймайды, оларды жоя да алады. Жою тек aiman apply --loadout <name> командасымен және тек инвентарьға белгілі элементтер үшін орындалады (CLI анықтамалығы).

Не жойылады	Қалай
Дағды	<base dir>/skills/<name>/ каталогы анықтамалық файлдарымен бірге тұтасымен жойылады
MCP сервері	орта конфигурациясынан тек осы сервердің жазбасы алынады; қалған жазбалар мен файлдың өзі сақталады

Claude Code үшін жазба ~/.claude.json файлынан жойылады — ол қай файлға орнатылса, сол файлдан. Жазба да, файл да болмаса, жою қатесіз өтеді.

Жолдарды қайта анықтау

Орта стандартты емес жолда орнатылса, aim.local.yaml-да base dir белгілеңіз:

environments:
  claude-code: /custom/path/.claude

Адаптер base dir ішінде дағдылар мен MCP config қайда екенін өзі біледі.