user-stories · daveebbelaar — скилл для Claude Code: бэклог и установка
Скилл user-stories для Claude Code, который превращает описание приложения в бэклог пользовательских историй с проверяемыми критериями.
MIT 1 000 установок ★ 1 933 обновлён 2026-11-05
npx skills add daveebbelaar/bama --skill user-stories -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/user-stories/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/user-stories/
1Через Skills CLI (Vercel)
npx skills add daveebbelaar/bama --skill user-stories -a codex2Вручную: положить файлы
.agents/skills/user-stories/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add daveebbelaar/bama --skill user-stories -a cursor2Вручную: положить файлы
.cursor/skills/user-stories/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install daveebbelaar/bama skills/plan/user-stories2Вручную: положить файлы
.github/skills/user-stories/SKILL.md1Через Skills CLI (Vercel)
npx skills add daveebbelaar/bama --skill user-stories -a gemini-cli2Командой платформы
gemini skills install https://github.com/daveebbelaar/bama --path skills/plan/user-storiesВручную: положить файлы
.devin/skills/user-stories/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add daveebbelaar/bama --skill user-stories -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.