刑事案件谅解书不必须详细写明案情，但需包含核心事实要素。谅解书的核心目的是表达被害人或其家属对犯罪嫌疑人/被告人的谅解态度，其内容需满足法律要件，但具体写法需根据案件性质和协商情况灵活处理。以下是具体分析：

1. 谅解书的法律要件

根据《刑事诉讼法》及相关司法解释，谅解书需满足以下要素：

• 主体明确：需由被害人或其法定代理人、近亲属签署（未成年人案件需监护人同意）；
• 自愿性：需体现签署人真实意愿，无胁迫、欺诈情形；
• 核心事实：需简要说明案件基本事实（如时间、地点、行为性质），但无需详细描述犯罪过程；
• 谅解意愿：明确表示对犯罪嫌疑人/被告人的行为予以谅解，并可提出从宽处理的建议。

示例：
“2023年X月X日，张三因琐事与李四发生冲突，致李四轻伤。现李四自愿对张三的行为表示谅解，建议司法机关对其从宽处理。”

2. 是否需要详细写案情？

• 无需详细描述的情形：
  若案件事实清楚（如轻微伤害、交通肇事等），且双方对基本事实无争议，谅解书可简化案情描述，重点突出谅解意愿。
  理由：谅解书本质是“态度文件”，非证据材料，详细案情可能引发不必要的争议或泄露隐私。

• 需简要说明案情的情形：
  若案件存在争议（如故意伤害与正当防卫的界限），或涉及复杂情节（如多次协商、赔偿过程），可简要概括案情以明确谅解基础。
  示例：
  “王五因邻里纠纷多次与赵六发生冲突，2023年X月X日双方再次争执，王五推搡致赵六摔倒骨折。现赵六认可王五已赔偿并道歉，自愿对其行为表示谅解。”

3. 风险提示与建议

• 避免模糊表述：
  谅解书需明确“谅解”对象（如具体行为或罪名），避免使用“一切行为”等模糊用语，防止被误解为对未指控行为的谅解。
• 保留协商证据：
  若谅解基于赔偿协议，建议将赔偿金额、支付方式等写入谅解书，或单独签订赔偿协议并附卷，避免后续纠纷。
• 司法实践差异：
  部分地区法院可能要求谅解书需经公证或见证，建议签署前咨询办案机关或律师，确保符合本地要求。

总结：谅解书的核心是“谅解意愿”的表达，案情描述需服务于这一目的。具体写法应结合案件性质、双方协商情况及司法机关要求灵活调整。如有疑问，可直接向我咨询具体案件的谅解书撰写要点。