theme-epic-story

📁 flpbalada/my-opencode-config 📅 14 days ago
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

Resources