AI研发报告的输出模板要解决两个问题：写的人知道每段填什么，审的人知道按什么顺序核对。建议把模板分成报告头、正文主体和核验区三层，核验项与正文结构逐条对应，让每条结论都能追溯到数据或工作项。下面给出一份可直接复制的空白模板，并说明字段含义、必填要求、完整示例与调整方法。
要点总览（TL;DR）
- AI研发报告模板建议分三层：报告头固定报告身份与时效，正文主体承载结论与依据，核验区记录发布前的检查动作。
- 正文主体包含结论摘要、进展与完成项、指标与数据口径、问题与阻塞、下阶段计划、需决策事项六个模块，结论摘要每条都要能追溯到工作项编号或指标。
- 必填字段是报告成立的最低条件：报告头缺报告对象、周期、数据截止时间、编制人时退回补齐；核验区任一项不通过，报告保持草稿状态。
- 核验项与结构要素一一对应，审阅人按事实核对、数据口径核对、敏感信息检查、表述与格式检查、审阅与发布记录的顺序逐项检查。
- 模板调整时同步更新空白模板、字段说明和必填标记三处，并保留版本号与变更记录，建议每季度复核指标口径与数据来源。
可复制空白模板：AI研发报告输出结构
以下模板可直接复制到文档工具中填写。方括号内为填写提示，正式使用时替换为实际内容；没有内容的字段写“无”或“不适用”，不要留空。
AI研发报告 一、报告头 报告名称： 报告对象： 报告周期：____年__月__日 至 ____年__月__日 数据截止时间：____年__月__日 __:__ 生成方式：□AI生成初稿 □人工撰写 □AI初稿+人工修订 编制人： 审阅人： 发布范围： 二、正文主体 1. 结论摘要 （3–5条，每条一句话结论，后附对应工作项编号或数据来源） 2. 进展与完成项 | 工作项编号 | 内容 | 状态 | 完成时间 | 证据/链接 | 3. 指标与数据口径 | 指标名 | 本期值 | 上期值 | 统计周期 | 数据来源 | 口径说明 | 4. 问题与阻塞 | 问题描述 | 影响范围 | 当前状态 | 责任人 | 预计解决时间 | 5. 下阶段计划 | 计划事项 | 目标 | 责任人 | 计划完成时间 | 6. 需决策事项 | 决策事项 | 背景 | 可选方案 | 建议方案 | 期望决策时间 | 决策人 | 三、核验区 | 核验项 | 核验内容 | 结果 | 核验人 | 核验时间 | | 事实核对 | 结论与进展项均有工作项或数据支撑 | □通过 □不通过 | | | | 数据口径核对 | 指标名、周期、来源、口径齐全且前后一致 | □通过 □不通过 | | | | 敏感信息检查 | 无个人信息、密钥、未公开商务信息 | □通过 □不通过 | | | | 表述与格式检查 | 结论先行、无歧义表述、表格完整 | □通过 □不通过 | | | | 审阅与发布记录 | 审阅人确认、发布范围与时间登记 | □通过 □不通过 | | |
三层结构的分工是：报告头固定报告的身份和时效，正文主体承载结论与依据，核验区记录发布前的检查动作。审阅人从核验区逐项往下走，遇到不通过项回到对应正文位置修改，改完重新核验。
字段说明：每个结构要素写什么
字段说明与上面的空白模板逐项对应，填写时按表取值即可。
| 字段 | 填写内容 | 常见写法与注意点 |
|---|---|---|
| 报告名称 | 报告类型+对象+周期 | 如“XX项目研发周报（第32周）”，名称中包含周期便于归档检索 |
| 报告对象 | 报告面向的项目、团队或产品线 | 写清范围边界，跨项目报告注明包含哪些项目 |
| 报告周期 | 起止日期 | 与团队统计周期一致，周报按自然周或迭代周期固定 |
| 数据截止时间 | 精确到时分 | 报告中的数据以此时间为准，晚于该时间的变化不纳入本期 |
| 生成方式 | AI生成初稿、人工撰写或两者结合 | 如实标注，便于审阅人判断哪些内容需要重点核对 |
| 编制人、审阅人 | 姓名或工号 | 编制人与审阅人分开，审阅人对核验结果负责 |
| 发布范围 | 接收报告的团队或角色 | 与敏感信息检查联动，范围越大检查越严 |
| 结论摘要 | 本期最重要的3–5条结论 | 结论先行，每条后附工作项编号或指标名，不写过程描述 |
| 进展与完成项 | 本期推进和完成的工作项 | 用工作项编号关联，状态用团队统一的状态值，完成项注明完成时间 |
| 指标与数据口径 | 本期关键指标及计算方式 | 每个指标写清统计周期、数据来源和口径说明，如“缺陷密度=本期新增缺陷数/本期交付需求数” |
| 问题与阻塞 | 影响进度的问题 | 写影响范围、当前状态、责任人和预计解决时间，只描述事实与影响 |
| 下阶段计划 | 下一周期的主要事项 | 每项有目标、责任人和计划完成时间，与本期未完成项衔接 |
| 需决策事项 | 需要上级或相关方拍板的事项 | 给出背景、可选方案、建议方案和期望决策时间，避免只提问题不给选项 |
| 核验区各检查项 | 检查结论与检查人 | 判断依据写在“核验内容”列，结果只有通过与不通过两种，不通过须注明修改位置 |
结论摘要和进展项是最容易写成流水账的两段。写法上先给判断，再给依据：例如“支付模块联调完成，具备提测条件（工作项 PAY-231，完成时间8月6日）”，比“本周继续推进支付模块联调工作”更能支撑审阅判断。指标段的关键是口径可复现，同一指标在不同期报告中统计周期和计算方式保持一致，变更口径要在口径说明中注明变更时间和原因。
必填与选填：哪些字段不能空
必填字段是报告成立的最低条件，缺失时报告不能进入审阅和发布环节。选填字段按报告类型取舍，不影响报告的有效性。
| 区域 | 必填字段 | 选填字段 |
|---|---|---|
| 报告头 | 报告对象、报告周期、数据截止时间、编制人 | 报告名称的附加说明、生成方式（人工撰写时可省略） |
| 正文主体 | 结论摘要、进展与完成项、问题与阻塞、下阶段计划 | 指标与数据口径（无量化指标的报告可省略）、需决策事项（无则写“无”）、附录、图表附件、背景补充 |
| 核验区 | 事实核对、数据口径核对、敏感信息检查、审阅记录 | 表述与格式检查（可由编制人自检替代）、发布范围登记（小范围内部报告可简化） |
必填项缺失或核验未通过时，按以下规则处理：
- 报告头必填项缺失，报告退回编制人补齐后再提交，不进入审阅队列。
- 正文必填项无内容时写“本期无”，并说明判断依据，例如“本期无阻塞问题，依据为缺陷跟踪与站会记录”。留空视为未填写。
- 核验区任一项为“不通过”，报告状态保持草稿，修改后重新核验，核验记录保留修改前后两次结果。
- 数据截止时间之后发生的变化，不在本期报告中修改结论，放入下期报告或备注说明。
填写示例：一份完整的AI研发周报
以下示例为演示情景，按空白模板逐段填写，展示字段之间的对应关系。
AI研发报告 一、报告头 报告名称：订单中心研发周报（第32周） 报告对象：订单中心项目组 报告周期：2025年8月4日 至 2025年8月8日 数据截止时间：2025年8月8日 18:00 生成方式：AI生成初稿+人工修订 编制人：李明 审阅人：王芳 发布范围：研发部、产品部 二、正文主体 1. 结论摘要 - 订单拆分需求开发完成并提测，进度符合计划（工作项 ORD-118）。 - 本期交付需求12个，需求交付周期中位数4.5天，较上期缩短0.8天（数据来源：项目管理系统，截止8月8日18:00）。 - 支付回调联调受第三方沙箱环境影响，存在2天延期风险（问题编号 ORD-121）。 - 下阶段需确认是否将优惠券重构纳入本迭代（决策事项 D-07）。 2. 进展与完成项 | 工作项编号 | 内容 | 状态 | 完成时间 | 证据/链接 | | ORD-118 | 订单拆分需求开发 | 已提测 | 8月7日 | 提测单 T-208 | | ORD-119 | 订单查询接口性能优化 | 已完成 | 8月6日 | 压测报告 P-31 | | ORD-120 | 退款流程异常修复 | 已完成 | 8月5日 | 修复记录 R-56 | 3. 指标与数据口径 | 指标名 | 本期值 | 上期值 | 统计周期 | 数据来源 | 口径说明 | | 需求交付数 | 12 | 10 | 8月4日–8月8日 | 项目管理系统 | 状态为“已完成”且完成时间在本期内的需求数 | | 需求交付周期中位数 | 4.5天 | 5.3天 | 同上 | 项目管理系统 | 从需求进入开发到完成的天数中位数 | | 新增缺陷数 | 9 | 7 | 同上 | 缺陷跟踪系统 | 本期新建且非重复的缺陷数 | 4. 问题与阻塞 | 问题描述 | 影响范围 | 当前状态 | 责任人 | 预计解决时间 | | 第三方支付沙箱不稳定，回调联调反复中断 | 支付回调联调，影响提测时间 | 处理中，已联系对方技术支持 | 张伟 | 8月11日 | 5. 下阶段计划 | 计划事项 | 目标 | 责任人 | 计划完成时间 | | 完成支付回调联调 | 联调通过并提测 | 张伟 | 8月12日 | | 订单拆分需求测试 | 完成主流程与异常场景测试 | 陈静 | 8月13日 | 6. 需决策事项 | 决策事项 | 背景 | 可选方案 | 建议方案 | 期望决策时间 | 决策人 | | 优惠券重构是否纳入本迭代 | 重构预计占用3人日，本迭代剩余容量约4人日 | A.纳入本迭代 B.顺延至下迭代 | B，优先保障订单拆分测试 | 8月11日 | 王芳 | 三、核验区 | 核验项 | 核验内容 | 结果 | 核验人 | 核验时间 | | 事实核对 | 4条结论均对应工作项或指标，无孤立结论 | 通过 | 王芳 | 8月8日 19:10 | | 数据口径核对 | 3项指标周期一致，口径说明与上期相同 | 通过 | 王芳 | 8月8日 19:15 | | 敏感信息检查 | 未包含个人信息、密钥与未公开商务信息 | 通过 | 王芳 | 8月8日 19:20 | | 表述与格式检查 | 结论先行，表格完整，无歧义表述 | 通过 | 王芳 | 8月8日 19:25 | | 审阅与发布记录 | 审阅通过，发布至研发部、产品部 | 通过 | 王芳 | 8月8日 19:30 |
示例中可以看到三处对应关系：结论摘要每条都能在进展表或指标表中找到出处；问题与阻塞的编号与结论摘要中的风险提示一致；需决策事项给出了方案对比和建议，审阅人可以直接判断是否需要上报。核验区的五项检查按顺序完成，每项记录了核验人和时间，发布记录与报告头的发布范围一致。
当报告中的进展、指标和问题来自项目管理系统中的工作项、迭代和缺陷数据时，AI生成初稿的环节可以衔接ONES Assistant：它能够理解项目、工作项、迭代和 Wiki 页面等工作上下文，并支持根据当前迭代生成项目周报保存到 Wiki（依据官方资料，实际可用性取决于团队在 ONES 中的数据完整度）。这样模板中的工作项编号、状态和完成时间有统一来源，核验区的事实核对可以按编号逐条回查。ONES 基于自身权限体系执行知识问答与任务，输出过程可追踪、结果可审计，便于审阅记录留痕。
调整与维护：按团队情况改造模板
模板需要随报告类型和审阅流程调整，调整时保持“结构要素—核验项”的对应关系不被打断。
按报告类型增减正文模块。周报保留全部六个正文模块，指标段可只保留3–5个核心指标；阶段报告在进展与完成项后增加里程碑达成情况，结论摘要相应扩展为阶段性判断；发布报告增加发布清单与回滚方案，问题与阻塞改为已知风险与应对措施。删减模块时同步删除对应的核验内容，避免核验区出现无对应正文的检查项。
按审阅流程调整核验区。只有编制人自检的团队，可把核验项合并为一张自检清单，保留事实核对、数据口径核对和敏感信息检查三项；有独立审阅人的团队，增加审阅意见栏和修改确认栏；需要合规留档的团队，在审阅与发布记录中增加发布渠道、接收人清单和归档位置。
字段增删同步更新三处。新增字段时，同时更新空白模板、字段说明表和必填标记，并在填写示例中补一个用法；删除字段时检查核验区是否有检查项依赖该字段，有则一并调整。字段说明与模板不一致是模板失效的常见原因，每次变更后由模板维护人对照检查一遍。
版本管理与变更记录。模板文件头部保留版本号和生效日期，文末附变更记录表，记录变更日期、变更内容、变更原因和维护人。旧版本报告归档时保留当时使用的模板版本号，便于回溯。
定期复核。建议每季度复核一次：核对指标口径是否仍与当前数据来源一致，数据来源系统是否发生变更，核验项是否覆盖了近期出现过的报告问题。复核结果记入变更记录，无变更也记录复核日期和结论。
| 调整场景 | 需要改动的部分 | 同步检查 |
|---|---|---|
| 周报改为阶段报告 | 正文增加里程碑模块，结论摘要扩展 | 核验区事实核对范围是否覆盖新模块 |
| 增加独立审阅环节 | 核验区增加审阅意见与修改确认栏 | 报告头审阅人字段与发布范围是否对应 |
| 数据来源系统更换 | 指标段数据来源与口径说明 | 数据截止时间与统计周期是否仍可执行 |
| 新增必填字段 | 空白模板、字段说明、必填标记、填写示例 | 缺失处理规则是否覆盖新字段 |
模板的价值在于让填写和审阅按同一套顺序进行。结构要素决定报告写什么，核验项决定发布前查什么，两者保持一一对应，报告才能在固定流程中稳定产出和追溯。
常见问题
AI生成初稿后，核验区哪些检查项需要重点加强？
生成方式标注为“AI生成初稿”或“AI初稿+人工修订”时，事实核对和数据口径核对是重点。事实核对要逐条确认结论摘要中的每条判断都能在进展表或指标表中找到对应的工作项编号或数据来源，孤立结论不能发布。数据口径核对要检查指标名、统计周期、数据来源和口径说明是否齐全，同一指标与上期报告的计算方式是否一致。敏感信息检查同样不能省略，AI初稿可能带入未公开的商务信息或个人信息，发布范围越大检查越严。
报告周期内数据没有更新，指标段可以留空吗？
指标段属于选填字段，没有量化指标的报告可以省略整个模块。如果保留指标段，本期值与上期值相同也要如实填写，并在口径说明中注明数据截止时间，不能留空。留空会让审阅人无法判断是数据未更新还是漏填。确实没有可统计数据的周期，写“本期无新增数据”，并说明数据来源系统的状态。
团队没有独立审阅人，核验区怎么简化？
只有编制人自检的团队，可以把五项核验合并为一张自检清单，保留事实核对、数据口径核对和敏感信息检查三项，表述与格式检查由编制人在提交前自行完成。审阅与发布记录可以简化为提交时间和发布范围登记。简化后仍要保留核验人和核验时间，便于后续回溯。团队增加独立审阅环节时，再补回审阅意见栏和修改确认栏。
报告中的工作项和指标数据如何保证与系统一致？
模板中的工作项编号、状态和完成时间应来自统一的项目管理系统，避免手工转录造成偏差。当报告数据来自 ONES 中的工作项、迭代和缺陷记录时，AI生成初稿的环节可以衔接 ONES Assistant：它能够理解项目、工作项、迭代和 Wiki 页面等工作上下文，并支持根据当前迭代生成项目周报保存到 Wiki（依据官方资料，实际可用性取决于团队在 ONES 中的数据完整度）。这样核验区的事实核对可以按工作项编号逐条回查，ONES 基于自身权限体系执行知识问答与任务，输出过程可追踪、结果可审计，审阅记录便于留痕。
模板改版后，旧报告需要按新模板重写吗？
不需要。旧版本报告归档时保留当时使用的模板版本号即可，便于回溯当时的字段口径和核验记录。新模板从生效日期起适用于新提交的报告，生效日期前的报告按原版本归档。如果改版涉及指标口径变更，在变更记录中注明变更时间和原因，新旧口径的报告对比时以口径说明为准。
