Token导航 LogoToken导航TokenDH.com
研究检索只读github未标认证来源可访问许可证需确认审计通过

problem-statement问题陈述

Agent Skill

problem-statement 用于查找、检索和筛选相关信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要根据关键词、任务场景或来源线索快速定位候选结果时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

总安装

19,663

周安装

836

GitHub Stars

3,867

下载量

6,889
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:problem-statement(问题陈述)
来源仓库:https://github.com/deanpeters/product-manager-skills
仓库路径:skills/problem-statement
安装命令:
npx skills add https://github.com/deanpeters/product-manager-skills --skill problem-statement
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/deanpeters/product-manager-skills --skill problem-statement

简介

以用户为中心的问题框架,捕捉谁被阻止、他们试图做什么、为什么重要以及感觉如何。

  • 围绕五个维度构建问题:角色、期望结果、障碍、根本原因和情感影响——确保您解决值得解决的问题,而不是功能请求
  • 包括填写模板、质量检查和反模式,以避免解决方案走私、通用角色和症状级诊断
  • 专为解决方案开始前的发现协调、利益相关者的支持和 PRD 框架而设计
  • 以用户研究为基础时效果最佳;包括有关收集上下文、与用户验证以及根据反馈进行迭代的指导

SKILL.md

Purpose

Articulate a problem from the user's perspective using an empathy-driven framework that captures who they are, what they're trying to do, what's blocking them, why, and how it makes them feel. Use this to align stakeholders on the problem before jumping to solutions, and to frame product work around user outcomes rather than feature requests.

This is not a requirements doc—it's a human-centered problem narrative that ensures you're solving a problem worth solving.

Key Concepts

The Problem Framing Framework

Based on Jobs-to-be-Done and empathy mapping, the framework structures problems as:

Problem Framing Narrative:

  • I am: [Describe the persona experiencing the problem]
  • Trying to: [Desired outcomes the persona cares about]
  • But: [Barriers preventing the outcomes]
  • Because: [Root cause of the problem]
  • Which makes me feel: [Emotional impact]

Context & Constraints:

  • [Geographic, technological, time-based, demographic factors]

Final Problem Statement:

  • [Single, concise, empathetic summary]

Why This Structure Works

  • Persona-centric: Forces you to see the problem through the user's eyes
  • Outcome-focused: "Trying to" emphasizes desired results, not tasks
  • Root cause analysis: "Because" pushes past symptoms to underlying issues
  • Emotional validation: "Makes me feel" humanizes the problem and builds empathy
  • Contextual: Constraints acknowledge real-world limitations

Anti-Patterns (What This Is NOT)

  • Not a solution in disguise: "The problem is we lack AI-powered analytics" = sneaking in a solution
  • Not a business problem: "Our revenue is down" isn't a user problem (it's a symptom)
  • Not a feature request: "Users need a dashboard" isn't a problem (what are they trying to do?)
  • Not generic: "Users want better UX" is too vague to be actionable

When to Use This

  • Kicking off discovery or problem validation work
  • Aligning stakeholders before solutioning
  • Socializing a problem with engineering, design, or exec teams
  • When you have feature requests but unclear underlying problems
  • Pitching why a problem is worth solving

When NOT to Use This

  • When you haven't done any user research yet (don't guess—interview first)
  • For internal operational problems (this is for user-facing problems)
  • As a substitute for a PRD (this frames the problem; PRD defines the solution)

Application

Use template.md for the full fill-in structure.

Step 1: Gather User Context

Before drafting, ensure you have:

  • User interviews or research: Direct quotes, observed behaviors, pain points
  • Jobs-to-be-Done insights: What users are "hiring" your product to do (reference skills/jobs-to-be-done/SKILL.md)
  • Persona clarity: Who specifically experiences this problem (reference skills/proto-persona/SKILL.md)
  • Constraints data: Geographic, tech, time, demographic limitations

If missing context: Run discovery interviews, contextual inquiries, or user shadowing. Don't fabricate problems.


Step 2: Draft the Problem Framing Narrative

Fill in the template from the persona's point of view:

## Problem Framing Narrative

**I am:** [Describe the key persona, highlighting 3-4 key characteristics]
- [Key pain point or characteristic 1]
- [Key pain point or characteristic 2]
- [Key pain point or characteristic 3]

**Trying to:**
- [Single sentence listing the desired outcomes the persona cares most about]

**But:**
- [Describe the barriers preventing the persona from achieving outcomes]
- [Job-to-be-done or outcome obstruction 1]
- [Job-to-be-done or outcome obstruction 2]
- [Job-to-be-done or outcome obstruction 3]

**Because:**
- [Describe the root cause empathetically]

