prompt blog generate tutorial.md
本地来源：seo-llm/raw/seo知识库/TXT整理/seo方法论/seo-knowledge-base/Prompts/prompt-blog-generate-tutorial.md.txt
# 教程类博客生成 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 (主要提示词)
````markdown
# 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
```markdown
**Last Updated**: [日期] | **Difficulty**: [级别] | **Time**: [预计时间]
```
---
### 4. Table of Contents
生成清晰的目录,链接到各个 section:
```markdown
## 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
清晰列出学习目标:
```markdown
## 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
明确列出前置要求:
```markdown
## 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 (可选)
如果项目复杂,提供最终结果预览:
```markdown
## Overview: What We're Building
Here's what the final result will look like:
[建议添加截图占位]
**Key Features:**
- 🎯 [特性1]
- 🎯 [特性2]
- 🎯 [特性3]
```
---
### 8. Step-by-Step Instructions
**每个步骤包含**:
````markdown
## Step [N]: [步骤名称]
### What You'll Do:
[简短说明这一步要完成什么]
### Instructions:
1. **[子步骤1]**
[详细说明]
```bash
# 代码示例(如果适用)
command-to-run --option value
```
````
[建议截图占位: step-N-substep-1.jpg]
2. **[子步骤2]**
[详细说明]
```javascript
// 代码示例
const example = 'code here';
```
3. **[子步骤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. [步骤1]
2. [步骤2]
3. [步骤3]
---
> 💬 **Still stuck?** Check our [FAQ](link) or [join the community](link)
````
---
### 10. Best Practices & Tips
```markdown
## Best Practices & Tips
### ✅ Do:
- ✔️ [最佳实践1]
- ✔️ [最佳实践2]
- ✔️ [最佳实践3]
### ❌ Don't:
- ✖️ [应避免的做法1]
- ✖️ [应避免的做法2]
### Performance Tips:
- 🚀 [性能优化建议1]
- 🚀 [性能优化建议2]
````
---
### 11. Complete Code Example
````markdown
## Complete Code Example
Here's the complete working code:
```[language]
// 完整代码示例
// 可以直接复制使用
[完整的可运行代码]
```
````
📥 **[Download Complete Code](https://github.com/repo)** | 📺 **[Watch Video Tutorial]({video_url})**
````
---
### 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
```markdown
## 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 个)
```markdown
## FAQs
### Q1: [常见问题1]?
**A**: [详细回答]
---
### Q2: [常见问题2]?
**A**: [详细回答]
```
---
## Writing Guidelines:
### DO:
✅ 使用第二人称("you", "your")
✅ 每步提供清晰的子步骤
✅ 包含可复制的完整代码
✅ 添加验证检查点
✅ 预见性地解决问题
✅ 使用具体的命令和配置
✅ 建议截图位置
### DON'T:
❌ 跳过安装步骤
❌ 使用模糊指令("just do X")
❌ 假设读者有先验知识
❌ 提供不完整的代码
❌ 忽略错误处理
❌ 使用复杂术语而不解释
---
## Code Example Requirements:
所有代码示例必须:
1. **语法高亮**: 使用正确的语言标记
2. **完整性**: 可以直接复制运行
3. **注释**: 关键行添加注释
4. **格式化**: 正确缩进和换行
**Example**:
```python
# 连接到数据库
connection = psycopg2.connect(
host="localhost", # 数据库地址
database="mydb", # 数据库名称
user="user", # 用户名
password="password" # 密码
)
# 创建游标
cursor = connection.cursor()
# 执行查询
cursor.execute("SELECT * FROM users WHERE active = true")
```
---
## Screenshot Suggestions:
为以下位置建议截图:
1. 安装/设置完成的确认界面
2. 每个主要步骤的结果
3. 常见错误的示例
4. 最终完成的项目/界面
5. 配置文件的关键部分
**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知识库-TXT整理-seo方法论-seo-knowledge-base-Prompts-prompt-bl-8c4338.txt（仅本地保留，不入库不部署）