安全交底核对 PerryLink/dsh-safety-brief-check

dsh-safety-brief-check — 安全技术交底记录完整性与签字闭环检查

dsh-safety-brief-check 读取一份安全技术交底记录——它的表头字段、被交底人和签字名单、工种名单——然后检查这份记录自身的完整性与闭环：你的表单要求的列是否都填了，每位被交底人是否都出现在签字名单里、有没有人签了两次，交底日期是否不晚于施工日期，作业工种是否出现在被交底的工种名单里，记录是否写明了工程部位和交底人，以及是否留有交底人、被交底人和专职安全员签字的位置。

它能回答什么

| 你问 | 它答 |
| 有位被交底人一直没签字。报告怎么说？ | SB-002——本包唯一一条 error 级规则——比对被交底人名单和签字名单，报出每一个没出现在签字名单里的人；签字名单里出现两次的名字单独报出，因为这两种缺口要用不同的办法补。它只比对这两份名单：判断不了签字是不是本人所签，也不要求逐人签字——如果你的单位允许一组人签一个名，就在材料里说明，或者把这条规则列进 disabledRules。 |
| 交底日期晚于施工日期，算错吗？ | SB-003 会报出来，同一天不算晚。这条规则上限是 warn：第二十七条把施工前作为时间前提，但没写明要做这个比较，所以这条发现只是供复核的线索——施工中途为后来发现的隐患补一次交底，日期本来就晚，记录里应当说明。日期解析不了会单独报出，不会悄悄丢掉。 |
| 检查通过之前，记录必须填哪些列？ | SB-001 读取 requiredFields，本包出厂时是空的，所以它报 skipped（未配置），而不是通过。你把表单的列列进去之后，它会报出每一个缺失或为空的列——空字符串也算没填——但不判断填进去的内容对不对。 |
| 记录有被交底人列，但没有专职安全员的位置。 | SB-006 检查表头里三方——交底人、被交底人、专职安全员——是否各有位置，报出没有对应列的；列名可以替换成你表单里的叫法。它停在 warn，因为 JGJ 59-2011 第3.1.3条是推荐性考评条款（该标准强制性的第4.0.1、5.0.3条已被住房和城乡建设部公告 2022 年第 164 号废止）。它问的是位置在不在，不是有没有人在那儿签字——那是 SB-002 的问题。 |
| 在工地上实际作业的工种，没有出现在交底记录的工种清单里。 | SB-005 把现场实际作业的工种与记录里的工种清单做比对，报出对不上的那些。它最高只给 warn，因为 JGJ 59-2011 要求交底按分部分项进行，但没规定强制的工种对应关系；当材料和 workTrades 参数都没写明现场作业的工种时，它报 skipped —— 它不硬编码任何工种清单。它只比对名称，所以钢筋工和钢筋班组算作不同，也不判断交底内容是否针对该工种。 |
| 记录里始终没写它覆盖哪个工程部位，也没写谁做的交底。 | SB-004 要求表头写明工程部位（subject）和交底人（briefer），缺哪个就报哪个；把 requireHeader 设为 false 时该规则不运行。它最高只给 warn，因为 GB 50870-2013 第8.2.1条没有明确列出表头字段：缺了这些字段，记录就无法说明谁向谁交底了哪个部位，所以这条发现只是可追溯性线索，而不是断言该条款被违反。 |

遵循的标准

| 文件 | 编号 | 引用它的规则 |
| 《建筑施工安全技术统一规范》 | GB 50870-2013 | SB-001, SB-002, SB-004, SB-007 |
| 《建筑施工安全检查标准》 | JGJ 59-2011 | SB-001, SB-002, SB-005, SB-006, SB-007 |
| 《建设工程安全生产管理条例》 | 国务院令第393号 | SB-002, SB-003 |

边界： 这个插件检查一份安全技术交底记录，看一份记录能被要求做到什么 —— 你的表单要求的列都填了，每个被交底的人都显示已签字，交底日期不晚于作业日期，被交底的工种覆盖了实际作业的工种，记录写明了部位和交底人。它不判断交底内容是否充分、是否针对了正确的危险源，也不判断签字是否真实。

⚠️ 只有一个 error，以及两条被废止的强制性条文，本包拒绝误用

SB-002 是唯一的 error 级规则，它依据的是一部行政法规：《建设工程安全生产管理条例》第二十七条要求交底「并由双方签字确认」，罚则是第六十四条第（一）项。其余规则最高只给 warn 或 info。

本包记录了两处更正，否则读者容易搞错：

1. JGJ 59-2011 第 3.1.3 条 —— 与本插件最贴近的条款 —— 是推荐性的考评条款。 该标准仅有的强制性条文是 4.0.1 和 5.0.3，而这两条都已被住房和城乡建设部公告 2022 年第 164 号废止（2023-06-01 起施行）。所以 SB-006（三方签字）只给 warn，其说明里写明了原因。

2. GB 50656-2011 第 10.0.6 条因同一公告失去强制性，且其「班前安全操作规程交底」的措辞位于条文说明，不在条款正文中。 所以本包完全不引用该标准 —— 有测试断言这个编号从不出现。

国家法律对班前会没有规定。 《安全生产法》的 119 条中没有任何班前这个词的出现；法律、行政法规、部门规章、国家标准都没有涉及。省级文件有（比如山东的班前「晨会」指引），但那是地方性的，不是国家层面的——所以任何班前检查出厂时都未配置，规则包也如实说明这一点。

已声明的局限：签名检查只比对姓名列表，无法判断签名是不是本人所签；内容检查是字面词出现检测，无法判断交底讲得好不好——JGJ 59-2011 自己的评分表会因「针对性不强」扣分，这种判断任何字符串操作都做不出来。

兼容性

| 层面 | 状态 |
| Harness | 对等版本范围 >=0.1.2-rc.1 <0.2.0 \|\| >=0.2.0-0 <0.3.0——已验证可接受 0.2.0-rc.2 和 0.2.1-alpha.1。故意不声明 engines.dsh：它没有读取方，也无法拒绝宿主 |
| Node | ^22.19.0 || >=24.0.0 |
| 平台 | 全部（纯 ESM；无原生代码、无网络、无模型调用） |
| 工具模式 | 在 native、ptc 和 both 下都能用；批量处理记录时用 ptc |

做什么

注册 safety_brief_check 工具。它读取一条记录——表头字段、接收人列表和签名人列表、工种列表——套用带版本的规则包，返回报告。

| 规则 | 检查内容 | 严重级别 | 依据 |
| SB-001 | 记录填齐你的表单要求的列（默认关闭） | info | GB 50870-2013 8.2.3 |
| SB-002 | 每个接收人都出现在签名人当中，且没有人签两次 | error | 国务院令第393号 第二十七条 |
| SB-003 | 交底日期不晚于作业日期 | warn | 第二十七条（推论） |
| SB-004 | 交底的工种覆盖实际作业的工种 | warn | JGJ 59-2011 3.1.3-3-2) |
| SB-005 | 记录写明地点和交底人 | warn | GB 50870-2013 8.2.1 |
| SB-006 | 记录为三个签名都留了位置 | warn | JGJ 59-2011 3.1.3-3-4) |
| SB-007 | 交底文本涉及 危险 / 操作规程 / 应急 | warn | GB 50870-2013 8.2.3 |

安装

dsh plugin --profile <name> add dsh-safety-brief-check
dsh --profile <name> --dump-config | grep 'dsh-safety-brief-check'

配置

| 键 | 类型 | 默认值 | 说明 |
| rulesFile | string | rules/safety-brief-check.yaml | 规则包路径，相对于包根目录 |
| disabledRules | string[] | [] | 停止运行的规则 id；每个都会出现在 skipped 里 |
| onlyRules | string[] | [] | 只运行这些规则 id；留空则运行全部规则 |
| skipNotes | string | "" | 附加到每条 skipped 原因后面的备注 |
| timeoutMs | number | 120000 | 协作式工具超时预算 |

值得了解的规则级参数：

- SB-001 requiredFields——记录必须携带的列，例如 [工程名称, 交底部位, 交底日期, 交底人, 被交底人]。留空表示该规则不运行。
- SB-004 requireTradeMatch——设为 false 可停止比对交底工种与作业工种。
- SB-005 requireHeader —— 如果你的记录确实没有表头，就设为 false。
- SB-006 parties —— 签字各方的标准名称，即 [交底人, 被交底人, 专职安全员]。
- SB-007 terms / contentColumns —— 交底文本应当涉及的词，以及从哪些列读取这些词。terms 为空表示该规则不运行。

