define-problem-statement — скилл для Claude Code: рамка проблемы
Собирает документ с формулировкой проблемы: кому она мешает, что это значит для бизнеса и по каким метрикам считать успех.
npx skills add product-on-purpose/pm-skills --skill define-problem-statement -a claude-codeЧто делает define-problem-statement
Скилл ведёт агента по шести шагам. Сначала он спрашивает, какой сегмент пользователей страдает от проблемы, и просит конкретику вместо «пользователей вообще». Дальше разбираются боли, бизнес-контекст, метрики успеха с базовыми значениями и целями, ограничения и открытые вопросы.
На выходе — документ по шаблону references/TEMPLATE.md с разделами: Problem Summary, User Impact, Business Context, Success Criteria, Constraints & Considerations, Open Questions. В references/EXAMPLE.md лежит заполненный пример. Есть чек-лист качества: проблема привязана к сегменту, влияние подкреплено данными, метрики имеют базу и цель.
Скилл не подходит, когда проблема уже согласована и нужен спек — тогда берут deliver-prd. Для сравнения вариантов решения есть develop-solution-brief, для мотивации клиента — define-jtbd-canvas. Если «проблема» пока гипотеза, её сначала проверяют через define-hypothesis. Это повод не тащить команду в работу над неподтверждённой идеей.
Какие задачи решает
- сформулировать проблему до того, как команда бросится её решать
- вернуть уехавший в сторону проект к исходному замыслу
- объяснить руководству, почему эту задачу стоит взять сейчас
- проверить, отвечает ли предложенное решение исходной боли
- ввести нового человека в контекст инициативы
Примеры запросов агенту
- Помоги сформулировать проблему для новой инициативы: сегмент — мобильные покупатели на этапе оплаты
- Проект ушёл в сторону от исходной задачи, собери problem statement заново
- Нужно рассказать руководству о приоритетах — сделай документ с бизнес-контекстом и метриками
Как установить define-problem-statement
1Через Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill define-problem-statement -a claude-code2Вручную: положить файлы
~/.claude/skills/define-problem-statement/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/define-problem-statement/
1Через Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill define-problem-statement -a codex2Вручную: положить файлы
.agents/skills/define-problem-statement/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill define-problem-statement -a cursor2Вручную: положить файлы
.cursor/skills/define-problem-statement/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install product-on-purpose/pm-skills define-problem-statement2Вручную: положить файлы
.github/skills/define-problem-statement/SKILL.md1Через Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill define-problem-statement -a gemini-cli2Командой платформы
gemini skills install https://github.com/product-on-purpose/pm-skills --path skills/define-problem-statementВручную: положить файлы
.devin/skills/define-problem-statement/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill define-problem-statement -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о define-problem-statement
Как установить define-problem-statement в Claude?
Выполните npx skills add product-on-purpose/pm-skills --skill define-problem-statement -a claude-code. Скилл окажется в ~/.claude/skills/define-problem-statement/SKILL.md.
Что делает define-problem-statement?
Проводит агента по шагам от сегмента пользователей до метрик успеха и собирает документ с рамкой проблемы. Шаблон и пример лежат в references/TEMPLATE.md и references/EXAMPLE.md.
Чем это отличается от deliver-prd и develop-solution-brief?
deliver-prd берут, когда проблема уже согласована и нужен спек. develop-solution-brief — чтобы предложить и сравнить варианты решения. Здесь фиксируют саму проблему.
Исходный текст
SKILL.md · Apache-2.0
--- name: define-problem-statement description: Creates a clear problem framing document with user impact, business context, and success criteria. Use when starting a new initiative, realigning a drifted project, or communicating up to leadership. license: Apache-2.0 metadata: phase: define version: "2.1.0" updated: 2026-06-10 category: problem-framing frameworks: [triple-diamond, lean-startup, design-thinking] author: product-on-purpose --- <!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 --> # Problem Statement A problem statement is a concise document that frames the problem you're solving, articulates the impact on users and the business, and defines clear success criteria. It serves as the foundation for all subsequent product work by ensuring alignment on *what* problem to solve before jumping to *how* to solve it. ## When to Use - Starting a new initiative or project to establish shared understanding - Realigning a drifted project back to its original intent - Communicating up to leadership or stakeholders about priorities - Evaluating whether a proposed solution actually addresses the core problem - Onboarding new team members to provide context ## When NOT to Use - The problem is already agreed and engineering needs the spec -> use `deliver-prd` - You want to propose and compare solution approaches -> use `develop-solution-brief` - You are capturing customer motivation rather than a business problem -> use `define-jtbd-canvas` - The "problem" is really an unvalidated assumption -> frame it with `define-hypothesis` and test it before committing a team to it ## Instructions When asked to create a problem statement, follow these steps: 1. **Identify the User Segment** Ask who is experiencing this problem. Get specific about the user persona, role, or segment. Avoid vague descriptions like "users" - instead target "mobile shoppers completing checkout" or "enterprise admins managing 50+ users." 2. **Understand the Pain Points** Explore what friction, frustration, or unmet need the user experiences. Ask probing questions to understand the severity and frequency of the problem. Look for evidence from user research, support tickets, or behavioral data. 3. **Establish Business Context** Connect the user problem to business impact. How does this problem affect revenue, retention, growth, or strategic goals? Why should the organization invest in solving this now versus later? 4. **Define Success Metrics** Identify how you will measure success. What metrics will move if this problem is solved? Establish current baselines and target improvements. Be specific and time-bound. 5. **Surface Constraints and Considerations** Note any technical limitations, resource constraints, regulatory requirements, or dependencies that will shape the solution space. 6. **Capture Open Questions** Document what you don't know yet. What assumptions need validation? What additional research is needed? ## Output Format Use the template in `references/TEMPLATE.md` to structure the output. A complete problem statement fills every template section: Problem Summary; User Impact; Business Context; Success Criteria; Constraints & Considerations; and Open Questions. ## Quality Checklist Before finalizing, verify: - [ ] Problem is specific to a defined user segment (not "all users") - [ ] Impact is quantified with data or reasonable estimates - [ ] Success metrics have baselines and targets - [ ] Problem describes the "what" without prescribing the "how" - [ ] Business context explains why this matters now - [ ] Open questions are captured for follow-up ## Examples See `references/EXAMPLE.md` for a completed example.
© product-on-purpose · Apache-2.0 · product-on-purpose/pm-skills