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

021-problem-framing — скилл для Claude Code: установка и обзор

Скилл 021-problem-framing помогает сформулировать суть проблемы, текущее и желаемое состояние, список заинтересованных лиц и критерии успеха до начала поиска решений.

Apache-2.0 139 установок ★ 465 обновлён 2026-10-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jabrena/plinth --skill 021-problem-framing -a claude-code
Открыть на GitHub

Что делает 021-problem-framing

Скилл входит в набор Plinth Toolkit и работает интерактивно. Он заставляет отделить саму проблему от вариантов её реализации: вместо выбора конкретной библиотеки или архитектурного фикса агент фиксирует наблюдаемые факты текущего состояния и описывает целевой результат как возможность, а не механизм.

Процесс разбит на пять шагов. Сначала агент читает файл references/021-problem-framing.md и проверяет доступные свидетельства. Затем он исключает из описания намёки на технологии, документирует статус-кво, находит стороны процесса и задаёт измеримые критерии приёмки. Итог передаётся дальше — например, в скилл 022-root-cause-analysis.

Жёсткое правило скилла запрещает выдумывать детали: если данных в описании задачи не хватает, агент обязан явно запросить уточнения, а не додумывать критерии успеха за команду.

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

  • отделить описание проблемы от предполагаемых технических решений
  • зафиксировать наблюдаемые факты текущего состояния системы
  • сформулировать желаемый результат в виде бизнес-эффекта
  • составить перечень заинтересованных сторон и ответственных лиц
  • определить проверяемые критерии успешного разрешения задачи

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

  • Помоги сформулировать проблему перед началом анализа причин инцидента
  • Примени problem framing к этой задаче и определи текущее и желаемое состояние
  • Составь список стейкхолдеров и критерии успеха для раздела Problem Framing

Как установить 021-problem-framing

1Через Skills CLI (Vercel)

npx skills add jabrena/plinth --skill 021-problem-framing -a claude-code

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

~/.claude/skills/021-problem-framing/SKILL.md

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

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

Вопросы о 021-problem-framing

Как установить 021-problem-framing в Claude Code?

Выполните в терминале команду npx skills add jabrena/plinth --skill 021-problem-framing -a claude-code. Файл навыка сохранится в ~/.claude/skills/021-problem-framing/SKILL.md.

Для чего нужен этот скилл?

Он направляет подготовку структурированного описания проблемы без привязки к конкретному коду, чтобы не допустить поспешного проектирования до выяснения реальных фактов.

Что требуется скиллу для работы?

Перед запуском инструкций агент обязан прочитать локальный справочный документ references/021-problem-framing.md из состава набора Plinth.

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

SKILL.md · Apache-2.0
---
name: 021-problem-framing
description: Use when a problem or issue needs explicit framing before deeper analysis begins — establishing the Problem statement, Current state, Desired state, Stakeholders, and Success criteria. This should trigger when an issue's Problem Framing point of view needs evaluation, or when a maintainer directly asks to frame a problem before root-cause analysis, design, or planning begins. Part of Plinth Toolkit
license: Apache-2.0
metadata:
  author: Juan Antonio Breña Moral
  version: 0.19.0
---
# Problem Framing

Guide production of a Problem statement, Current state, Desired state, Stakeholders, and Success criteria for a problem or issue under exploration. **This is an interactive SKILL**.

**What is covered in this Skill?**

- Stating the problem independently of any specific solution
- Describing the current state using observable facts
- Describing the desired state as an outcome, not an implementation mechanism
- Identifying stakeholders affected by, accountable for, or informed about the problem
- Defining success criteria that make problem resolution verifiable
- Feeding a clarified problem frame into `022-root-cause-analysis` and the remaining Functional Specification lenses

## Constraints

Frame the problem before any deeper analysis. When this technique is orchestrated by another workflow, the orchestrator owns clarifying-question sequencing; when applied standalone, ask directly.

- **MUST** read `references/021-problem-framing.md` before applying Problem Framing guidance
- **MUST** state the problem independently of any specific solution, technology, or implementation
- **MUST** describe the current state using observable facts, not opinions or assumed causes
- **MUST** describe the desired state as an outcome or capability, not a specific mechanism
- **MUST** identify stakeholders affected by, accountable for, or informed about the problem, not only the requester
- **MUST** define success criteria that are observable or measurable
- **MUST NOT** invent a problem statement, state, stakeholder, or success criterion when the available content is vague or ambiguous; flag the gap for a clarifying question instead

## When to use this skill

