代理技能、指南和工具，教授 AI 编码代理 Jmix 特定的模式、强制规则及使用 Jmix 框架开发应用的最佳实践。

仓库结构

每个Jmix主版本都存在于其独立分支上：Jmix 2的v2，Jmix 3的v3，依此类推。默认分支是当前稳定的主版本。分支的content/文件夹包含：

• guidelines-block.md：一个短块，由 / 标记界定，安装程序将其合并到项目的代理指南文件中。它指向代理的jmix技能。
• skills/：每个技能一个文件夹，每个文件夹包含SKILL.md（针对特定Jmix功能的说明和规则），并可选包含示例或其他材料的子文件夹。

工作室装置

最简单的方法是 Jmix Studio 3.0+：在 Jmix 工具窗口的 设置菜单中运行 AI 代理工具包操作，然后按照向导操作。

快速CLI安装

一个命令启动一个交互向导，包含三个步骤：安装技能、添加指南，以及注册 JetBrains、Context7 和 Playwright MCP 服务器。

macOS / Linux：

Windows （PowerShell 5+）:

Jmix Agent Toolkit

Agent skills, guidelines and tools that teach AI coding agents the Jmix-specific patterns, mandatory rules and best practices for developing applications with the Jmix framework.

Repository Structure

Each Jmix major version lives on its own branch: v2 for Jmix 2, v3 for Jmix 3, and so on. The default branch is the current stable major. A branch’s content/ folder holds:

• guidelines-block.md: a short block, delimited by / markers, that the installer merges into the project’s agent guidelines file. It points the agent at the jmix skill.
• skills/: one folder per skill, each with a SKILL.md (instructions and rules for a specific Jmix feature) and optional subfolders with examples or other materials.

Studio Installation

The simplest way is Jmix Studio 3.0+: run the AI Agents Toolkit action from the Settings menu of the Jmix tool window and follow the wizard.

Quick CLI Installation

One command starts an interactive wizard with three steps: installing skills, adding guidelines, and registering the JetBrains, Context7 and Playwright MCP servers.

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/jmix-framework/jmix-agent-toolkit/v3/install.sh | bash

Windows (PowerShell 5+):

Invoke-RestMethod https://raw.githubusercontent.com/jmix-framework/jmix-agent-toolkit/v3/install.ps1 | Invoke-Expression

If the execution policy blocks the script, bypass it:

powershell -NoProfile -ExecutionPolicy Bypass -Command "Invoke-RestMethod 'https://raw.githubusercontent.com/jmix-framework/jmix-agent-toolkit/v3/install.ps1' | Invoke-Expression"

If powershell.exe itself is blocked by a corporate policy (CreateProcess error=5, Access is denied), use PowerShell 7 (pwsh):

pwsh -NoProfile -ExecutionPolicy Bypass -Command "Invoke-RestMethod 'https://raw.githubusercontent.com/jmix-framework/jmix-agent-toolkit/v3/install.ps1' | Invoke-Expression"

Non-Interactive Subcommands

Each runs one step without the wizard. CSV is a comma-separated list (e.g. claude,codex) or a single value.

install.sh skills     [--scope global|local] [--claude=false]
install.sh agents-md  [--claude=false]
install.sh mcp        --servers CSV --agents CSV [--scope local|global] [--context7-key KEY]
install.sh mcp-jetbrains | mcp-context7 | playwright --agents CSV [--scope local|global]
                                     # mcp-context7 also takes [--context7-key KEY]

Piped from curl, pass the subcommand after bash -s --:

curl -fsSL https://raw.githubusercontent.com/jmix-framework/jmix-agent-toolkit/v3/install.sh | bash -s -- mcp --servers jetbrains,playwright --agents claude,codex