Mobility
·
用LLM管理安全开发规范：一次llm-wiki实践
内容提要
本文探讨了如何利用大语言模型（LLM）管理安全开发规范。通过建立一个llm-wiki中间层，将原始文档编译成结构化数据，生成操作手册CLAUDE.md，收集素材，并最终输出规范文档。这种方法提高了文档管理效率，确保信息的可持续更新和交叉引用，解决了传统文档管理中的问题。
关键要点
-
安全开发规范文档越来越多，但难以找到和使用。
-
Karpathy提出的llm-wiki思路可以将原始文档编译成结构化数据，提高文档管理效率。
-
实现过程包括生成CLAUDE.md、收集原始素材、让LLM生成Wiki层和生成最终规范文档。
-
CLAUDE.md包含三层架构说明、Wiki页面规范、摄入和查询工作流等关键部分。
-
收集的原始素材包括多种格式的安全开发规范文档和故障复盘报告，保持原貌不修改。
-
LLM生成的Wiki层需要多轮迭代，以确保交叉引用和逻辑关系清晰。
-
最终生成的规范文档具有解释性和交叉引用，提升了阅读体验。
-
更新机制允许通过添加新素材自动更新Wiki层和规范文档。
-
在处理非结构化素材时，需先手动整理以提高效率。
-
llm-wiki管理方法将文档管理转变为知识工程，降低维护成本，提升可持续性。
延伸解读
文档管理的挑战与解决方案
随着安全开发规范文档的增加，传统的文档管理方式面临着查找困难和信息散落的问题。llm-wiki方法通过将原始文档编译成结构化数据，显著提高了文档的可用性和管理效率。这种方法不仅解决了信息检索的难题，还确保了文档的持续更新和交叉引用，适应了快速变化的开发环境。
LLM的迭代与优化
在使用LLM生成Wiki层的过程中，初始版本往往存在交叉引用不充分和逻辑关系不清晰的问题。通过多轮迭代和细化规范，能够逐步提升生成内容的质量。这一过程强调了持续改进的重要性，确保最终输出的规范文档不仅准确而且易于理解。
处理非结构化素材的策略
在收集和整理原始素材时，面对格式不一和质量参差不齐的文档，手动整理成为提高处理效率的关键步骤。尽管增加了前期工作量，但通过结构化处理，能够显著提升LLM后续处理的效果，从而确保最终生成的Wiki层和规范文档的质量。
延伸问答
如何利用大语言模型管理安全开发规范？
通过建立llm-wiki中间层，将原始文档编译成结构化数据，生成操作手册CLAUDE.md，最终输出规范文档。
llm-wiki的核心优势是什么？
llm-wiki通过编译原始文档为结构化数据，提高文档管理效率，确保信息可持续更新和交叉引用。
在实现llm-wiki过程中遇到的主要问题是什么？
主要问题包括LLM生成的Wiki质量不稳定、交叉引用经常断裂以及处理非结构化素材效率低。
如何确保生成的规范文档具有良好的阅读体验？
生成的规范文档包含解释性内容和交叉引用，能够直接用Markdown格式阅读，支持代码高亮和内部链接跳转。
更新llm-wiki的机制是怎样的？
通过将新文件放入raw/sources/目录并告知LLM进行更新，LLM会自动更新Wiki层和规范文档。
如何处理原始素材的多样性和非结构化问题？
在处理非结构化素材时，需先手动整理以提高效率，确保LLM能够有效处理。
