AgentSkillsCN

roadmap-visualizer

在创建或更新产品路线图时使用。建议在优先级排序完成后使用。该技能可生成基于时间轴的路线图,其中包含主题、依赖关系、里程碑,以及信心指数。

SKILL.md
--- frontmatter
name: roadmap-visualizer
description: Use when creating or updating product roadmaps. Use after prioritization complete. Produces timeline-based roadmap with themes, dependencies, milestones, and confidence indicators.

Roadmap Visualizer

Overview

Create clear, stakeholder-appropriate product roadmaps that communicate direction without false precision. Balance commitment with flexibility by using time horizons and confidence levels.

Core principle: A roadmap is a communication tool, not a project plan. It should show direction and intent, not Gantt-chart-level detail.

When to Use

  • Quarterly/annual planning
  • Stakeholder alignment meetings
  • Board/executive presentations
  • Team direction-setting
  • Customer conversations about future features

Output Format

yaml
roadmap:
  product: "[Product name]"
  version_date: "[YYYY-MM-DD]"
  planning_horizon: "[Quarters covered]"
  
  vision_context:
    vision: "[Product vision one-liner]"
    north_star: "[Primary success metric]"
    current_state: "[Where we are now]"
  
  themes:
    - id: "[THEME-01]"
      name: "[Theme name]"
      description: "[What this theme accomplishes]"
      strategic_goal: "[Which company goal this supports]"
      success_metric: "[How we measure theme success]"
  
  time_horizons:
    now:
      timeframe: "[Current quarter]"
      confidence: "High"
      items:
        - id: "[ITEM-01]"
          title: "[Initiative name]"
          theme: "[THEME-01]"
          description: "[Brief description]"
          status: "[In Progress | Planned | Complete]"
          dependencies: ["[Dependency]"]
          target_outcome: "[What success looks like]"
    
    next:
      timeframe: "[Next quarter]"
      confidence: "Medium"
      items:
        - id: "[ITEM-02]"
          title: "[Initiative name]"
          theme: "[THEME-01]"
          description: "[Brief description]"
          depends_on: ["[ITEM-01]"]
          open_questions: ["[What we need to learn]"]
    
    later:
      timeframe: "[Future quarters]"
      confidence: "Low"
      items:
        - id: "[ITEM-03]"
          title: "[Initiative name]"
          theme: "[THEME-02]"
          description: "[Brief description]"
          contingent_on: "[What must be true]"
  
  milestones:
    - date: "[YYYY-MM-DD]"
      name: "[Milestone name]"
      items: ["[ITEM-01]", "[ITEM-02]"]
      significance: "[Why this matters]"
  
  dependencies:
    internal:
      - item: "[ITEM-01]"
        depends_on: "[Team/System]"
        status: "[Confirmed | Pending | At-risk]"
    external:
      - item: "[ITEM-02]"
        depends_on: "[External party]"
        status: "[Confirmed | Pending | At-risk]"
        mitigation: "[If at-risk]"
  
  risks:
    - risk: "[Description]"
      impact: "[Which items affected]"
      mitigation: "[Planned response]"
  
  not_planned:
    - item: "[Thing we're NOT doing]"
      reason: "[Why]"
      reconsider_when: "[Trigger for revisiting]"

Time Horizon Framework

Avoid false precision with dates. Use horizons:

HorizonTimeframeConfidenceDetail Level
NowCurrent quarterHigh (>80%)Specific features, committed
NextNext quarterMedium (50-80%)Themes + key initiatives
Later6+ monthsLow (<50%)Directional themes only
Not PlannedN/AN/AExplicit exclusions

Confidence Indicators

VisualMeaningCommitment Level
██████ SolidHigh confidenceCommitted
▓▓▓▓▓▓ PartialMedium confidencePlanned
░░░░░░ LightLow confidenceExploring

Theme-Based Organization

Group by strategic themes, not features:

Example Themes

yaml
themes:
  - id: "GROWTH"
    name: "New User Acquisition"
    description: "Reduce friction in signup and onboarding"
    
  - id: "RETENTION"
    name: "User Engagement"  
    description: "Increase stickiness and daily usage"
    
  - id: "PLATFORM"
    name: "Foundation & Scale"
    description: "Infrastructure for next growth phase"
    
  - id: "REVENUE"
    name: "Monetization"
    description: "New revenue streams and pricing"

Stakeholder Views

Different audiences need different roadmap views:

Executive View

code
┌─────────────────────────────────────────────────────────────┐
│ Product Roadmap 2026                                        │
├─────────────────────────────────────────────────────────────┤
│ Vision: Enable [outcome] for [users]                        │
│ North Star: [Metric] from X → Y                             │
├─────────────────────────────────────────────────────────────┤
│ Q1           │ Q2           │ Q3           │ Q4            │
│ ██████████   │ ▓▓▓▓▓▓▓▓▓   │ ░░░░░░░░░   │ ░░░░░░░░░    │
│ Growth       │ Retention    │ Platform     │ TBD          │
│ - Onboarding │ - Engagement │ - Scale      │              │
│ - Signup     │ - Mobile     │ - API        │              │
│              │              │              │              │
│ Milestone: 🎯 New user flow launch (Feb)                   │
└─────────────────────────────────────────────────────────────┘

Team View

yaml
# More detail for execution teams
now:
  - title: "Self-serve onboarding"
    description: "Users complete setup without support"
    epic_ids: ["EPIC-123", "EPIC-124"]
    owner: "Team Alpha"
    target: "Feb 15"
    progress: 60%
    blockers: ["API dependency with Platform team"]

Customer View

markdown
## Coming Soon
- **Improved onboarding** - Get started faster with guided setup
- **Mobile app** - Full functionality on iOS and Android

## Planned for Later This Year  
- **API access** - Build custom integrations
- **Advanced reporting** - Deeper analytics

_Timing is approximate and may change_

Dependency Mapping

Visualize cross-team and external dependencies:

code
[Onboarding Flow] ──depends on──> [Platform: Auth API]
         │                              │
         │                              └──> Status: ✅ Confirmed
         │
         └──depends on──> [External: Payment Provider]
                                │
                                └──> Status: ⚠️ Pending contract

Roadmap Anti-Patterns

Anti-PatternProblemFix
Feature listNo strategy, just tasksOrganize by themes
Date-drivenFalse precision, missed datesUse time horizons
Too detailedCan't see forest for treesSummary for execs
Never updatedStale, ignoredQuarterly refresh
No "not doing"Endless scope creepExplicit out-of-scope
Hidden dependenciesSurprise blockersSurface early

Update Cadence

TriggerAction
QuarterlyFull roadmap review and refresh
New strategyRealign themes to goals
Major completionMove items, update progress
Significant changeCommunicate proactively
Stakeholder requestPrepare appropriate view

Roadmap Review Checklist

Before sharing:

  • Aligned with current product vision
  • Themes map to strategic goals
  • Now/Next/Later clearly differentiated
  • Confidence levels indicated
  • Dependencies identified
  • Risks surfaced
  • "Not doing" is explicit
  • Appropriate detail for audience
  • Updated within last month