/interview-me

Роль: Архитектор. Читает существующий код, проводит жёсткое интервью и выдаёт production-grade спецификацию.

Характер скилла

Это коллаборативный архитектор с активным pushback’ом. Он не записывает всё что говоришь — он думает вместе с тобой, строит на твоих идеях, находит пробелы и конструктивно их оспаривает. Если видит противоречие — называет его прямо. Если видит security-проблему — не двигается дальше пока не закроешь.

Что делает

Phase 1 (Pre-Analysis): форкает Explore-агента → молча читает архитектуру проекта, стек, package.json, CLAUDE.md, существующие спеки → кратко резюмирует контекст
Phase 2 (Interview): интервью через AskUserQuestion (2–4 варианта на вопрос + шкала coverage)
Phase 3 (HTML Preview): по желанию — интерактивный HTML с inline-комментариями для ревью
Phase 4 (Spec Generation): пишет спеку с динамическими секциями
Phase 5 (Tasks): генерирует задачи (GitHub Issues, Claude Tasks или markdown)

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

Добавляешь крупную фичу в существующий проект (нужен анализ кода)
Нужен Decisions Log — история «почему именно так, а не иначе»
Задача требует security hard-block на этапе требований
Задача сложная, нужна покрывающая coverage map по областям
Хочешь возможность вернуться к интервью через день/неделю (resume)
Нужно автоматически создать GitHub Issues из спеки

Когда НЕ использовать

Идея расплывчатая, код не нужен → /project-manager сначала
Нужен быстрый design-doc без анализа кода → brainstorming
Хочешь WHAT/WHY документ для клиента → /project-manager

Промт для запуска

/interview-me <путь к файлу требований>

или с текстом:

/interview-me Хочу добавить авто-закупку у нового поставщика. Система
уже поддерживает DHM и CPAPX — нужно добавить ResmedDirect.

UI во время работы

Скилл показывает Coverage Map перед каждым вопросом:

Coverage: Problem [done] | Users [done] | API Design [in progress] | 
          Data Model [pending] | Error Handling [pending] | Security [pending]

Вопросы — через AskUserQuestion с нетривиальными вариантами (2–4 шт):

┌────────────────────────────────────────────────────────────┐
│ Как ResmedDirect обрабатывает неуспешный платёж?           │
│                                                            │
│ ○ Возвращает HTTP ошибку — мы делаем retry                │
│ ○ Переводит заказ в pending, нужен ручной разбор          │
│ ○ Отменяет заказ автоматически                            │
│ ○ Other: ________________________                          │
└────────────────────────────────────────────────────────────┘

Security Hard Block

Если в процессе интервью обнаруживается любая из этих проблем — скилл не пишет спеку пока не закрыта:

PII/sensitive data без шифрования или access controls
Риски обхода аутентификации/авторизации
Injection уязвимости (SQL, XSS, command injection)
Секреты/credentials в plaintext
Отсутствие rate limiting на публичных endpoints
Хранение данных без стратегии удаления

Выходной документ

Динамические секции на основе того, что вскрыло интервью. Общий вид:

# [Feature Name]

## Overview / Problem Statement
## Goals & Non-Goals
## User Stories / Use Cases
## Technical Design
## API Design
## Data Model
## Error Handling
## Security Considerations   ← всегда, если были вопросы о безопасности
## Performance Considerations
## Migration Strategy
## Testing Strategy
## Edge Cases
## Decisions Log             ← полный аудит trail всех pushback, разногласий, решений
## Dependency Graph & Implementation Order

HTML Preview (опционально)

После интервью предложит сгенерировать .preview-<spec-name>.html:

Кликаешь на любой параграф → добавляешь inline-комментарий
Кликаешь «Revise» → комментарии копируются в буфер → вставляешь мне → обновляю preview
Кликаешь «Approved» → генерируется финальная markdown-спека

Resume

Состояние сохраняется в .interview-state.json. Если вернёшься завтра:

/interview-me requirements.md

Скилл прочитает state, перепроверит что ответы не устарели из-за изменений в коде, и продолжит с места остановки.

Установка

git clone --depth 1 https://github.com/Sorbh/interview-me ~/.claude/skills/interview-me

# Исправить вложенную структуру (gotcha репо):
mv ~/.claude/skills/interview-me/interview-me/SKILL.md ~/.claude/skills/interview-me/
mv ~/.claude/skills/interview-me/interview-me/STYLE_PRESETS.md ~/.claude/skills/interview-me/
rmdir ~/.claude/skills/interview-me/interview-me

Источник: github.com/Sorbh/interview-me, MIT License.

← /project-manager

Сравнение →

Combined Flow →