知识库治理与文档标准

文档最小结构

适用范围 → 前置条件 → 操作或判断步骤 → 验证方法 → 失败回退 → 风险提示 → 相关文档。

文档元数据

每篇文档包含标题、描述、唯一地址、分类、产品、版本、作者、负责人、审核人、更新时间、状态、标签和 AI 索引开关。

发布流程

作者创建分支并提交文档 → 自动检查格式、链接和构建 → Vercel Preview 预览 → 领域负责人审核 → 合并主分支 → 自动发布。

生命周期

• 草稿：尚不能指导现场执行。
• 审核中：等待技术和内容确认。
• 已发布：当前有效版本。
• 待复审：临近复审期限或依赖发生变化。
• 已归档：保留历史但不进入默认搜索。

质量指标

搜索无结果率、文档使用率、问题解决率、过期率、反馈关闭时间和重复问题数量。访问量高不等于内容有效，应结合任务是否完成判断。

AI 索引要求

标题直接表达问题，段落有清晰语义边界，结论附带条件和来源，版本信息进入元数据，删除内容时同步清除旧索引。