К основному содержанию
скилл CX Codex

03-shadow-areas — скилл для Claude Code: поиск пробелов в документах

Скилл 03-shadow-areas для Claude Code сканирует написанный документ (идею, историю, PRD, спецификацию) и выдаёт структурированный отчёт о пробелах — что автор не учёл. Работает также на Cursor, Codex, GitHub Copilot и OpenCode.

MIT ★ 571 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-refine@aidd-framework
Открыть на GitHub

Что делает 03-shadow-areas

03-shadow-areas анализирует текстовый артефакт и находит слепые зоны: пропущенные требования, неясные части, недостаток деталей. Каждый пробел получает категорию из фиксированной таксономии, уровень серьёзности (blocker, major, minor) и прямой вопрос, на который автор может сразу ответить. Скилл работает не как диалог, а как аналитический сканер — один проход через документ и готовый отчёт.

В скилле три действия: detect разбирает артефакт и извлекает пробелы, render-report формирует отчёт markdown, отсортированный по категориям и серьёзности, а diff сравнивает текущий результат с предыдущим отчётом и показывает, какие пробелы закрыли, какие остались, какие появились новые. Категории и правила серьёзности хранятся в справочниках references/locked-sets.json.

Применяй, когда нужно найти, что упущено в документе перед тем, как двигаться дальше. Скилл не заменяет Q&A и не ревьюит код — он специально для письменных артефактов.

Какие задачи решает

  • найти пробелы в технической спецификации перед разработкой
  • проверить историю пользователя на полноту деталей
  • выявить недостаток требований в PRD
  • отследить, какие пробелы закрыли в новой версии документа
  • выделить наиболее критичные пропуски в идее проекта

Примеры запросов агенту

  • Сканируй spec.md на пробелы и покажи отчёт категориями
  • Найди слепые зоны в этом описании истории: [вставь текст]
  • Сравни новый вариант PRD с предыдущим отчётом из reports/prd-v1.md

Как установить 03-shadow-areas

1Через маркетплейс плагинов

/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-refine@aidd-framework

Команда ставит плагин aidd-refine целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add ai-driven-dev/framework --skill 03-shadow-areas -a claude-code

3Вручную: положить файлы

~/.claude/skills/03-shadow-areas/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/03-shadow-areas/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о 03-shadow-areas

Как установить 03-shadow-areas в Claude Code?

Выполни /plugin marketplace add ai-driven-dev/framework, затем /plugin install aidd-refine@aidd-framework и npx skills add ai-driven-dev/framework --skill 03-shadow-areas -a claude-code. Файл скилла будет в ~/.claude/skills/03-shadow-areas/SKILL.md.

Что делает 03-shadow-areas?

Сканирует документ и выдаёт структурированный отчёт о пробелах: каждый пропуск получает категорию, уровень серьёзности и конкретный вопрос, чтобы автор знал, что уточнить или дописать.

Как установить скилл в других IDE?

Для Cursor: npx skills add ai-driven-dev/framework --skill 03-shadow-areas -a cursor. Для Codex: npx skills add ai-driven-dev/framework --skill 03-shadow-areas -a codex. Для GitHub Copilot: gh skill install ai-driven-dev/framework 03-shadow-areas. Для OpenCode: npx skills add ai-driven-dev/framework --skill 03-shadow-areas -a opencode.

Исходный текст

SKILL.md · MIT
---
name: 03-shadow-areas
description: Scan a markdown artifact (idea, stories, PRD, spec) for blind spots into a shadow report grouped by category and severity. Use to find gaps or what is missing in a written artifact. Not for interactive Q&A or code review.
argument-hint: file | text
---

# Shadow Areas

Analytically scans a written artifact for gaps the author has not addressed. Unlike iterative Q&A clarification, this skill reads the existing material and emits a structured report: each gap carries a category from a locked 7-category taxonomy, a 3-tier severity, and a direct-question probe the author can act on immediately.

## Actions

| #   | Action           | Role                                                                     | Input                                    |
| --- | ---------------- | ------------------------------------------------------------------------ | ---------------------------------------- |
| 01  | `detect`         | Parse input, extract gaps, classify category and severity, emit probes   | file path or inline text                 |
| 02  | `render-report`  | Render markdown grouped by category and sorted by severity, write report | gap list from detect                     |
| 03  | `diff`           | Load prior report, classify gaps as closed / still-open / newly-introduced | gap list from detect + prior report path |

