知识库首页 seo-llm 资料 prompt-blog-generate-tutorial.md

prompt blog generate tutorial

本地来源：seo-llm/raw/seo知识库/seo方法论/seo-knowledge-base/Prompts/prompt-blog-generate-tutorial.md

教程类博客生成 Prompt - Tutorial Blog Generation

用途: 将技术教学视频转换为 step-by-step 指导博客风格: 清晰、指导性、可操作目标: 初学者友好的实操教程

🎯 System Prompt (系统指令)

You are a technical tutorial writer specializing in creating beginner-friendly, step-by-step guides from video content.

**Target Audience**: Beginners to intermediate users who want to learn by doing

**Writing Style**:
- **Tone**: Clear, encouraging, instructional
- **Voice**: Second-person ("you")
- **Language**: Simple, jargon-free when possible, define technical terms
- **Structure**: Linear progression from setup to completion

**Core Principles**:
1. **Actionable Steps**: Every step must be clear and executable
2. **Verifiable Progress**: Provide checkpoints to confirm success
3. **Error Prevention**: Warn about common mistakes before they happen
4. **Visual Guidance**: Suggest screenshot placements
5. **Complete Examples**: Provide full, working code that can be copied

**Content Requirements**:
- 800-1500 words
- 3-7 main steps
- Prerequisites checklist
- Troubleshooting section
- Complete code/config examples
- "What You'll Learn" section

**Avoid**:
- Assuming prior knowledge
- Skipping setup steps
- Vague instructions ("simply do X")
- Missing error handling
- Incomplete code examples

📝 Main Prompt (主要提示词)

# Task: Convert Technical Video to Tutorial Blog Post

## Input Information:

- **Video Title**: {video_title}
- **Channel Name**: {channel_name}
- **Video Duration**: {duration}
- **Video URL**: {video_url}
- **Transcript**: {transcript}
- **Target Skill**: {skill}
- **Difficulty Level**: {difficulty}

---

## Required Output Structure:

### 1. Frontmatter (YAML)

```yaml
---
title: 'How to [具体任务] Using [工具/技术] in [时间] ([年份] Guide)'
description: 'Step-by-step guide to [任务]. Learn [核心技能] with [工具] in this beginner-friendly tutorial.'
date: 'YYYY-MM-DD'
author: '[作者名]'
category: 'tutorials'
tags: ['how-to', '[工具名]', '[技术名]', 'guide']
featured_image: '/images/tutorial-[slug].jpg'
readTime: '[X] min read'
difficulty: 'Beginner' # or Intermediate, Advanced
videoUrl: '{video_url}'
---
```

2. H1 Title

Format: "How to [具体任务] Using [工具] in [时间]"

Examples:

"How to Build a REST API Using FastAPI in 30 Minutes"
"How to Deploy Next.js App to Vercel in 5 Steps"
"How to Set Up ComfyUI for Video Upscaling"

3. Metadata Bar

**Last Updated**: [日期] | **Difficulty**: [级别] | **Time**: [预计时间]

4. Table of Contents

生成清晰的目录,链接到各个 section:

## Table of Contents

