Back to Details

roadmap-analyzer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Roadmap Analyzer

路线图分析器

Overview

概述

This skill analyzes a project's current feature set against the needs of the Ideal Customer Profile (ICP). Before analyzing, discover the project's ICP from documentation (
.agents/SYSTEM/
or project docs) and current features from the codebase and documentation.
The skill produces three outputs:
  1. Gap Analysis Table: Side-by-side comparison of ICP needs vs current features with gaps highlighted
  2. Prioritized Backlog: Ranked list of features to build next based on ICP alignment and impact
  3. Strategic Themes: High-level focus areas with specific initiatives
此技能会根据ICP（理想客户画像）的需求分析项目当前的功能集合。在分析之前，从文档（
.agents/SYSTEM/
或项目文档）中获取项目的ICP信息，并从代码库和文档中提取当前功能。
该技能会生成三类输出：
  1. 差距分析表：并排对比ICP需求与当前功能，突出显示差距
  2. 优先级待办事项列表：基于ICP契合度和影响程度排序的下一步开发功能列表
  3. 战略主题：包含具体举措的高层级重点领域

When to Use This Skill

适用场景

Invoke this skill when asked to:
  • "What should we build next?"
  • "Compare our features against what our customers need"
  • "Analyze product gaps for our ICP"
  • "Help me plan the product roadmap"
  • "What features are missing for our target customers?"
  • "Evaluate our competitive positioning"
  • "What do we need to focus on to serve SMBs creating UGC?"
当遇到以下需求时，可调用此技能：
  • “我们下一步应该开发什么？”
  • “对比我们的功能与客户需求的匹配度”
  • “分析我们产品针对ICP的功能差距”
  • “帮我规划产品路线图”
  • “我们的目标客户还缺少哪些功能？”
  • “评估我们的竞争定位”
  • “为了服务创建UGC的SMB客户，我们需要聚焦哪些方面？”

Analysis Workflow

分析流程

Step 1: Discover Current Features

步骤1：梳理现有功能

Use a hybrid approach to identify existing project capabilities (discover from project):
采用混合方法识别项目的现有功能（从项目中提取）：

1.1 Automated Codebase Scan

1.1 自动化代码库扫描

Search the codebase for feature implementations. Focus on:
Key directories to explore:
apps/frontend-apps/*/      - Frontend applications
apps/apis/*/               - Backend APIs
packages/*/                - Shared packages
Search patterns for features:
  • Component names (React components often indicate UI features)
  • API endpoints (routes indicate backend capabilities)
  • Service methods (business logic indicates functionality)
  • Database schemas (data models reveal supported features)
  • Configuration files (feature flags, settings)
Use grep/glob to find:
  • Video editing features: 
    pattern: "edit|timeline|trim|cut|transition"
  • Avatar features: 
    pattern: "avatar|character|persona|voice"
  • Export features: 
    pattern: "export|format|platform|render"
  • Template features: 
    pattern: "template|preset|brand"
  • AI features: 
    pattern: "ai|generate|auto|openai|anthropic"
搜索代码库中的功能实现，重点关注：
需探索的关键目录：
apps/frontend-apps/*/      - 前端应用
apps/apis/*/               - 后端API
packages/*/                - 共享包
功能搜索模式：
  • 组件名称（React组件通常代表UI功能）
  • API端点（路由代表后端能力）
  • 服务方法（业务逻辑代表功能特性）
  • 数据库 schema（数据模型揭示支持的功能）
  • 配置文件（功能开关、设置项）
使用grep/glob查找以下功能：
  • 视频编辑功能：
    pattern: "edit|timeline|trim|cut|transition"
  • 头像功能：
    pattern: "avatar|character|persona|voice"
  • 导出功能：
    pattern: "export|format|platform|render"
  • 模板功能：
    pattern: "template|preset|brand"
  • AI功能：
    pattern: "ai|generate|auto|openai|anthropic"

1.2 User Context Integration

1.2 用户上下文整合

Ask the user:
  • "Are there features I should know about that might not be obvious in the code?"
  • "Any recent features added that might not be fully integrated?"
  • "Features in beta or soft-launched?"
  • "Integrations or capabilities documented elsewhere?"
询问用户以下问题：
  • “是否存在一些在代码中不易发现的功能？”
  • “是否有最近新增但未完全整合的功能？”
  • “是否有处于测试版或软启动阶段的功能？”
  • “是否有在其他地方文档化的集成或能力？”

1.3 Feature Inventory Creation

1.3 创建功能清单

