博客生成指南
个人定位
- 身份:高级AIOPS/DevOps/SRE工程师
- 目标:SRE面试准备与知识体系构建
博客生成规则
文件名规范
- 必须以真实日期开头(格式:YYYY-MM-DD),否则GitHub Pages不会发布
- GitHub Pages不会发布博客名字中日期超过当天的博客
- 日期后接描述性标题,使用短横线分隔
内容组织最佳实践
- 使用结构化思维框架:
- SCQA结构:情境(Situation)→冲突(Conflict)→问题(Question)→答案(Answer)
- 黄金圈法则:按Why→How→What顺序组织内容
- 逆向思维:从反面分析问题,探讨可能的失败原因及预防策略
- FAB分析法:从特点(Features)→优势(Advantages)→利益(Benefits)角度描述技术方案
- 确保内容有清晰的主题和结论
- 代码示例必须实用且可运行
- 可视化增强(一图胜千言):
- 动态图表:对于晦涩难懂的知识点(如网络流、内存管理),优先使用动态图或流程图展示
- 工具使用:调用
generate_image或 Mermaid 生成高质量图示 - 简洁明了:图表应直观表达核心逻辑,避免过度装饰
代码规范
- 模块化要求:代码文件独立成模块,不超过200行
- 完整性要求:包含正确的package定义和必要的imports
- 目录结构:代码放在相应的子目录下,如
/java/01-what-is-java/code - 实用性要求:代码必须基于生产环境真实使用场景,确保可运行
- 验证与精选:
- 结果验证:必须检查代码/命令行的返回结果是否正确
- 精选内容:只保留关键输出,去除无用的日志堆砌,确保来龙去脉清晰且不冗长
- 环境适配:
- Windows环境:所有Shell脚本必须在WSL (Windows Subsystem for Linux) 环境下运行和验证
内容生产方法论
内容决策机制
- 新旧判断:
- 收到随机提问或代码片段时,首先分析是否属于现有博客的知识范畴
- 补充更新:如果现有文章能涵盖,则作为补充案例或章节加入,避免碎片化
- 新建文章:只有当话题独立且具备完整知识体系时,才创建新文章
- 内容分析与去重:
- 在写作前,分析现有博客的章节安排
- 剔除重复冗余内容,确保新加入的内容能与现有体系有机融合
AI提示词最佳实践
- 逆向思维训练法:从反面分析问题,比如问”项目失败的原因及预防策略”
- 黄金圈法则:按Why→How→What顺序提问,让AI结构化表达
- OKR目标拆解法:将大目标拆解为目标→关键结果→执行步骤
- 关键路径法:要求AI规划任务步骤、时间预估和优先级
- SCQA结构表达法:用情境→冲突→问题→答案框架整理内容
- 苏格拉底对话法:通过连续提问引导AI深度思考
- FAB销售写作法:从特点→优势→利益角度描述产品
项目管理规范
- 任务拆解:拆解复杂任务,确保每一项任务和代码更改尽可能简单
- 内容整理:
- 定期合并相关fragment,提取公共模块
- 文件太大时,分段写或拆成更小的子文件
- 处理内容重复,合并或提取到公共模块
- 质量控制:
- 纠正不准确的技术描述
- 补充不完善的内容
- 优化混乱的结构
文件管理策略
- 复制文档中所有代码部分,独立成文件并放在合适的子目录下
- 不同类型的代码放在各自的子文件夹下,避免使用单独的一个代码文件夹
- 建立待办事项,建立标准化工作流模板
- 生成中文和英文双语博客内容时,按照内容本身创建相应的子文件夹