Доработка сырой идеи

Доводит сырую идею за три фазы: уточняющие вопросы и пять-восемь вариантов, два-три направления с проверкой ценности, реализуемости и допущений, затем одностраничник с MVP и списком «Чего не делаем». Для случаев, когда идея расплывчата или план надо проверить.

ВайбкодингПак: Agent Skills (Addy Osmani)195 строкidea-refine
Автор
Источник
addyosmani/agent-skills/skills/idea-refine @ 8c99fa3
Лицензия
MIT · Copyright (c) 2025 Addy Osmani

Об этом скилле

Что делает

Скилл доводит сырую идею до одностраничного описания за разговор в три фазы. Сначала агент переформулирует идею как задачу «Как нам…» (How might we), задаёт три-пять уточняющих вопросов (для кого, что считать успехом, какие ограничения, почему сейчас) и предлагает пять-восемь вариантов, каждый через свою линзу: от противного, упрощение, версия в десять раз масштабнее и другие. Если дело происходит в репозитории, варианты опираются на существующую архитектуру.

После вашей реакции агент сводит понравившееся в два-три направления, проверяет каждое на ценность для пользователя, реализуемость и отличие от того, что уже есть, и называет скрытые допущения и то, что может идею убить. Ему прямо велено быть честным, а не поддакивать. Итог — одностраничник: задача, выбранное направление, допущения для проверки, объём MVP, список «Чего не делаем» и открытые вопросы. В docs/ideas/ он сохраняется только с вашего согласия.

С собой у скилла три справочника: frameworks.md (SCAMPER, первые принципы, премортем и другие линзы), refinement-criteria.md (критерии оценки, аудит допущений и правила урезания MVP) и examples.md (три примера сессий). Скрипт scripts/idea-refine.sh только создаёт папку docs/ideas/ и печатает статус в JSON.

Когда включать и когда не надо

Когда идея ещё расплывчатая, когда хочется больше вариантов, прежде чем выбрать один, или когда план нужно проверить на прочность («stress-test my plan»).

Два случая скилл отправляет в другие места: если человек пока не понимает, чего хочет, — в скилл Интервью о задаче, а если направление уже выбрано и нужны требования — в скилл Спецификация и PRD до начала работы. Это диалог, так что без вас в сессии он не работает.

Как поставить и вызвать

Команда установки ниже кладёт SKILL.md, три справочника, скрипт и лицензию. Агент сам подхватывает скилл по описанию или по фразам вроде «refine this idea». Вызвать вручную:

  • Claude Code: /idea-refine или попросить скилл по имени.
  • Codex: $idea-refine.
  • Cursor: наберите / в чате Agent и выберите idea-refine.

Пример: /idea-refine CLI, который показывает команде, какие feature-флаги мёртвые и их можно удалить.

Сессии в examples.md начинаются с /ideate; после этой установки вызов — /idea-refine. Чтобы закрыть шаги до и после, поставьте и два скилла, названных выше.

Чем отличается от похожих

Брейншторм перед работой выясняет, что именно вы хотите построить, и заканчивается одобренным дизайн-документом и планом. Этот скилл работает на шаг раньше и шире: нарочно порождает варианты, оценивает их и заканчивается описанием идеи со списком «Чего не делаем», а не планом реализации. Спецификация перед кодом сразу превращает идею в спецификацию и план работ. Допрос плана разбирает план, решение или идею ветка за веткой — к каждому вопросу рекомендуемый ответ и, где уместно, варианты, — но письменного описания идеи не оставляет. Интервью о задаче из того же набора нужно раньше, когда вы ещё не знаете, чего хотите: вопросы по одному, к каждому догадка, пока намерение не подтверждено. В таком случае этот скилл сам отсылает к нему.

Установка

Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.

Скилл написан на английском — агент поймёт его и ответит вам по-русски.

