name: blog-post description: 当撰写长篇博客文章、教程或教育文章时,这些内容需要结构、深度和SEO考虑,请使用此技能。
博客文章写作技能
此技能提供了创建高质量博客文章的结构化工作流程,以教育和吸引读者。
何时使用此技能
当被要求以下情况时使用此技能:
- 撰写博客文章或文章
- 创建教程或操作指南
- 开发教育长篇内容
- 撰写思想领导文章
首先进行研究(必需)
在撰写任何博客文章之前,您必须委派研究:
- 使用
task工具,设置subagent_type: "researcher" - 在描述中,指定主题和保存位置:
task(
subagent_type="researcher",
description="研究 [主题]。将发现保存到 research/[slug].md"
)
示例:
task(
subagent_type="researcher",
description="研究 2025 年 AI 代理的现状。将发现保存到 research/ai-agents-2025.md"
)
- 研究完成后,在撰写前阅读发现文件
输出结构(必需)
每篇博客文章必须同时包含文章和封面图像:
blogs/
└── <slug>/
├── post.md # 博客文章内容
└── hero.png # 必需:生成的封面图像
示例:一篇关于“2025 年 AI 代理”的文章 → blogs/ai-agents-2025/
您必须完成以下两个步骤:
- 将文章写入
blogs/<slug>/post.md - 使用
generate_image生成封面图像并保存到blogs/<slug>/hero.png
没有封面图像的博客文章是不完整的。
博客文章结构
每篇博客文章应遵循以下结构:
1. 钩子(开头)
- 以一个引人入胜的问题、统计或陈述开始
- 让读者想要继续阅读
- 保持在 2-3 句话
2. 背景(问题)
- 解释为什么这个话题重要
- 描述问题或机会
- 连接到读者的经验
3. 主要内容(解决方案)
- 分成 3-5 个主要部分,使用 H2 标题
- 每个部分涵盖一个关键点
- 在有用时包括代码示例、图表或截图
- 使用项目符号列表
4. 实际应用
- 展示如何应用概念
- 如果适用,包括逐步说明
- 提供代码片段或模板
5. 结论与号召行动
- 总结关键要点(最多 3 个项目符号)
- 以明确的号召行动结束
- 链接到相关资源
封面图像生成
撰写文章后,使用 generate_cover 工具生成封面图像:
generate_cover(prompt="图像的详细描述...", slug="您的博客-slug")
该工具将图像保存到 blogs/<slug>/hero.png。
撰写有效的图像提示
使用以下元素构建您的提示:
- 主题:主要焦点是什么?具体而具体。
- 风格:艺术方向(极简主义、等距、扁平设计、3D渲染、水彩画等)
- 构图:元素如何排列(居中、三分法则、对称)
- 调色板:具体颜色或情绪(暖色调土色、冷色调蓝紫色、高对比度)
- 灯光/氛围:柔和漫射光、戏剧性阴影、黄金时刻、霓虹光
- 技术细节:长宽比考虑、用于文字覆盖的负空间
示例提示
对于技术博客文章:
等距 3D 插图,展示代表 AI 代理的互连发光立方体,每个立方体都有微妙的电路图案。立方体通过发光数据流连接。深蓝色背景 (#0a192f) 带有电蓝色 (#64ffda) 和柔和紫色 (#c792ea) 点缀。干净极简风格,顶部大量负空间用于标题。专业科技美学。
对于教程/操作指南:
干净扁平插图,展示双手在键盘上打字,抽象代码符号向上漂浮,转变为灯泡和齿轮。从柔和珊瑚色到浅桃色的温暖渐变背景。友好、平易近人的风格。居中构图,留有空间用于文字覆盖。
对于思想领导:
抽象可视化,展示与几何神经网络模式融合的人类剪影轮廓。分裂构图 - 左侧有机水彩纹理过渡到右侧干净矢量线条。柔和鼠尾草绿和温暖赤陶色调色板。沉思、前瞻性情绪。
SEO 考虑
- 在标题和第一段中包含主要关键词
- 在整个文章中自然使用关键词 3-5 次
- 保持标题在 60 个字符以下
- 撰写元描述(150-160 个字符)
质量检查清单
完成前:
- [ ] 文章保存到
blogs/<slug>/post.md - [ ] 封面图像生成在
blogs/<slug>/hero.png - [ ] 钩子在前 2 句话中吸引注意力
- [ ] 每个部分都有明确的目的
- [ ] 结论总结关键点
- [ ] 号召行动告诉读者下一步该做什么