system-design · qodex-ai — скилл для Claude Code: что делает и как установить
Скилл system-design задаёт правила чистой архитектуры и DDD для агента. Помогает проектировать модули и пресекает создание самодельных велосипедов.
LicenseRef-Proprietary 218 установок ★ 50 обновлён 2026-01-05
npx skills add qodex-ai/ai-agent-skills --skill system-design -a claude-codeЧто делает system-design
Скилл инструктирует помощника проектировать программы по канонам Clean Architecture и предметно-ориентированного проектирования (DDD). Правила запрещают смешивать интерфейс с прикладными сценариями и писать запросы к базе прямо внутри контроллеров. Вместо универсальных папок utils и сброса разрозненных функций в helpers.js агент обязан давать классам и модулям предметные имена вроде OrderCalculator.
В основу заложен подход library-first. Перед написанием своего кода модель обязана искать готовые пакеты в npm или сторонние сервисы, например готовые инструменты повторных вызовов вместо рукотворных таймеров. Свой код разрешается писать только для специфичной логики предметной области или критичных по скорости участков.
Инструкции ограничивают размер сущностей: функции длиннее 80 строк дробятся, а файлы свыше 200 строк разносятся по отдельным модулям. Вложенность условий ограничена тремя уровнями. Лицензия у скилла проприетарная.
Какие задачи решает
- разделить бизнес-логику и работу с базой данных
- запретить свалку функций в общих файлах
utils - заменить самописные утилиты готовыми библиотеками из npm
- разбить длинные компоненты и файлы свыше 200 строк
Примеры запросов агенту
- Спроектируй сервис оформления заказов по правилам предметно-ориентированной архитектуры.
- Проверь модуль авторизации и убери лишний самописный код в пользу npm-пакетов.
- Разбей контроллер платежей на отдельные доменные сущности и юзкейсы.
Как установить system-design
1Через Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill system-design -a claude-code2Вручную: положить файлы
~/.claude/skills/system-design/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/system-design/
1Через Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill system-design -a codex2Вручную: положить файлы
.agents/skills/system-design/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill system-design -a cursor2Вручную: положить файлы
.cursor/skills/system-design/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install qodex-ai/ai-agent-skills skills/system-design2Вручную: положить файлы
.github/skills/system-design/SKILL.md1Через Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill system-design -a gemini-cli2Командой платформы
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/system-designВручную: положить файлы
.devin/skills/system-design/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill system-design -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о system-design
Как установить system-design в Claude Code?
Выполните команду npx skills add qodex-ai/ai-agent-skills --skill system-design -a claude-code. Конфигурация сохранится по пути ~/.claude/skills/system-design/SKILL.md.
Что делает скилл system-design?
Он заставляет агента применять паттерны Clean Architecture и DDD, ограничивать длину файлов 200 строками и брать готовые пакеты вместо написания велосипедов.
Когда скилл разрешает писать собственный код вместо библиотек?
Собственная реализация допускается для правил конкретной предметной области, узких мест производительности, задач повышенной безопасности или если внешние решения не подошли после проверки.
Похожие скиллы
Все скиллы по теме «Бэкенд и API» →Сначала — system-design от других авторов.