Claude Code — macOS, Linux
curl -fsSL --create-dirs -o ~/.claude/skills/idea-refine/SKILL.md https://anymodel.org/en/skills/addy-osmani/idea-refine/SKILL.md -o ~/.claude/skills/idea-refine/LICENSE https://anymodel.org/en/skills/addy-osmani/idea-refine/LICENSE -o ~/.claude/skills/idea-refine/examples.md https://anymodel.org/en/skills/addy-osmani/idea-refine/examples.md -o ~/.claude/skills/idea-refine/frameworks.md https://anymodel.org/en/skills/addy-osmani/idea-refine/frameworks.md -o ~/.claude/skills/idea-refine/refinement-criteria.md https://anymodel.org/en/skills/addy-osmani/idea-refine/refinement-criteria.md -o ~/.claude/skills/idea-refine/scripts/idea-refine.sh https://anymodel.org/en/skills/addy-osmani/idea-refine/scripts/idea-refine.sh && chmod +x ~/.claude/skills/idea-refine/scripts/idea-refine.sh
Codex, Cursor — macOS, Linux
curl -fsSL --create-dirs -o ~/.agents/skills/idea-refine/SKILL.md https://anymodel.org/en/skills/addy-osmani/idea-refine/SKILL.md -o ~/.agents/skills/idea-refine/LICENSE https://anymodel.org/en/skills/addy-osmani/idea-refine/LICENSE -o ~/.agents/skills/idea-refine/examples.md https://anymodel.org/en/skills/addy-osmani/idea-refine/examples.md -o ~/.agents/skills/idea-refine/frameworks.md https://anymodel.org/en/skills/addy-osmani/idea-refine/frameworks.md -o ~/.agents/skills/idea-refine/refinement-criteria.md https://anymodel.org/en/skills/addy-osmani/idea-refine/refinement-criteria.md -o ~/.agents/skills/idea-refine/scripts/idea-refine.sh https://anymodel.org/en/skills/addy-osmani/idea-refine/scripts/idea-refine.sh && chmod +x ~/.agents/skills/idea-refine/scripts/idea-refine.sh
Claude Code — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','examples.md','frameworks.md','refinement-criteria.md','scripts/idea-refine.sh') { $p = Join-Path "$HOME\.claude\skills\idea-refine" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/addy-osmani/idea-refine/$f" -UseBasicParsing -OutFile $p }
Codex, Cursor — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','examples.md','frameworks.md','refinement-criteria.md','scripts/idea-refine.sh') { $p = Join-Path "$HOME\.agents\skills\idea-refine" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/addy-osmani/idea-refine/$f" -UseBasicParsing -OutFile $p }

Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/addy-osmani/idea-refine/SKILL.md

SKILL.md

Исходник

Idea Refine

Overview

Refines raw ideas into sharp, actionable concepts worth building through structured divergent and convergent thinking.

When to Use

  • Use when an idea is still vague and needs shaping before it can become a plan
  • Use when you need to stress-test assumptions before committing to a direction
  • Use when you want to expand options before converging on one
  • Trigger phrases: "Help me refine this idea", "Ideate on [concept]", "Stress-test my plan"
  • Not for: a user who is unsure what they want at all (use interview-me), or a direction already chosen that needs a spec (use spec-driven-development)

How It Works

  1. Understand & Expand (Divergent): Restate the idea, ask sharpening questions, and generate variations.
  2. Evaluate & Converge: Cluster ideas, stress-test them, and surface hidden assumptions.
  3. Sharpen & Ship: Produce a concrete markdown one-pager moving work forward.

Usage

This skill is primarily an interactive dialogue. Invoke it with an idea, and the agent will guide you through the process.

# Optional. Run from the project root so this creates ./docs/ideas.
# <skill-dir> is the directory that contains this SKILL.md
# (for example .agents/skills/idea-refine or .cursor/skills/idea-refine).
bash <skill-dir>/scripts/idea-refine.sh

Output

The final output is a markdown one-pager saved to docs/ideas/[idea-name].md (after user confirmation), containing:

  • Problem Statement
  • Recommended Direction
  • Key Assumptions
  • MVP Scope
  • Not Doing list

Detailed Instructions

You are an ideation partner. Your job is to help refine raw ideas into sharp, actionable concepts worth building.

Philosophy

  • Simplicity is the ultimate sophistication. Push toward the simplest version that still solves the real problem.
  • Start with the user experience, work backwards to technology.
  • Say no to 1,000 things. Focus beats breadth.
  • Challenge every assumption. "How it's usually done" is not a reason.
  • Show people the future — don't just give them better horses.
  • The parts you can't see should be as beautiful as the parts you can.

