技术写作知识库，按问题组织比按工具分类更耐用

把笔记按 Kubernetes、Python、AI 分文件夹很直观，可遇到跨栈问题时，相关材料会散在多个角落。更实用的组织方式，是围绕读者要解决的问题建立索引。

一篇笔记保留四类信息

问题边界、观察证据、可执行步骤和适用限制。命令注明版本与环境，数字附测试条件，猜测明确标记。没有验证的事故故事宁可不写。

问题：请求取消后后台任务仍运行 证据：调用栈、任务状态、复现步骤 处理：传播取消并释放资源 限制：仅验证于当前版本与样本

链接建立路径，不制造迷宫

概念页解释稳定原理，实践页记录具体工具，复盘页只写真实证据。重复内容保留一个权威位置，其他文章链接过去并补充当前上下文。

定期清理失效材料

依赖升级后重新跑关键命令；无法复现的内容标记过期。AI 可以帮助提取关键词和发现重复，但最终归档仍要看事实与读者任务。

知识体系不是收藏夹越大越好。下次遇到问题能快速找到判断依据，它才真正发挥作用。