spec-review

name	spec-review
description	**UNIVERSAL TRIGGER**: Ревью спецификаций и ТЗ на гапы, нестыковки и противоречия. Используй когда: - "get/show/list/display spec issues", "retrieve spec analysis" - "check/analyze/fetch spec review", "review spec" - "проверь спецификацию/ТЗ", "ревью спеки", "проанализируй ТЗ" - "найди гапы в требованиях", "найди нестыковки/противоречия" - пользователь дал ссылку на Google Doc, GitHub issue или Docmost-документ со спецификацией - пользователь вставил текст спецификации и просит проверить **Уровни глубины**: - `--quick` / `-q` — только критические блокеры (быстро) - `--standard` / `-s` — критические + высокие (по умолчанию) - `--deep` / `-d` — все проблемы включая средние - `--exhaustive` / `-e` — полный аудит с рекомендациями - `--no-ask` — использовать standard без вопроса (для CI/CD) **Ключевые слова для уровней**: - "быстро проверь", "только блокеры" -> quick - "тщательно", "подробно", "глубоко" -> deep - "полный аудит", "исчерпывающий" -> exhaustive **Google Doc**: - "проверь спеку docs.google.com/document/d/XXX" - "ревью этого ТЗ [ссылка на Google Doc]" **Docmost**: - "проверь спеку https://docs.company.com/p/XXXXXXXX" - "ревью этого ТЗ в Docmost [ссылка]" **GitHub Issue** (ТОЛЬКО с ревью-контекстом!): - "проанализируй issue #123" (ревью-слово: "проанализируй") - "проверь спецификацию github.com/.../issues/456" (ревью-слово: "проверь") - голый "issue #123" без ревью-контекста -- НЕ триггер (github-issues или task-routing) **Текст в сообщении**: - "проверь это ТЗ: [текст спецификации]" - пользователь вставил большой текст и просит ревью **Локальный файл**: - "проверь спеку в docs/spec.md" - "сделай ревью файла requirements.txt" TRIGGERS: спецификация, ТЗ, spec, specification, requirements, проверь спеку, ревью спеки, review spec, analyze spec, найди гапы, найди противоречия, найди нестыковки, docs.google.com/document, github.com/issues, docmost, /p/, техническое задание, требования, acceptance criteria, проанализируй требования, check requirements, --quick, -q, --deep, -d, --exhaustive, -e, --no-ask, быстро проверь, тщательно проанализируй, полный аудит, только блокеры, глубокий анализ, исчерпывающий
tools	Skill

Spec Review Skill

Роутер для ревью спецификаций. Определяет источник и уровень глубины, затем ВЫЗЫВАЕТ команду /spec-review через Skill tool.

КРИТИЧЕСКИ ВАЖНО

Эта skill — роутер. Твоя задача:

1. Извлечь источник (URL, path, #number) из ОРИГИНАЛЬНОГО сообщения пользователя
2. Определить уровень глубины (флаги или ключевые слова)
3. Вызвать Skill tool с skill: "spec-review" и корректным args

НЕ выводи текст описывающий вызов. ВЫПОЛНИ вызов через Skill tool. НЕ теряй URL/path из оригинального сообщения пользователя.

Алгоритм

1. Извлечь источник из сообщения пользователя

Найди в ОРИГИНАЛЬНОМ сообщении пользователя (до загрузки этого скилла) один из:

Тип	Паттерн	Пример args
Google Doc	docs.google.com/document/d/...	https://docs.google.com/document/d/1abc123/edit
GitHub Issue	github.com/.../issues/N или #N с ревью-контекстом	https://github.com/org/repo/issues/42
Docmost	https://{domain}/p/{pageId}	https://docs.company.com/p/3f6f2b9d
Локальный файл	путь к файлу	docs/spec.md
Текст в сообщении	большой блок текста (>500 символов)	(пустая строка)

GitHub Issue: активируй ТОЛЬКО при ревью-контексте (слова: "проверь", "ревью", "review", "analyze", "проанализируй", "спеку", "ТЗ"). Без ревью-контекста — это github-issues или task-routing.

2. Определить уровень глубины

Явные флаги (приоритет):

Флаг	Синоним
--quick	-q
--standard	-s
--deep	-d
--exhaustive	-e
--no-ask	(доп. флаг, совместим с любым уровнем)

Ключевые слова (если нет флага):

• "быстро", "только критичное", "только блокеры" -> --quick
• "тщательно", "подробно", "глубоко", "детально" -> --deep
• "полный аудит", "исчерпывающий", "всё проверить" -> --exhaustive

3. Собрать args и вызвать Skill tool

Формат args: [depth_flag] [--no-ask] <source>

Примеры готовых args:

• https://github.com/org/repo/issues/42
• --quick #42
• --deep docs/spec.md
• --exhaustive https://docs.google.com/document/d/xxx
• --no-ask #42
• (пустая строка, если текст спецификации в сообщении)

Теперь вызови Skill tool с skill: "spec-review" и собранным args.