Organize discovered features into categories from 
references/feature-categories.md
:
  1. Content Input & Ideation
  2. AI Avatar Creation & Management
  3. Video Editing & Assembly
  4. Visual Enhancement & Effects
  5. Text, Captions & Typography
  6. Audio & Music
  7. Platform Optimization & Export
  8. Templates & Brand Management
  9. Collaboration & Workflow
  10. Asset Management & Media Library
  11. AI & Automation Features
  12. Analytics & Performance
  13. Learning & Support
  14. Integration & Ecosystem
  15. E-commerce & Monetization
For each feature, note:
  • Status: Exists (production), Partial (incomplete), Planned, Missing
  • Quality: Production-ready, Beta, Prototype, Needs improvement
  • Location: Where found in codebase (file paths)
将梳理出的功能按照
references/feature-categories.md
中的分类进行整理：
  1. 内容输入与创意构思
  2. AI头像创建与管理
  3. 视频编辑与组装
  4. 视觉增强与特效
  5. 文本、字幕与排版
  6. 音频与音乐
  7. 平台优化与导出
  8. 模板与品牌管理
  9. 协作与工作流
  10. 资产管理与媒体库
  11. AI与自动化功能
  12. 分析与性能
  13. 学习与支持
  14. 集成与生态系统
  15. 电商与变现
针对每个功能，需记录：
  • 状态：已存在（生产环境）、部分实现（未完成）、已规划、缺失
  • 质量：生产就绪、测试版、原型、需优化
  • 位置：在代码库中的路径（文件路径）

Step 2: Load ICP and Editor Needs Context

步骤2：加载ICP与编辑器需求上下文

Read the reference documents to understand requirements:
Required reading:
  • references/icp-profile.md
    - Deep understanding of target customer needs
  • references/editor-needs.md
    - What editors need for great social content
  • references/feature-categories.md
    - Comprehensive feature taxonomy
Key focus areas from ICP:
  1. AI Avatar Army: Creating multiple avatars, consistency, customization
  2. User Empowerment: Self-service creation, templates, intuitive UX
  3. UGC at Scale: Volume, speed, platform-native content
  4. Team Collaboration: Multi-user, approvals, brand consistency
Critical editor needs:
  • Platform-specific optimization (TikTok, Instagram, YouTube)
  • Fast pacing and trending effects
  • Text overlays and captions
  • Audio/music integration
  • Quick variations for A/B testing
阅读参考文档以理解需求：
必读文档：
  • references/icp-profile.md
    - 深入了解目标客户需求
  • references/editor-needs.md
    - 编辑器创建优质社交内容所需的功能
  • references/feature-categories.md
    - 全面的功能分类体系
ICP的核心关注领域：
  1. AI Avatar军团：创建多个头像、保持一致性、支持自定义
  2. 用户赋能：自助创建、模板、直观的UX
  3. 规模化UGC：产量、速度、平台原生内容
  4. 团队协作：多用户、审批流程、品牌一致性
编辑器的核心需求：
  • 平台专属优化（TikTok、Instagram、YouTube）
  • 快节奏与流行特效
  • 文本叠加与字幕
  • 音频/音乐集成
  • 快速生成变体用于A/B测试

Step 3: Gap Analysis

步骤3：差距分析

Compare current features against ICP needs and editor requirements.
对比现有功能与ICP需求及编辑器要求。

3.1 Create Gap Analysis Table

3.1 创建差距分析表

Format:
markdown
| Feature Category | ICP Need Priority | Current State | Gap Severity | Key Missing Elements |
|-----------------|-------------------|---------------|--------------|----------------------|
| AI Avatar Creation | CRITICAL | Partial | HIGH | Multiple avatars, avatar library, voice cloning |
| Platform Optimization | CRITICAL | Missing | CRITICAL | Auto-reframe, batch export multiple formats |
| ... | ... | ... | ... | ... |
Gap Severity Levels:
  • CRITICAL: Blocking ICP adoption, core value prop missing
  • HIGH: Significantly impacts ICP success, competitive disadvantage
  • MEDIUM: Limits scale/efficiency, nice-to-have
  • LOW: Future enhancement, not blocking
Priority Levels:
  • CRITICAL: Must-have for ICP, core to value proposition
  • HIGH: Important for ICP success, competitive requirement
  • MEDIUM: Valuable but not essential
  • LOW: Nice-to-have, future consideration