**Which makes me feel:**
- [Describe the emotions from the persona's perspective]

Quality checks:

  • "I am" specificity: Can you picture this person? Or is it generic ("busy professionals")?
  • "Trying to" clarity: Is this an outcome (measurable) or a task (activity)?
  • "But" depth: Are these real barriers or just inconveniences?
  • "Because" honesty: Is this the root cause or just a symptom?
  • "Makes me feel" authenticity: Do these emotions come from research or assumptions?

Step 3: Document Context & Constraints

## Context & Constraints

- [Enumerate geographic, technological, time-based, or demographic factors]
- [e.g., "Must work offline in rural areas with limited connectivity"]
- [e.g., "Used by non-technical users unfamiliar with complex software"]
- [e.g., "Time-sensitive: decisions must be made within 24 hours"]

Quality checks:

  • Relevance: Do these constraints directly impact the problem?
  • Specificity: Are they concrete enough to inform design decisions?

Step 4: Craft the Final Problem Statement

Synthesize the narrative into one powerful sentence:

## Final Problem Statement

[Single, concise statement that provides a powerful and empathetic summary]

Formula: [Persona] needs a way to [desired outcome] because [root cause], which currently [emotional/practical impact].

Example: "Enterprise IT admins need a way to provision user accounts in under 5 minutes because current processes take 2+ hours with manual approvals, which causes project delays and frustrated end-users."

Quality checks:

  • One sentence: If it requires multiple sentences, the problem isn't crisp yet
  • Measurable: Can you tell if you've solved it?
  • Empathetic: Does it resonate emotionally?
  • Shareable: Could you say this in a meeting and have stakeholders nod?

Step 5: Validate and Socialize

  • Test with users: Read it aloud to people who experience the problem. Do they say "Yes, exactly!"?
  • Share with stakeholders: Product, engineering, design, exec. Does it align everyone?
  • Iterate based on feedback: If anyone says "I don't think that's the real problem," dig deeper.

Examples

See examples/sample.md for full examples (good and bad problem statements).

Mini example excerpt:

**I am:** A software developer on a distributed team
**Trying to:** Communicate in real-time with my team without losing context
**But:** Email is too slow and IM is ephemeral
**Because:** No tool combines real-time chat with searchable history
**Which makes me feel:** Frustrated and disconnected

Common Pitfalls

Pitfall 1: Solution Smuggling

Symptom: "The problem is we don't have [specific feature]"

Consequence: You've predetermined the solution without validating the problem.

Fix: Reframe around the user's desired outcome, not the feature. Ask "What are they trying to achieve?"


Pitfall 2: Business Problem Disguised as User Problem

Symptom: "Users want to increase our revenue" or "The problem is our churn rate"

Consequence: These are company problems, not user problems. Users don't care about your metrics.

Fix: Dig into *why* users churn or *what* would make them spend more. Frame it from their perspective.


Pitfall 3: Generic Personas

Symptom: "I am a busy professional trying to be more productive"

Consequence: Too broad to be actionable. Every product claims to help "busy professionals."

Fix: Get specific. "I am a sales rep managing 50+ leads manually in spreadsheets, trying to prioritize follow-ups without missing high-value opportunities."


Pitfall 4: Symptom Instead of Root Cause

Symptom: "Because the UI is confusing"

Consequence: You're describing a symptom, not the underlying issue.

Fix: Ask "Why is the UI confusing?" Keep asking "why" until you hit the root cause (e.g., "Because users have no mental model for how the system works").


Pitfall 5: Fabricated Emotions

Symptom: "Which makes me feel empowered and delighted"

Consequence: These sound like marketing copy, not real user emotions.

Fix: Use actual quotes from user interviews. Real emotions: "frustrated," "overwhelmed," "anxious," "stuck."


References

Related Skills

  • skills/jobs-to-be-done/SKILL.md — Informs the "Trying to" and "But" sections
  • skills/proto-persona/SKILL.md — Defines the "I am" persona
  • skills/positioning-statement/SKILL.md — Problem statement informs positioning
  • skills/user-story/SKILL.md — Problem statement guides story prioritization

External Frameworks

  • Clayton Christensen, *Jobs to Be Done* — Origin of outcome-focused problem framing
  • Osterwalder & Pigneur, *Value Proposition Canvas* — Customer pains/gains/jobs
  • Dave Gray, *Empathy Mapping* — Emotional framing techniques

Dean's Work

  • [Link to relevant Dean Peters' Substack articles if applicable]

Provenance

  • Adapted from prompts/framing-the-problem-statement.md in the https://github.com/deanpeters/product-manager-prompts repo.

Skill type: Component Suggested filename: problem-statement.md Suggested placement: /skills/components/ Dependencies: References skills/jobs-to-be-done/SKILL.md, skills/proto-persona/SKILL.md

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Codex

36.84%
按下载量换算2,538

Claude

28.61%
按下载量换算1,971

Cursor

17.68%
按下载量换算1,218

Gemini CLI

10.16%
按下载量换算700

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

只读

该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。当前只有一个来源,正式发布前建议补源仓库或其他目录站核验。

来源信息

继续浏览同类 Skills