blog-writer

博客撰写

撰写清晰、准确的博客文章，帮助开发者了解 Lightfast 的能力和行业趋势。

重要：准确性高于营销效果

开始撰写前：

1. 核实每项声明：

   • 如果引用数字，请确认来源
   • 如果提及功能，请确认该功能已在生产环境中推出
   • 如果不确定，请要求澄清

2. 切勿夸大宣传：

   • 说明局限性：“目前支持 X；Y 将在 vZ 中推出”
   • 如实说明 Beta 状态和发布计划

3. 匹配类别语气：

   • 工程：技术权威、数据驱动
   • 公司：富有愿景、定义品类
   • 产品：解决问题、注重收益
   • 教程：循序渐进、注重实用
   • 研究：数据驱动、方法优先

写作指南

1. 简洁易读、便于浏览：符合类别的字数要求
2. 突出价值：从读者能获得什么开始写
3. 保持透明：提及 Beta 状态和局限性
4. 使用主动语态：“你现在可以……”而不是“用户能够……”
5. 不使用表情符号：保持专业语气
6. 包含 TL;DR：20-300 个字符，便于 AI 引用（位于 frontmatter 的 tldr 字段中）
7. FAQ 部分：包含 3-5 个符合搜索查询的问题（位于 frontmatter 的 faq[] 中）
8. 代码示例：工程类文章必须包含

工作流

1. 从输入中识别类别；如果不明确，则先询问
2. 从 resources/categories/{category}.md 加载类别风格指南
3. 使用 web-search-researcher agent 研究主题
4. 根据类别模板和 模板 撰写初稿
5. 根据 AEO 要求 添加 AEO 元素
6. 使用检查清单 进行审核

快速参考

选择类别

类别	适用情况	受众
工程	技术深度解析、架构、研究	开发者、工程师
公司	融资、合作、活动、招聘	高管、投资者
产品	功能发布、更新、教程	客户、潜在客户
教程	分步操作指南、使用指南	正在学习的开发者
研究	数据分析、研究结果、基准测试	工程负责人

应做事项

• 包含代码示例（工程类/教程类）
• 使用“从……转向……”的叙述方式（公司类）
• 从痛点切入（产品类）
• 添加 3-5 个相关文档的链接

应避免事项

• 空洞的营销流行语
• 未经核实的声明
• 长段落（确保各部分便于浏览）
• 泛泛的企业套话

输出

将初稿保存到：thoughts/blog/{YYYY-MM-DD-slug}.md

必需的 Frontmatter 字段

每份初稿都必须包含以下字段（对应 apps/www/src/lib/content-schemas.ts 中的 BlogPostSchema）：

• title（核心字段）
• description（150-160 个字符，即 meta description）
• keywords[]（至少 3 项；第一项为主要关键词）
• ogTitle、ogDescription、ogImage（社交媒体/OG）
• authors[]（包含 name、url、twitterHandle 的结构化数组）
• publishedAt、updatedAt（ISO 日期时间）
• category（engineering | product | company | tutorial | research）
• readingTimeMinutes（整数）
• featured（布尔值）
• tldr（20-300 个字符）
• faq[]（至少 1 项）
• _draft: true（用于追踪）

完整的 frontmatter 模板请参阅 resources/templates.md。

资源

• 文档模板
• AEO 要求
• 发布前检查清单
• 工程风格指南
• 公司风格指南
• 产品风格指南