竣工验收资料自动归档
1. 这个数字员工做什么
项目经理在 IM 中对悟帆说一句"帮我归档XX项目的竣工资料",悟帆自动从简道云拉取该项目全生命周期的记录(施工日志、材料报验、检验批、隐蔽工程、设计变更、会议纪要等),按照建筑工程竣工验收标准智能归类,生成完整的归档目录和归档报告,同时识别缺失项并给出补齐建议。
以前是"项目经理翻遍简道云各个表单 → 手动整理资料清单 → 逐份核对是否齐全 → 手写归档目录 → 发现缺资料再一个个找人要"。现在是"说一句人话 → 悟帆自动拉数据、分类、出报告、列缺失"。中间全部跳过。
2. 适用角色
项目经理、资料员、技术负责人、质量总监、甲方代表。
3. 效果预览

4. 简道云侧准备
本方案基于已有的项目管理系统,需要新增一张归档记录表。
4.1 已有表单(数据源,无需新建)
以下表单作为归档数据的来源,确保已有数据正常录入即可:
表单名称 | 作用 | 关键字段 |
项目信息表 | 项目基本信息 | 项目名称、项目编号、建设单位、开竣工日期 |
施工日志 | 每日施工记录 | 日期、天气、施工内容、人员机械 |
材料报验表 | 进场材料验收 | 材料名称、规格、厂家、合格证、报验日期 |
检验批验收记录 | 分部分项验收 | 工程名称、检验批编号、验收结论 |
隐蔽工程验收记录 | 隐蔽节点验收 | 隐蔽部位、验收日期、验收结论 |
设计变更单 | 设计修改记录 | 变更编号、变更内容、审批状态 |
会议纪要 | 工程例会记录 | 会议日期、议题、决议事项 |
检测报告台账 | 第三方检测 | 检测项目、检测日期、检测结论 |
4.2 新建表单:竣工归档记录表
用于存储悟帆生成的归档结果,字段设计如下:
字段 | 类型 | 说明 |
归档编号 | 流水号 | 格式:GD-YYYYMMDD-001,自动生成 |
项目名称 | 单行文本 | 关联项目信息表,填写项目名称 |
项目编号 | 单行文本 | 关联项目信息表,填写项目编号 |
归档发起人 | 成员单选 | 触发归档操作的人员 |
归档日期 | 日期时间 | 归档操作执行时间,默认当前时间 |
归档状态 | 下拉框 | 选项:完整归档 / 有缺失项 / 补齐中 / 已补齐 |
A类-工程管理资料 | 多行文本 | 归类后的资料清单,含份数和明细 |
B类-施工技术资料 | 多行文本 | 归类后的资料清单,含份数和明细 |
C类-材料构配件设备资料 | 多行文本 | 归类后的资料清单,含份数和明细 |
D类-施工记录 | 多行文本 | 归类后的资料清单,含份数和明细 |
E类-试验检测报告 | 多行文本 | 归类后的资料清单,含份数和明细 |
F类-质量验收资料 | 多行文本 | 归类后的资料清单,含份数和明细 |
G类-竣工图 | 多行文本 | 归类后的资料清单,含份数和明细 |
资料总份数 | 数字 | 所有类别资料份数之和 |
缺失项清单 | 多行文本 | 缺失资料的名称、所属类别、补齐建议 |
缺失项数量 | 数字 | 缺失资料的总条数 |
归档报告摘要 | 多行文本 | 归档整体情况的文字总结 |
5. 悟帆侧准备
需要准备一份建筑工程竣工验收资料归档标准文档,作为悟帆的知识库。这份文档是归档分类的核心依据,质量直接决定归类准确度。
文档内容要求:
- 资料分类标准:按《建设工程文件归档规范》(GB/T 50328)的七大类(A~G)列出每类应包含的资料名称清单。不要笼统写"施工相关资料",要写成: A类(工程管理资料):开工报告、施工组织设计(方案)审批表、图纸会审记录、设计交底记录、工程定位测量记录... C类(材料/构配件/设备资料):出厂合格证、进场检验记录、复试报告、材料代用审批表...
- 每类资料的判定规则:什么算"有"、什么算"缺失"。例如: 材料报验表中有记录且合格证附件不为空 → 算"有" 检验批验收记录中验收结论为"合格" → 算"有",为"不合格"或空 → 标记异常
- 常见缺失项及补齐路径:每类资料通常由谁负责、找谁要。例如: 材料合格证 → 找材料员/采购部 检测报告 → 找检测单位/试验室 隐蔽验收记录 → 找质量员/监理
这份文档不需要放在简道云知识库里——悟帆自己能保存和引用。重点是写清楚分类规则和判定逻辑,越具体越好。
6. 悟帆侧配置
6.1 创建悟帆技能
在悟帆中创建一个名为"竣工资料归档"的技能,将上述归档标准文档作为技能的参考资料上传。
6.2 配置简道云连接
确保悟帆已连接简道云,并具备以下表单的读取权限:
- 项目信息表、施工日志、材料报验表、检验批验收记录、隐蔽工程验收记录、设计变更单、会议纪要、检测报告台账
以及"竣工归档记录表"的写入权限。
6.3 任务指令
在 IM 中对悟帆说以下内容即可触发归档(可直接复制使用):
帮我归档【项目名称】的竣工资料。
请按以下步骤执行:
1. 从简道云"项目管理系统"中,按项目名称查询该项目的基本信息(项目编号、建设单位、开工日期、竣工日期)。
2. 依次从以下表单中拉取该项目的全周期数据:
- 施工日志(全部记录)
- 材料报验表(全部记录)
- 检验批验收记录(全部记录)
- 隐蔽工程验收记录(全部记录)
- 设计变更单(全部记录)
- 会议纪要(全部记录)
- 检测报告台账(全部记录)
3. 按照建筑工程竣工验收资料归档标准(GB/T 50328),将所有资料归入以下七大类:
- A类:工程管理资料
- B类:施工技术资料
- C类:材料/构配件/设备资料
- D类:施工记录
- E类:试验/检测报告
- F类:质量验收资料
- G类:竣工图
对每类列出已有的资料名称和份数。
4. 对照归档标准,识别缺失项。对每个缺失项说明:
- 缺失的资料名称
- 所属类别
- 为什么需要这份资料
- 建议找谁补齐(根据资料类型推断责任人)
- 补齐的优先级(高/中/低)
5. 生成归档报告摘要,包含:
- 项目基本信息
- 各类资料完整度(已有/应有 百分比)
- 缺失项汇总
- 整体归档评估
6. 将归档结果写入简道云"竣工归档记录表",包括:
- 项目名称、项目编号、归档发起人、归档日期
- 各类资料清单(A~G类分别写入对应字段)
- 资料总份数
- 缺失项清单和缺失项数量
- 归档报告摘要
- 归档状态:无缺失项则填"完整归档",有缺失项则填"有缺失项"
7. 在 IM 中回复归档摘要,格式如下:
📋 【项目名称】竣工资料归档报告
━━━━━━━━━━━━━━━━
资料总览:共 X 份,覆盖 7 大类
✅ A类 工程管理资料:X 份
✅ B类 施工技术资料:X 份
...
━━━━━━━━━━━━━━━━
⚠️ 缺失项(共 X 项):
1. [资料名] → 找 [责任人],[补齐建议]
2. ...
━━━━━━━━━━━━━━━━
详细记录已写入简道云"竣工归档记录表"
注意事项:
- 如果某个表单查询不到数据,不要报错,在对应类别标注"无记录"并列入缺失项
- 材料报验表中同一材料可能有多条记录,按材料种类去重统计
- 检验批记录按分部工程分组统计
- 归档标准中未列明但项目中实际存在的资料,归入最接近的类别
7. 联调测试
测试用例 | 预期结果 |
对悟帆说"帮我归档滨江花园二期的竣工资料",该项目数据完整 | 悟帆从 8 张表单拉取数据,按 A~G 七大类归类,生成归档报告,写入简道云归档记录表,IM 回复"完整归档",无缺失项 |
对悟帆说"帮我归档XX项目的竣工资料",该项目缺少防水卷材合格证和外墙保温检测报告 | IM 回复中明确列出 2 项缺失,每项标注所属类别、建议找谁补齐(如"找材料员张工"),归档记录表状态为"有缺失项" |
对悟帆说"帮我归档XX项目的竣工资料",该项目刚开工、数据很少 | 悟帆正常执行,大量类别显示"无记录"并列入缺失项,IM 回复中说明当前阶段资料覆盖率较低,给出优先补齐建议 |
对悟帆说"帮我归档XX项目的竣工资料",项目名称不存在 | 悟帆回复"未找到该项目,请确认项目名称是否正确",并列出简道云中已有的项目列表供选择 |
对悟帆说"帮我归档XX项目的竣工资料",材料报验表中有 50 条钢筋记录 | 悟帆按材料种类去重,钢筋归为一条(附注"共 50 批次"),不会重复计数 50 次 |
8. 踩坑提醒
Q1:悟帆拉取数据时提示"查询超时"或数据不全怎么办?
A:大型项目的全周期数据量可能很大(几百上千条记录)。排查思路:
- 确认简道云 API 单次查询上限(默认 100 条),悟帆需要分页拉取。如果技能指令中没有分页逻辑,补充"每次查询 100 条,循环拉取直到无更多数据"。
- 如果某张表单数据量特别大(如施工日志 365 天),可以在指令中加时间范围过滤,比如只拉取关键节点的记录。
- 检查简道云 API Key 的权限是否覆盖了所有需要读取的表单。
Q2:资料归类不准确,比如把"技术交底记录"归到了 A 类而不是 B 类?
A:归类准确度取决于知识库文档的质量。排查思路:
- 检查归档标准文档中是否明确列出了"技术交底记录"属于 B 类。如果文档中只写了"B类:施工技术资料"而没有展开明细,悟帆只能靠推理,容易出错。
- 解决方法:在知识库文档中把每类资料的名称逐一列出,越详细越好。对于容易混淆的资料(如"施工方案"可能属于 A 类也可能属于 B 类),明确标注判定规则。
- 如果反复出现同类错误,可以在任务指令中加一条"技术交底记录统一归入 B 类"这样的硬规则。
Q3:缺失项太多,感觉标准太严了,实际项目中很多资料本来就不需要?
A:这是常见问题。国标 GB/T 50328 是通用标准,不同类型和规模的工程实际需要的资料清单不同。排查思路:
- 在知识库文档中按工程类型(房建/市政/装修)分别列出必需资料和可选资料。悟帆在归档时先判断项目类型,再匹配对应的资料清单。
- 在任务指令中增加一步:"先根据项目的工程类型和规模,确定适用的归档资料清单,再进行核对"。
- 对于"可选资料",在归档报告中标注为"建议提供"而非"缺失",与"必需资料"的缺失区分开。
Q4:归档记录写入简道云时报错?
A:常见原因和解决方法:
- 字段名不匹配——悟帆写入时用的字段名和简道云表单中的字段名(_widget_xxx)不一致。确保悟帆技能中配置了正确的字段映射。
- 多行文本超长——如果某类资料清单特别长,超过了简道云单字段的字符限制(通常 5000 字符),需要截断或拆分。
- 成员单选字段——"归档发起人"需要传 username 而不是姓名,确保悟帆获取的是当前对话用户的简道云 username。

400-111-0890
在线咨询