模板应该约束结构#

一个好的技术文章模板，会提醒我不要漏掉必要信息：问题现象是什么、为什么会出现、怎么定位、怎么验证结果。

但模板不应该替我写正文。如果某个段落换个标题还能直接用，那它基本就是废话。

不同栏目要有不同写法#

• 数据分析文章应该给出数据检查顺序和 pandas 示例。

• 算法文章应该讲题型识别、状态维护和边界条件。

• 计算机视觉文章应该强调输入图片、标注、可视化和结果复核。

• 问题解决文章应该写出现象、命令、日志和处理判断。

我会保留的固定部分#

固定的是检查意识，不是句子本身。比如“验证结果”这一节可以保留，但验证 pandas 缺失值和验证 Nginx 403 的方法完全不同，不能用同一段话糊过去。

判断文章是否机械#

• 连续几篇文章的小标题完全一样。

• 总结段把标题换进去就结束。

• 代码块与主题关系很弱。

• 没有具体命令、数据字段、参数或判断标准。

实战复盘#

复盘《个人博客文章模板优化》时，我会把它当成一个站点维护动作，而不是单篇文章。凡是影响首页、分类、RSS、Sitemap、搜索索引或旧链接的改动，都要在发布后做一次线上验证。

如果只在源码里看起来正确，但线上接口或页面没有变化，就说明构建或发布链路还有问题。博客维护类内容必须把“怎么确认已经生效”写清楚。

以后继续扩展这类文章时，可以补充真实命令输出、截图前后的差异，以及回滚路径。这样文章会更接近操作手册，而不是零散备忘。

最小验收样例#

验收《个人博客文章模板优化》时，我会选一篇真实文章或一个真实页面作为样例，而不是只看源码。先确认页面能打开，再确认列表、分类、归档、搜索这些入口都能找到它。

如果文章讲的是站点维护，还要记录修改前后差异：改了哪个文件、构建产物是否更新、线上 HTTP 状态码是多少。这样后面出问题时，可以直接回到这次验收记录。

小结#

文章模板要帮助写作进入状态，而不是替代思考。真正可复用的是写作流程，不能复用的是针对具体问题的判断。