- Frame this problem before deeper analysis
- Apply problem framing to this issue
- Establish the problem statement, current state, and desired state
- Identify stakeholders and success criteria for this problem
- Draft the Problem Framing section of a Functional Specification

## Workflow

1. **Read the Reference**

Read `references/021-problem-framing.md`, then identify what evidence is already available for the problem statement, current state, desired state, stakeholders, and success criteria.

2. **Separate the Problem from any Solution**

Strip out wording that already assumes a fix, technology, or implementation, and restate the gap in observable terms.

3. **Describe Current and Desired State**

Describe the current state as observable facts and the desired state as a target outcome or capability.

4. **Identify Stakeholders and Success Criteria**

List stakeholders affected by, accountable for, or informed about the problem, then define observable or measurable success criteria.

5. **Report the Problem Frame**

Report the Problem statement, Current state, Desired state, Stakeholders, and Success criteria, and flag any field left open pending a clarifying answer.

## Reference

For detailed guidance, examples, and constraints, see [references/021-problem-framing.md](references/021-problem-framing.md).

© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
problem-framing-canvas deanpeters Скилл problem-framing-canvas помогает структурировать формулировку проблемы по модели MITRE до начала разработки решений. Рассчитан на 30–45 минут интерактивной сессии. CX Codex +1 2 800установок define-problem-statement product-on-purpose Скилл define-problem-statement собирает документ с формулировкой проблемы: кому она мешает, что это значит для бизнеса и по каким метрикам считать успех. CX Codex +1 928установок analyse-problem NeoLabHQ Скилл analyse-problem раскладывает проблему на одну страницу по формату A3: фон, текущее состояние, цель, корневая причина и план действий. CX Codex +1 1 300установок problem-solver tronghieu Скилл problem-solver ведёт поиск корневых причин сбоев и дефектов, отделяя факты от гипотез. Помогает, когда ломается процесс или падают метрики, но источник поломки неизвестен. CX Codex +1 ★ 117звёзд репо foundation-lean-canvas product-on-purpose Скилл foundation-lean-canvas для Claude Code собирает стратегию продукта в одностраничный Lean Canvas. Запускается для проработки новой идеи, проверки бизнес-модели или сравнения вариантов. CX Codex +1 808установок jtbd-framing rampstackco Скилл jtbd-framing для Claude Code применяет метод Jobs-to-be-Done к продуктовым решениям. Он подключается при разборе JTBD, смене приоритетов или позиционировании продукта. CX Codex +1 291установок

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

Весь набор →
812-regulations-eu-product-liability-directive Скилл 812-regulations-eu-product-liability-directive переводит требования директивы ЕС 2024/2853 в инженерные артефакты: область охвата, тесты опасных сценариев, история обновлений и предупреждения для Java-продуктов и ИИ-функций. CX Codex +1 165установок 810-regulations-eu-mifid-ii Скилл 810-regulations-eu-mifid-ii помогает проверить Java-сервисы на соответствие нормам MiFID II и подготовить технические доказательства комплаенса перед релизом. CX Codex +1 165установок 022-root-cause-analysis Скилл 022-root-cause-analysis для Claude Code проводит анализ корневых причин методами «Пять почему», Fishbone и Current Reality Tree. Помогает найти причину ошибки, а не заклеить симптом. CX Codex +1 144установок 025-quality-attribute-discovery Скилл 025-quality-attribute-discovery помогает выявить и расставить приоритеты нефункциональных требований до начала архитектурной работы. Он связывает каждое требование с фактами о проблеме и её контексте. CX Codex +1 143установок 024-context-mapping Скилл 024-context-mapping для Claude Code, Codex, Cursor и других агентов, который собирает карту контекста вокруг задачи: существующие системы, интеграции, владельцы и внешние зависимости. CX Codex +1 142установок 023-assumption-analysis Скилл 023-assumption-analysis помогает выявить допущения и неизвестные в проблеме, оценить их и составить план проверки до начала проектирования. CX Codex +1 140установок 059-design-atdd Скилл 059-design-atdd для Claude Code проверяет, связаны ли цель изменения OpenSpec, критерии приёмки и задачи реализации или проверки. Он собирает отчёт с доказательствами и незакрытыми расхождениями. CX Codex +1 135установок 058-design-bdd Скилл 058-design-bdd проводит Java-команду через Behavior-Driven Development как практику совместного открытия. Работает с проверенными фактами о поведении, конкретными примерами и сценариями на общем языке команды. CX Codex +1 135установок

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

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