claude-dev-skill

Что такое claude-dev-skill?

claude-dev-skill — пользовательский навык для Claude Code, который превращает Claude в «техлида» для разработки ПО с несколькими AI-агентами-работниками. Навык обеспечивает структурированный многофазный workflow, координирующий параллельную работу в изолированных worktree, чтобы минимизировать потерю контекста и конфликты слияния путём маршрутизации изменений через PR и ревью.

Его основная цель — выйти за рамки однонитевой генерации кода: он направляет согласование требований (PRD), архитектурные решения, декомпозицию задач, параллельную реализацию, статические проверки QA и структурированный шаг ревью/слияния PR.

Ключевые возможности

• Командный workflow /dev (многофазный SOP): Начинается с классификации запроса и проходит через согласование PRD, архитектуру и создание issues, реализацию работниками, верификацию QA и координацию слияния PR.
• Правило маршрутизации техлида: Основной разговор трактуется как координатор; он «никогда не пишет код напрямую», требуя изменений через Worker Agent → PR → ревью.
• Параллельные Worker Agents через worktrees: Запускает несколько агентов-работников, развивающих параллельно в изолированных worktree для разных частей фичи (например, auth, API, frontend).
• Предварительный скан конфликтов до кодирования: Перед стартом агенты сканируют открытые Issues на пересечение файлов, чтобы выявить конфликты заранее.
• Координация PR после слияния: После слияний сканирует открытые PR и уведомляет ветки, требующие rebase.
• Security gate перед ревью: Требует запуска инструментов безопасности (например, bandit + pip-audit для Python или npm audit для Node) как обязательный шаг перед фазой ревью.
• Структурированный чеклист ревью PR с условиями вето: Ревью кода по 7-пунктному чеклисту с обязательными условиями вето.
• Самопроверка на контрпримерах для покрытия тестов: Включает шестикатегорийную самопроверку, чтобы работники учитывали сценарии Null/Empty/Boundary/External failure/Concurrency/Malicious input.

Как использовать claude-dev-skill

1. Установите файлы навыка в директорию команд Claude Code (скриптовая установка для macOS/Linux/Windows или ручное копирование с сохранением структуры директорий).
2. Убедитесь, что у вас установлен Claude Code (официальный CLI от Anthropic) и выполнен логин.
3. Используйте GitHub CLI (gh) с аутентифицированной сессией (сначала запустите gh auth login).
4. В Claude Code выполните /dev [опциональное описание]. Навык классифицирует запрос (например, новый проект, новая фича, багфикс, хотфикс, архитектурные изменения, рефакторинг) и запустит соответствующий flow.

Типичный запуск следует фазам из репозитория: согласование PRD (два раунда), архитектура и декомпозиция задач с GitHub Issues, параллельное выполнение работниками в worktrees, статическая верификация QA и ревью/слияние PR по чеклисту.

Сценарии использования

• Разработка небольшой/средней фичи веб-бэкенда с готовым PRD: Используйте /dev, чтобы перевести существующий документ требований в архитектурные решения, GitHub Issues и параллельные реализации работниками.
• Одновременная реализация нескольких модулей с минимизацией конфликтов слияния: Назначьте отдельным агентам-работникам разные компоненты (например, аутентификация vs. CRUD API задач vs. фронтенд) и полагайтесь на предварительный скан конфликтов и координацию rebase после слияния.
• Координированная правка багов или хотфиксов: Для багфиксов или экстренных хотфиксов flow классифицирует тип запроса и направляет через архитектурное ревью, изменения работниками, верификацию QA и структурированное слияние PR.
• Систематический рефакторинг с структурированным ревью: При рефакторинге самопроверка на контрпримерах и security gate перед слиянием помогают работникам учитывать edge-кейсы и запускать обязательные аудиты перед ревью.
• Архитектурные изменения, требующие согласования перед кодированием: Используйте фазу 1 (согласование PRD) и фазу 2 (архитектурные решения), чтобы уточнить план команды перед стартом реализации работниками.

FAQ

• Что значит «tech lead» в рабочем процессе этого навыка? Основной разговор выступает в роли координатора: согласовывает PRD, определяет направление архитектуры, запускает worker-агентов и обеспечивает, чтобы изменения кода проходили через PR worker-агентов и ревью, а не прямые правки в чате.

• Написывает ли claude-dev-skill код напрямую из основного разговора? Нет. В рабочем процессе есть «железное правило»: основной разговор никогда не пишет код напрямую; изменения должны проходить через Worker Agent и затем PR для ревью.

• Как обрабатываются конфликты при параллельной разработке? Навык включает сканирование конфликтов перед кодированием (worker-агенты проверяют открытые Issues на пересечение файлов перед стартом) и шаг после слияния, который сканирует открытые PR для выявления веток, требующих rebase.

• Какие проверки безопасности применяются? Перед фазой ревью обязательно запускаются инструменты безопасности, такие как bandit плюс pip-audit для Python или npm audit для Node, согласно описанию Security gate репозитория.

• Подходит ли это для задач по продакшен-развёртыванию? Описание области репозитория указывает, что оно не подходит для проектов, требующих продакшен-развёртывания, поскольку не предоставляет возможности DevOps/развёртывания.

Альтернативы

• Одноагентные ассистенты для кода (автодополнение/чат-стиль): Они фокусируются на написании кода напрямую из промптов, но обычно не предоставляют многоагентный workflow от PRD до PR с принудительными ревью-гейтами.
• Традиционные многошаговые промпты + ручные PR-workflow: Можно самостоятельно промптить Claude для декомпозиции задач и ручного запуска worker’ов, но теряется встроенная SOP-структура (классификация, сканирование конфликтов, координация QA и чеклистов).
• Стандартные GitHub-ориентированные командные workflow (Issues/PR без AI SOP): Команды могут воспроизвести части потока с помощью GitHub Issues и PR-ревью, но параллелизация «worker agent» и автоматизированный роутинг фаз не предоставляются аналогично.
• Другие пользовательские навыки Claude Code для планирования или тестирования: Вместо координации параллельных worker-агентов от начала до конца, некоторые навыки фокусируются только на одной части workflow (например, генерация тестов), оставляя интеграцию и координацию слияний пользователю.