格式：
markdown
| 功能分类 | ICP需求优先级 | 当前状态 | 差距严重程度 | 核心缺失要素 |
|-----------------|-------------------|---------------|--------------|----------------------|
| AI头像创建 | CRITICAL | 部分实现 | HIGH | 多头像支持、头像库、语音克隆 |
| 平台优化 | CRITICAL | 缺失 | CRITICAL | 自动重构图、批量导出多格式 |
| ... | ... | ... | ... | ... |
差距严重程度等级：
  • CRITICAL（严重）：阻碍ICP客户的采用，核心价值主张缺失
  • HIGH（高）：严重影响ICP客户的成功，造成竞争劣势
  • MEDIUM（中）：限制规模/效率，属于锦上添花的功能
  • LOW（低）：未来优化项，不构成阻碍
需求优先级等级：
  • CRITICAL（严重）：ICP客户的必备功能，核心价值主张的组成部分
  • HIGH（高）：对ICP客户的成功至关重要，竞争所需的功能
  • MEDIUM（中）：有价值但非必需
  • LOW（低）：锦上添花的功能，未来考虑项

3.2 Identify Critical Gaps

3.2 识别关键差距

Highlight gaps where:
  1. ICP Need Priority = CRITICAL AND Gap Severity = CRITICAL/HIGH
  2. Feature is table stakes for competitors
  3. Feature directly enables "AI avatar army" or "user empowerment"
  4. Feature required for platform-native content (TikTok, Instagram, etc.)
重点突出以下差距：
  1. ICP需求优先级为CRITICAL且差距严重程度为CRITICAL/HIGH
  2. 属于竞争对手的标配功能
  3. 直接支持“AI Avatar军团”或“用户赋能”目标
  4. 平台原生内容所需的功能（TikTok、Instagram等）

Step 4: Generate Prioritized Backlog

步骤4：生成优先级待办事项列表

Create a ranked list of features to build next.
创建按优先级排序的下一步开发功能列表。

4.1 Prioritization Framework

4.1 优先级评估框架

Score each feature on:
ICP Impact (1-5)
  • 5: Core to ICP value prop, directly addresses primary pain point
  • 4: Strongly supports ICP needs, key differentiator
  • 3: Valuable for ICP, improves experience
  • 2: Nice-to-have for ICP
  • 1: Minimal ICP impact
Urgency (1-5)
  • 5: Blocking sales/adoption, critical competitive gap
  • 4: Significant competitive pressure, customer requests
  • 3: On roadmap, good timing to build
  • 2: Can wait, not time-sensitive
  • 1: Future consideration
Implementation Effort (1-5)
  • 5: Very high effort, 3+ months, complex
  • 4: High effort, 1-3 months, significant work
  • 3: Medium effort, 2-4 weeks, moderate complexity
  • 2: Low effort, < 2 weeks, straightforward
  • 1: Very low effort, < 1 week, simple
Priority Score = (ICP Impact × 2 + Urgency × 1.5) / Implementation Effort
Higher score = higher priority.
从以下维度为每个功能评分：
ICP影响度（1-5分）
  • 5分：核心ICP价值主张，直接解决主要痛点
  • 4分：强力支持ICP需求，关键差异化功能
  • 3分：对ICP客户有价值，提升体验
  • 2分：ICP客户的锦上添花功能
  • 1分：对ICP客户影响极小
紧急程度（1-5分）
  • 5分：阻碍销售/客户采用，严重的竞争差距
  • 4分：面临显著竞争压力，有客户请求
  • 3分：已在路线图上，开发时机成熟
  • 2分：可延后，不具时间敏感性
  • 1分：未来考虑项
实现难度（1-5分）
  • 5分：难度极高，需3个月以上，复杂度高
  • 4分：难度高，需1-3个月，工作量大
  • 3分：难度中等，需2-4周，复杂度适中
  • 2分：难度低，需少于2周，实现简单
  • 1分：难度极低，需少于1周，非常简单
优先级得分 = (ICP影响度 × 2 + 紧急程度 × 1.5) / 实现难度
得分越高，优先级越高。

4.2 Backlog Format

4.2 待办事项格式

markdown
undefined
markdown
undefined

Prioritized Feature Backlog

优先级功能待办事项

P0 (Build Immediately - Priority Score > 3.0)

