Break produto scope em utilizador stories com claro critérios de aceitação. — Claude Skill
Um Skill Claude para Claude Code por Pawel Huryn — executar /write-stories no Claude·Atualizado em 18 de jun. de 2026·vmain@d384f0c
Converte funcionalidades, designs e contexto de PRD em user stories pequenas usando 3 Cs e INVEST, com critérios de aceitação testáveis e casos-limite.
- transforma a feature ou PRD em stories que explicam who precisa de what e why.
- usa Card, Conversation, e Confirmation so stories carry intent, não just tasks.
- Applies INVEST criteria so stories stay independent, small, valuable, e testable.
- Writes critérios de aceitação, casos-limite, e out-de-scope notes that QA, design, e engenharia can verify.
o equipa cria a large ticket called “criar onboarding checklist,” then discovers casos-limite during implementation.
Run /write-stories para split o feature em utilizador-centered stories com claro critérios de aceitação antes sprint planning.
Para quem é
O que faz
Break a feature em sprint-sized stories com critérios de aceitação.
transformar Figma flows e PRD notes em implementation-pronto backlog items.
Make o expected behavior testable antes engenharia starts.
Como funciona
ler o feature, PRD, design link, utilizador roles, e pressupostos.
Identify distinct utilizador journeys e split o work em independent stories.
Write each story as utilizador, ação, e benefit.
Add critérios de aceitação covering normal behavior, casos-limite, validation, accessibility, e integrations.
assinalar stories that are too large, blocked by em falta decisões, ou não pronto para sprint planning.
Opções de entrada
o scope that precisa de para become backlog items.
Exemplo
Feature: onboarding checklist para novo workspace admins. utilizadores: workspace admin, invited teammate. Design: Figma link. Business goal: raise ativação a partir de 38% para 55%. Rules: show checklist only during primeiro 14 days; completed tasks deve não distract admins; invite reminder can be sent once per day; admin precisa de para know what is blocking ativação; suporte wants an evento log when reminders are sent.
Não crie um ticket grande chamado “criar checklist de onboarding”. Divida pela jornada do utilizador: admin entende progresso, admin lembra colegas, colega aceita convite, suporte vê histórico de lembretes.
As a workspace admin, I want para see which setup steps are incomplete so that I know what is blocking ativação. critérios de aceitação: 1. checklist appears only para workspaces less than 14 days antigo. 2. atual ativação bloqueio appears primeiro. 3. Completed tasks are marked complete e visually de-emphasized. 4. If todos tasks are complete, o empty declarar explains that setup is done. 5. o checklist is usable com keyboard navigation e screen readers.
As a workspace admin, I want para remind invited teammates a partir do checklist so that setup does não stall. critérios de aceitação: 1. Reminder button appears only para pending invites. 2. Reminder can be sent once per teammate per day. 3. Admin sees a claro success ou failure mensagem. 4. Reminder activity is logged para suporte. 5. o button is disabled com an explanation depois o diário limit is reached.
As an invited teammate, I want o invite link para take me directly para o workspace so that I can start collaborating sem asking o admin para ajudar. critérios de aceitação: 1. Valid invite opens o correct workspace. 2. Expired invite explains what happened e offers a pedido-novo-invite path. 3. Already accepted invite routes para o workspace. 4. Acceptance updates o admin checklist dentro do expected refresh window.
Do não incluir bulk CSV invite, role-permission redesign, ou SSO provisioning in this story set. criar separate discovery items if those are still needed.
pronto depois produto confirms 14-day visibility rule, Design confirms empty declara, engenharia confirms reminder-taxa limit, e suporte confirms o evento log campos they precisar de.
Métricas que melhora
Funciona com
Quer usar User Stories?
Escolha como começar.
Instale e execute este skill localmente no seu computador.
Abra um terminal no seu computador e cole este comando:
Isto descarrega o skill com todos os ficheiros para o seu computador:
Adicione -g no fim para o tornar disponível em todos os seus projetos.
Inicie o Claude Code, depois escreva o comando:
utilizador Stories
criar utilizador stories following o 3 C's (Card, Conversation, Confirmation) e INVEST criteria. gera stories com descriptions, design links, e critérios de aceitação.
usar when: Writing utilizador stories, breaking down features em stories, creating backlog items, ou defining critérios de aceitação.
Arguments:
- ¤KEEP0¤: o produto ou system nomear
- ¤KEEP0¤: o novo feature para break em stories
- ¤KEEP0¤: Link para design files (Figma, Miro, etc.)
- ¤KEEP0¤: Key pressupostos ou contexto
Step-by-Step processo
- Analyze o feature based on provided design e contexto
- Identify utilizador roles e distinct utilizador journeys
- Apply 3 C's framework:
- Card: Simple title e one-liner
- Conversation: Detailed discussion de intent
- Confirmation: claro critérios de aceitação
- Respect INVEST criteria: Independent, Negotiable, Valuable, Estimable, Small, Testable
- usar plain language a primary school graduate can understand
- Link para design files para visual reference
- Output utilizador stories in structured format
Story template
Title: [Feature nomear]
Description: As a [utilizador role], I want para [ação], so that [benefit].
Design: [Link para design files]
critérios de aceitação:
- [claro, testable criterion]
- [Observable behavior]
- [System valida correctly]
- [Edge case handling]
- [Performance ou accessibility consideration]
- [Integration point]
Example utilizador Story
Title: Recently Viewed Section
Description: As an Online Shopper, I want para see a 'Recently viewed' section on o produto página para easily revisit items I considered.
Design: [Figma link]
critérios de aceitação:
- o 'Recently viewed' section is displayed at o bottom do produto página para cada utilizador who has previously viewed at least 1 produto.
- It is não displayed para utilizadores visiting o primeiro produto página de their session.
- o atual produto itself is excluded a partir do displayed items.
- o section showcases produto cards ou thumbnails com images, titles, e prices.
- Each produto card indicates when it was viewed (e.g., 'Viewed 5 minutes ago').
- Clicking on a produto card leads o utilizador para o corresponding produto página.
Output Deliverables
- Complete set de utilizador stories para o feature
- Each story inclui title, description, design link, e 4-6 critérios de aceitação
- Stories are independent e can be developed in qualquer order
- Stories are sized para one sprint cycle
- Stories reference related design documentation
Further Reading
Documentos de referência
name: user-stories description: "criar utilizador stories following o 3 C's (Card, Conversation, Confirmation) e INVEST criteria com descriptions, design links, e critérios de aceitação. usar when writing utilizador stories, breaking down features em backlog items, ou defining critérios de aceitação."
utilizador Stories
criar utilizador stories following o 3 C's (Card, Conversation, Confirmation) e INVEST criteria. gera stories com descriptions, design links, e critérios de aceitação.
usar when: Writing utilizador stories, breaking down features em stories, creating backlog items, ou defining critérios de aceitação.
Arguments:
- ¤KEEP0¤: o produto ou system nomear
- ¤KEEP0¤: o novo feature para break em stories
- ¤KEEP0¤: Link para design files (Figma, Miro, etc.)
- ¤KEEP0¤: Key pressupostos ou contexto
Step-by-Step processo
- Analyze o feature based on provided design e contexto
- Identify utilizador roles e distinct utilizador journeys
- Apply 3 C's framework:
- Card: Simple title e one-liner
- Conversation: Detailed discussion de intent
- Confirmation: claro critérios de aceitação
- Respect INVEST criteria: Independent, Negotiable, Valuable, Estimable, Small, Testable
- usar plain language a primary school graduate can understand
- Link para design files para visual reference
- Output utilizador stories in structured format
Story template
Title: [Feature nomear]
Description: As a [utilizador role], I want para [ação], so that [benefit].
Design: [Link para design files]
critérios de aceitação:
- [claro, testable criterion]
- [Observable behavior]
- [System valida correctly]
- [Edge case handling]
- [Performance ou accessibility consideration]
- [Integration point]
Example utilizador Story
Title: Recently Viewed Section
Description: As an Online Shopper, I want para see a 'Recently viewed' section on o produto página para easily revisit items I considered.
Design: [Figma link]
critérios de aceitação:
- o 'Recently viewed' section is displayed at o bottom do produto página para cada utilizador who has previously viewed at least 1 produto.
- It is não displayed para utilizadores visiting o primeiro produto página de their session.
- o atual produto itself is excluded a partir do displayed items.
- o section showcases produto cards ou thumbnails com images, titles, e prices.
- Each produto card indicates when it was viewed (e.g., 'Viewed 5 minutes ago').
- Clicking on a produto card leads o utilizador para o corresponding produto página.
Output Deliverables
- Complete set de utilizador stories para o feature
- Each story inclui title, description, design link, e 4-6 critérios de aceitação
- Stories are independent e can be developed in qualquer order
- Stories are sized para one sprint cycle
- Stories reference related design documentation