Skip to content

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

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

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

AI ортасыTarget IDӘдепкі base dirДағдыларMCP config
Claude Codeclaude-code~/.claudeskills/<name>/SKILL.md~/.claude.json
Cursorcursor~/.cursorskills/<name>/SKILL.mdmcp.json
Codex CLIcodex~/.codexskills/<name>/SKILL.mdconfig.toml

Claude Code ​

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

json
{
  "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 пайдаланады:

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 белгілеңіз:

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

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

Released under the Apache 2.0 License.