Dispatch by context: with no prior report run `detect` then `render-report`; with one, run `detect` then `diff`.
Before running an action, read its file in `actions/`, not only the table or assets.

## Transversal rules

- Never modify the source artifact.
- Every gap carries all three: a category, a severity, and a probe question.
- Every probe is a direct question ending with `?`.
- Categories and severities come from the locked sets in `references/locked-sets.json`.
- When zero blockers and zero majors remain, stamp the report `status: clean`.
- On re-runs, gaps are matched by category and snippet, never by question wording, so rephrasing a question never creates a spurious "newly introduced" gap.

## References

- `references/categories.md`: locked 7-category taxonomy with definition and example per category.
- `references/severity-rubric.md`: blocker / major / minor decision rules and examples.
- `references/probe-style.md`: direct-question form rules.
- `references/locked-sets.json`: machine-readable sets reused by the validator.

## Assets

- `assets/report-template.md`: report skeleton with header, per-category sections, and `status: clean` block.

© AI-Driven Dev · MIT · ai-driven-dev/framework

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
create-specification официальный github Скилл create-specification для GitHub Copilot создаёт Markdown-спецификацию решения для заданной цели, включая требования, ограничения и интерфейсы. CX Codex +1 13 537установок Specification официальный github Субагент Specification создаёт и обновляет структурированные файлы спецификаций для нового или существующего кода. Помогает зафиксировать требования и контракты в едином формате. CX Codex +1 298установок utility-mermaid-diagrams product-on-purpose Скилл utility-mermaid-diagrams помогает создавать корректные диаграммы Mermaid для PRD и технических спецификаций, подбирая подходящий тип из 15 вариантов и проверяя синтаксис. CX Codex +1 829установок knowledge-base-builder Mario Aldayuz / Littlebird Скилл knowledge-base-builder собирает проектную документацию из звонков и переписок Littlebird в структурированный Markdown-пакет с фиксацией противоречий. CX Codex +1 ★ 96звёзд репо deliver-prd product-on-purpose Скилл deliver-prd составляет документ требований к продукту (PRD) для передачи разработки инженерам или ИИ-агентам. CX Codex +1 1 100установок requirements-clarity davila7 Скилл requirements-clarity превращает размытые запросы на разработку в структурированное ТЗ через диалог. Скилл задаёт наводящие вопросы и генерирует PRD, когда накопит достаточно деталей. CX Codex +1 204установок

Из того же набора80

Весь набор →
00-repo-init Скилл 00-repo-init инициализирует локальный Git-репозиторий с веткой main, файлом CONTRIBUTING.md и пустым коммитом, а затем при необходимости публикует его на удалённый хост. CX Codex +1 ★ 571звёзд репо 09-for-sure Скилл 09-for-sure запускает цикл работы агента и повторных проверок до прохождения заданного условия. Используйте его для задачи с проверяемым результатом, например командой. CX Codex +1 ★ 571звёзд репо 07-refactor Скилл 07-refactor меняет код к лучшему по одной из четырёх осей: производительность, безопасность, чистота, архитектура. Работает по своему сканированию или по готовому отчёту аудита. CX Codex +1 ★ 571звёзд репо 00-init Скилл 00-init управляет телеметрией AIDD в проекте: включает и останавливает замер ресурсов с согласия пользователя, задаёт имя автора или удаляет сохранённые метрики. CX Codex +1 ★ 571звёзд репо 11-explore Скилл 11-explore сканирует проект по трём осям: установленные инструменты, контекст и кодовую базу. Показывает компактную карту, а по запросу углубляется в любую из них. CX Codex +1 ★ 571звёзд репо 04-audit Скилл 04-audit проверяет кодовую базу в режиме чтения по семи направлениям качества и собирает единый отчёт с приоритетами. Код он не меняет. CX Codex +1 ★ 571звёзд репо 01-bootstrap Скилл 01-bootstrap помогает спроектировать архитектуру нового SaaS и записывает решения в aidd_docs/INSTALL.md. Запускайте его в начале проекта, когда выбираете стек и архитектурный подход. CX Codex +1 ★ 571звёзд репо checker Субагент checker, который судит готовую работу по чеклисту, запускает валидацию и проверяет, служит ли код реальной потребности. Не правит код, только выносит вердикт с доказательствами. CX Codex +1 ★ 571звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой