Configuration scopes
Сводная таблица, где физически хранится каждая настройка WorkAI — правила, скиллы, custom agents, MCP и разрешения — на уровне проекта и на уровне пользователя.
У большинства механизмов настройки WorkAI два уровня: проектный (лежит в репозитории, действует только в нём) и личный (лежит в домашней папке, действует во всех проектах). Ниже — сводная таблица, чтобы быстро найти, где физически лежит конкретная настройка, не открывая отдельную страницу про каждый механизм.
Таблица путей
| Что | Проект | Личное |
|---|---|---|
| Rules | .workai/rules/*.md (совместимость: .cursor/rules/*.mdc|.md) | ~/.workai/rules/*.md |
| Skills | .agents/skills, .github/skills, .claude/skills, .cursor/skills | ~/.agents/skills, ~/.copilot/skills, ~/.claude/skills, ~/.cursor/skills |
| Custom agents | .github/agents, .claude/agents | ~/.copilot/agents, ~/.claude/agents |
| MCP | .workai/mcp.json (ключ mcpServers) | ~/.workai/mcp.json (совместимость: ~/.cursor/mcp.json, .cursor/mcp.json) |
| Permissions | ключи в settings.json (chat.tools.*.autoApprove) | то же, на уровне User settings |
Пояснения по строкам
Rules. Личные правила действуют во всех ваших проектах, проектные — только в текущем и, если закоммичены, доступны команде. WorkAI дополнительно распознаёт формат Cursor — файлы .mdc и обычные .md в .cursor/rules. Подробности — на странице /docs/rules.
Skills. Ищутся сразу по нескольким путям — своим и путям других экосистем (GitHub, Claude, Cursor), проектным и личным одновременно. Подробности — /docs/skills.
Custom agents. Файлы .agent.md с собственным промптом и набором инструментов, которые можно выбрать явно или которым агент делегирует часть работы как субагенту. Подробности и различие с субагентами — /docs/custom-agents.
MCP. Свой формат WorkAI (ключ mcpServers) существует параллельно с форматом VS Code (mcp.json с ключом servers); для совместимости читается и .cursor/mcp.json. Подробности — /docs/mcp.
Permissions. В отличие от остальных строк, это не отдельный файл — обычные ключи внутри settings.json, проектного или личного. Есть и третий, самый узкий уровень — разрешение «в этом чате», которое не персистится и живёт только до конца текущего диалога. Подробности — /docs/agent/security/run-modes.
Личное и проектное складываются, а не заменяют друг друга
По каждой строке таблицы WorkAI собирает настройки из личного и проектного пути одновременно, а не выбирает один вместо другого: правила, скиллы, custom agents и MCP-серверы из обоих уровней доступны агенту сразу. Подробное поведение при совпадении имён — на странице конкретного механизма.