scope-framing — скилл для Claude Code: рамки исследования и установка
Перед исследованием скилл помогает определить решение, ради которого собирают информацию, и критерии завершения. Пригодится, когда задача рискует уйти в сторону от практического вопроса.
npx skills add ferrumclaudepilgrim/claude-code-android --skill scope-framing -a claude-codeЧто делает scope-framing
Скилл сначала просит сформулировать решение, на которое повлияют результаты, и назвать того, кто будет ими пользоваться. Затем задаёт вопросы о конечном результате, границах исследования и причинах, по которым выводы могут оказаться бесполезными.
Ответы нужно записать в короткий документ до начала работы. Если решение не определено, скилл велит остановиться и попросить пользователя уточнить задачу. Это значит, что исследование не начнётся, пока не появится понятный повод для него.
Скилл доступен для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. В Claude Code для работы ему разрешены Read, Bash, Glob и Grep; тема исследования передаётся как аргумент.
Какие задачи решает
- связать исследование с конкретным решением
- задать критерии завершения исследования
- отделить нужные вопросы от тех, что вне рамок
- выявить причины, из-за которых выводы окажутся бесполезны
Примеры запросов агенту
- Перед исследованием
Roomвыясни, какое решение оно должно поддержать и что будет считаться готовым результатом. - Исследуй варианты хранения с учётом того, кто будет использовать выводы, и перечисли вопросы вне рамок.
- Помоги определить рамки исследования миграции: результат, исключения и факторы, которые могут сделать вывод бесполезным.
Как установить scope-framing
1Через Skills CLI (Vercel)
npx skills add ferrumclaudepilgrim/claude-code-android --skill scope-framing -a claude-code2Вручную: положить файлы
~/.claude/skills/scope-framing/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/scope-framing/
1Через Skills CLI (Vercel)
npx skills add ferrumclaudepilgrim/claude-code-android --skill scope-framing -a codex2Вручную: положить файлы
.agents/skills/scope-framing/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ferrumclaudepilgrim/claude-code-android --skill scope-framing -a cursor2Вручную: положить файлы
.cursor/skills/scope-framing/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ferrumclaudepilgrim/claude-code-android scope-framing2Вручную: положить файлы
.github/skills/scope-framing/SKILL.md1Через Skills CLI (Vercel)
npx skills add ferrumclaudepilgrim/claude-code-android --skill scope-framing -a gemini-cli2Командой платформы
gemini skills install https://github.com/ferrumclaudepilgrim/claude-code-android --path .claude/skills/scope-framingВручную: положить файлы
.devin/skills/scope-framing/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ferrumclaudepilgrim/claude-code-android --skill scope-framing -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о scope-framing
Как установить scope-framing в Claude Code?
Выполните npx skills add ferrumclaudepilgrim/claude-code-android --skill scope-framing -a claude-code, затем используйте файл ~/.claude/skills/scope-framing/SKILL.md.
Что делает scope-framing?
Перед исследованием скилл помогает определить решение, ожидаемый результат, границы работы и возможные причины неудачи. Ответы нужно записать до начала исследования.
Что произойдёт, если решение для исследования не определено?
Скилл остановит исследование и попросит пользователя уточнить, какое решение должны поддержать результаты.
Исходный текст
SKILL.md · MIT
--- name: scope-framing description: Before starting any research task, define what decision the research serves, what "done" looks like, and what is out of scope. Prevents research that answers the technically correct question but not the operationally relevant one. user-invocable: true disable-model-invocation: false argument-hint: "<research topic>" allowed-tools: Read, Bash, Glob, Grep --- # Scope Framing Answer every question before starting research. Write the answers into a brief scope document: one paragraph or a short list per question. Then proceed. If you cannot answer question 1, ask the user before starting. ## Required Questions **1. What decision will this research serve?** One sentence. Name the decision that will change based on what you find. If no decision is downstream of this research, the research has no purpose. Example: "Whether to use package X or build a custom implementation." **2. Who will act on the findings?** Name the actor: a user, an agent, or another system. Different actors need different formats and levels of detail. An agent needs a recommendation. A decision-maker needs tradeoffs. Someone following instructions needs steps. **3. What does "done" look like?** Name the specific deliverable that closes this research. Not "I understand the topic" but "a one-page comparison of options A, B, and C with a recommendation." Research without a defined end state expands forever. **4. What is explicitly out of scope?** Name at least 2 things you will not research. Naming exclusions forces a scope decision and prevents drift. If you cannot name exclusions, your scope is not defined yet. **5. What would make this research useless?** Identify failure modes before you start. Common causes: wrong scope (you answered a related but different question), stale data (the information is outdated for the version in use), missing context (you don't have access to a key constraint that changes the answer). ## Output Write the scope document before doing any research. Save it or include it at the top of your research output. If scope cannot be defined (if question 1 has no answer), stop and ask the user to clarify the decision before you proceed.
© ferrumclaudepilgrim · MIT · ferrumclaudepilgrim/claude-code-android