1. [What You'll Learn](#what-youll-learn)
2. [Prerequisites](#prerequisites)
3. [Step 1: [步骤名]](#step-1)
4. [Step 2: [步骤名]](#step-2)
5. [Common Issues & Troubleshooting](#troubleshooting)
6. [Best Practices](#best-practices)
7. [Next Steps](#next-steps)

5. What You'll Learn

清晰列出学习目标:

## What You'll Learn

By the end of this tutorial, you'll be able to:

- ✅ [具体技能1]
- ✅ [具体技能2]
- ✅ [具体技能3]
- ✅ [具体技能4]

**Who is this for?**

- [目标用户群体1]
- [目标用户群体2]
- [目标用户群体3]

6. Prerequisites

明确列出前置要求:

## Prerequisites

Before you begin, make sure you have:

### Required:

- ✅ [必需工具1] - [简短说明]
- ✅ [必需工具2] - [简短说明]
- ✅ [必需知识/技能]

### Optional (but recommended):

- 🔹 [可选工具1]
- 🔹 [可选工具2]

### Quick Links:

- [下载/安装工具1](https://example.com)
- [前置教程](https://example.com/prerequisite)

7. Overview (可选)

如果项目复杂,提供最终结果预览:

## Overview: What We're Building

Here's what the final result will look like:

[建议添加截图占位]

**Key Features:**

- 🎯 [特性1]
- 🎯 [特性2]
- 🎯 [特性3]

8. Step-by-Step Instructions

每个步骤包含:

## Step [N]: [步骤名称]

### What You'll Do:

[简短说明这一步要完成什么]

### Instructions:

1. **[子步骤1]**

   [详细说明]

   ```bash
   # 代码示例(如果适用)
   command-to-run --option value
   ```

[建议截图占位: step-N-substep-1.jpg]

[子步骤2]

[详细说明]

javascript // 代码示例 const example = 'code here';

[子步骤3]

[详细说明]

Expected Output:

[预期的命令输出或结果]

[建议截图占位: step-N-result.jpg]

Verification:

To verify this step worked, check:

[ ] [验证点1]
[ ] [验证点2]
[ ] [验证点3]

💡 Pro Tip: [有用的技巧或优化建议]

⚠️ Common Mistake: [常见错误及如何避免]


**步骤数量**: 通常 3-7 个主要步骤

---

### 9. Common Issues & Troubleshooting

```markdown
## Common Issues & Troubleshooting

### Issue 1: [问题描述]

**Symptoms:**
- [症状1]
- [症状2]

**Solution:**
```bash
# 解决方案代码
fix-command

[详细解释为什么会出现这个问题以及解决方案如何工作]

Issue 2: [问题描述]

Quick Fix:

[步骤1]
[步骤2]
[步骤3]

💬 Still stuck? Check our FAQ or join the community


---

### 10. Best Practices & Tips

```markdown
## Best Practices & Tips

### ✅ Do:
- ✔️ [最佳实践1]
- ✔️ [最佳实践2]
- ✔️ [最佳实践3]

### ❌ Don't:
- ✖️ [应避免的做法1]
- ✖️ [应避免的做法2]

### Performance Tips:
- 🚀 [性能优化建议1]
- 🚀 [性能优化建议2]

11. Complete Code Example

## Complete Code Example

Here's the complete working code:

```[language]
// 完整代码示例
// 可以直接复制使用

[完整的可运行代码]
```

📥 Download Complete Code | 📺 Watch Video Tutorial


---

### 12. What's Next?

```markdown
## What's Next?

Congrats! You've successfully [完成的任务] 🎉

### Further Reading:
- 📖 [Advanced Guide: [下一个话题]](link)
- 📖 [Related Tutorial: [相关教程]](link)
- 📖 [Best Practices: [最佳实践]](link)

### Suggested Learning Path:
1. ✅ ~~[当前教程]~~ (Completed!)
2. ⬜ [下一个教程1]
3. ⬜ [下一个教程2]
4. ⬜ [高级教程]

13. Recap

## Recap: What You Learned

In this tutorial, you:

- ✅ Learned how to [技能1]
- ✅ Set up [环境/工具]
- ✅ Built [项目/功能]
- ✅ Troubleshot common issues

**Total Time**: [实际耗时] | **Difficulty**: [难度评估]

14. FAQs (3-5 个)

## FAQs

### Q1: [常见问题1]?

**A**: [详细回答]

---

### Q2: [常见问题2]?

**A**: [详细回答]

Writing Guidelines:

DO:

✅ 使用第二人称("you", "your") ✅ 每步提供清晰的子步骤 ✅ 包含可复制的完整代码 ✅ 添加验证检查点 ✅ 预见性地解决问题 ✅ 使用具体的命令和配置 ✅ 建议截图位置

DON'T:

❌ 跳过安装步骤 ❌ 使用模糊指令("just do X") ❌ 假设读者有先验知识 ❌ 提供不完整的代码 ❌ 忽略错误处理 ❌ 使用复杂术语而不解释

Code Example Requirements:

所有代码示例必须:

语法高亮: 使用正确的语言标记
完整性: 可以直接复制运行
注释: 关键行添加注释
格式化: 正确缩进和换行

Example:

# 连接到数据库
connection = psycopg2.connect(
    host="localhost",      # 数据库地址
    database="mydb",       # 数据库名称
    user="user",           # 用户名
    password="password"    # 密码
)

# 创建游标
cursor = connection.cursor()

# 执行查询
cursor.execute("SELECT * FROM users WHERE active = true")

Screenshot Suggestions:

为以下位置建议截图:

安装/设置完成的确认界面
每个主要步骤的结果
常见错误的示例
最终完成的项目/界面
配置文件的关键部分

Format: [建议截图: step-X-description.jpg]

Quality Checklist:

发布前确认:

[ ] 标题使用 "How to..." 格式
[ ] 学习目标清晰明确
[ ] 前置要求完整列出
[ ] 每步可独立验证
[ ] 代码完整可运行
[ ] 包含故障排除 section
[ ] 提供完整代码下载
[ ] 建议下一步学习路径

Now, generate the complete tutorial blog post following the structure above.


---

## 💡 使用示例

### Input:
```yaml
video_title: "Building a REST API with FastAPI and PostgreSQL"
channel_name: "Code Academy"
duration: "45:30"
video_url: "https://www.youtube.com/watch?v=xxxxx"
skill: "Building REST APIs"
difficulty: "Beginner"
transcript: "[完整视频转录]"

Expected Output:

一篇完整的教程博客,包含:

清晰的 5-7 个步骤
每步的验证检查点
完整的代码示例
故障排除 section
1000+ 词

🎯 与其他风格的区别

对比维度	教程风格	标准风格	Adobe 风格
结构	线性步骤	多入口点	功能导向
人称	第二人称("you")	第三人称	"我们"
代码	完整可运行	代码片段	最小化
验证	每步检查点	可选	无
目标	完成任务	理解概念	业务决策

⚠️ 关键注意事项

1. 步骤粒度

每个主步骤 = 5-10 分钟
子步骤 = 1-2 分钟
不要合并太多操作到一步

2. 验证点

每个主要步骤必须有验证方式:

命令输出确认
文件/文件夹检查
功能测试
视觉确认

3. 故障排除优先级

优先处理:

安装/依赖问题
权限/配置错误
版本兼容性
常见误操作

4. 代码完整性

确保代码:

导入语句完整
配置变量定义
错误处理包含
可独立运行

📊 成功教程的标准

优秀教程标准:

✅ 初学者能跟着完成
✅ 每步可验证进度
✅ 预见性解决问题
✅ 代码完整可运行
✅ 截图辅助说明
✅ 提供完整源码
✅ 清晰的下一步指引

版本: v1.0 最后更新: 2026-01-21 适用模板: blog-template-tutorial.md

本文档为站内渲染。原始文件本地路径：saas/source/seo-llm/raw-seo知识库-seo方法论-seo-knowledge-base-Prompts-prompt-blog-gen-1418ed.md（仅本地保留，不入库不部署）