| 结构 | 标题 / 场景 / 症状 / 原因 / 步骤 / 验证 / 相关 |
|---|---|
| 语言 | 先给结论与可直接执行的解法，再展开原理 |
| 更新 | 版本与最后验证时间必须标注 |
条目骨架示例
条目骨架示例
标题：MySQL 主从延迟骤增的排查步骤
症状：Seconds_Behind_Master 持续增长
原因：大事务 / 从库单线程回放 / IO 瓶颈
步骤：1 查大事务 2 查回放线程 3 查磁盘 IO
验证：延迟回落至 <5s 并稳定 30 分钟知识条目模板
知识条目模板统一结构：标题（含关键词）、适用场景、症状、环境、原因、解决步骤、验证、相关问题；模板降低写作门槛，也让检索与复用更顺畅。
易错点
- 模板字段空着提交：信息残缺，复用时仍要重查
- 不标验证时间：读者无法判断内容是否仍适用
数据来源与参考
- 知识条目写作公开实践（KCS/技术写作模板）