# Spec Review

> **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/documen

- Skill: `dapi/spec-review` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dapi/spec-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dapi/spec-review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: dapi (https://skillmd.com/u/dapi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dapi/spec-review

---


# 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`.