Перейти к основному содержимому

Гид По Навыкам (Skills) PIN

Как, когда и какие skills из .claude/skills использовать при работе над PIN. Дополняет таблицу навыков в CLAUDE.md.

Что такое skill и как он устроен​

Skill — это папка в .claude/skills/<name>/ с файлом SKILL.md (YAML-frontmatter name/description [+category/risk/source] и телом-инструкцией), иногда с под-ресурсами (references/, scripts/, examples/, metadata.json). Skill — это пере-используемая экспертиза/чек-лист, которую ты подключаешь под конкретный тип задачи. В репозитории ~264 навыка (общая библиотека); ниже — те, что релевантны стеку и домену PIN.

Когда использовать skill​

  • Подключай skill, когда задача явно попадает в его область (см. таблицы ниже) и он добавляет экспертизу/структуру, которой у тебя нет под рукой.
  • НЕ подключай «на всякий случай», не дублируй уже применённое, не тащи skill не по теме.
  • Если не уверен, какой навык подходит — используй skill-router (маршрутизатор). Если подходящего нет и задача повторяемая — создай через skill-creator/skill-developer (см. «Мета-навыки»).
  • Для документационных задач PIN сначала смотри шаблоны docs/99-templates/ и правила docs/01-engineering-rules/ — они первичны; skill дополняет, а не заменяет их.

Как использовать skill (рабочий цикл)​

  1. Пойми задачу и прочитай релевантную документацию/ТЗ/SDK (docs/, Talent.Common.*).
  2. Подбери skill по таблицам ниже (или через skill-router).
  3. Следуй инструкции skill'а (его SKILL.md и под-ресурсы).
  4. Применяй к контексту PIN: реальные типы SDK Talent.Common.*, домен недвижимости, границы контекстов, конвенции (CLAUDE.md/AGENTS.md) — без суффикса Async, строгая типизация, XML doc.
  5. Результат сверяй с правилами PIN (docs/01-engineering-rules/) и шаблонами (docs/99-templates/).

Какие skills — по областям и задачам PIN​

Домен, границы контекстов, агрегаты, события​

  • Задачи: выделение bounded contexts (Identity, Шахматка, CRM/Фиксация, Вознаграждения…), агрегатов, value objects, доменных событий; проектирование саги фиксации/бронирования.
  • Skills: domain-driven-design, ddd-strategic-design, ddd-context-mapping (стратегический уровень); ddd-tactical-patterns (агрегаты/VO/инварианты); event-store-design, saga-orchestration (события/саги).
  • Применение: агрегаты → AggregateRoot<TKey> + capability-интерфейсы SDK; события → IDomainEvent (+INotificationRequest/IKafkaEvent); саги → ISagaOrchestrator/ISagaOutboxService.

Backend C#/.NET на SDK Talent.Common.*​

  • Задачи: CQRS-операция (endpoint/consumer/job), handler, репозиторий, транзакция/outbox.
  • Skills: dotnet-backend-patterns, dotnet-backend, dotnet-architect, csharp-pro, backend-architect, cc-skill-backend-patterns, cc-skill-coding-standards.
  • Применение: операция → IOperationRequest+IOperationHandler→Result; загрузка → IDbRepository (FindBy/GetById/GetByIds); коммит → IUnitOfWork.SaveChanges; события → outbox (IKafkaEvent).

Данные: PostgreSQL / ClickHouse / EF / миграции / поиск​

  • Задачи: проектирование сущностей/таблиц (Company, User, Object/Lot, Fixation, Booking), индексы шахматки, jsonb/owned types, миграции, аналитика (ClickHouse), FTS/поиск.
  • Skills: database-design, database-architect, postgresql, postgresql-optimization, database-optimizer, database-migration, cc-skill-clickhouse-io, nosql-expert, similarity-search-patterns (поиск/подборки).
  • Применение: сущности по docs/99-templates/entity-template.md; VO → EF owned (ConfigureOwnedTypes); строгая типизация jsonb; ClickHouse-факты → docs/99-templates/clickhouse-fact-template.md.

Identity / авторизация / RBAC​

  • Задачи: scoped-RBAC + record-level + resource-based; роли/permissions/scope; интеграция с внешним talent identity через Kafka.
  • Skills: auth-implementation-patterns, backend-security-coder, cc-skill-security-review.
  • Применение: политики/permissions → docs/99-templates/policy-permission-template.md; tenant/scope в каждом query (SDK tenant-интерсепторы).

API / контракты​

  • Skills: api-design-principles, api-patterns, api-endpoint-builder, api-documentation.
  • Применение: каждый метод — по docs/99-templates/api-method-template.md (контракт+CQRS+алгоритм в одном файле, ссылка на command-query как правило).

Frontend (React / TS / FSD)​

  • Skills: react-best-practices, react-component-performance, react-flow-architect, frontend-developer, frontend-design, typescript-pro/typescript-expert/typescript-advanced-types, zod-validation-expert, zustand-store-ts.
  • Применение: страницы/слайсы/сторы → docs/99-templates/frontend-*; Zod для внешнего ввода; FSD-границы.

Документация (правила, шаблоны, ADR)​

  • Skills: docs-architect, documentation-templates, documentation, agents-md, c4-context/c4-container/c4-component/c4-code.
  • Применение: пиши по шаблонам docs/99-templates/ и правилам docs/01-engineering-rules/; диаграммы — mermaid (C4/sequence/state/ER).

Качество кода / ревью / упрощение​

  • Skills: code-reviewer, code-review-excellence, code-review-checklist, clean-code, code-simplifier, simplify-code. Команды: /code-review (перед коммитом), /simplify (после).

Тестирование​

  • Skills: tdd-orchestrator, tdd-workflow. Тест-спеки — по docs/99-templates/integration-test-template.md.

Observability / DevOps​

  • Skills: observability-engineer, observability-monitoring-monitor-setup, observability-monitoring-slo-implement. Дашборды/рунбуки — по шаблонам docs/99-templates/.

Архитектура и ADR​

  • Skills: architecture, architecture-patterns, architect-review, architecture-decision-records, c4-*. ADR — по docs/99-templates/adr-template.md.

Мета-навыки​

  • skill-router — выбрать подходящий навык под задачу, если не знаешь имя.
  • skill-creator / skill-developer / skill-creator-ms — создать/доработать навык для повторяемой PIN-задачи (напр. «генерация тех задания по шаблону», «аудит строгой типизации»).
  • project-skill-audit — проверить покрытие навыками и предложить новые/обновления.

Команды (slash-commands)​

КомандаКогда
/code-reviewПоиск багов в diff перед коммитом.
/simplifyЧистка/упрощение после реализации.
/verifyПроверка работоспособности изменения.
/runЗапуск приложения.
/commitКоммит по конвенции (русский, без мусора).

Обратные ссылки​

Автоссылки: где используется этот документ.

Связанные документы​

  • CLAUDE.md — таблица навыков + правила кода.
  • AGENTS.md — миссия, engineering-rules.
  • docs/01-engineering-rules/ — правила документирования и кода.
  • docs/99-templates/ — канонические шаблоны документов.
  • docs/11-backend-sdk/ — реальные building blocks Talent.Common.*.