story — скилл для Claude Code: что делает и как установить
Скилл story для Claude Code уточняет одну пользовательскую историю перед разработкой, добавляет критерии приёмки и формирует краткий план реализации.
MIT ★ 265 обновлён 2026-11-11
npx skills add nschurmann/hola-ai --skill story -a claude-codeЧто делает story
Скилл анализирует переданную задачу вместе с текущей кодовой базой и файлом инструкций проекта. На этой основе он формулирует критерии приёмки в формате Given/When/Then с точки зрения пользователя, фиксируя только видимое поведение без деталей внутренней реализации. Если критериев получается больше трёх, ассистент предлагает разбить историю на несколько частей и переходит к первой из них.
Вместе с критериями создаётся мини-план максимум из пяти пунктов без упоминания файлов или фрагментов кода. Дополнительные архитектурные паттерны попадают в отдельный блок предложений только при наличии прямых предпосылок в исходном коде. Результат оформляется готовым markdown-блоком с описанием задачи, критериями, границами скоупа и ждёт подтверждения человека.
Какие задачи решает
- сформулировать критерии приёмки в формате Given/When/Then
- разбить слишком крупную историю на несколько небольших задач
- составить верхнеуровневый план реализации без привязки к файлам
- зафиксировать границы задачи и отсечь лишние требования
Примеры запросов агенту
- Возьми историю «Как пользователь, я хочу сбросить пароль по ссылке из письма» и подготовь критерии приёмки
- Оформи критерии приёмки и мини-план для тикета на добавление фильтрации заказов
Как установить story
1Через Skills CLI (Vercel)
npx skills add nschurmann/hola-ai --skill story -a claude-code2Вручную: положить файлы
~/.claude/skills/story/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/story/
1Через Skills CLI (Vercel)
npx skills add nschurmann/hola-ai --skill story -a codex2Вручную: положить файлы
.agents/skills/story/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add nschurmann/hola-ai --skill story -a cursor2Вручную: положить файлы
.cursor/skills/story/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install nschurmann/hola-ai skills/story2Вручную: положить файлы
.github/skills/story/SKILL.md1Через Skills CLI (Vercel)
npx skills add nschurmann/hola-ai --skill story -a gemini-cli2Командой платформы
gemini skills install https://github.com/nschurmann/hola-ai --path skills/storyВручную: положить файлы
.devin/skills/story/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о story
Как установить story в Claude Code?
Выполните команду npx skills add nschurmann/hola-ai --skill story -a claude-code. Также можно разместить файл вручную по пути ~/.claude/skills/story/SKILL.md.
Что делает story?
Скилл прорабатывает одну задачу перед кодингом: сверяет её с репозиторием, формулирует критерии приёмки и составляет план не более чем из пяти пунктов.
Что происходит, если у задачи набирается больше трёх критериев?
Скилл предлагает декомпозировать её на несколько историй стандартного формата и продолжает разбор только с первой частью.
Исходный текст
SKILL.md · MIT
--- name: story description: Takes ONE user story from the backlog, adds acceptance criteria and proposes an implementation plan. disable-model-invocation: true --- # Story We refine a single story, right before building it. You propose and I decide. ## Steps 1. **Read the story** I give you and review the current code and the project's agent instructions file to understand the context. 2. **Acceptance criteria.** Propose in Given/When/Then format. They only describe *what* the user sees or gets, never *how* it's implemented. 3. **If it needs more than 3 criteria, evaluate splitting it.** Deliver the new stories in backlog format (`As a…, I want…, so that…`) for me to add to the tracker, and we continue with the first one. 4. **Mini plan.** 5 bullets max, no code or file names. How it cuts through the layers. 5. **Wait for my approval.** We adjust until I say yes. ## Rules - **Don't invent requirements.** If information is missing, ask me. - **The simplest thing that meets the criteria.** No abstractions, layers, configuration or patterns "for the future". - **Suggest, don't decide.** If a pattern could help, mention it under "Suggestions" with its why. Only suggest it if there's a concrete signal in the current code, not in advance. ## Output format A block ready to paste into the issue. ```markdown ## Story As a <actor>, I want <action>, so that <benefit>. ## Acceptance criteria - [ ] Given <context>, when <action>, then <result>. - [ ] ... ## Plan - ... ## Out of scope - <what's left out of this story, so it doesn't sneak in> ## Suggestions (your call) - <optional> ```
© nschurmann · MIT · nschurmann/hola-ai