021-problem-framing — скилл для Claude Code: установка и обзор
Скилл 021-problem-framing помогает сформулировать суть проблемы, текущее и желаемое состояние, список заинтересованных лиц и критерии успеха до начала поиска решений.
Apache-2.0 139 установок ★ 465 обновлён 2026-10-21
npx skills add jabrena/plinth --skill 021-problem-framing -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/021-problem-framing/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/021-problem-framing/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 021-problem-framing -a codex2Вручную: положить файлы
.agents/skills/021-problem-framing/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 021-problem-framing -a cursor2Вручную: положить файлы
.cursor/skills/021-problem-framing/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jabrena/plinth skills/021-problem-framing2Вручную: положить файлы
.github/skills/021-problem-framing/SKILL.md1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 021-problem-framing -a gemini-cli2Командой платформы
gemini skills install https://github.com/jabrena/plinth --path skills/021-problem-framingВручную: положить файлы
.devin/skills/021-problem-framing/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 021-problem-framing -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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