制定AI知识问答引用规范，目标是把“答案必须可追溯”变成团队能照着做的文档和流程。规范需要先划定适用范围与引用对象，再确定引用粒度、标注字段、无来源和来源冲突的处理方式，最后配套角色分工、复核机制与抽检指标。本文给出可直接填写的文档骨架、字段表、角色职责表和检查清单，适用于使用知识库、项目数据与文档开展AI问答的研发团队。
要点总览（TL;DR）
- 引用规范的核心是把“答案可追溯”写成可执行文档：先定适用范围与引用对象，再定引用粒度、标注字段，以及无来源、来源冲突、来源过期的处理规则。
- 制定过程分六步：盘点知识源、定义引用字段、设计标注格式、规定核验动作、评审发布、迭代维护，每步都有明确产出。
- 字段表区分必填与选填，来源名称、文档编号、版本号、定位、更新时间为必填；需求、缺陷、设计文档、会议纪要的定位方式按知识类型分别规定。
- 落地靠五个角色分工：提问者、知识维护者、回答整理者、复核者、规范负责人，复核按触发条件执行，知识更新后由维护者与规范负责人共同处理失效引用。
- 发布前核对文档完整性，运行中用引用覆盖率、来源有效率、复核通过率抽检，出现阻断项退回整改，指标口径变化时同步修订规范版本。
引用规范先定哪几件事：核心答案与操作步骤
一份可执行的引用规范，至少要回答四个问题：哪些问答必须带引用、引用到什么粒度、引用写成什么格式、引用缺失或冲突时怎么办。这四个问题定下来，规范的主体就成立了，剩下的工作是把它拆成字段、角色和检查项。
规范要覆盖的引用对象与范围
先列清楚团队里哪些知识源会进入AI问答，再决定每类来源的引用要求。常见对象包括知识库文档、需求条目、缺陷记录、设计文档、会议纪要、代码库说明和项目计划。范围要写明适用场景，例如“面向研发人员的内部知识问答”与“对外交付材料中的问答结论”可以采用不同的引用强度。范围写得越具体，后续争议越少。
范围条款建议包含三项内容：适用的团队与问答渠道、必须带引用的问答类型（如流程解释、缺陷原因分析、需求变更说明）、可以豁免引用的类型（如纯格式咨询）。豁免项要写清理由，避免执行时随意扩大。
引用粒度与标注格式的确定方法
引用粒度决定读者能否回到原文核对。段落级引用适合解释性内容，条目级引用适合需求、缺陷这类结构化记录，版本级引用适合规范、制度类文档。团队可以按知识类型分别规定最低粒度，例如需求类问答必须定位到需求条目编号，设计说明必须定位到章节标题。
标注格式的确定方法是先列出读者核对时需要的信息，再删去冗余项。通常保留来源名称、文档编号、版本、定位和更新时间即可满足核对需要。格式一旦确定，应在规范中给出正例和反例，减少各人写法不一。
无来源、来源冲突、来源过期的处理规则
这三类情况是引用规范最容易缺位的部分，需要逐条写明处理动作：
- 无来源：回答中标注“无来源”并说明原因，例如知识库尚未收录；涉及决策或对外结论时转人工确认，确认前不作为正式答案发布。
- 来源冲突：保留冲突双方的引用，注明各自版本与更新时间，提交复核者判断；规范中写明以哪类来源优先，例如以最新评审通过的版本为准。
- 来源过期：引用时核对更新时间，超过团队设定有效期的来源标注“待确认”，由知识维护者更新后再引用。
制定规范的六步操作
规范本身是一份文档，制定过程可以按以下六步推进，每步都有明确产出：
| 步骤 | 输入 | 动作 | 输出与完成标志 |
|---|---|---|---|
| 1. 盘点知识源 | 现有知识库目录、项目空间、文档清单 | 按类型列出问答会用到的来源，标注责任人与更新频率 | 知识源清单，覆盖主要问答场景 |
| 2. 定义引用字段 | 知识源清单、读者核对需求 | 确定必填与选填字段，按知识类型区分 | 字段定义表，每个字段有填写说明 |
| 3. 设计标注格式 | 字段定义表 | 写出标准格式、正例与反例 | 格式示例，团队可直接套用 |
| 4. 规定核验动作 | 问答流程现状 | 明确谁在什么时点核对引用、发现问题的处理路径 | 核验规则与升级路径 |
| 5. 评审发布 | 规范草稿 | 组织知识维护者与一线使用者评审，修订后发布 | 评审记录与发布版本 |
| 6. 迭代维护 | 运行抽检结果、问题反馈 | 按周期修订字段、格式与规则 | 修订记录与新版本说明 |
六步中，第2步和第4步最容易走过场。字段定义要落到“谁填、填什么、填到什么程度”，核验动作要落到具体时点和责任人，否则规范发布后仍会回到口头约定。
引用字段与标注格式：一张表定清楚
字段表是引用规范的核心交付物。设计时按“读者能否据此找到原文”来判断字段取舍，而不是字段越多越好。下表给出常用字段及填写要求，团队可在此基础上增删。
| 字段 | 填写要求 | 必填/选填 | 示例 |
|---|---|---|---|
| 来源名称 | 知识源在团队内的通用名称 | 必填 | 支付服务设计说明 |
| 文档编号 | 知识库或项目中的唯一标识 | 必填 | WIKI-2048 |
| 版本号 | 引用内容所属版本，与文档版本一致 | 必填 | v2.3 |
| 定位 | 章节标题、段落序号或条目编号 | 必填 | 第4章“超时重试策略” |
| 更新时间 | 来源最近一次有效更新时间 | 必填 | 2025-03-12 |
| 可信等级 | 按团队定义标注，如“已评审”“草稿” | 选填 | 已评审 |
| 责任人 | 来源的维护人或答疑人 | 选填 | 张工（支付组） |
必填字段保证可追溯，选填字段服务于复核和后续维护。可信等级与责任人是否必填，取决于团队对问答结论的使用强度：用于对外交付或跨团队决策时，建议设为必填。
不同知识类型的字段差异
结构化记录与叙述型文档的引用方式不同，字段要求应分类规定：
- 需求：以需求条目编号为主要定位，版本号对应需求变更版本，更新时间取最近一次状态变更时间。
- 缺陷：以缺陷编号定位，补充发现版本与修复版本，便于判断结论适用的代码范围。
- 设计文档：定位到章节，版本号必须与评审通过的版本一致，草稿版本需标注可信等级。
- 会议纪要：定位到会议日期与议题编号，注明结论是否已形成正式决议，未决议内容不作为最终依据。
标注格式示例与常见填写错误
标准格式可以写成一行：来源名称｜文档编号｜版本｜定位｜更新时间，例如“支付服务设计说明｜WIKI-2048｜v2.3｜第4章 超时重试策略｜2025-03-12”。多个来源并列时逐条列出，不合并省略。
常见错误包括：只写文档名称不写编号，同名文档无法区分；版本号写成“最新版”，读者无法判断引用时点；定位只写到文档级别，核对成本高；更新时间照抄创建时间；来源冲突时只保留一个引用，隐去另一方。规范中把这些反例列出来，比只给正例更能减少执行偏差。
角色与交付物：谁提问、谁标注、谁复核
规范落地依赖五个角色。角色可以一人兼任，但职责边界要在文档中写清，避免出现“都以为对方会核对”的情况。
| 角色 | 输入 | 动作 | 输出与完成标志 |
|---|---|---|---|
| 提问者 | 业务问题、已知背景 | 描述问题场景与期望用途，说明是否需要正式结论 | 问题记录，用途与时限明确 |
| 知识维护者 | 知识源清单、更新通知 | 维护文档版本与状态，处理过期来源 | 来源可用，版本与更新时间准确 |
| 回答生成/整理者 | 问题记录、检索结果 | 组织答案，按格式标注引用，标注无来源与冲突情况 | 带引用的回答草稿，字段齐全 |
| 复核者 | 回答草稿 | 抽查引用能否定位、版本是否有效、冲突是否说明 | 复核结论，通过或退回修改 |
| 规范负责人 | 抽检结果、反馈问题 | 维护规范文本，组织评审与修订 | 规范版本与修订记录 |
复核环节的触发条件与升级路径
不是每条问答都需要完整复核，否则流程难以持续。建议设定触发条件：涉及跨团队决策、对外交付、需求变更结论、来源存在冲突或来源过期的问答，必须复核；日常查询类问答可以抽检。复核发现引用无法定位或版本失效时，退回整理者补充；涉及知识源本身错误的，升级给知识维护者修订文档，修订完成前该来源标注“待确认”。
知识更新后引用失效的维护责任
文档更新后，历史问答中的引用可能指向旧版本。规范应约定：知识维护者在发布新版本时，同步检查该来源被引用的问答记录，标注“已更新至新版本”或“结论已变化”；规范负责人按季度汇总失效引用，纳入抽检报告。责任落在知识维护者与规范负责人两方，前者负责来源侧，后者负责机制侧。
在工具承载上，ONES 提供 Wiki 页面与项目数据的统一知识上下文，支持基于指定 Wiki 页面组回答问题并附上引用来源，问答与任务执行基于权限体系进行，输出过程可追踪。团队可以把引用字段、复核状态和修订记录放进文档与工作项流程中管理，让规范中的角色动作有对应的记录位置。
示例：一条带引用的问答记录长什么样
以下为演示情景，用于说明规范各字段的填写方式，不代表真实项目数据。
提问：支付服务调用超时后的重试次数是多少？用于编写联调测试用例。
回答：按当前设计，支付服务调用超时后最多重试2次，重试间隔采用指数退避，首次间隔200毫秒。该结论适用于v2.3版本，v2.2及更早版本为固定间隔重试。
引用：
- 支付服务设计说明｜WIKI-2048｜v2.3｜第4章“超时重试策略”｜2025-03-12｜已评审
- 联调测试用例集｜TEST-317｜v1.6｜用例组“支付超时”｜2025-03-20｜已评审
逐项看填写依据：来源名称使用团队通用叫法，便于检索；文档编号保证同名文档可区分；版本号与引用内容对应，回答中同时说明旧版本差异，避免读者误用；定位写到章节，复核者可直接翻到原文；更新时间用于判断来源是否在有效期内；可信等级说明该版本已经过评审。
来源冲突时的示例处理
假设测试用例集写的是“重试3次”，与设计说明不一致。规范要求保留双方引用并说明差异：“设计说明v2.3为2次，测试用例集v1.6仍按3次编写，两者存在冲突，已提交复核，确认前以设计说明为准，测试用例待更新。”这样处理保留了核对线索，也明确了临时结论的适用条件，避免只留一个答案导致后续误用。
从示例中可迁移的规律
这个示例体现三条可复用做法：回答先给结论再给适用版本，让读者知道边界；引用与结论一一对应，不把多个来源笼统合并；冲突不隐藏，写明临时取舍与后续动作。团队可以把这三条写进规范的示例章节，作为新成员培训材料。
完成检查：规范发布前与运行中的核对项
规范是否可用，发布前看文档完整性，运行后看执行数据。两类检查分开做，避免用运行指标掩盖文档缺陷。
发布前的文档完整性检查项
- 适用范围与豁免场景已写明，且有判断示例。
- 引用对象清单覆盖团队主要知识类型，每类有责任人与更新频率。
- 字段表区分必填与选填，每个字段有填写说明和一个示例。
- 标注格式给出正例与反例，多个来源并列的写法已规定。
- 无来源、来源冲突、来源过期的处理规则均可执行，有责任人和升级路径。
- 角色职责表覆盖提问、维护、整理、复核、规范维护五个环节。
- 复核触发条件明确，抽检指标的口径、统计范围与周期已写入。
- 规范有版本号、发布人与修订记录。
运行中的抽检指标
| 指标 | 口径 | 用途 |
|---|---|---|
| 引用覆盖率 | 抽检问答中带完整必填引用的比例 | 判断标注动作是否执行到位 |
| 来源有效率 | 引用来源中版本有效、可定位的比例 | 发现过期来源与定位不清问题 |
| 复核通过率 | 提交复核的问答一次通过的比例 | 评估整理质量与复核成本 |
指标口径要在规范中固定，例如统计周期为每月、样本为全部复核问答加随机抽检问答。口径变化时同步更新规范版本，避免前后数据不可比。
阻断项与整改条件
以下情况应作为阻断项处理：回答涉及对外交付但无有效引用；来源冲突未说明即发布结论；引用版本已失效且未标注。出现阻断项时，该问答退回整理者，整改完成前不作为正式答案使用。连续两个统计周期引用覆盖率低于团队设定阈值时，由规范负责人组织复盘，检查是字段设计过重还是执行环节缺人。
规范迭代的触发信号
出现以下信号时启动修订：知识源类型发生明显变化，现有字段无法覆盖；复核退回集中在同一类填写错误；抽检发现指标口径与实际流程脱节；团队引入新的问答渠道或工具，引用展示方式需要对齐。修订按“提出—评审—发布—通知”四步走，保留旧版本以便追溯历史问答的引用依据。
常见问题
团队刚开始用AI问答，引用规范可以先简化到什么程度？
可以先保留最小可用版本：只规定三类内容——哪些问答必须带引用、必填字段是哪几个、无来源时怎么处理。必填字段建议先固定来源名称、文档编号、版本号、定位和更新时间五项，可信等级与责任人暂作选填。复核环节先只覆盖对外交付和跨团队决策的问答，其余抽检。运行一个统计周期后，再根据退回集中的错误类型补充字段和规则，避免第一版规范过重导致执行不下去。
引用规范与知识库的文档管理规范是什么关系？
两者管的对象不同，需要衔接。文档管理规范管来源本身：谁能编辑、如何评审、版本怎么发布、过期文档怎么归档；引用规范管问答中如何标注和核对来源。衔接点在于字段：引用规范里的版本号、更新时间、可信等级，都依赖文档管理规范提供准确的版本与状态信息。如果文档侧没有版本记录，引用侧的版本字段就填不准。制定引用规范时，应先确认知识源的版本与状态维护方式，再决定哪些字段设为必填。
AI回答里出现来源冲突，规范要求保留双方引用，实际操作中怎么避免读者误用？
处理冲突时，回答需要同时给出三样信息：冲突双方各自的引用、差异点、临时结论及其适用条件。例如写明“设计说明v2.3为2次，测试用例集v1.6仍按3次编写，确认前以设计说明为准，测试用例待更新”。临时结论要标注“待复核”，并写明复核责任人和预计确认时间。复核完成后，由回答整理者更新记录，保留旧引用作为历史线索。这样读者能看到结论的边界，不会把临时取舍当成最终结论。
抽检指标设多少合适，指标不达标时先改规范还是先追执行？
阈值没有通用标准，建议先按团队现状测一个基线周期，再设定略高于基线的目标。指标不达标时先看退回原因分布：如果错误集中在同一类字段填写，多半是字段说明不清或字段过多，应修订规范；如果错误分散且集中在特定环节，多半是执行缺人或复核时点缺失，应先补流程责任。连续两个统计周期不达标时，由规范负责人组织复盘，把原因归类后再决定改文档还是改分工。
知识文档更新后，历史问答里的旧引用要不要逐条清理？
不必逐条重写历史记录，但要有标记机制。知识维护者发布新版本时，检查该来源被引用的问答，标注“已更新至新版本”或“结论已变化”；规范负责人按季度汇总失效引用，纳入抽检报告。对于仍被频繁查阅的问答，优先更新引用并复核结论；低频记录保留原引用和更新标记即可。关键是让后来查阅的人能看到版本变化，而不是让旧结论以未标注的状态继续流通。
