theme-epic-story
9
总安装量
2
周安装量
#32438
全站排名
安装命令
npx skills add https://github.com/flpbalada/my-opencode-config --skill theme-epic-story
Agent 安装分布
opencode
2
claude-code
2
amp
1
cursor
1
kimi-cli
1
codex
1
Skill 文档
Theme, Epic, Story – Hierarchical Product Work Structure
A framework for organizing product work at multiple levels of granularity. This hierarchy helps teams plan strategically while maintaining clear, actionable work items that can be completed within sprints.
When to Use This Skill
- Organizing product backlogs
- Planning releases and roadmaps
- Breaking down large initiatives
- Communicating with stakeholders at different levels
- Estimating effort for large features
- Prioritizing work across teams
Hierarchy Overview
PRODUCT WORK HIERARCHY
Theme (Strategic)
â
âââ Epic (Tactical)
â âââ Story (Operational)
â âââ Story
â âââ Story
â
âââ Epic
â âââ Story
â âââ Story
â âââ Story
â
âââ Epic
âââ Story
âââ Story
Time scope:
Theme: Quarters/Year
Epic: Weeks/Months
Story: Days/Sprint
Theme
Definition
THEME = Strategic Goal or Focus Area
Characteristics:
ââââââââââââââââââââââââââââââââââââââââââââââââââââ
â ⢠Broad business or user objective â
â ⢠Spans multiple epics and stories â
â ⢠Aligns with company vision/strategy â
â ⢠May take quarters to fully address â
â ⢠Guides prioritization decisions â
ââââââââââââââââââââââââââââââââââââââââââââââââââââ
Examples:
âââ "Improve Mobile Experience"
âââ "Increase User Retention"
âââ "Expand to Enterprise Market"
âââ "Reduce Customer Support Load"
âââ "Enable Self-Service"
Theme Structure
| Component | Description |
|---|---|
| Name | Clear, memorable identifier |
| Objective | What success looks like |
| Key Results | Measurable outcomes |
| Related Epics | Work that contributes to this theme |
| Owner | Strategic accountable person |
Epic
Definition
EPIC = Large Feature or Initiative
Characteristics:
ââââââââââââââââââââââââââââââââââââââââââââââââââââ
â ⢠Too large for single sprint â
â ⢠Delivers significant user value â
â ⢠Contains multiple related stories â
â ⢠Can be released incrementally â
â ⢠Has clear start and end â
ââââââââââââââââââââââââââââââââââââââââââââââââââââ
Examples:
âââ "User Authentication System"
âââ "Document Management Module"
âââ "Payment Processing Integration"
âââ "Search and Discovery Feature"
âââ "Onboarding Flow Redesign"
Epic Structure
Epic Template:
EPIC: [Name]
âââ Theme: [Parent theme]
âââ Objective: [What this epic achieves]
âââ Success Metrics: [How we measure completion]
âââ Stories:
â âââ Story 1
â âââ Story 2
â âââ Story 3...
âââ Dependencies: [Other epics/external factors]
âââ Estimated Duration: [Sprints/weeks]
âââ Owner: [Product owner or lead]
Story (User Story)
Definition
STORY = Smallest Unit of User Value
Characteristics:
ââââââââââââââââââââââââââââââââââââââââââââââââââââ
â ⢠Completable within single sprint â
â ⢠Delivers tangible user value â
â ⢠Written from user's perspective â
â ⢠Testable with clear acceptance criteria â
â ⢠Independent enough to be prioritized â
ââââââââââââââââââââââââââââââââââââââââââââââââââââ
Format: "As a [user], I want [goal] so that [benefit]"
Examples:
âââ "As a user, I want to reset my password via email
â so that I can regain access to my account"
âââ "As an admin, I want to view user activity logs
â so that I can audit system usage"
âââ "As a customer, I want to save my cart
so that I can complete purchase later"
Story Structure (INVEST Criteria)
| Criterion | Meaning |
|---|---|
| Independent | Can be worked on separately from other stories |
| Negotiable | Open to discussion on implementation |
| Valuable | Delivers value to user or business |
| Estimable | Team can estimate effort required |
| Small | Fits within single sprint |
| Testable | Has clear acceptance criteria |
Hierarchy Example
THEME: Document Management
â
â "Enable users to efficiently manage and
â collaborate on documents within our platform"
â
âââ EPIC: Document Storage System
â â
â â "Users can upload, organize, and
â â retrieve documents securely"
â â
â âââ STORY: Design database schema for documents
â â âââ AC: Schema supports metadata, versioning, permissions
â â
â âââ STORY: Implement file upload functionality
â â âââ AC: Users can upload files up to 100MB
â â
â âââ STORY: Create folder organization UI
â â âââ AC: Users can create, rename, delete folders
â â
â âââ STORY: Add document search capability
â âââ AC: Users can search by name, content, date
â
âââ EPIC: Document Sharing
â â
â âââ STORY: Implement share link generation
â âââ STORY: Add permission levels (view/edit)
â âââ STORY: Create sharing notification system
â
âââ EPIC: Document Collaboration
â
âââ STORY: Implement real-time co-editing
âââ STORY: Add commenting functionality
âââ STORY: Create version history view
Breaking Down Work
Theme â Epics
Decomposition Questions:
Theme: "Improve Mobile Experience"
â
â¼
Ask: What major initiatives contribute to this?
Epics:
âââ "Responsive Design Overhaul"
âââ "Mobile-Specific Features"
âââ "Performance Optimization for Mobile"
âââ "Touch Gesture Implementation"
âââ "Offline Mode Support"
Epic â Stories
Decomposition Techniques:
1. BY WORKFLOW STEPS
Epic: User Registration
âââ Stories: Enter details â Verify email â Set preferences â Complete
2. BY USER ROLES
Epic: Admin Dashboard
âââ Stories: Super admin view â Manager view â Standard admin view
3. BY DATA TYPES
Epic: Import Functionality
âââ Stories: CSV import â JSON import â Excel import
4. BY OPERATIONS (CRUD)
Epic: Contact Management
âââ Stories: Create contact â Read/list â Update â Delete
5. BY ACCEPTANCE CRITERIA
Epic: Search Feature
âââ Stories: Basic search â Filters â Sort â Save searches
Estimation Guidance
SIZE REFERENCE
Theme:
âââ Duration: Quarters to year
âââ Team effort: Multiple teams possible
âââ Story count: 50-200+ stories
Epic:
âââ Duration: 2-8 weeks typically
âââ Team effort: 1-2 teams
âââ Story count: 5-20 stories
âââ Story points: 40-150 points
Story:
âââ Duration: 1-5 days
âââ Team effort: 1-3 developers
âââ Story points: 1-13 points (Fibonacci)
âââ If > 13 points â Break down further
Stakeholder Communication
| Audience | Focus Level | Key Information |
|---|---|---|
| Executives | Themes | Strategic alignment, OKRs, ROI |
| Product Leaders | Epics | Roadmap, dependencies, timelines |
| Development Team | Stories | Acceptance criteria, tech details |
| Customers | Themes/Epics | Benefits, release timelines |
Analysis Template
## Work Breakdown Structure
**Initiative:** [Name] **Date:** [Date]
### Theme Definition
**Theme:** [Name] **Objective:** [What we're trying to achieve] **Key Results:**
- [ ] KR1: [Measurable outcome]
- [ ] KR2: [Measurable outcome]
### Epic Breakdown
| Epic | Stories | Est. Sprints | Priority |
| ------ | ------- | ------------ | ------------ |
| Epic 1 | X | Y | High/Med/Low |
| Epic 2 | X | Y | High/Med/Low |
### Story Inventory (per Epic)
**Epic:** [Name]
| Story | Points | Sprint | Status |
| ----------------- | ------ | -------- | ------ |
| As a... I want... | X | Sprint N | To Do |
| As a... I want... | X | Sprint N | To Do |
### Dependencies
| Item | Depends On | Risk Level |
| ------------ | ------------ | ------------ |
| [Epic/Story] | [Dependency] | High/Med/Low |
### Release Plan
| Release | Epics Included | Target Date |
| ------- | -------------- | ----------- |
| v1.0 | Epic 1, 2 | [Date] |
| v1.1 | Epic 3 | [Date] |
Common Pitfalls
ANTI-PATTERNS TO AVOID
â Epics that never end
â Set clear scope and acceptance criteria
â Stories too large
â If can't complete in sprint, break down
â Themes too vague
â Must have measurable outcomes
â Skipping hierarchy levels
â Theme â Story directly loses context
â Over-decomposition
â Stories like "add button" lack value context
â Rigid structure
â Allow refinement as learning happens
Integration with Other Methods
| Method | Combined Use |
|---|---|
| User Story Fundamentals | Story writing format and criteria |
| Kanban | Visualizing work flow across levels |
| Jobs to Be Done | Themes aligned with user jobs |
| Five Whys | Understanding why theme matters |
| Hypothesis Tree | Breaking down theme into testable parts |
Quick Reference
HIERARCHY CHECKLIST
Theme:
â¡ Aligns with company strategy
â¡ Has measurable key results
â¡ Spans multiple epics
â¡ Clear owner assigned
Epic:
â¡ Delivers significant user value
â¡ Has defined start and end
â¡ Contains 5-20 stories
â¡ Fits in roadmap timeline
Story:
â¡ Follows "As a... I want... so that..." format
â¡ Meets INVEST criteria
â¡ Has acceptance criteria
â¡ Completable in single sprint
â¡ Estimable by team