plan-review — скилл для Claude Code: что делает и как установить
Оценивает спецификацию фичи с трёх сторон — стратегии, дизайна и инженерной реализуемости — ещё до начала разработки. Помогает найти пробелы в требованиях.
npx skills add mvschwarz/openrig --skill plan-review -a claude-codeЧто делает plan-review
Скилл анализирует документы в папке фичи: основной SPEC.md, а при наличии — validation.md, background.md и каталог supporting/. Оценка идёт через три призмы: продуктовая стратегия компании, UX-дизайн и техническая реализуемость со стороны менеджера продукта.
Интерфейсный блок выставляет баллы от 0 до 10 по шести направлениям, проверяя доступность, логику переходов и пустые состояния экранов. Техническая часть не предлагает готовых архитектурных решений, а проверяет ясность критериев приёмки, возможные изменения модели данных и внешние зависимости. На выходе формируется структурированный отчёт с оценками и списком проблем трёх уровней: блокирующие, важные и рекомендации.
Для запуска скиллу необходим составленный SPEC.md, иначе агенту не к чему будет привязать выводы. Создание итогового резюме по результатам проверки требует отдельного скилла exec-summary.
Какие задачи решает
- найти пробелы в
SPEC.mdдо передачи задачи в разработку - оценить UX фичи по шкале из шести параметров интерфейса
- проверить соответствие фичи бизнес-целям и целевым персонам
- выявить скрытые технические зависимости и неясные критерии приёмки
Примеры запросов агенту
- Проведи plan-review для спецификации в папке
features/auth/SPEC.md - Оцени план фичи с точки зрения продуктовой стратегии и UX
- Разбери
SPEC.mdи выдели блокирующие проблемы перед спринтом
Как установить plan-review
1Через Skills CLI (Vercel)
npx skills add mvschwarz/openrig --skill plan-review -a claude-code2Вручную: положить файлы
~/.claude/skills/plan-review/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/plan-review/
1Через Skills CLI (Vercel)
npx skills add mvschwarz/openrig --skill plan-review -a codex2Вручную: положить файлы
.agents/skills/plan-review/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mvschwarz/openrig --skill plan-review -a cursor2Вручную: положить файлы
.cursor/skills/plan-review/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mvschwarz/openrig plan-review2Вручную: положить файлы
.github/skills/plan-review/SKILL.md1Через Skills CLI (Vercel)
npx skills add mvschwarz/openrig --skill plan-review -a gemini-cli2Командой платформы
gemini skills install https://github.com/mvschwarz/openrig --path skills/_canonical/pm/plan-reviewВручную: положить файлы
.devin/skills/plan-review/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mvschwarz/openrig --skill plan-review -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о plan-review
Как установить plan-review в Claude Code?
Выполните в терминале команду npx skills add mvschwarz/openrig --skill plan-review -a claude-code.
Какие документы нужны скиллу для работы?
Основным является SPEC.md в папке фичи. Если подготовлены файлы validation.md, background.md или материалы в папке supporting/, скилл также включит их в анализ.
Что входит в итоговый отчёт plan-review?
Агент выдаёт оценки от 1 до 10 по стратегии, дизайну и реализуемости, таблицу UX-метрик, а также список замечаний с делением на блокирующие, важные и рекомендации.
Исходный текст
SKILL.md · Apache-2.0
--- name: plan-review description: "Multi-perspective review of a feature plan or requirements doc before development begins. Evaluates from strategy, design/UX, and engineering angles to catch gaps early." --- You are a multi-perspective plan reviewer. Before a feature moves from requirements to development, you evaluate it from three angles to catch gaps, scope drift, and missed opportunities. ## Three Review Lenses ### 1. Strategy Review (CEO/Product Leader Lens) - Does this align with company growth objectives? - Which personas does this serve? Are they buyers, users, or influencers? - How does this compare to what competitors offer? - Is the scope right? Too ambitious or too focused? - What's the opportunity cost — what are we NOT building by doing this? ### 2. Design Review (UX/Interaction Lens) Rate these dimensions (0-10): 1. **Information architecture** — discoverable and logically organized? 2. **Interaction states** — empty, loading, error, success, edge cases covered? 3. **User journey** — matches how the persona actually works? 4. **Consistency** — follows existing UI patterns? 5. **Accessibility** — keyboard nav, screen readers, color contrast? 6. **AI integration** — if AI-powered, is it natural and trustworthy? ### 3. Engineering Feasibility (Technical Lens) - Are acceptance criteria specific enough that a dev won't need to guess? - Are there data model implications needing early discussion? - Are there dependencies on other features or systems? - Are there performance/scale considerations? - Is the scope realistic for the implied timeline? ## Process ### Step 1: Read the Material Read all available docs in the feature folder: - **validation.md** — office hours verdict, demand evidence, wedge scope (if exists) - **background.md** — customer drivers, competitive context (if exists) - **SPEC.md** — the main document to review - **supporting/** — mockups, data files, visual references ### Step 2: Run All Three Reviews ### Step 3: Synthesis ```markdown ## Plan Review: [Feature Name] **Date**: [date] **Reviewed**: [SPEC.md path] ### Strategy Assessment **Score: [1-10]** - [Key findings] ### Design Assessment **Score: [1-10]** | Dimension | Score | Notes | |-----------|-------|-------| | Information Architecture | X/10 | [notes] | | Interaction States | X/10 | [notes] | | User Journey | X/10 | [notes] | | Consistency | X/10 | [notes] | | Accessibility | X/10 | [notes] | | AI Integration | X/10 | [notes] | ### Engineering Feasibility **Score: [1-10]** - [Key findings] ### Issues Found #### Blocking (must fix before dev) 1. [Issue with specific reference to requirement] #### Important (should fix, but not blocking) 1. [Issue] #### Suggestions (nice to have) 1. [Suggestion] ### Recommended Actions - [Specific actions before proceeding to development] ``` ### Step 4: Generate Executive Summary After the review is complete and issues are resolved, generate an executive summary using the exec-summary skill. Save it to the feature folder as `executive-summary.md`. ## Guidelines - **Be specific.** Cite exact requirements that have issues. - **Reference real context.** Check personas, competitors, and existing features. - **Don't do the dev's job.** The engineering lens is about PM-side clarity, not architecture. - **Praise what's good.** Helps the PM know what to keep doing.
© mvschwarz · Apache-2.0 · mvschwarz/openrig