Process

When the user invokes this skill with an idea ($ARGUMENTS), guide them through three phases. Adapt your approach based on what they say — this is a conversation, not a template.

Phase 1: Understand & Expand (Divergent)

Goal: Take the raw idea and open it up.

  1. Restate the idea as a crisp "How Might We" problem statement. This forces clarity on what's actually being solved.

  2. Ask 3-5 sharpening questions — no more. Focus on:

    • Who is this for, specifically?
    • What does success look like?
    • What are the real constraints (time, tech, resources)?
    • What's been tried before?
    • Why now?

    Use the AskUserQuestion tool to gather this input. Do NOT proceed until you understand who this is for and what success looks like.

  3. Generate 5-8 idea variations using these lenses:

    • Inversion: "What if we did the opposite?"
    • Constraint removal: "What if budget/time/tech weren't factors?"
    • Audience shift: "What if this were for [different user]?"
    • Combination: "What if we merged this with [adjacent idea]?"
    • Simplification: "What's the version that's 10x simpler?"
    • 10x version: "What would this look like at massive scale?"
    • Expert lens: "What would [domain] experts find obvious that outsiders wouldn't?"

    Push beyond what the user initially asked for. Create products people don't know they need yet.

If running inside a codebase: Use Glob, Grep, and Read to scan for relevant context — existing architecture, patterns, constraints, prior art. Ground your variations in what actually exists. Reference specific files and patterns when relevant.

Read frameworks.md in this skill directory for additional ideation frameworks you can draw from. Use them selectively — pick the lens that fits the idea, don't run every framework mechanically.

Phase 2: Evaluate & Converge

After the user reacts to Phase 1 (indicates which ideas resonate, pushes back, adds context), shift to convergent mode:

  1. Cluster the ideas that resonated into 2-3 distinct directions. Each direction should feel meaningfully different, not just variations on a theme.

  2. Stress-test each direction against three criteria:

    • User value: Who benefits and how much? Is this a painkiller or a vitamin?
    • Feasibility: What's the technical and resource cost? What's the hardest part?
    • Differentiation: What makes this genuinely different? Would someone switch from their current solution?

    Read refinement-criteria.md in this skill directory for the full evaluation rubric.

  3. Surface hidden assumptions. For each direction, explicitly name:

    • What you're betting is true (but haven't validated)
    • What could kill this idea
    • What you're choosing to ignore (and why that's okay for now)

    This is where most ideation fails. Don't skip it.

Be honest, not supportive. If an idea is weak, say so with kindness. A good ideation partner is not a yes-machine. Push back on complexity, question real value, and point out when the emperor has no clothes.

Phase 3: Sharpen & Ship

Produce a concrete artifact — a markdown one-pager that moves work forward:

# [Idea Name]

## Problem Statement
[One-sentence "How Might We" framing]

## Recommended Direction
[The chosen direction and why — 2-3 paragraphs max]

## Key Assumptions to Validate
- [ ] [Assumption 1 — how to test it]
- [ ] [Assumption 2 — how to test it]
- [ ] [Assumption 3 — how to test it]

## MVP Scope
[The minimum version that tests the core assumption. What's in, what's out.]

## Not Doing (and Why)
- [Thing 1] — [reason]
- [Thing 2] — [reason]
- [Thing 3] — [reason]

## Open Questions
- [Question that needs answering before building]

The "Not Doing" list is arguably the most valuable part. Focus is about saying no to good ideas. Make the trade-offs explicit.

Ask the user if they'd like to save this to docs/ideas/[idea-name].md (or a location of their choosing). Only save if they confirm.

Anti-patterns to Avoid

  • Don't generate 20+ ideas. Quality over quantity. 5-8 well-considered variations beat 20 shallow ones.
  • Don't be a yes-machine. Push back on weak ideas with specificity and kindness.
  • Don't skip "who is this for." Every good idea starts with a person and their problem.
  • Don't produce a plan without surfacing assumptions. Untested assumptions are the #1 killer of good ideas.
  • Don't over-engineer the process. Three phases, each doing one thing well. Resist adding steps.
  • Don't just list ideas — tell a story. Each variation should have a reason it exists, not just be a bullet point.
  • Don't ignore the codebase. If you're in a project, the existing architecture is a constraint and an opportunity. Use it.

