software-design-principles — скилл для Claude Code: как установить
Инженерный канон в формате Markdown для архитектурного ревью, планирования рефакторинга и проверки зависимостей. Помогает согласовать слои кода и зоны ответственности перед слиянием PR.
npx skills add databricks-solutions/consort --skill software-design-principles -a claude-codeЧто делает software-design-principles
Скилл не содержит программного кода или исполняемых сценариев. Это структурированный свод правил для ассистента и инженера. Документ регламентирует принципы SOLID и направление зависимостей.
Перед слиянием изменений скилл требует заполнить таблицу зон ответственности. Она распределяет авторизацию и бизнес-логику по уровням приложения. Внешние тесты запрещено ломать при внутреннем рефакторинге. При изменении схемы базы данных удаление полей обязано происходить синхронно в миграциях и моделях ORM.
Скилл опирается исключительно на текстовые инструкции. Поэтому контроль за соблюдением архитектурных границ ложится на участников ревью.
Какие задачи решает
- разграничить сквозную функциональность по слоям архитектуры
- проверить направление зависимостей модулей перед слиянием PR
- синхронизировать удаление полей в миграциях и коде моделей
- отделить устаревшие тесты от случайных регрессий при рефакторинге
Примеры запросов агенту
- Проверь этот пуллреквест по правилам software-design-principles и заполни матрицу ответственности
- Спланируй рефакторинг сервиса авторизации так, чтобы зависимости шли строго внутрь
- Помоги убрать устаревшее поле из базы и моделей по правилу expand/contract
Как установить software-design-principles
1Через Skills CLI (Vercel)
npx skills add databricks-solutions/consort --skill software-design-principles -a claude-code2Вручную: положить файлы
~/.claude/skills/software-design-principles/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/software-design-principles/
1Через Skills CLI (Vercel)
npx skills add databricks-solutions/consort --skill software-design-principles -a codex2Вручную: положить файлы
.agents/skills/software-design-principles/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add databricks-solutions/consort --skill software-design-principles -a cursor2Вручную: положить файлы
.cursor/skills/software-design-principles/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install databricks-solutions/consort software-design-principles2Вручную: положить файлы
.github/skills/software-design-principles/SKILL.md1Через Skills CLI (Vercel)
npx skills add databricks-solutions/consort --skill software-design-principles -a gemini-cli2Командой платформы
gemini skills install https://github.com/databricks-solutions/consort --path skills/software-design-principlesВручную: положить файлы
.devin/skills/software-design-principles/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add databricks-solutions/consort --skill software-design-principles -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о software-design-principles
Как установить software-design-principles в Claude Code?
Выполните команду npx skills add databricks-solutions/consort --skill software-design-principles -a claude-code. Файл навыка появится по пути ~/.claude/skills/software-design-principles/SKILL.md.
Что делает скилл software-design-principles?
Скилл фиксирует инженерные правила: изоляцию слоёв, практику рефакторинга и разметку сквозных задач. Агент считывает эти рекомендации во время проектирования модулей и ревью кода.
Содержит ли software-design-principles исполняемые скрипты?
Нет, репозиторий включает только текстовые Markdown-файлы. Инструмент не запускает команды автоматически, а служит архитектурным ориентиром в диалоге.
