Back to Details

blog-post

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Blog Post Writing Skill

博客文章撰写技能

This skill provides a structured workflow for creating high-quality blog posts that educate and engage readers.
此技能为创作兼具教育性与吸引力的高质量博客文章提供结构化工作流。

When to Use This Skill

何时使用此技能

Use this skill when asked to:
  • Write a blog post or article
  • Create a tutorial or how-to guide
  • Develop educational long-form content
  • Write thought leadership pieces
在以下场景中使用此技能：
  • 撰写博客文章或文章
  • 创建教程或操作指南
  • 开发教育类长篇内容
  • 撰写思想领导力文章

Research First (Required)

先做调研（必填步骤）

Before writing any blog post, you MUST delegate research:
  1. Use the 
    task
    tool with 
    subagent_type: "researcher"
  2. In the description, specify BOTH the topic AND where to save:
task(
    subagent_type="researcher",
    description="Research [TOPIC]. Save findings to research/[slug].md"
)
Example:
task(
    subagent_type="researcher",
    description="Research the current state of AI agents in 2025. Save findings to research/ai-agents-2025.md"
)
  1. After research completes, read the findings file before writing
在撰写任何博客文章之前，你必须委托调研工作：
  1. 使用 
    task
    工具，设置 
    subagent_type: "researcher"
  2. 在描述中同时指定主题和保存路径：
task(
    subagent_type="researcher",
    description="Research [TOPIC]. Save findings to research/[slug].md"
)
示例：
task(
    subagent_type="researcher",
    description="Research the current state of AI agents in 2025. Save findings to research/ai-agents-2025.md"
)
  1. 调研完成后，在撰写前阅读调研结果文件

Output Structure (Required)

输出结构（必填要求）

Every blog post MUST have both a post AND a cover image:
blogs/
└── <slug>/
    ├── post.md        # The blog post content
    └── hero.png       # REQUIRED: Generated cover image
Example: A post about "AI Agents in 2025" → 
blogs/ai-agents-2025/
You MUST complete both steps:
  1. Write the post to 
    blogs/<slug>/post.md
  2. Generate a cover image using 
    generate_image
    and save to 
    blogs/<slug>/hero.png
A blog post is NOT complete without its cover image.
每篇博客文章必须同时包含文章内容和封面图片：
blogs/
└── <slug>/
    ├── post.md        # 博客文章内容
    └── hero.png       # 必填项：生成的封面图片
示例：一篇关于“AI Agents in 2025”的文章 → 
blogs/ai-agents-2025/
你必须完成以下两个步骤：
  1. 将文章写入 
    blogs/<slug>/post.md
  2. 使用 
    generate_image
    生成封面图片并保存至 
    blogs/<slug>/hero.png
没有封面图片的博客文章视为未完成。

Blog Post Structure

博客文章结构

Every blog post should follow this structure:
每篇博客文章应遵循以下结构：

1. Hook (Opening)

1. 钩子（开篇）

  • Start with a compelling question, statistic, or statement
  • Make the reader want to continue
  • Keep it to 2-3 sentences
  • 以引人入胜的问题、统计数据或陈述开头
  • 吸引读者继续阅读
  • 控制在2-3句话以内

2. Context (The Problem)

2. 背景（问题阐述）

  • Explain why this topic matters
  • Describe the problem or opportunity
  • Connect to the reader's experience
  • 解释该主题的重要性
  • 描述问题或机遇
  • 结合读者的实际体验

3. Main Content (The Solution)

3. 核心内容（解决方案）

  • Break into 3-5 main sections with H2 headers
  • Each section covers one key point
  • Include code examples, diagrams, or screenshots where helpful
  • Use bullet points for lists
  • 拆分为3-5个带H2标题的主要章节
  • 每个章节覆盖一个关键点
  • 必要时包含代码示例、图表或截图
  • 使用项目符号呈现列表内容

4. Practical Application

4. 实践应用

  • Show how to apply the concepts
  • Include step-by-step instructions if applicable
  • Provide code snippets or templates
  • 展示如何应用相关概念
  • 如有需要，包含分步说明
  • 提供代码片段或模板

5. Conclusion & CTA

5. 结论与行动号召（CTA）

  • Summarize key takeaways (3 bullets max)
  • End with a clear call-to-action
  • Link to related resources
  • 总结关键要点（最多3个项目符号）
  • 结尾给出清晰的行动号召
  • 链接至相关资源

