К основному содержанию
скилл CX Codex

pattern-detection · rsmdt — скилл для Claude Code: что делает и как установить

Скилл pattern-detection находит правила именования, архитектурные слои и форматы тестов в проекте. Помогает писать новый код в едином стиле кодовой базы.

MIT ★ 587 обновлён 2026-10-26

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add rsmdt/the-startup
/plugin install team@the-startup
Открыть на GitHub

Что делает pattern-detection

Скилл исследует репозиторий перед генерацией правок или код-ревью. Он проверяет стили именования, структуру каталогов, обработку ошибок, импорты и организацию тестов. Для подтверждения правила агент изучает от 3 до 5 характерных файлов каждого типа и подкрепляет выводы ссылками на конкретные строки с номерами.

При нестыковках инструмент формирует список конфликтов: показывает оба спорных примера, смотрит на свежесть коммитов и предлагает решение. Приоритет отдаётся правилам, которые уже проверяются линтерами или приняты в текущем изменяемом модуле. По одной изолированной строке скилл шаблон не объявляет.

Итоговый отчёт сортирует находки по уровню уверенности на основе частоты использования и проектных инструкций вроде CONTRIBUTING.md. Это предотвращает случайное смешивание соглашений при рефакторинге.

Какие задачи решает

  • определить принятый стиль именования файлов, переменных и функций
  • выбрать подходящую структуру каталогов и организацию импортов перед написанием модуля
  • выявить конфликты соглашений между старыми и новыми участками кода
  • составить отчёт по практикам тестирования и моков для нового компонента

Примеры запросов агенту

  • Проверь соглашения об именовании и структуре тестов в каталоге src/modules/billing перед добавлением новой логики
  • Найди архитектурные шаблоны и правила импортов в репозитории через pattern-detection
  • Определи стиль обработки ошибок в существующих сервисах и покажи примеры строк кода

Как установить pattern-detection

1Через маркетплейс плагинов

/plugin marketplace add rsmdt/the-startup
/plugin install team@the-startup

Команда ставит плагин team целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add rsmdt/the-startup --skill pattern-detection -a claude-code

3Вручную: положить файлы

~/.claude/skills/pattern-detection/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/pattern-detection/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о pattern-detection

Как установить pattern-detection в Claude Code?

Выполните в терминале агента команду /plugin marketplace add rsmdt/the-startup, а затем /plugin install team@the-startup. Также можно подключить скилл командой npx skills add rsmdt/the-startup --skill pattern-detection -a claude-code.

Что делает pattern-detection?

Анализирует исходники, тесты и конфигурации проекта, находит повторяющиеся инженерные соглашения и выдаёт отчёт со ссылками на конкретные строки.

Как скилл разрешает конфликты разных стилей?

Он сравнивает примеры из разных файлов, учитывает дату изменения кода и отдаёт предпочтение правилам, зафиксированным в настройках линтера или в целевом каталоге.

Исходный текст

SKILL.md · MIT
---
name: pattern-detection
description: Identify existing codebase patterns (naming conventions, architectural patterns, testing patterns) to maintain consistency. Use when generating code, reviewing changes, or understanding established practices.
---

## Persona

Act as a codebase pattern analyst that discovers, verifies, and documents recurring conventions across naming, architecture, testing, and code organization to ensure new code maintains consistency with established practices.

**Analysis Target**: $ARGUMENTS

## Interface

PatternCategory: NAMING | ARCHITECTURE | TESTING | ORGANIZATION | ERROR_HANDLING | CONFIGURATION

Confidence: HIGH | MEDIUM | LOW

Pattern {
  category: PatternCategory
  name: string                   // e.g., "PascalCase component files"
  description: string            // what the pattern is
  evidence: string[]             // file:line examples that demonstrate it
  confidence: Confidence
  isDocumented: boolean          // found in style guide or CONTRIBUTING.md
}

PatternReport {
  patterns: Pattern[]
  conflicts: PatternConflict[]   // where patterns are inconsistent
  recommendations: string[]      // for new code
}

PatternConflict {
  category: PatternCategory
  description: string
  exampleA: string               // file:line of pattern A
  exampleB: string               // file:line of pattern B
  recommendation: string         // which to follow and why
}

State {
  target = $ARGUMENTS
  samples = []
  patterns = []
  conflicts = []
}

## Constraints

**Always:**
- Survey at least 3-5 representative files of each type before declaring a pattern.
- Provide concrete file:line evidence for every detected pattern.
- Distinguish between intentional conventions and accidental consistency.
- Follow existing patterns even if imperfect — consistency trumps preference.
- Check tests for patterns too — test code reveals expected conventions.
- Recommend the pattern used in the specific area being modified when conflicts arise.
- When tied on conflicts, prefer the pattern with tooling enforcement.

**Never:**
- Declare a pattern from a single file occurrence.
- Assume patterns from other projects apply to this codebase.
- Introduce new patterns without acknowledging deviation from existing ones.
- Ignore conflicting patterns — always surface and recommend resolution.

## Reference Materials

- [Pattern Catalogs](reference/pattern-catalogs.md) — Naming, architecture, testing, and organization pattern catalogs with detection guidance
- [Common Patterns](examples/common-patterns.md) — Concrete examples of pattern recognition and application in real codebases

## Workflow

### 1. Survey Files

Determine scope:

match (target) {
  specific file     => survey sibling files in same directory
  directory/module  => survey representative files across subdirectories
  entire codebase   => sample from each major directory/module
}

For each scope, collect representative samples:
1. Read 3-5 files of each relevant type (source, test, config).
2. Prioritize files in the same module/feature as the target.
3. Include style guides, CONTRIBUTING.md, linter configs if present.
4. Note file ages — newer files may represent intended direction.

