用 OKF 规范把代码转成可导航知识库

是什么 这是一段面向代码助手的文档工程提示词，目标不是修改业务逻辑，而是把项目中的数据库表和 API 转换成结构化、可互相引用的知识资源。它要求先理解当前项目的完整链路，再在 docs/okf/ 下建立概念文件与统一索引。

核心设计 其方法由三层组成：以独立 Markdown 文件承载单个资源，以 YAML frontmatter 提供类型、标题、描述和资源标识等机器可读元数据，再通过标准链接连接相关概念，最终由 index.md 作为导航入口。这种结构兼顾人类阅读、自动解析和后续增量维护，适合接入 AI agent、文档检索或知识图谱流程。

关键洞察 真正有价值的不是文件数量，而是资源边界和关系质量：表、接口、领域概念应有稳定命名，引用关系应能反映调用、依赖或归属。索引也不应只是文件清单，而应成为从领域到实现的最短路径。

边界与风险 提示词没有定义 OKF 的正式 schema、校验器、核心资源判定标准和链接失效检查机制，执行结果可能在不同项目中不一致。若缺少自动生成与持续校验，文档容易随代码演进而过时。内容价值主要来自知识架构和研发效能，而非视觉、交互或体验设计。