Cover Image Generation

封面图片生成

After writing the post, generate a cover image using the 
generate_cover
tool:
generate_cover(prompt="A detailed description of the image...", slug="your-blog-slug")
The tool saves the image to 
blogs/<slug>/hero.png
.
完成文章撰写后，使用 
generate_cover
工具生成封面图片：
generate_cover(prompt="A detailed description of the image...", slug="your-blog-slug")
该工具会将图片保存至 
blogs/<slug>/hero.png
。

Writing Effective Image Prompts

撰写有效的图片提示词

Structure your prompt with these elements:
  1. Subject: What is the main focus? Be specific and concrete.
  2. Style: Art direction (minimalist, isometric, flat design, 3D render, watercolor, etc.)
  3. Composition: How elements are arranged (centered, rule of thirds, symmetrical)
  4. Color palette: Specific colors or mood (warm earth tones, cool blues and purples, high contrast)
  5. Lighting/Atmosphere: Soft diffused light, dramatic shadows, golden hour, neon glow
  6. Technical details: Aspect ratio considerations, negative space for text overlay
按照以下要素构建提示词：
  1. 主体：画面的核心焦点是什么？请具体、明确。
  2. 风格：艺术方向（极简风、等轴测图、扁平化设计、3D渲染、水彩风等）
  3. 构图：元素的排列方式（居中、三分法、对称）
  4. 调色板：特定颜色或氛围（暖大地色调、冷蓝紫色调、高对比度）
  5. 光线/氛围：柔和漫射光、戏剧性阴影、黄金时刻、霓虹光效
  6. 技术细节：宽高比考量、预留文字叠加的空白区域

Example Prompts

提示词示例

For a technical blog post:
Isometric 3D illustration of interconnected glowing cubes representing AI agents, each cube has subtle circuit patterns. Cubes connected by luminous data streams. Deep navy background (#0a192f) with electric blue (#64ffda) and soft purple (#c792ea) accents. Clean minimal style, lots of negative space at top for title. Professional tech aesthetic.
For a tutorial/how-to:
Clean flat illustration of hands typing on a keyboard with abstract code symbols floating upward, transforming into lightbulbs and gears. Warm gradient background from soft coral to light peach. Friendly, approachable style. Centered composition with space for text overlay.
For thought leadership:
Abstract visualization of a human silhouette profile merging with geometric neural network patterns. Split composition - organic watercolor texture on left transitioning to clean vector lines on right. Muted sage green and warm terracotta color scheme. Contemplative, forward-thinking mood.
技术类博客文章：
Isometric 3D illustration of interconnected glowing cubes representing AI agents, each cube has subtle circuit patterns. Cubes connected by luminous data streams. Deep navy background (#0a192f) with electric blue (#64ffda) and soft purple (#c792ea) accents. Clean minimal style, lots of negative space at top for title. Professional tech aesthetic.
教程/操作指南类：
Clean flat illustration of hands typing on a keyboard with abstract code symbols floating upward, transforming into lightbulbs and gears. Warm gradient background from soft coral to light peach. Friendly, approachable style. Centered composition with space for text overlay.
思想领导力类：
Abstract visualization of a human silhouette profile merging with geometric neural network patterns. Split composition - organic watercolor texture on left transitioning to clean vector lines on right. Muted sage green and warm terracotta color scheme. Contemplative, forward-thinking mood.

SEO Considerations

SEO考量

  • Include the main keyword in the title and first paragraph
  • Use the keyword naturally 3-5 times throughout
  • Keep the title under 60 characters
  • Write a meta description (150-160 characters)
  • 在标题和第一段中包含主关键词
  • 自然使用关键词3-5次
  • 标题长度控制在60字符以内
  • 撰写元描述（150-160字符）

Quality Checklist

质量检查清单

Before finishing:
  • Post saved to 
    blogs/<slug>/post.md
  • Hero image generated at 
    blogs/<slug>/hero.png
  • Hook grabs attention in first 2 sentences
  • Each section has a clear purpose
  • Conclusion summarizes key points
  • CTA tells reader what to do next
完成前请检查：
  • 文章已保存至 
    blogs/<slug>/post.md
  • 封面图片已生成至 
    blogs/<slug>/hero.png
  • 开篇钩子在开头2句话内抓住读者注意力
  • 每个章节都有明确的主题
  • 结论总结了关键要点
  • 行动号召明确告知读者下一步操作