# 知识库治理与文档标准

定义文档模板、所有权、审核、版本、过期处理和质量指标。

## 文档最小结构

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

## 文档元数据

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

## 发布流程

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

## 生命周期

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

## 质量指标

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

## AI 索引要求

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