P0（立即开发 - 优先级得分 > 3.0）

  1. [Feature Name] (Score: 4.2)
    • Why: [ICP impact explanation]
    • Customer need: [Specific ICP pain point addressed]
    • Effort: [Time estimate]
    • Dependencies: [What's needed first]
  1. [功能名称]（得分：4.2）
    • 原因：[ICP影响说明]
    • 客户需求：[解决的具体ICP痛点]
    • 工作量：[时间预估]
    • 依赖项：[前置需求]

P1 (Build Next Quarter - Priority Score 2.0-3.0)

P1（下一季度开发 - 优先级得分2.0-3.0）

[Same format]
[相同格式]

P2 (Future Consideration - Priority Score < 2.0)

P2（未来考虑 - 优先级得分 < 2.0）

[Same format]
undefined
[相同格式]
undefined

4.3 Quick Wins Section

4.3 快速见效项板块

Identify features with:
  • High ICP Impact (4-5)
  • Low Implementation Effort (1-2)
  • Decent Urgency (3+)
These are "quick wins" that deliver high value with low investment.
识别具备以下特征的功能：
  • 高ICP影响度（4-5分）
  • 低实现难度（1-2分）
  • 中等以上紧急程度（3分+）
这些是“快速见效项”，以低投入带来高价值。

Step 5: Define Strategic Themes

步骤5：定义战略主题

Group features into high-level strategic focus areas.
将功能分组为高层级的战略聚焦领域。

5.1 Theme Identification

5.1 主题识别

Analyze feature clusters to identify 3-5 strategic themes, such as:
Example themes:
  • "AI Avatar Arsenal": Building the avatar creation and management system
  • "Platform-Native Mastery": Optimizing for TikTok, Instagram, YouTube
  • "Team Empowerment Engine": Collaboration, templates, workflows
  • "Speed to Market": Automation, batch processing, quick variations
  • "Editor's Toolkit": Core editing capabilities for creators
分析功能集群，识别3-5个战略主题，例如：
示例主题：
  • "AI Avatar武器库"：构建头像创建与管理系统
  • "平台原生精通"：针对TikTok、Instagram、YouTube进行优化
  • "团队赋能引擎"：协作、模板、工作流
  • "上市速度"：自动化、批量处理、快速生成变体
  • "编辑器工具包"：创作者所需的核心编辑能力

5.2 Theme Structure

5.2 主题结构

For each theme, provide:
markdown
undefined
针对每个主题，提供以下内容：
markdown
undefined

[Theme Name]

[主题名称]

Vision: [1-2 sentence vision for this theme]
ICP Alignment: [How this theme serves ICP needs]
Current State: [Where we are today]
Target State: [Where we need to be]
Key Initiatives:
  1. [Initiative Name]
    • Features: [Specific features]
    • Impact: [Expected outcome]
    • Timeline: [When to build]
  2. [Next initiative] [Same format]
Success Metrics:
undefined
愿景：[1-2句话描述主题愿景]
ICP契合度：[该主题如何满足ICP需求]
当前状态：[我们的现状]
目标状态：[我们需要达到的状态]
核心举措:
  1. [举措名称]
    • 功能：[具体功能]
    • 影响：[预期成果]
    • 时间线：[开发时间]
  2. [下一个举措] [相同格式]
成功指标:
  • [指标1]：[目标值]
  • [指标2]：[目标值]
undefined

5.3 Theme Prioritization

5.3 主题优先级排序

Recommend theme focus order based on:
  1. Foundation themes first: Core platform capabilities required for everything else
  2. Differentiator themes next: Unique value props (e.g., AI avatar army)
  3. Enhancement themes last: Improvements to existing capabilities
基于以下因素推荐主题的聚焦顺序：
  1. 先基础主题：其他所有功能所需的核心平台能力
  2. 再差异化主题：独特的价值主张（如AI Avatar军团）
  3. 最后优化主题：对现有能力的改进

Step 6: Output Assembly

步骤6：整合输出内容

Combine all analysis into a comprehensive report:
markdown
undefined
将所有分析内容整合成一份综合报告：
markdown
undefined

[Project] Roadmap Analysis

[项目名称] 路线图分析

[Date]

[日期]

Executive Summary

执行摘要

[3-5 bullets summarizing key findings and recommendations]
[3-5个要点总结关键发现与建议]

Gap Analysis

差距分析

[Gap analysis table from Step 3]
[步骤3中的差距分析表]

Critical Gaps

关键差距

[Detailed explanation of critical gaps from Step 3.2]
[步骤3.2中关键差距的详细说明]

Prioritized Backlog

优先级待办事项

[Prioritized backlog from Step 4]
[步骤4中的优先级待办事项]

Quick Wins

快速见效项

[Quick wins list from Step 4.3]
[步骤4.3中的快速见效项列表]

Strategic Themes

战略主题

[Strategic themes from Step 5]
[步骤5中的战略主题]

Recommended Focus

推荐聚焦方向

Next 30 days: [Immediate priorities] Next quarter: [Q1 focus areas] Next 6 months: [Half-year vision]
未来30天：[近期优先级] 下一季度：[Q1聚焦领域] 未来6个月：[半年愿景]

Appendix

附录

Feature Inventory

功能清单

[Complete list of discovered features]
[完整的梳理出的功能列表]

ICP Summary

ICP摘要

[Brief ICP recap]
undefined
[ICP的简要回顾]
undefined

Best Practices

最佳实践

Analysis Quality

分析质量

  1. Be specific: Don't just say "add editing features"—specify "Add timeline trimming with frame-level precision"
  2. Show evidence: Reference where features exist (or don't) in codebase
  3. Connect to customer: Explain how each feature serves ICP needs
  4. Consider competition: Note when gaps create competitive disadvantage
  5. Balance ambition with reality: Acknowledge technical constraints
  1. 具体明确：不要只说“添加编辑功能”，要具体说明“添加支持帧级精度的时间轴裁剪功能”
  2. 提供依据：注明功能存在（或缺失）的代码库位置
  3. 关联客户：解释每个功能如何满足ICP需求
  4. 考虑竞争：注明差距是否会造成竞争劣势
  5. 平衡野心与现实：承认技术约束

Prioritization Rigor

优先级评估严谨性

  1. Defend scores: Explain why a feature gets specific impact/urgency/effort scores
  2. Consider dependencies: Note when features require others to be built first
  3. Think sequentially: Some features enable others (e.g., avatar library before multi-avatar videos)
  4. Question assumptions: If effort seems high, suggest simpler MVP versions
  1. 解释得分：说明功能获得特定影响度/紧急程度/难度得分的原因
  2. 考虑依赖项：注明功能是否需要先开发其他功能
  3. 按顺序思考：有些功能是其他功能的基础（如先有头像库，再有多头像视频）
  4. 质疑假设：如果难度看起来很高，建议先做简化的MVP版本

Strategic Thinking

战略思维

  1. Theme coherence: Themes should feel cohesive, not arbitrary groupings
  2. ICP-centric: Every recommendation should trace back to ICP needs
  3. Differentiation: Emphasize features that set the project apart
  4. Reality check: Acknowledge market timing, competitive landscape, technical feasibility
  1. 主题连贯性：主题应具有凝聚力，而非随意分组
  2. 以ICP为中心：每个建议都应追溯到ICP需求
  3. 差异化：强调能让项目脱颖而出的功能
  4. 现实校验：考虑市场时机、竞争格局、技术可行性

Common Pitfalls to Avoid

需避免的常见误区

  1. Don't just list features: Explain WHY each feature matters for ICP
  2. Don't ignore existing features: Give credit for what already exists
  3. Don't treat all gaps equally: Not all missing features are critical
  4. Don't forget the "AI avatar army" vision: This is a key differentiator
  5. Don't overlook platform-specific needs: TikTok ≠ YouTube
  6. Don't assume features work well: Existing features might have quality gaps
  1. 不要只罗列功能：解释每个功能对ICP客户的重要性
  2. 不要忽略现有功能：对已存在的功能给予认可
  3. 不要等同所有差距：并非所有缺失的功能都是关键的
  4. 不要忘记“AI Avatar军团”愿景：这是核心差异化点
  5. 不要忽视平台专属需求：TikTok ≠ YouTube
  6. 不要假设功能运行良好：现有功能可能存在质量差距

Resources

参考资源

references/

references/目录

Three comprehensive reference documents inform the analysis:
  • icp-profile.md: Detailed profile of target customers (SMBs creating UGC with AI, empowering users, building AI avatar armies). Includes pain points, core needs, success metrics, and buying journey.
  • editor-needs.md: Comprehensive breakdown of what video editors need to create great content for social platforms (TikTok, Instagram, YouTube). Covers editing capabilities, platform-specific requirements, audio/visual needs, and competitive benchmarks.
  • feature-categories.md: Taxonomy of 15 feature categories typical in AI UGC platforms. Provides framework for organizing discovered features and identifying gaps systematically.
Load these references at the start of analysis to inform all evaluation and recommendations.
三份综合参考文档为分析提供依据：
  • icp-profile.md：目标客户的详细画像（使用AI创建UGC的SMB客户，赋能用户，构建AI Avatar军团）。包括痛点、核心需求、成功指标和购买旅程。
  • editor-needs.md：视频编辑器为社交平台（TikTok、Instagram、YouTube）创建优质内容所需的功能的全面拆解。涵盖编辑能力、平台专属要求、音视频需求和竞争基准。
  • feature-categories.md：AI UGC平台常见的15个功能分类体系。为系统地梳理功能和识别差距提供框架。
在分析开始时加载这些参考文档，为所有评估和建议提供依据。",