问题不是写“遇到技术难点”,是写“Swagger文档里写的返回字段和实际API吐的不一致,我比对了三个环境才确认是测试服缓存没刷”。每个问题要带症状、定位路径、解决动作、验证方式。别写“查阅资料”,写“grep了log目录下七天的日志,发现异常发生在凌晨两点零三分”。问题段落里,动词密度必须高于其他部分。