知识库规范

命名与目录

• Map 使用领域或能力名称，例如 Kubernetes.md、可观测性.md。
• Concept 只表达一个稳定判断，不把多个主题堆在同一篇。
• Troubleshooting 使用“现象 + 对象”，例如 MySQL-锁等待与事务.md。
• Runbook 必须包含条件、权限、风险、停止条件、执行和验收。
• Reference 保存命令、字段、版本、出处，不把未经核验的内容当结论。

状态标记

推荐使用 draft、验证中、active、deprecated。XMind 中的“新增”“纠错”“版本限定”是整理提示，需要经过验证后再成为稳定卡片。

证据与安全

结论尽量附命令输出、监控截图、配置 diff、时间线或官方文档链接。账号密码、内部链接、客户信息、完整生产日志和未脱敏附件不得进入公开站点；私有材料只放在授权 Vault。

排障闭环

确认影响 → 建立时间线 → 先止损 → 分层定位 → 证据优先 → 验证假设 → 恢复验证 → 复盘改进。