Tone

Direct, thoughtful, slightly provocative. You're a sharp thinking partner, not a facilitator reading from a script. Channel the energy of "that's interesting, but what if..." -- always pushing one step further without being exhausting.

Read examples.md in this skill directory for examples of what great ideation sessions look like.

Common Rationalizations

Rationalization Reality
I'll generate 20+ ideas to cover all bases 5-8 well-considered variations beat 20 shallow ones. Quality over quantity.
The user just needs encouragement, not critique A yes-machine produces weak ideas. Push back with specificity and kindness.
Who this is for is obvious — no need to ask Every good idea starts with a person and their problem. Skipping it means designing for nobody.
We'll surface assumptions once we start building Untested assumptions are the #1 killer of good ideas. Surface them before committing.
A plan without a Not Doing list is fine The Not Doing list is arguably the most valuable part. Make trade-offs explicit.

Red Flags

  • Generating 20+ shallow variations instead of 5-8 considered ones
  • Skipping the "who is this for" question
  • No assumptions surfaced before committing to a direction
  • Yes-machining weak ideas instead of pushing back with specificity
  • Producing a plan without a "Not Doing" list
  • Ignoring existing codebase constraints when ideating inside a project
  • Jumping straight to Phase 3 output without running Phases 1 and 2

Verification

After completing an ideation session:

  • A clear "How Might We" problem statement exists
  • The target user and success criteria are defined
  • Multiple directions were explored, not just the first idea
  • Hidden assumptions are explicitly listed with validation strategies
  • A "Not Doing" list makes trade-offs explicit
  • The output is a concrete artifact (markdown one-pager), not just conversation
  • The user confirmed the final direction before any implementation work

Подключить через AnyModel API

Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Agent Skills (Addy Osmani)

Доступность: аудит и исправления по WCAG 2.2

Делает аудит готового интерфейса по WCAG 2.2 AA: axe-core и pa11y, затем клавиатура, экранный чтец и контраст, и исправляет подтверждённые нарушения, начиная с семантического HTML. Для случаев, когда страницу нужно проверить на доступность перед выкладкой.

Проектирование API и интерфейсов

Делает проект API и интерфейсов модулей от контракта: одна форма ошибок, проверка на границах, только добавляющие изменения, пагинация и ключи идемпотентности. Для случаев, когда проектируются эндпоинты или меняется публичный интерфейс.

Тесты в браузере через Chrome DevTools MCP

Делает проверку изменений в настоящем Chrome через MCP-сервер Chrome DevTools: скриншоты, DOM, консоль, сеть и трейсы, а содержимое страницы считает недоверенным. Для случаев, когда разрабатывается или отлаживается что-то в браузере.

Настройка CI/CD

Делает пайплайн CI/CD с закреплённым порядком проверок от линтера до размера бандла, примерами на GitHub Actions, превью-деплоями, фича-флагами, поэтапной выкаткой и откатом. Для случаев, когда настраивается или чинится сборка и деплой.

Код-ревью по нескольким осям

Делает ревью изменения по пяти осям — корректность, читаемость, архитектура, безопасность, производительность, — проверяет тесты мутацией условия и помечает находки по уровню. Для случаев, когда ветку, пул-реквест или дифф пора сливать.

Упрощение кода

Делает работающий код проще для чтения, не меняя поведения: сначала выясняет, зачем он такой, потом упрощает по одному шагу с тестами после каждого. Для случаев, когда код работает, но читается тяжелее, чем мог бы.

Планка качества как контракт

Делает из планки качества проекта контракт: после короткого опроса записывает числа в CONSTRAINTS.md, привязывает их к инструментам и ловит в диффе пропущенные тесты и ослабленные пороги. Для случаев, когда планка нигде не записана.

Настройка контекста агента

Делает настройку контекста агента: шаблон файла правил, загрузка только нужных файлов и разделов спецификации, чистка длинной сессии и безопасный момент начать новую. Для случаев, когда начинается сессия или ответы агента портятся.

Отладка и восстановление после ошибок

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

Вывод из эксплуатации и миграции

Выводит из эксплуатации старые системы, API и фичи: решает, стоит ли, проверяет замену, переводит потребителей по одному, удаляет код при нулевом использовании, схему меняет через expand/contract. Для случаев, когда старое заменяют или переименовывают колонку.

