Skills, правила и персистентные инструкции

Skills, правила и персистентные инструкции

Skills — это заготовленные команды для Claude Code. Rules и CLAUDE.md — постоянные инструкции, которые работают в каждой сессии.

CLAUDE.md — главный механизм персистентных инструкций

CLAUDE.md — это файл, который Claude Code читает при каждом запуске. Храните в нём всё, что Claude должен знать о проекте:

# My Project

## Стек
- Next.js 14 App Router
- PostgreSQL через lib/db.ts

## Правила кода
- TypeScript, строгий режим
- Tailwind CSS для стилей
- Все SQL-запросы параметризованные

## Команды
- npm run dev — запуск разработки
- npm run test — тесты
- npm run build — сборка

Иерархия CLAUDE.md

~/.claude/CLAUDE.md          # Глобальные правила (все проекты)
~/project/CLAUDE.md          # Правила проекта
~/project/src/CLAUDE.md      # Правила для поддиректории

Инструкции объединяются: сначала глобальные, потом проектные, потом директории.

Skills — заготовленные команды

Skills — это шаблонные команды, вызываемые через /skill-name. Хранятся в .claude/skills/ или ~/.claude/skills/.

Пример skill для ревью PR:

---
name: review-pr
description: Провести ревью текущих изменений
---

Проверь git diff и сделай code review:
1. Безопасность: SQL injection, XSS, открытые секреты
2. Производительность: N+1 запросы, лишние ре-рендеры
3. Типобезопасность: any, несовпадения типов
4. Тесты: покрытие новой функциональности

Формат: краткое резюме + список проблем по приоритету

Вызов: /review-pr

.claude/rules/ — модульные правила

Альтернатива большому CLAUDE.md — разбить правила на файлы:

.claude/
├── rules/
│   ├── typescript.md     # Правила TypeScript
│   ├── testing.md        # Правила тестирования
│   └── git.md            # Правила git commits
└── skills/
    └── review-pr.md

Глобальные vs проектные инструкции

Глобальные (~/.claude/CLAUDE.md):

• Личные предпочтения (язык ответов, стиль)
• Общие правила для всех проектов

Проектные (./CLAUDE.md):

• Стек и архитектура конкретного проекта
• Специфичные команды и скрипты
• Правила команды

Итог

• CLAUDE.md — главный способ задать постоянный контекст
• Skills — заготовленные команды, вызываются через /имя
• Иерархия: глобальные → проектные → директории
• .claude/rules/ — модульная организация правил