菜单
Use when someone needs to write a single user story or a small set of stories — translating a known user need into a structured, development-ready format with acceptance criteria. Triggers on: "write a user story", "user story format", "acceptance
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/newkayak12/claude-skills --skill user-story命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
| name | user-story |
| effort | high |
| description | Use when someone needs to write a single user story or a small set of stories — translating a known user need into a structured, development-ready format with acceptance criteria. Triggers on: "write a user story", "user story format", "acceptance |
| type | component |
| theme | pm-artifacts |
| scenarios | ["I need to write a user story for a new notification system in our B2B SaaS app","Convert this PRD requirement into a properly formatted user story with Gherkin acceptance criteria","Write me a user story with Given/When/Then criteria for the checkout flow","유저 스토리 포맷으로 이 기능 요건을 변환해줘","인수 조건이 포함된 사용자 스토리 작성해줘"] |
| estimated_time | 5-10 min |
| compatibility | {"recommended":[],"optional":["think-tool"],"remote_mcp_note":"think-tool이 있으면 완성된 스토리의 INVEST 기준 검증 품질이 높아집니다. Claude 설정 → MCP Servers에서 remote SSE 엔드포인트를 추가하세요."} |
Use when:
Not for:
| Claude | You |
|---|---|
| Drafts As a / I want / So that structure | Validates persona accuracy against real users |
| Writes Given/When/Then acceptance criteria | Confirms testability with QA |
| Flags anti-patterns (task-style, vague, too large) | Decides on story scope and priority |
| Validates against INVEST criteria | Signs off the story before it enters the sprint |
../user-story-splitting/SKILL.md — split stories that fail the "Small" INVEST check../user-story-mapping/SKILL.md — generate a full story map first, then author individual stories../prd-development/SKILL.md — PRD requirements decompose into user storiesA user story combines:
Use Case (Mike Cohn format):
Acceptance Criteria (Gherkin format):
skills/user-story-splitting/SKILL.md)Before writing a story, ensure you have:
skills/proto-persona/SKILL.md)skills/problem-statement/SKILL.md)If missing context: Run discovery interviews or problem validation work first.
If you want a consistent Markdown stub, you can generate one from CLI inputs. This script is deterministic and does not fetch data or write files.
python3 scripts/user-story-template.py --persona \"trial user\" --action \"log in with Google\" --outcome \"access the app without creating a new password\"
Use template.md for the full fill-in structure. Fill in the Use Case section with As a / I want to / so that fields.
Quality checks:
Common mistakes:
Use template.md for the full fill-in structure. Fill in the Acceptance Criteria section with Scenario / Given / When / Then fields.
Quality checks:
Red flags:
skills/user-story-splitting/SKILL.md)Write a short, memorable summary that captures the story's value:
Examples:
If think-tool is available, invoke it now to review the completed story against these three criteria:
When and one Then in the acceptance criteriaAs a persona is more specific than "user" or "customer"Then clause is independently falsifiable and does not restate the When clauseThe think-tool should output PASS or FLAG with a one-sentence reason for each flagged criterion.
skills/user-story-splitting/SKILL.mdSee examples/sample.md for full examples (good, bad, and split-needed stories).
For detailed pitfall diagnosis and fixes, see references/pitfalls.md.
skills/user-story-splitting/SKILL.md — How to break large stories into smaller onesskills/proto-persona/SKILL.md — Defines the "As a [persona]" sectionskills/problem-statement/SKILL.md — Stories should address validated problemsskills/epic-hypothesis/SKILL.md — Epics decompose into user storiesskills/user-story/scripts/user-story-template.py — Deterministic Markdown stub generator (no network access)prompts/user-story-prompt-template.md in the https://github.com/deanpeters/product-manager-prompts repo.
基于 SOC 职业分类