storytelling-synthesizer
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseStorytelling Synthesizer Skill
叙事合成器Skill
Purpose
用途
Transform technical work (pull requests, commit histories, feature implementations) into compelling narratives that resonate with different audiences—whether preparing hackathon demos, writing technical blog posts, or creating marketing content.
将技术工作内容(PR、提交历史、功能实现)转化为引人入胜的叙事内容,适配不同受众的需求——无论你是准备黑客松演示、撰写技术博客文章,还是创作营销内容。
When to Use This Skill
适用场景
- Hackathon Demos: Convert technical achievements into engaging 5-10 minute presentations
- Technical Blog Posts: Transform PR descriptions into detailed, narrative-driven articles
- Marketing Content: Distill complex features into customer-focused value propositions
- Presentation Outlines: Create structured narratives for conference talks or internal presentations
- Release Notes: Convert commit histories into user-friendly announcements
- Investor Pitches: Frame technical work as business value and impact
- Team Communications: Share accomplishments in compelling, non-technical ways
- 黑客松演示:将技术成果转化为时长5-10分钟的精彩演讲内容
- 技术博客文章:将PR描述转化为详尽、以叙事为驱动的文章
- 营销内容:将复杂功能提炼为以客户为中心的价值主张
- 演讲大纲:为会议演讲或内部汇报创建结构化叙事框架
- 版本发布说明:将提交历史转化为用户友好的公告内容
- 投资者推介:将技术工作包装为体现商业价值与影响力的内容
- 团队沟通:以引人入胜的非技术语言分享成果
Core Philosophy: Story Structure
核心哲学:故事结构
Every technical work has a narrative hidden within it. The synthesizer extracts and amplifies it:
Problem → Solution → Impact → Hook
This mirrors the Hero's Journey pattern adapted for technical work:
- Problem: The challenge that motivated the work (conflict)
- Solution: How the technical work addresses it (resolution)
- Impact: What changes because of this work (outcome)
- Hook: The compelling angle that captures attention (why it matters)
每一项技术工作背后都隐藏着一个叙事。本合成器会提取并放大这个叙事:
问题 → 解决方案 → 影响 → 钩子
这与改编自技术工作的英雄之旅模式相契合:
- 问题:驱动这项工作的挑战(冲突点)
- 解决方案:技术工作如何解决该问题(解决方式)
- 影响:这项工作带来了哪些改变(成果)
- 钩子:吸引注意力的引人入胜的切入点(重要性)
Narrative Templates
叙事模板
Every technical narrative follows one of these proven story structures:
每一个技术叙事都遵循以下经过验证的故事结构之一:
1. Demo Script Template
1. 演示脚本模板
Purpose: 5-10 minute engaging presentation for live audience
Structure:
Opening Hook (30 seconds)
├─ Grab attention with surprising stat or problem statement
├─ One-sentence problem definition
└─ Show what's broken/slow/frustrating
Context & Problem (1-2 minutes)
├─ Why this problem matters
├─ Who experiences the pain
├─ Cost of the problem (time, money, frustration)
└─ Previous attempts or workarounds
The Solution (2-3 minutes)
├─ Key innovation or insight
├─ Live demo with specific, measurable results
├─ Show before/after comparison
└─ Highlight the "wow moment"
Impact & Metrics (1 minute)
├─ Quantified results (faster, cheaper, easier)
├─ Real-world application
├─ Future potential
└─ Call to action (what's next)
Closing (30 seconds)
├─ Reinforce core message
├─ Memorable final thought
└─ Invite questions用途:面向现场观众的5-10分钟精彩演讲内容
结构:
Opening Hook (30 seconds)
├─ Grab attention with surprising stat or problem statement
├─ One-sentence problem definition
└─ Show what's broken/slow/frustrating
Context & Problem (1-2 minutes)
├─ Why this problem matters
├─ Who experiences the pain
├─ Cost of the problem (time, money, frustration)
└─ Previous attempts or workarounds
The Solution (2-3 minutes)
├─ Key innovation or insight
├─ Live demo with specific, measurable results
├─ Show before/after comparison
└─ Highlight the "wow moment"
Impact & Metrics (1 minute)
├─ Quantified results (faster, cheaper, easier)
├─ Real-world application
├─ Future potential
└─ Call to action (what's next)
Closing (30 seconds)
├─ Reinforce core message
├─ Memorable final thought
└─ Invite questions2. Blog Post Outline Template
2. 博客文章大纲模板
Purpose: 1,500-3,000 word technical narrative for written audience
Structure:
Title & Hook
├─ Compelling headline with intrigue
└─ Opening paragraph that answers "why should I read this?"
Problem Statement (400-500 words)
├─ Real-world scenario showing the problem
├─ Technical detail: what specifically breaks
├─ Cost of the status quo
├─ Why existing solutions fall short
└─ Reader self-recognition ("this is my problem")
Solution Overview (300-400 words)
├─ High-level approach before technical dive
├─ Core innovation or insight
├─ How it differs from alternatives
└─ Why this approach was chosen
Technical Deep Dive (600-800 words)
├─ Architecture or implementation details
├─ Key code snippets or diagrams
├─ Design decisions and tradeoffs
├─ Performance characteristics
└─ How it handles edge cases
Results & Validation (300-400 words)
├─ Metrics demonstrating success
├─ Before/after comparison
├─ Real-world test cases
├─ Performance benchmarks
└─ User feedback or testimonials
Implications & Future Work (200-300 words)
├─ What this enables
├─ Related opportunities
├─ Roadmap items
└─ Call to action for readers
Code Example (if applicable)
├─ Complete, runnable example
├─ Common use cases
├─ Error handling shown
└─ Performance tips
Conclusion (100-200 words)
├─ Reinforce main takeaway
├─ How readers can use this
├─ Invite feedback and discussion
└─ Links to resources用途:面向读者的1500-3000字详细技术叙事文章
结构:
Title & Hook
├─ Compelling headline with intrigue
└─ Opening paragraph that answers "why should I read this?"
Problem Statement (400-500 words)
├─ Real-world scenario showing the problem
├─ Technical detail: what specifically breaks
├─ Cost of the status quo
├─ Why existing solutions fall short
└─ Reader self-recognition ("this is my problem")
Solution Overview (300-400 words)
├─ High-level approach before technical dive
├─ Core innovation or insight
├─ How it differs from alternatives
└─ Why this approach was chosen
Technical Deep Dive (600-800 words)
├─ Architecture or implementation details
├─ Key code snippets or diagrams
├─ Design decisions and tradeoffs
├─ Performance characteristics
└─ How it handles edge cases
Results & Validation (300-400 words)
├─ Metrics demonstrating success
├─ Before/after comparison
├─ Real-world test cases
├─ Performance benchmarks
└─ User feedback or testimonials
Implications & Future Work (200-300 words)
├─ What this enables
├─ Related opportunities
├─ Roadmap items
└─ Call to action for readers
Code Example (if applicable)
├─ Complete, runnable example
├─ Common use cases
├─ Error handling shown
└─ Performance tips
Conclusion (100-200 words)
├─ Reinforce main takeaway
├─ How readers can use this
├─ Invite feedback and discussion
└─ Links to resources3. Presentation Outline Template
3. 演讲大纲模板
Purpose: Structured narrative for 20-45 minute talk or internal presentation
Structure:
Slide 1: Title & Hook
├─ Provocative title with intrigue
├─ Speaker name and credentials
└─ One-sentence premise
Slides 2-3: Problem & Context (3-4 minutes)
├─ Relatable problem scenario
├─ Current challenges
├─ Why this matters
└─ Scope and audience impact
Slides 4-6: Solution Architecture (5-7 minutes)
├─ Visual system diagram
├─ Key components and their roles
├─ Technical innovation points
└─ Design philosophy
Slides 7-9: Implementation Details (5-7 minutes)
├─ Code architecture or workflows
├─ Key algorithms or patterns
├─ Tradeoffs and decisions made
└─ Integration points
Slides 10-11: Demo or Case Study (5-10 minutes)
├─ Live demonstration (or video) of solution in action
├─ Real-world results and metrics
├─ Comparison to alternatives
└─ Handling of edge cases or failures
Slides 12-13: Impact & Metrics (3-4 minutes)
├─ Quantified results
├─ Business or user impact
├─ Adoption or usage metrics
└─ Customer testimonials (if available)
Slides 14-15: Future & Roadmap (2-3 minutes)
├─ What's next
├─ Related opportunities
├─ Call to action or open problems
└─ How audience can contribute or adopt
Slide 16: Closing
├─ Key takeaway summary
├─ Contact and resources
└─ Invite questions用途:用于20-45分钟的会议演讲或内部汇报的结构化叙事内容
结构:
Slide 1: Title & Hook
├─ Provocative title with intrigue
├─ Speaker name and credentials
└─ One-sentence premise
Slides 2-3: Problem & Context (3-4 minutes)
├─ Relatable problem scenario
├─ Current challenges
├─ Why this matters
└─ Scope and audience impact
Slides 4-6: Solution Architecture (5-7 minutes)
├─ Visual system diagram
├─ Key components and their roles
├─ Technical innovation points
└─ Design philosophy
Slides 7-9: Implementation Details (5-7 minutes)
├─ Code architecture or workflows
├─ Key algorithms or patterns
├─ Tradeoffs and decisions made
└─ Integration points
Slides 10-11: Demo or Case Study (5-10 minutes)
├─ Live demonstration (or video) of solution in action
├─ Real-world results and metrics
├─ Comparison to alternatives
└─ Handling of edge cases or failures
Slides 12-13: Impact & Metrics (3-4 minutes)
├─ Quantified results
├─ Business or user impact
├─ Adoption or usage metrics
└─ Customer testimonials (if available)
Slides 14-15: Future & Roadmap (2-3 minutes)
├─ What's next
├─ Related opportunities
├─ Call to action or open problems
└─ How audience can contribute or adopt
Slide 16: Closing
├─ Key takeaway summary
├─ Contact and resources
└─ Invite questions4. Marketing/Value Prop Template
4. 营销/价值主张模板
Purpose: Customer-focused description emphasizing business value
Structure:
Headline
├─ Outcome-focused: "Reduce Processing Time by 75%"
└─ Avoid jargon: use customer language
Problem Statement
├─ What customers struggle with TODAY
├─ Cost in time, money, or frustration
└─ Why they tried other solutions
Before Scenario
├─ Typical customer experience without solution
├─ Specific friction points
├─ Emotional impact (frustration, stress)
└─ Quantified pain (hours lost, revenue impact)
Solution Overview
├─ What our solution does (in customer language)
├─ Key benefits (not features)
├─ How it simplifies their work
└─ Typical adoption timeline
After Scenario
├─ Typical experience with solution
├─ Workflow improvements
├─ Time/cost savings
└─ Emotional benefits (confidence, speed)
Social Proof
├─ Customer testimonials
├─ Quantified results from real customers
├─ Case studies or success stories
└─ Industry recognition
Call to Action
├─ Next step (try it, learn more, contact)
├─ Reduce friction (free trial, demo, docs)
└─ Success promise用途:以客户为中心的描述内容,强调商业价值
结构:
Headline
├─ Outcome-focused: "Reduce Processing Time by 75%"
└─ Avoid jargon: use customer language
Problem Statement
├─ What customers struggle with TODAY
├─ Cost in time, money, or frustration
└─ Why they tried other solutions
Before Scenario
├─ Typical customer experience without solution
├─ Specific friction points
├─ Emotional impact (frustration, stress)
└─ Quantified pain (hours lost, revenue impact)
Solution Overview
├─ What our solution does (in customer language)
├─ Key benefits (not features)
├─ How it simplifies their work
└─ Typical adoption timeline
After Scenario
├─ Typical experience with solution
├─ Workflow improvements
├─ Time/cost savings
└─ Emotional benefits (confidence, speed)
Social Proof
├─ Customer testimonials
├─ Quantified results from real customers
├─ Case studies or success stories
└─ Industry recognition
Call to Action
├─ Next step (try it, learn more, contact)
├─ Reduce friction (free trial, demo, docs)
└─ Success promiseStep-by-Step Synthesis Process
分步合成流程
Step 1: Extract Technical Achievements
步骤1:提取技术成果
Analyze the technical work to identify:
- What was built: Features, fixes, optimizations
- Why it matters: Problem solved, inefficiency removed
- How it works: Key innovation or technique
- Metrics: Performance gains, adoption, impact
- Constraints: Limitations, tradeoffs, open questions
分析技术工作内容,识别以下要点:
- 构建内容:功能、修复、优化项
- 重要性:解决的问题、消除的低效点
- 实现方式:核心创新或技术
- 指标:性能提升、采用率、影响
- 约束条件:局限性、权衡点、待解决问题
Step 2: Identify the "Why" and Impact
步骤2:明确"原因"与影响
For each achievement:
- Technical why: What gap did this fill? What was broken?
- User why: How does this improve the user's life or work?
- Business why: What value does this create? For whom?
- Emotional why: What frustration does this relieve?
针对每项成果,分析:
- 技术层面的原因:填补了哪些空白?解决了哪些痛点?
- 用户层面的原因:如何改善用户的工作或生活?
- 商业层面的原因:创造了哪些价值?面向哪些群体?
- 情感层面的原因:缓解了哪些困扰?
Step 3: Determine Your Audience
步骤3:确定受众
Different narratives for different audiences:
- Technical audience (engineers, architects): Focus on innovation, architecture, tradeoffs
- Product audience (PMs, designers): Focus on user impact, metrics, adoption
- Executive audience (leadership, investors): Focus on business value, ROI, strategic fit
- User audience (customers, community): Focus on simplicity, benefits, how to use
- Marketing audience (content, brand): Focus on narrative arc, emotional resonance, differentiation
不同受众需要不同的叙事内容:
- 技术受众(工程师、架构师):聚焦创新点、优雅的解决方案、技术创新
- 产品受众(产品经理、设计师):聚焦用户影响、指标、采用率
- 高管受众(领导层、投资者):聚焦商业价值、投资回报率、战略契合度
- 用户受众(客户、社区):聚焦简洁性、收益、使用方法
- 营销受众(内容创作者、品牌方):聚焦叙事弧线、情感共鸣、差异化
Step 4: Structure the Narrative
步骤4:构建叙事结构
Choose the appropriate template based on medium:
- Demo: 5-10 minute engaging presentation
- Blog post: 1,500+ word detailed article
- Presentation: 20-45 minute structured talk
- Marketing: Customer-focused value proposition
根据媒介选择合适的模板:
- 演示:5-10分钟的精彩演讲内容
- 博客文章:1500字以上的详细文章
- 演讲:20-45分钟的结构化演讲内容
- 营销内容:以客户为中心的价值主张
Step 5: Add Compelling Hooks
步骤5:添加引人入胜的钩子
Every narrative needs attention-grabbing elements:
Opening Hooks (grab attention in first 30 seconds):
- Surprising statistic: "95% of developers waste 10+ hours per week on..."
- Provocative question: "What if you could cut deployment time by 80%?"
- Relatable problem: "We've all experienced the frustration of..."
- Bold claim: "This technique can improve performance by 10x"
Transitions (maintain engagement between sections):
- "But here's the problem..."
- "That's where our approach differs..."
- "The results speak for themselves..."
- "This insight led us to..."
Closing Hooks (memorable final thought):
- "This changes everything about how we..."
- "The real power isn't in the code—it's in..."
- "What starts as a technical optimization becomes..."
每个叙事都需要吸引注意力的元素:
开场钩子(前30秒抓住注意力):
- 令人惊讶的数据:"95%的开发者每周浪费10+小时在...上"
- 挑衅性问题:"如果你能将部署时间缩短80%,会怎样?"
- 相关问题:"我们都曾经历过...的困扰"
- 大胆断言:"这项技术可以将性能提升10倍"
过渡句(保持各部分的吸引力):
- "但问题在于..."
- "这就是我们的方法与众不同之处..."
- "结果不言而喻..."
- "这一见解引导我们..."
结尾钩子(令人难忘的最终观点):
- "这彻底改变了我们...的方式"
- "真正的力量不在于代码——而在于..."
- "从技术优化开始,最终演变为..."
Step 6: Include Concrete Examples
步骤6:加入具体示例
Make narratives tangible with:
- Before/After screenshots or metrics: Visual comparison of impact
- Code snippets: Show implementation elegance or simplicity
- Real-world scenarios: Specific, relatable use cases
- Customer quotes: Authentic voices describing results
- Quantified results: "30% faster", "50% fewer bugs", "10x improvement"
通过以下内容让叙事更具体:
- 前后对比截图或指标:直观展示影响
- 代码片段:展示实现的优雅性或简洁性
- 真实场景:具体、相关的用例
- 客户引用:描述成果的真实声音
- 量化结果:"快30%"、"bug减少50%"、"提升10倍"
Step 7: Review for Storytelling Quality
步骤7:审查叙事质量
Verify the narrative:
- Starts with a hook that captures attention
- Problem is clearly articulated and relatable
- Solution is presented as novel or elegant
- Impact is quantified and meaningful
- Audience understands "why this matters to me"
- Flow is logical and easy to follow
- Pacing varies (not monotonous)
- Memorable final thought
验证叙事内容:
- 开场钩子能抓住注意力
- 问题表述清晰且相关
- 解决方案呈现为新颖或优雅
- 影响经过量化且有意义
- 受众理解"这与我有什么关系"
- 逻辑流畅、易于理解
- 节奏多变(不单调)
- 有令人难忘的最终观点
Usage Examples
使用示例
Example 1: PR to Demo Script
示例1:PR转化为演示脚本
Input: PR description for caching optimization feature
Output: 7-minute demo script
Hook: "Imagine if every user interaction was 5x faster. That's what we just built."
Problem: Users experience 3-5 second delays on page loads. Our slowest operations
are cache misses on frequently accessed data. We've tried traditional solutions
but hit scaling limits at 100k users.
Solution: We implemented a distributed memory cache with automatic eviction policies
and real-time invalidation. Live demo shows the same operation dropping from 3.2s
to 640ms—5x faster.
Metrics: 47% reduction in average response time, 92% cache hit rate, handles 500k
concurrent users. Users report significantly faster experience.
Closing: This isn't just a performance tweak—it fundamentally changes how our
system scales. We can now support 10x our current user base without additional
infrastructure.输入:缓存优化功能的PR描述
输出:7分钟演示脚本
Hook: "Imagine if every user interaction was 5x faster. That's what we just built."
Problem: Users experience 3-5 second delays on page loads. Our slowest operations
are cache misses on frequently accessed data. We've tried traditional solutions
but hit scaling limits at 100k users.
Solution: We implemented a distributed memory cache with automatic eviction policies
and real-time invalidation. Live demo shows the same operation dropping from 3.2s
to 640ms—5x faster.
Metrics: 47% reduction in average response time, 92% cache hit rate, handles 500k
concurrent users. Users report significantly faster experience.
Closing: This isn't just a performance tweak—it fundamentally changes how our
system scales. We can now support 10x our current user base without additional
infrastructure.Example 2: Commit History to Blog Outline
示例2:提交历史转化为博客大纲
Input: 15 commits implementing authentication feature
Output: 2,000-word blog post outline
Title: "Building a Zero-Overhead Authentication System: How We Reduced Auth
Latency by 80%"
Problem: Every API request requires auth validation. Existing solutions add 200ms
per request. At scale, this becomes our primary bottleneck. We needed something
lightweight that scales to millions of requests/second.
Solution: In-process caching of validation results with background refresh. Smart
invalidation based on user lifecycle events. Result: 25ms per auth check, 92%
improvement.
Deep Dive: JWT parsing optimizations, caching strategy, invalidation mechanics,
security considerations.
Results: Production metrics show 78% latency reduction, zero auth-related outages,
no performance regression.
Code Example: [Complete working example]
Future: Event-driven invalidation, federated auth support, multi-tenant isolation.输入:实现认证功能的15条提交记录
输出:2000字博客文章大纲
Title: "Building a Zero-Overhead Authentication System: How We Reduced Auth
Latency by 80%"
Problem: Every API request requires auth validation. Existing solutions add 200ms
per request. At scale, this becomes our primary bottleneck. We needed something
lightweight that scales to millions of requests/second.
Solution: In-process caching of validation results with background refresh. Smart
invalidation based on user lifecycle events. Result: 25ms per auth check, 92%
improvement.
Deep Dive: JWT parsing optimizations, caching strategy, invalidation mechanics,
security considerations.
Results: Production metrics show 78% latency reduction, zero auth-related outages,
no performance regression.
Code Example: [Complete working example]
Future: Event-driven invalidation, federated auth support, multi-tenant isolation.Example 3: Feature Implementation to Marketing Copy
示例3:功能实现转化为营销文案
Input: Technical specs for simplified API design
Output: Customer-focused value proposition
Headline: "Integrate Faster, Break Less: Our New Simplified API"
Problem: Developers spend 40% of integration time just understanding our API.
One wrong parameter causes cryptic errors. Updates require full refactoring.
Before: Complex 200-parameter API, 50-page documentation, integration timeline
of 2-3 weeks for typical use case.
After: Intuitive design with sensible defaults. 10-parameter quick-start path
covers 90% of use cases. Most integrations complete in 2-3 hours.
Results: 5 major customers report 75% faster integration. Support tickets
cut by 60%. New customer onboarding time reduced from days to hours.
CTA: "Try it free for 30 days. No credit card required."输入:简化API设计的技术规格
输出:以客户为中心的价值主张
Headline: "Integrate Faster, Break Less: Our New Simplified API"
Problem: Developers spend 40% of integration time just understanding our API.
One wrong parameter causes cryptic errors. Updates require full refactoring.
Before: Complex 200-parameter API, 50-page documentation, integration timeline
of 2-3 weeks for typical use case.
After: Intuitive design with sensible defaults. 10-parameter quick-start path
covers 90% of use cases. Most integrations complete in 2-3 hours.
Results: 5 major customers report 75% faster integration. Support tickets
cut by 60%. New customer onboarding time reduced from days to hours.
CTA: "Try it free for 30 days. No credit card required."Example 4: System Architecture to Presentation
示例4:系统架构转化为演讲内容
Input: New microservices architecture technical design
Output: 30-minute presentation outline
- Slides 1-2: The problem with our monolithic system (scaling limits, deployment friction)
- Slides 3-4: System architecture overview (visual diagram, service boundaries)
- Slides 5-7: Key innovations (async messaging, service discovery, circuit breakers)
- Slides 8-10: Live demo of deployment, scaling, monitoring
- Slides 11-12: Results (10x scaling capacity, 60% faster deployments, zero incidents)
- Slides 13-14: Roadmap (service mesh, tracing, multi-region)
- Slide 15: Closing (technical excellence enables business velocity)
undefined输入:新微服务架构的技术设计
输出:30分钟演讲大纲
- Slides 1-2: The problem with our monolithic system (scaling limits, deployment friction)
- Slides 3-4: System architecture overview (visual diagram, service boundaries)
- Slides 5-7: Key innovations (async messaging, service discovery, circuit breakers)
- Slides 8-10: Live demo of deployment, scaling, monitoring
- Slides 11-12: Results (10x scaling capacity, 60% faster deployments, zero incidents)
- Slides 13-14: Roadmap (service mesh, tracing, multi-region)
- Slide 15: Closing (technical excellence enables business velocity)
undefinedNarrative Patterns
叙事模式
Effective technical narratives often follow proven patterns:
有效的技术叙事通常遵循以下经过验证的模式:
The David vs. Goliath Pattern
大卫与歌利亚模式
Problem is perceived as impossible or requiring massive resources. Clever solution
shows surprising simplicity and elegance.
问题被认为是不可能解决或需要大量资源的。巧妙的解决方案展现出惊人的简洁性与优雅性。
The Discovery Pattern
发现模式
Journey from exploration to realization. Audience discovers insight alongside
the storyteller. Creates engagement and learning.
从探索到实现的过程。受众与讲述者一同发现见解。提升参与度与学习效果。
The Transformation Pattern
转型模式
Clear before/after showing dramatic improvement. Emphasizes scope of change and
impact. Works well for demos and marketing.
清晰的前后对比展示显著改进。强调变化的范围与影响。适用于演示和营销内容。
The Layering Pattern
分层模式
Start simple, progressively add complexity. Shows how solution scales from basic
to sophisticated. Builds confidence in understanding.
从简单开始,逐步增加复杂度。展示解决方案如何从基础扩展到复杂。建立理解信心。
The Reversal Pattern
反转模式
Conventional wisdom suggests one approach. Technical work reveals better way.
Creates intellectual interest and demonstrates thought leadership.
传统智慧建议一种方法。技术工作揭示了更好的方式。引发求知欲并展示思想领导力。
Technical Hooks That Work
有效的技术钩子
Surprising Performance Gains:
"We cut response time from 5 seconds to 50 milliseconds—a 100x improvement."
Elegant Simplicity:
"The entire solution is 200 lines of code, yet handles millions of requests/sec."
Novel Insight:
"We realized the problem wasn't the algorithm—it was that we were asking the
wrong question."
Scaling Achievement:
"Scales from 1 user to 100 million users without architectural change."
Reliability Milestone:
"First week in production: zero incidents, 99.99% uptime despite 10x traffic spike."
Elegance Achievement:
"Reduced codebase by 40% while adding 5x more functionality."
令人惊讶的性能提升:
"We cut response time from 5 seconds to 50 milliseconds—a 100x improvement."
优雅的简洁性:
"The entire solution is 200 lines of code, yet handles millions of requests/sec."
新颖见解:
"We realized the problem wasn't the algorithm—it was that we were asking the
wrong question."
扩展成就:
"Scales from 1 user to 100 million users without architectural change."
可靠性里程碑:
"First week in production: zero incidents, 99.99% uptime despite 10x traffic spike."
优雅性成就:
"Reduced codebase by 40% while adding 5x more functionality."
Audience-Specific Adaptations
受众特定适配
For Engineers
面向工程师
- Emphasize technical novelty, elegant solutions, innovation
- Include code samples, algorithm details, architecture diagrams
- Discuss tradeoffs and why alternatives were rejected
- Be precise about measurements and benchmarking
- 强调技术新颖性、优雅的解决方案、创新
- 包含代码示例、算法细节、架构图
- 讨论权衡点及拒绝替代方案的原因
- 精确描述测量与基准测试
For Product Managers
面向产品经理
- Focus on user impact, business metrics, adoption
- Include before/after stories and customer quotes
- Show ROI: investment vs. benefit
- Discuss timeline, resource utilization, roadmap impact
- 聚焦用户影响、商业指标、采用率
- 包含前后对比故事与客户引用
- 展示投资回报率:投入与收益
- 讨论时间线、资源利用、路线图影响
For Executives
面向高管
- Lead with business value: revenue, cost, risk reduction
- Use high-level framing: "10x our capacity" vs. "optimized caching"
- Include time-to-value: when does business see benefit
- Connect to strategy: how does this enable our goals
- 以商业价值开头:收入、成本、风险降低
- 使用高层框架:"10倍容量"而非"优化缓存"
- 包含价值实现时间:业务何时能看到收益
- 关联战略:如何支撑我们的目标
For Users/Customers
面向用户/客户
- Remove technical jargon entirely
- Lead with benefits: "faster", "easier", "safer"
- Use specific, relatable examples
- Answer: "How does this help me?" clearly
- 完全移除技术术语
- 以收益开头:"更快"、"更简单"、"更安全"
- 使用具体、相关的示例
- 清晰回答:"这对我有什么帮助?"
For Marketing
面向营销人员
- Emphasize differentiation from competitors
- Create emotional resonance: what user need does this fulfill
- Use narrative structure: problem → solution → result
- Highlight customer impact and success stories
- 强调与竞争对手的差异化
- 创造情感共鸣:满足用户的哪些需求
- 使用叙事结构:问题 → 解决方案 → 结果
- 突出客户影响与成功案例
Content Transformation Examples
内容转化示例
| Source | Target | Focus |
|---|---|---|
| PR description | Demo script | Engagement, live showing |
| Commit messages | Blog post | Deep explanation, learning |
| Test cases | Use case examples | Practical application |
| Metrics | Headline statistics | Business impact |
| Architectural diagram | Presentation slide | Visual explanation |
| Error logs | Failure scenario story | Problem validation |
| Feature flags | Rollout narrative | Controlled innovation |
| Code comments | Blog section | Design rationale |
| Source | Target | Focus |
|---|---|---|
| PR description | Demo script | Engagement, live showing |
| Commit messages | Blog post | Deep explanation, learning |
| Test cases | Use case examples | Practical application |
| Metrics | Headline statistics | Business impact |
| Architectural diagram | Presentation slide | Visual explanation |
| Error logs | Failure scenario story | Problem validation |
| Feature flags | Rollout narrative | Controlled innovation |
| Code comments | Blog section | Design rationale |
Verification Checklist
验证清单
After synthesizing a narrative, verify:
- Opens with compelling hook within 30 seconds
- Problem is clearly articulated and relatable
- Solution is presented clearly (not too technical/simple)
- Metrics are concrete and meaningful
- Audience understands "why this matters to me"
- Pacing varies (not monotonous)
- Transitions flow logically
- Specific examples make it tangible
- Closes with memorable takeaway
- Appropriate for target audience
- Matches chosen medium (demo, blog, presentation)
- Length is appropriate (7 min demo, not 20 min)
合成叙事后,验证以下内容:
- 前30秒有引人入胜的钩子
- 问题表述清晰且相关
- 解决方案呈现清晰(不过于技术化/简单化)
- 指标具体且有意义
- 受众理解"这与我有什么关系"
- 节奏多变(不单调)
- 过渡逻辑流畅
- 包含具体示例
- 结尾有令人难忘的要点
- 适配目标受众
- 匹配所选媒介(演示、博客、演讲)
- 长度合适(7分钟演示而非20分钟)
Common Pitfalls to Avoid
常见陷阱
Pitfall 1: Too Much Technical Detail
- Problem: Audience loses interest in implementation specifics
- Solution: Lead with impact, provide technical depth only if relevant
Pitfall 2: No Clear Problem Statement
- Problem: Audience doesn't understand why the work matters
- Solution: Spend 30-40% of time articulating the problem
Pitfall 3: Missing Metrics or Impact
- Problem: Sounds impressive but lacks concrete proof
- Solution: Always include quantified before/after comparisons
Pitfall 4: Wrong Audience Adaptation
- Problem: Technical details for marketers, oversimplification for engineers
- Solution: Analyze audience first, then adapt narrative
Pitfall 5: Weak Closing
- Problem: Ends with "and that's it" rather than memorable thought
- Solution: Close with implication, not just summary
Pitfall 6: Pacing Issues
- Problem: Drags in some sections, rushes in others
- Solution: Plan timing carefully; vary pacing to maintain interest
陷阱1:过多技术细节
- 问题:受众对实现细节失去兴趣
- 解决方案:以影响开头,仅在相关时提供技术深度
陷阱2:无清晰的问题陈述
- 问题:受众不理解工作的重要性
- 解决方案:用30-40%的时间阐述问题
陷阱3:缺少指标或影响
- 问题:听起来不错但缺乏具体证据
- 解决方案:始终包含量化的前后对比
陷阱4:受众适配错误
- 问题:向营销人员展示技术细节,向工程师过度简化
- 解决方案:先分析受众,再调整叙事
陷阱5:薄弱的结尾
- 问题:以"就这样了"结束而非令人难忘的观点
- 解决方案:以启示而非总结结尾
陷阱6:节奏问题
- 问题:部分内容拖沓,部分内容仓促
- 解决方案:仔细规划时间;调整节奏以保持兴趣
Integration with Technical Work
与技术工作的整合
This skill treats any technical output as raw material:
- PRs: Extract problem, solution, metrics
- Commit histories: Identify progression and key decisions
- Code: Understand elegance, innovation, tradeoffs
- Metrics: Quantify impact and improvements
- Designs: Articulate architectural reasoning
- Documentation: Extract use cases and examples
本技能将任何技术输出视为原材料:
- PR:提取问题、解决方案、指标
- 提交历史:识别进展与关键决策
- 代码:理解优雅性、创新、权衡点
- 指标:量化影响与改进
- 设计:阐述架构推理
- 文档:提取用例与示例
Output Formats
输出格式
The skill produces ready-to-use narratives in:
- Demo Scripts: Complete with timing, cues, talking points
- Blog Post Outlines: Section-by-section structured narrative
- Presentation Outlines: Slide-by-slide narrative with speaker notes
- Marketing Copy: Customer-focused value propositions
- Release Notes: User-friendly announcements
- Elevator Pitches: 30-60 second hook descriptions
- Social Media Posts: Platform-optimized snippets
- Investor Narratives: Impact-focused business storytelling
本技能生成可直接使用的叙事内容,格式包括:
- 演示脚本:包含时间、提示、演讲要点
- 博客文章大纲:分章节的结构化叙事
- 演讲大纲:带演讲者注释的逐页叙事
- 营销文案:以客户为中心的价值主张
- 版本发布说明:用户友好的公告
- 电梯演讲:30-60秒的钩子描述
- 社交媒体帖子:适配平台的片段
- 投资者叙事:聚焦影响的商业叙事
Philosophy
哲学理念
This skill embodies key principles:
- Clarity Over Complexity: Narrative should illuminate, not obscure
- Authenticity: Stories should reflect reality, not marketing fantasy
- Audience Empathy: Adapt to what matters to listeners/readers
- Metric-Driven: Back claims with quantified results
- Engagement First: Hook attention before delivering message
- Impact Focused: Always connect back to "why does this matter"
本技能体现以下核心原则:
- 清晰优先于复杂:叙事应阐明内容,而非模糊
- 真实性:故事应反映现实,而非营销幻想
- 受众同理心:适配听众/读者的关注点
- 数据驱动:用量化结果支持主张
- 参与度优先:传递信息前先抓住注意力
- 聚焦影响:始终关联"这为什么重要"
Success Criteria
成功标准
A well-synthesized narrative:
- Captures attention within 30 seconds
- Makes non-technical people understand the achievement
- Makes technical people respect the elegance
- Provides specific, memorable examples
- Connects to audience's needs and context
- Is appropriate for chosen medium
- Could be delivered/read without original technical knowledge
- Leaves clear impression of impact and value
优质的合成叙事应满足:
- 前30秒抓住注意力
- 非技术人员能理解成果
- 技术人员认可解决方案的优雅性
- 包含具体、令人难忘的示例
- 关联受众的需求与场景
- 适配所选媒介
- 无需原始技术知识即可交付/阅读
- 留下清晰的影响与价值印象
Related Skills and Workflows
相关技能与工作流
- Technical Writing: Converts narratives to polished prose
- Presentation Design: Turns outlines into visual slides
- Marketing Communication: Adapts narratives for campaigns
- Demo Development: Creates working demonstrations
- Release Management: Packages narratives as announcements
- 技术写作:将叙事转化为精炼的文字
- 演示设计:将大纲转化为可视化幻灯片
- 营销沟通:调整叙事以适配营销活动
- 演示开发:创建可运行的演示
- 版本管理:将叙事打包为公告
Feedback and Evolution
反馈与演进
This skill should improve based on feedback:
- What narrative structures resonate most with your audience?
- What hooks consistently capture attention?
- What examples make concepts click?
- What pacing variations work best?
Document learnings and share with the community.
undefined本技能应根据反馈不断改进:
- 哪些叙事结构最能引起受众共鸣?
- 哪些钩子始终能抓住注意力?
- 哪些示例能让概念清晰易懂?
- 哪些节奏变化效果最佳?
记录学习成果并与社区分享。
undefined