defining-stories

kecbigmt 的头像作者 kecbigmt

指导创建用户故事和史诗设计文档。在定义新功能、编写Given-When-Then标准、创建故事日志或设计需要范围定义的较大功能时使用。

📖 中文导读:指导创建用户故事和史诗设计文档。在定义新功能、编写Given-When-Then标准、创建故事日志或设计需要范围定义的较大功能时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: defining-stories description: Create user stories and epic design documents. Use when defining new features, writing Given-When-Then criteria, creating story logs, or designing larger features.

Defining Stories

Epic vs Story

Document Purpose When to Create
Epic Design document defining scope and technical approach Starting a larger feature
Story Incremental deliverable with acceptance criteria As needed during development

Agile approach: Stories emerge during development. Create each story when ready to implement.

User Story Format

As a [role], I want [capability], so that [benefit].

Acceptance Criteria

- [ ] **Given** [precondition], **When** you [action], **Then** [expected result]
  • Focus on user-observable behavior
  • Include happy paths AND error cases
  • Leave checkboxes unchecked (PO checks them)

Verification Approach

Define how criteria will be verified:

Project Type Options
CLI Direct command execution
API curl/httpie, API testing tools
Web UI E2E tests, browser MCP tools
Mobile Device/emulator, MCP tools
Library Unit/integration tests

If MCP tools or skills for testing are available, use them. If unsure, ask PO.

Story Log

File: docs/stories/<YYYYMMDDTHHMMSS>_<name>.story.md

date -u +"%Y%m%dT%H%M%S"  # Generate timestamp

Use the story-template skill for structure.

Epic Documents

Directory: docs/stories/<YYYYMMDD>_<epic-name>/ File: <YYYYMMDDTHHMMSS>_<epic-name>.epic.md

Use the epic-template skill for structure.