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

user-stories · daveebbelaar — скилл для Claude Code: бэклог и установка

Скилл user-stories для Claude Code, который превращает описание приложения в бэклог пользовательских историй с проверяемыми критериями.

MIT 1 000 установок ★ 1 933 обновлён 2026-11-05

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

Что делает user-stories

Скилл читает docs/BRIEF.md, файлы исследований в docs/research/*.md и docs/screens/INDEX.md, если они есть, а затем записывает истории в docs/STORIES.md. В каждой истории задаётся одно действие, связанные скриншоты, зависимости и статус. Критерии приёмки помечаются способом проверки: снимком экрана, модульным тестом, самопроверкой или ручным тестом.

Бэклог делится на этапы от основного сценария приложения до системных функций и полировки. Для первого этапа задан диапазон от 5 до 10 историй; если всего их больше 60, лишние переносятся в ## Later. Истории с интерфейсом на первом этапе получают блок UX: через инструмент Skill с ux-design, который также начинает docs/GLOSSARY.md.

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

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

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

  • Составь пользовательские истории по docs/BRIEF.md и запиши их в docs/STORIES.md.
  • Разбей функции приложения на приоритетный бэклог с критериями, которые можно проверить.
  • Определи, что строить первым, используя исследование и индекс экранов в docs/.

Как установить user-stories

1Через Skills CLI (Vercel)

npx skills add daveebbelaar/bama --skill user-stories -a claude-code

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

~/.claude/skills/user-stories/SKILL.md

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

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

Вопросы об user-stories

Как установить user-stories в Claude Code?

Выполни npx skills add daveebbelaar/bama --skill user-stories -a claude-code. Файл скилла появится по пути ~/.claude/skills/user-stories/SKILL.md.

Что делает user-stories?

Создаёт docs/STORIES.md с приоритетными пользовательскими историями и проверяемыми критериями приёмки на основе brief, исследований или индекса экранов.

Как скилл задаёт критерии приёмки?

Каждый критерий получает метку способа проверки: снимок экрана, модульный тест, самопроверка или ручной тест. История описывает одно действие пользователя.

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

SKILL.md · MIT
---
name: user-stories
description: Prioritized backlog of user stories with checkable acceptance criteria (docs/STORIES.md) for a macOS app, built from a brief, research, or screen index. Use after app-brief or clone, or when the user asks for user stories, a backlog, a feature list, or "what do we build first".
---

# User stories

Screens show what an app looks like. Stories say what a person does with
it. You build and test stories, not screens.

Read `docs/BRIEF.md`, `docs/research/*.md`, and `docs/screens/INDEX.md`
where they exist. Write `docs/STORIES.md`.

## Story format

```markdown
### S-012 Complete a task with the keyboard
As the user, I select a task and press Command-Return to complete it.
Screens: 01-inbox.png, 02-today.png
Depends: S-004
Acceptance:
- [snap] The circle fills and the row fades out within half a second.
- [self] An "Undo" banner shows for five seconds; Command-Z also undoes it.
- [unit] A recurring task moves to its next date.
Status: todo
```

- One action per story. "Rename a project from its context menu", not
  "Manage projects".
- Every acceptance line starts with how it is checked: `[snap]` snapshot,
  `[unit]` unit test, `[self]` self-test, `[manual]` a person must try it.
  "Works well" is not checkable.
- `Screens:` links reference screenshots, so `improve-loop` knows what to
  compare. Without a reference app, name the snapshot pages that will show
  the story. A panel, sheet, or menu needs its own snapshot page.
- `Depends:` (optional) lists stories that must be done first.
- Keep a control and the only surface that shows it in one story: a
  highlighting field that lives only in the quick-add panel ships with the
  panel.
- Status: `todo`, `doing`, `done`, or `dropped`.

## Milestones

Each milestone ends with an app the user can use for a day.

1. **M1 Core loop**: the one thing the app is for, end to end. Data
   survives a restart.
2. **M2 Organize**: the main structure, sidebar pages, moving items.
3. **M3 Time**: dates, Today and Upcoming, recurrence, reminders.
4. **M4 Speed**: quick-add panel, global shortcut, natural language input,
   keyboard navigation, search, menu commands.
5. **M5 System**: menu bar, Share menu, Shortcuts, notifications, CLI.
6. **M6 Polish**: drag and drop, context menus, empty states, icon, settings.

Rename milestones to fit the app. Inside a milestone, stories that others
depend on come first.

## Seed data

Every attribute the seed data sets (symbols, colors, notes) is something a
story lets the user create in the app. Otherwise snapshots show features
no one can use.

## Leave things out

Drop what exists only for other people or for the vendor: accounts,
sharing, teams, integrations, upgrade prompts, gamification. List them
under `## Dropped`, one line each, so the decision is visible.

## UX notes

For each M1 story that adds a screen, an action, or words, call the Skill
tool with `ux-design`. It adds a `UX:` block under the acceptance lines and
starts `docs/GLOSSARY.md`, so every story uses the same names. Later
milestones get their UX notes in `improve-loop`, just before they are built.

## Size check

M1 has 5 to 10 stories. Over 60 stories in total means version one is too
big: move stories to `## Later`.

Done when every main job in the brief, every "Version one: yes" row in the
research matrix, and every screen in the index maps to a story or a
`Dropped` line, and every M1 story with UI has a `UX:` block.

© daveebbelaar · MIT · daveebbelaar/bama

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

Все скиллы по теме «Заметки, задачи и проекты» →

Сначала — user-stories от других авторов.

user-stories phuryn Скилл user-stories для Claude Code, Codex, Cursor и других агентских CLI: разбивает фичу на пользовательские истории по трём C и INVEST. Запускается, когда фичу пора превратить в элементы бэклога. CX Codex +1 3 500установок write-stories Paweł Huryn Команда write-stories разбивает описание функции или PRD на элементы бэклога с критериями приёмки. Выберите формат: user stories, job stories или WWA. CX Codex +1 ★ 28 211звёзд репо deliver-user-stories product-on-purpose Скилл deliver-user-stories разбивает описание фичи или PRD на юзер-стори в формате «как <роль>, я хочу <действие>, чтобы <выгода>» — с критериями приёмки и проверкой по INVEST. CX Codex +1 1 000установок user-story-writing aj-geddes Скилл user-story-writing оформляет требования к продукту в виде пользовательских историй с критериями приёмки Given-When-Then. Пригодится при планировании спринтов и ведении бэклога. CX Codex +1 798установок bmad-epics-and-stories aj-geddes Скилл bmad-epics-and-stories превращает PRD и архитектуру в готовый к разработке бэклог: один файл epics.md и набор самодостаточных story-файлов с критериями приёма, заметками разработчика и картой зависимостей. CX Codex +1 138установок writing-user-stories nicepkg Скилл writing-user-stories для Claude Code помогает агентам писать user stories по правильному формату. Запускается, когда нужно сформулировать требование через призму пользователя — его роль, действие и выгода. CX Codex +1 1установок 02-user-stories AI-Driven Dev Скилл 02-user-stories разбирает эпик, бриф или PRD на упорядоченные пользовательские истории с критериями приёмки и проверяет их готовность. CX Codex +1 ★ 571звёзд репо

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

Весь набор →
app-brief Скилл app-brief для Claude Code и Cursor создаёт одностраничный файл docs/BRIEF.md для нового приложения под macOS до написания кода. CX Codex +1 1 000установок design-from-app Скилл design-from-app для Claude Code воссоздает дизайн любого приложения в виде нативной дизайн-системы SwiftUI по скриншотам. CX Codex +1 1 000установок os-integrations Скилл os-integrations для Claude Code помогает выбрать API macOS и нужные разрешения для системных функций приложения. Включается при добавлении глобальных горячих клавиш, захвата экрана или управления окнами других приложений. CX Codex +1 1 000установок layout-grid Скилл layout-grid для Claude Code проверяет сетку и выравнивание в приложениях macOS SwiftUI. Запускается при создании кастомных экранов, карточек, форм и после изменения вёрстки. CX Codex +1 1 000установок swift-swiftui Скилл swift-swiftui для Claude Code задаёт правила Swift 6 и SwiftUI для приложений macOS. Подключается при написании, проверке и отладке Swift-кода, в том числе при ошибках конкуренции и Sendable. CX Codex +1 1 000установок design-kit Скилл design-kit для Claude Code и Cursor собирает дизайн-систему для macOS SwiftUI на токенах и компонентах. Включается, когда нужна своя тема интерфейса, фирменный стиль или библиотека элементов. CX Codex +1 1 000установок design-system Скилл design-system для Claude Code собирает дизайн-систему macOS-приложения из цветовых и интерфейсных токенов. Он подключается при настройке акцентного цвета, тем или общих правил для экранов. CX Codex +1 1 000установок new-mac-app Скилл new-mac-app для Claude Code создаёт нативное macOS-приложение на SwiftUI из готового шаблона. Он запускается, когда нужен новый проект или каркас приложения. CX Codex +1 1 000установок

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

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