Документация и ADR

Записывает решения в ADR по формату проекта, документирует API, README и changelog с упором на «почему», по истории git проверяет, не устарел ли документ. Для случаев, когда принято дорогое решение, меняется публичный API или документы разошлись с кодом.

Разработка через сомнение

Отдаёт нетривиальные решения субагенту со свежим контекстом, чтобы тот искал ошибки, сортирует находки, ограничивает цикл тремя кругами и предлагает мнение другой модели. Для случаев, когда ставки высоки: авторизация, миграции, необратимые операции.

Фронтенд-интерфейсы для продакшена

Строит компоненты и страницы на дизайн-системе проекта: композиция, простое состояние, WCAG 2.1 AA, mobile-first, состояния загрузки, пустого списка и ошибки, без ИИ-эстетики. Для случаев, когда создают или меняют пользовательский интерфейс.

Git-процесс и версионирование

Ведёт работу в git атомарными коммитами в коротких ветках: сообщения с типом, проверка секретов и тестов перед коммитом, worktree для параллельных агентов, semver, теги и changelog. Для случаев, когда коммитят, ветвятся, открывают PR или выпускают релиз.

Реализация тонкими срезами

Строит изменения тонкими срезами — вертикально, от контракта или от риска, — тестируя и коммитя каждый перед следующим, в рамках задачи, с feature-флагами и откатываемыми шагами. Для случаев, когда правка затрагивает несколько файлов или задача велика.

Интервью о задаче

Расспрашивает по одному вопросу с догадкой об ответе и оценкой уверенности, пока агент не сможет предсказать ответы, и до спецификации и кода получает подтверждённое намерение. Для случаев, когда в запросе неясно, для кого, зачем и что считать успехом.

Наблюдаемость: логи, метрики, трейсы

Встраивает в фичу JSON-логи с ID запроса, метрики RED и USE с ограниченными метками, трейсы OpenTelemetry и алерты по симптомам с ранбуками, а затем проверяет саму телеметрию. Для случаев, когда фича, фоновая задача или интеграция идёт в прод.

Оптимизация производительности

Ускоряет приложение по замерам: снимает базу, исправляет одно доказанное узкое место, перемеряет с учётом разброса и откатывает нейтральные правки; есть примеры для N+1, индексов, кэша и бандла. Для случаев, когда что-то тормозит или не влезает в бюджет.

Разбивка работы на задачи

Разбивает спецификацию на небольшие вертикальные задачи с критериями приёмки, проверками, размером, порядком и контрольными точками — в tasks/todo.md или в трекер. Для случаев, когда спецификация готова, а работа слишком велика для одного захода.

Защита кода от уязвимостей

Защищает код: модель угроз, правила «всегда», «сначала спросить», «никогда» и паттерны против инъекций, XSS, обхода доступа, SSRF, утечки секретов и опасных зависимостей. Для случаев, когда код принимает ввод, ведёт вход, хранит личные данные или зовёт LLM.

Подготовка к запуску в прод

Готовит запуск в прод: чек-лист перед выкаткой, фича-флаг с этапами от 5% до 100%, пороги для продолжения или отката, бюджет ошибок, письменный план отката и проверки в первый час. Для случаев, когда фича или крупное изменение вот-вот уйдёт в прод.

Код по официальной документации

Пишет код под фреймворк по официальной документации: берёт точные версии из файла зависимостей, открывает нужную страницу, следует описанному API и даёт ссылки, помечая непроверенное. Для случаев, когда код должен соответствовать версии фреймворка в проекте.

Спецификация и PRD до начала работы

Пишет спецификацию до кода: выявляет допущения, описывает цель, команды, структуру, стиль, тесты и границы, а план, задачи и код начинает только после одобрения; есть карты модулей и дельта-спецификации. Для случаев, когда у новой фичи размытые требования.

TDD: красный, зелёный, рефакторинг

Ведёт изменения по циклу «красный, зелёный, рефакторинг»: находит команды тестов проекта, пишет падающий тест первым, воспроизводит каждый баг тестом до исправления и задаёт правила для моков и имён. Для случаев, когда добавляется логика или чинится баг.