博客生成指南

博客生成指南

个人定位

  • 身份:高级AIOPS/DevOps/SRE工程师
  • 目标:SRE面试准备与知识体系构建

博客生成规则

文件名规范

  • 必须以真实日期开头(格式:YYYY-MM-DD),否则GitHub Pages不会发布
  • GitHub Pages不会发布博客名字中日期超过当天的博客
  • 日期后接描述性标题,使用短横线分隔

内容组织最佳实践

  • 使用结构化思维框架
    • SCQA结构:情境(Situation)→冲突(Conflict)→问题(Question)→答案(Answer)
    • 黄金圈法则:按Why→How→What顺序组织内容
    • 逆向思维:从反面分析问题,探讨可能的失败原因及预防策略
    • FAB分析法:从特点(Features)→优势(Advantages)→利益(Benefits)角度描述技术方案
  • 确保内容有清晰的主题和结论
  • 代码示例必须实用且可运行

代码规范

  • 模块化要求:代码文件独立成模块,不超过200行
  • 完整性要求:包含正确的package定义和必要的imports
  • 目录结构:代码放在相应的子目录下,如/java/01-what-is-java/code
  • 实用性要求:代码必须基于生产环境真实使用场景,确保可运行

内容生产方法论

AI提示词最佳实践

  1. 逆向思维训练法:从反面分析问题,比如问”项目失败的原因及预防策略”
  2. 黄金圈法则:按Why→How→What顺序提问,让AI结构化表达
  3. OKR目标拆解法:将大目标拆解为目标→关键结果→执行步骤
  4. 关键路径法:要求AI规划任务步骤、时间预估和优先级
  5. SCQA结构表达法:用情境→冲突→问题→答案框架整理内容
  6. 苏格拉底对话法:通过连续提问引导AI深度思考
  7. FAB销售写作法:从特点→优势→利益角度描述产品

项目管理规范

  • 任务拆解:拆解复杂任务,确保每一项任务和代码更改尽可能简单
  • 内容整理
    • 定期合并相关fragment,提取公共模块
    • 文件太大时,分段写或拆成更小的子文件
    • 处理内容重复,合并或提取到公共模块
  • 质量控制
    • 纠正不准确的技术描述
    • 补充不完善的内容
    • 优化混乱的结构

文件管理策略

  • 复制文档中所有代码部分,独立成文件并放在合适的子目录下
  • 不同类型的代码放在各自的子文件夹下,避免使用单独的一个代码文件夹
  • 建立待办事项,建立标准化工作流模板
  • 生成中文和英文双语博客内容时,按照内容本身创建相应的子文件夹