spec-review

**通用触发器**：审查规格和需求文档中的差距、不一致和矛盾。使用场景： - “检查规格/需求文档”，“审查规格”，“review spec” - “查找需求中的差距”，“分析需求文档” - “查找规格中的不一致/矛盾” - 用户提供了 Google Doc 或 GitHub issue 的链接，其中包含规格 - 用户粘贴了规格文本并要求检查来源类型： 📄 **Google Doc**： - “检查 specs docs.google.com/document/d/XXX” - “审查这个需求文档 [Google Doc 链接]” 🐙 **GitHub Issue**： - “分析 issue #123” - “检查规格 github.com/.../issues/456” 📝 **消息中的文本**： - “检查这个需求文档：[规格文本]” - 用户粘贴了大段文本并要求审查 📁 **本地文件**： - “检查 specs in docs/spec.md” - “审查 requirements.txt 文件” 触发器：规格，需求文档，spec，规格，需求，检查规格，审查规格，review spec，分析规格，查找差距，查找矛盾，查找不一致， docs.google.com/document，github.com/issues，技术需求，需求，验收标准，分析需求，check requirements

SKILL.md

--- frontmatter

name: spec-review
description: |
  **UNIVERSAL TRIGGER**: Ревью спецификаций и ТЗ на гапы, нестыковки и противоречия.

  Используй когда:
  - "проверь спецификацию/ТЗ", "ревью спеки", "review spec"
  - "найди гапы в требованиях", "проанализируй ТЗ"
  - "найди нестыковки/противоречия в спецификации"
  - пользователь дал ссылку на Google Doc или GitHub issue со спецификацией
  - пользователь вставил текст спецификации и просит проверить

  Типы источников:

  📄 **Google Doc**:
  - "проверь спеку docs.google.com/document/d/XXX"
  - "ревью этого ТЗ [ссылка на Google Doc]"

  🐙 **GitHub Issue**:
  - "проанализируй issue #123"
  - "проверь спецификацию github.com/.../issues/456"

  📝 **Текст в сообщении**:
  - "проверь это ТЗ: [текст спецификации]"
  - пользователь вставил большой текст и просит ревью

  📁 **Локальный файл**:
  - "проверь спеку в docs/spec.md"
  - "сделай ревью файла requirements.txt"

  TRIGGERS: спецификация, ТЗ, spec, specification, requirements,
  проверь спеку, ревью спеки, review spec, analyze spec,
  найди гапы, найди противоречия, найди нестыковки,
  docs.google.com/document, github.com/issues,
  техническое задание, требования, acceptance criteria,
  проанализируй требования, check requirements
tools: Skill

Spec Review Skill

Автоактивируемый роутер для ревью спецификаций. Определяет источник и вызывает команду /spec-review.

Логика определения источника

1. Google Doc

Паттерн: docs.google.com/document/d/{DOCUMENT_ID}

code

Если в сообщении есть ссылка на Google Doc:
→ Извлечь DOCUMENT_ID
→ Вызвать: Skill tool → skill: "spec-review", args: "{URL}"

2. GitHub Issue

Паттерны:

•github.com/{owner}/{repo}/issues/{number}
•#123 (в контексте репозитория)
•issue #123

code

Если в сообщении есть ссылка/номер GitHub issue:
→ Вызвать: Skill tool → skill: "spec-review", args: "{URL или #number}"

3. Текст спецификации

Признаки:

•Большой блок текста (>500 символов)
•Содержит ключевые слова: "требования", "функционал", "user story", "acceptance criteria"
•Пользователь явно просит проверить этот текст

code

Если пользователь вставил текст спецификации:
→ Сохранить текст во временный файл или передать напрямую
→ Вызвать: Skill tool → skill: "spec-review", args: ""
→ В следующем сообщении передать текст спецификации

4. Локальный файл

Паттерны:

•Путь к файлу: docs/spec.md, ./requirements.txt
•"файл X", "в файле X"

code

Если указан путь к файлу:
→ Вызвать: Skill tool → skill: "spec-review", args: "{path}"

Примеры активации

Пример 1: Google Doc

code

User: Проверь спеку https://docs.google.com/document/d/1abc123/edit
Assistant: [Вызывает Skill tool: spec-review с args: "https://docs.google.com/document/d/1abc123/edit"]

Пример 2: GitHub Issue

code

User: Сделай ревью issue #42
Assistant: [Вызывает Skill tool: spec-review с args: "#42"]

Пример 3: Текст

code

User: Проверь это ТЗ:
## Функционал
1. Пользователь может регистрироваться
2. Пользователь может логиниться
...