Read reference/pattern-catalogs.md for detection guidance.

### 2. Identify Patterns

Scan samples across each PatternCategory:

match (category) {
  NAMING => {
    File naming convention (kebab, PascalCase, snake_case)
    Function/method verb prefixes (get/fetch/retrieve)
    Variable naming (pluralization, private indicators)
    Boolean prefixes (is/has/can/should)
  }
  ARCHITECTURE => {
    Directory structure layering (MVC, Clean, Hexagonal, feature-based)
    Import direction and dependency flow
    State management approach
    Module boundary conventions
  }
  TESTING => {
    Test file placement (co-located, mirror tree, feature-based)
    Test naming style (BDD, descriptive, function-focused)
    Setup/teardown conventions
    Assertion and mock patterns
  }
  ORGANIZATION => {
    Import ordering and grouping
    Export style (default vs named)
    Comment and documentation patterns
    Code formatting conventions
  }
}

For each detected pattern, record: name, description, 2+ evidence locations, confidence level.

### 3. Verify Intentionality

For each detected pattern:
1. Check if documented in style guide or CONTRIBUTING.md.
2. Check linter/formatter configs that enforce it.
3. Count occurrences — high consistency = likely intentional.
4. Check commit history — was it introduced deliberately?

Assign confidence:

match (evidence) {
  documented + enforced by tooling  => HIGH
  consistent across 80%+ of files  => HIGH
  consistent across 50-80% of files => MEDIUM
  found in < 50% of files           => LOW — may be accidental
}

### 4. Detect Conflicts

Compare patterns within each category for inconsistencies (e.g., some files use camelCase, others use snake_case).

For each conflict:
1. Identify both variations with evidence.
2. Check date/author patterns — newer code may represent intended direction.
3. Check if one variation is in the target area being modified.
4. Recommend which pattern to follow with rationale.

### 5. Document Patterns

Produce PatternReport:
1. Confirmed patterns (HIGH confidence first).
2. Probable patterns (MEDIUM confidence).
3. Conflicts detected with resolution recommendations.
4. Recommendations for new code in the target area.

© Rudolf S. · MIT · rsmdt/the-startup

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →

Сначала — pattern-detection от других авторов.

pattern-detection akillness Скилл pattern-detection группирует повторяющиеся баги, аномалии в логах и подозрительные участки кода в один пакет проверки перед поиском причин и правок. CX Codex +1 362установок brooks-lint hyhmrright Плагин brooks-lint анализирует код и тесты на риски деградации по канонам классических книг разработки. Выдаёт оценку здоровья проекта и точные рекомендации с цитатами. ★ 1 584звёзд репо llm-artifacts-detection existential-birds Скилл llm-artifacts-detection находит типичный мусор после ИИ-кодеров: лишние слои абстракций, тесты стандартных библиотек, мёртвый код и очевидные комментарии. CX Codex +1 151установок component-common-domain-detection tech-leads-club Скилл component-common-domain-detection ищет бизнес-логику, которая повторяется в нескольких компонентах, и предлагает, что свести в общий сервис, библиотеку или один компонент. CX Codex +1 ★ 7 191звёзд репо test-smell-detection dotnet Скилл test-smell-detection для Claude Code проверяет тесты по таксономии testsmells.org и ранжирует найденные дефекты по риску. Разбирает архитектурные проблемы тестовой базы. CX Codex +1 4 400установок coding davidkiss Скилл coding для Claude Code задаёт общие правила разработки и подключается к задачам по написанию, рефакторингу и проверке кода. Он также требует проверять изменения перед завершением работы. CX Codex +1 394установок dart-use-pattern-matching dart-lang Скилл dart-use-pattern-matching для Claude Code применяет сопоставление с образцом, выражения switch и деструктуризацию Dart 3. Запускается при рефакторинге цепочек if-else и парсинге JSON. CX Codex +1 20 800установок

Из того же набора50

Весь набор →
security-assessment Скилл security-assessment для Claude, который проводит аудит безопасности: модель угроз по STRIDE, разбор кода по OWASP и находки с приоритетом и шагами исправления. CX Codex +1 ★ 587звёзд репо technical-writing Скилл technical-writing составляет архитектурные решения (ADR), системную документацию, описания API и эксплуатационные регламенты прямо в репозитории проекта. CX Codex +1 ★ 587звёзд репо refactor Скилл refactor для Claude Code анализирует выбранный код и предлагает пошаговый рефакторинг без изменения поведения. Помогает упростить структуру и сохранить бизнес-логику. CX Codex +1 ★ 587звёзд репо requirements-elicitation Скилл requirements-elicitation превращает размытые идеи в чёткие требования с приоритетами и критериями приёмки. Разбирает конфликты стейкхолдеров, выявляет реальные потребности и документирует границы проекта. CX Codex +1 ★ 587звёзд репо monitor-production Субагент monitor-production настраивает метрики, логи, трассировки, оповещения и дашборды для продакшена. Пригодится при запуске мониторинга, настройке SLO и разборе сбоев. CX Codex ★ 587звёзд репо review-compatibility Субагент review-compatibility для Claude Code, который проверяет код на breaking changes в API, базах данных и конфигах. CX Codex ★ 587звёзд репо specify-requirements Скилл specify-requirements создаёт и проверяет продуктовые требования (PRD) в файлах spec.md. Пригодится при описании пользовательских историй и критериев приёмки. CX Codex +1 ★ 587звёзд репо build-feature Субагент build-feature для Claude Code реализует функции в интерфейсе, API, сервисах и других слоях проекта. Подключается к запросам на создание или изменение кода. CX Codex ★ 587звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой