报告审核助手
一、技能定位
用于审核房屋结构鉴定/检测类报告（docx），直接输出审核意见并生成 Word 意见书，供报告编写人修改。
二、触发方式（一句话）
| 触发词 | 说明 |
|---|---|
| "审核这份报告：路径" | 标准流程：两轮闭卷审核 → 输出意见清单 + HTML展示页 |
| "深度审核这份报告：路径" | 同上 + 角色扮演轮（质安站/委托方/法庭律师视角） |
三、审核流程（两轮闭卷，必须执行）
第0步 · 统一解析（主代理执行，先于子代理启动）
收到审核请求后，主代理先用统一脚本解析报告（禁止子代理各自解析 docx）：
python "<技能目录>\scripts\parse_report.py" "<报告.docx路径>" "<会话工作目录>"
> 技能安装后，<技能目录> 替换为技能在本机的实际安装路径（如 C:\Users\<用户名>\.workbuddy\skills\报告审核助手\）；脚本随技能包自带，无需额外安装。
解析产出：
- 报告全文.md（正文 + 全部表格内嵌，标题转 ##）——生成在会话工作目录根目录
- 表格数据.json（全部表格结构化二维数组，带表格序号）——生成在会话工作目录根目录
> ⚠️ 子代理提示词按"文件在会话目录根目录"书写，因此第 2 个参数必须是会话工作目录本身，不可传子目录；产出文件名固定为 报告全文.md / 表格数据.json，不得改名。
>
> ⚠️ 禁止：给子代理原始 docx 让其自己解析；不提取图片/批注/修订。
第1步 · 启动2个并行子代理（Agent，闭卷，互不看到对方结果）
子代理指令 = 从 <技能目录>\导出工具\子代理提示词模板.md 逐字复制对应模板，只替换 <编号>、<工程名称>、<会话工作目录>、<类型文件> 四个占位符，不得改写模板内容、不得增删字段、不得添加"审核重点方向"等自由发挥内容；复制时排除引用块说明行（模板头部 ⚠️ 说明与尾部【模板结束】标记行），其余逐字复制：
| 子代理 | 分工（职责） | 使用模板 | 产出特点 |
|---|---|---|---|
| 子代理1 · 纯审 | 裸审：不参考任何规则清单，凭专业判断找问题，覆盖规则外的发现 | 模板"一、子代理1 · 纯审" | 无规则依据的发现 |
| 子代理2 · 清单找茬+复算 | 用规则库逐条核对报告 + 联网核查规范版本 + 用 Python 脚本精确复算附表数据 | 模板"二、子代理2 · 清单找茬+数据复算" | 找茬意见 + 复算记录表 |
> ⚠️ 模板是唯一权威：主代理给子代理的指令必须与模板一致。若模板与 SKILL.md 正文冲突，以模板为准并反馈修正。
- 目的：纯审保持"裸审"原始发现力，发现规则之外的新问题；找茬+复算用规则系统化扫描 + 脚本验算抓算术错误。
- 规则库读取：优先共享盘
\\共享盘\结构部\28.AI审核技能\规则库\（技术负责人更新后全员自动生效）；共享盘不可访问时自动回退本技能自带本地副本规则库\（随技能安装，紧急兜底），使用本地副本时在意见汇总注明"规则库来源：本地备份（共享盘不可用）"
汇总（主代理执行）
- 收集2个子代理结果
- 去重：相同/相似问题合并为一条（保留最完整的描述+判断依据）
- 避免清单双级过滤（必须执行）：读取避免清单（优先
\\共享盘\结构部\28.AI审核技能\规则库\避免清单.md，共享盘不可访问时读技能目录规则库\避免清单.md并注明来源为本地备份），将每条意见与避免清单条目比对：
- 一级 · 硬避免：命中即无条件剔除（如委托编号对应关系、证书编号格式、GB 55008引用、抽检比例惯例等——这类意见任何报告都不提）
- 二级 · 软避免：命中后读"否定原因"判情境——情境一致剔除；情境明显不同（结构类型/建造年代/委托方要求等实质差异）保留提出并注明对照理由
- 优先级：避免清单 > 规则库；二级拿不准时宁可提出，不擅自剔除 - 规范数值/条文类意见联网核实（必须执行，B方案扩展）：凡涉及规范数值/条文引用的意见（维度=规范核对，或问题含限值/系数/条文号/表号/版本），不论来源（纯审/找茬/复算/多路），主代理汇总时统一联网复核：
- 权威源：工标网 http://www.csres.com/；每条至少 2 个独立来源交叉确认，冲突以 csres.com 为准
- 分档类数值（按结构类型/层数/材料分档的限值、系数）必须核对规范原文的完整分档表，按本报告实际结构类型+层数取档，禁止跨档套用（案例：0342 单层建筑侧向位移 H/150 被误判"应为多层框架 H/200"；0331 纯审编造"19m/7层"总高度限值）
- 核实一致 → 判断依据补充来源 URL 后保留；核实不一致/查无出处 → 修正或剔除
- 联网不可用 → 标注"待核实"并提醒用户
- 工作量控制：找茬轮已联网核实且判断依据附有来源 URL 的意见 → 分档类数值必须复核，其余抽查；未附 URL 或纯审/复算来源 → 必须复核 - 每条意见统一格式（见第四节）
- 输出意见清单 + 生成 HTML 意见展示页（见第五节）
四、意见格式（七字段，必须完整）
每条意见必须包含：
| 字段 | 说明 | 必填 |
|---|---|---|
| 编号 | A1/A2...B1...C1（首字母=严重度） | ✅ |
| 位置 | 章节号/表号/图号/页码 | ✅ |
| 问题 | 缺陷描述（一句话） | ✅ |
| 判断依据 | 为什么提这条（关键） | ✅ |
| 修改建议 | 怎么改 | ✅ |
| 维度 | 规范核对/数据自洽/逻辑审查/交付规范 | ✅ |
| 来源 | 纯审 / 找茬 / 找茬-复算 / 多路（如"纯审A3+找茬B5"）；数据复算发现的意见标注"找茬-复算" | ✅ |
严重度分级：
- A类：必须修改，影响结论正确性/合规性
- B类：建议修改，影响严谨性/一致性
- C类：一般问题，格式/文字
> 📌 判断依据采集 SOP（五类规则：引用型/数据型/对照型/缺省型/规范型）见 <技能目录>\导出工具\子代理提示词模板.md，由子代理执行；主代理汇总时校验每条意见字段完整即可。
五、输出（HTML 展示页 + 可选 Word 意见书）
- 会话内：直接输出意见清单（每条：编号 | 严重度 | 位置 | 问题 | 修改建议）
- HTML 意见展示页（首选输出，必须生成）：运行导出脚本生成美观的只读展示页（纯展示意见，非打标交互），用 present_files 展示给用户：
bash "<Python路径>" "<技能目录>\导出工具\gen_view_page.py" "<意见JSON路径>" "<输出.html路径>"
- 脚本仅用 Python 标准库，WorkBuddy 自带环境直接可用，零依赖
- 展示页样式：报告信息头部 + A/B/C 分级统计条 + 分级分节卡片（A红/B橙/C灰），每条含编号/位置/问题/判断依据/修改建议/维度/来源
- 若无法运行脚本（环境异常），退化为：把意见清单组织为美观 HTML 并用 present_files 展示 - Word 意见书（可选）：用户需要纸质版/可编辑版时，再用内置文档能力生成 Word。
HTML 展示页内容规范
- 头部：报告编号 + 工程名称 / 报告类型 / 报告结论 / 审核日期
- 统计条：A类 x / B类 y / C类 z / 共 N 条
- 分级分节（按严重度分三节）：
- 一、A类问题（必须修改，影响结论正确性/合规性）
- 二、B类问题（建议修改，影响严谨性/一致性）
- 三、C类问题（一般问题，格式/文字）
- 每条意见：编号（A/B/C色标）+ 维度 + 来源 + 位置 + 问题 + 判断依据 + 修改建议
- 页面为只读展示，不含单选按钮/提交/删除等任何打标交互元素
意见 JSON 键名契约（硬性，2026-08-24）
生成 HTML 前，意见 JSON 的 items 每条意见键名必须用中文：
> 编号 / 严重度 / 位置 / 问题 / 判断依据 / 修改建议 / 维度 / 来源（与 gen_view_page.py 读取一致）
- 禁止用英文键（num/loc/prob/basis 等）——会导致页面字段全空白且历史版本无报错
- 生成 HTML 前必须
json.load校验首条含全部 8 键；gen_view_page.py 已内置契约校验（键名不符将明确报错退出，不再静默产出空白页）
六、执行注意事项
- 子代理必须并行启动、独立上下文，不得共享中间结果（闭卷）
- 汇总去重时保留最完整表述，标注来源轮次（纯审/找茬/找茬-复算）
- 审核完成后直接输出意见清单+HTML展示页
- 拿不准的规范条文先查原文，宁可不提不要编造
- 规范核查冲突裁决：子代理之间或与主代理对规范版本/状态的核查结论冲突时，以工标网 http://www.csres.com/ 为准，意见判断依据中注明该来源 URL
七、维护说明
本技能由技术负责人统一维护，规则库位于公司共享盘 \\共享盘\结构部\28.AI审核技能\规则库\（与主技能共用，技术负责人更新后全员自动生效）。技能自带本地规则库副本（规则库\ 目录），仅用于共享盘不可访问时的紧急兜底。
更新机制：技术负责人更新主技能时，会同步本技能并重新打包分发包。无需自行更新规则库；技术负责人发布新版本技能包后，按 README 安装方法覆盖即可。
使用本技能不需要：打标、投递意见、维护规则。只需"审核 → 拿意见书 → 转交编写人"。
