03-shadow-areas — скилл для Claude Code: поиск пробелов в документах
Скилл 03-shadow-areas для Claude Code сканирует написанный документ (идею, историю, PRD, спецификацию) и выдаёт структурированный отчёт о пробелах — что автор не учёл. Работает также на Cursor, Codex, GitHub Copilot и OpenCode.
MIT ★ 571 обновлён 2026-10-29
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-refine@aidd-frameworkЧто делает 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-code3Вручную: положить файлы
~/.claude/skills/03-shadow-areas/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/03-shadow-areas/
1Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 03-shadow-areas -a codex2Вручную: положить файлы
.agents/skills/03-shadow-areas/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 03-shadow-areas -a cursor2Вручную: положить файлы
.cursor/skills/03-shadow-areas/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ai-driven-dev/framework plugins/aidd-refine/skills/03-shadow-areas2Вручную: положить файлы
.github/skills/03-shadow-areas/SKILL.md1Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 03-shadow-areas -a gemini-cli2Командой платформы
gemini skills install https://github.com/ai-driven-dev/framework --path plugins/aidd-refine/skills/03-shadow-areasВручную: положить файлы
.devin/skills/03-shadow-areas/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 03-shadow-areas -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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