材料格式

工具接受 JSON 或 YAML。一条记录就是一个扁平映射；姓名和工种列表可以是数组，也可以是带分隔符的字符串：

工程名称: 某某厂房工程交底部位: 二层结构交底日期: 2026-03-10 施工日期: 2026-03-12 交底人: 张工被交底人: 李四、王五、赵六签字: 李四、王五、赵六工种: 钢筋工、木工

被交底人: [李四, 王五] # the array form also works
签字: 李四，王五； # and Chinese punctuation splits the same way

比较姓名时会去掉空白，所以 李 四 和 李四 是同一个人。漏签和重复签字会产生不同的发现，因为两者的修法不同。日期读不出来就报「读不出来」，而不是跳过，这样格式错误的单元格永远无法掩盖时序检查。

规则来源

规则数据放在 rules/safety-brief-check.yaml。每条规则都带一份文件、一个文件编号、按来源自身编号体系给出的条款、一段逐字摘录，以及摘录的读取 URL。加载器会强制要求：摘录必须是真实引文，至少八个字符；依据一般原则或地方政策作出的检查，永远不能标为 error。

引用的条款来自：

- 《建设工程安全生产管理条例》（国务院令第393号，2004-02-01 施行，未修订）—— 第二十七条、第六十四条第（一）项
- 《建筑施工安全检查标准》（JGJ 59-2011）—— 第3.1.3条第3款第2）3）4）项，以及附录B的评分条目
- 《建筑施工安全技术统一规范》（GB 50870-2013）—— 第8.2.1条、第8.2.3条、第8.2.4条

有两处更正塑造了这个规则包，并记录在它的头部：

1. 行业标准的那条条款是推荐性的。 JGJ 59-2011 的强制性条文是 4.0.1 和 5.0.3，两者均被住建部公告 2022 年第 164 号废止；因此引用 3.1.3 的规则标为 warn。
2. GB 50656-2011 第 10.0.6 条因同一公告失去强制性，而且它的班前措辞在条文说明里，不在条款正文中——所以规则包完全不引用该标准。

完整的条款核验报告，包括已核查并已排除的来源，在 rules/evidence/clause-verification.md。

故障排查

- SB-001 报告自己被跳过。 它的字段列表是空的。把你表单用到的列填进去。
- SB-004 什么都没报告。 材料和调用都没有提供施工工种的列表。传入 workTrades，或者接受这项比较没有进行。
- SB-002 标记了一个确实签了字的姓名。 两列可能把姓名写得不一致（多个空格、用了不同的字）。比较会去掉空白，除此之外完全精确。
- SB-003 在一条正确的记录上触发。 如果交底是在作业之后补做的——作业中途发现了隐患——规则包的说明认为这合法，应当在记录中说明。该发现是
- 提示词只做检查，绝不做判定。
- 插件装上了，工具却一直不出现。 检查 main 是否指向 lib/index.mjs，以及 pnpm run build 是否生成了它；main 写错会让加载器静默跳过入口。
- dsh plugin add 以不兼容为由拒绝这个包。 peer 范围覆盖 0.1.x 和 0.2.x；如果你的运行时不在这个范围内，显式授予豁免： dsh plugin --profile <name> allow-version dsh-safety-brief-check@0.1.0 --dsh-version <runtime> --accept-risk
- check 报告 manifest-peers 失败。 静态检查器比对的是硬编码的 peer 范围，早于 0.2 系列。运行时在安装时强制校验 peer 兼容性，所以声明的范围才是正确的；这是 dsh-plugin-dev 中已知的上游问题。

开发

pnpm install
pnpm run typecheck # tsc --noEmit
pnpm test # vitest, paired fixtures per rule
pnpm run build # tsdown -> lib/index.mjs + lib/index.d.mts
node ../scripts/sync-shared.mjs dsh-safety-brief-check # refresh src/shared from ../_shared

许可证

Apache License 2.0 © 2026 dsh-safety-brief-check contributors.