detect-policy-conflict-gs/TUTORIAL.md

使用教程

本技能有两种平行的使用方式：

• 数据管理：在左侧「制度送审稿」表上点工具栏 / 行内按钮
• 对话任务：用自然语言让 Agent 完成同一能力

定时任务是否提供：见下方「入口三」（当前为占位，按需启用）。

---

本技能做什么

【新制度送审稿】 → 【条款向量化 + 制度库全库比对】 → 【冲突 / 缺程序 / 重复发文标注】 → 【Word 侧栏批注 + 表状态更新】

• 输入：起草人在 OA 上传的新制度 Word 送审稿 + 校内现行全部制度（约 300+ 份）
• 输出：Word 侧栏批注清单 + 送审稿表状态更新 + 可选离线审查报告
• 说明：本技能不替代法律 / 合规终审；冲突标注供参考，最终签发仍由校办文秘科与分管校领导负责

---

开始前

确认：

1. 已安装并登录匠厂客户端
2. 已在技能市场安装本技能（建议更新到最新版）
3. 校内现行制度库的访问权限已配置（OA_API_BASE_URL / OA_API_TOKEN 已登记到本技能 .env）
4. 【如需】上传送审稿前，确认 Word 文档已完成自校
5. 【如需】首次使用前，先在「数据管理 → 制度库同步」点击一次「立即同步」载入最新制度索引

---

入口一：数据管理

适合：制度起草人、校办文秘科、喜欢点界面操作的用户。

左侧各表是干什么的

表名（中文）	作用
制度送审稿	每一份等待审查 / 审查中 / 已通过的送审稿，状态行可见
冲突条款清单	审查过程中发现的所有冲突条款，含新旧制度链接
制度库索引	校内现行 300+ 份制度文件的索引（只读）
审查任务日志	每一次审查的执行记录与耗时

首次准备（若需要）

1. 进入 数据管理 → 制度库索引
2. 点击表顶 「立即同步」（空表可点）
3. 成功后应看到：本校全部现行制度的标题、文号、发文日期、最近修订日期等元数据

主流程：送审一份新制度

1. 进入 制度送审稿
2. 点击表顶 「上传送审稿」，选择本地 Word 文件
3. 上传成功后行自动进入「可送审」状态
4. 选中该行 → 点击 「审查送审稿」
5. 等待 10~30 秒（向量化比对 300+ 份制度）
6. 完成后行状态变为「已通过」/「冲突中」/「驳回」，并写入冲突条款清单

行级 / 批量

你想做什么	操作
重新审查某一份	制度送审稿 行内 → 「重新审查」
批量重新审查	勾选多行 → 「批量重新审查」
导出审查报告	制度送审稿 行内 → 「导出审查报告」
手动标记状态	制度送审稿 行内 → 「标记为已通过」 / 「标记为驳回」

---

入口二：对话任务

适合：临时提问、不想切换表、不熟界面操作的用户。

什么时候用对话

• 临时送审 1~2 份制度，但不想打开数据管理
• 想用自然语言解释"为什么这份制度与某份旧制度冲突"
• 想知道"本月一共审了多少份、有多少冲突"

示例话术

你想做什么	可以这样说
送审一份新制度	「我刚上传了《XX管理办法》，请帮我审一下」
重新比对	「请重新比对昨天那一份《XX 制度》」
查看本月统计	「本月一共审了多少份制度？有多少冲突？」
解释冲突	「为什么这份送审稿与《XX 制度》第 X 条冲突？」
导出报告	「把这份审查报告导出 PDF 发给我」

Agent 可能追问什么

• 缺参数时：会问"请告诉我送审稿的 ID 或文件名"
• 上传未完成时：会提示"送审稿尚未完成向量化，请稍候"
• 失败时：可改用数据管理点按钮重新触发

---

入口三：定时任务

本技能当前为占位（按需启用）

本技能当前未启用定时任务入口。如未来启用，建议场景：

• 制度库新增 / 变更后，自动扫描存量送审稿是否还合规
• 每月最后一天自动生成《本月送审审查月报》

启用条件：OA 提供 Webhook / 制度库订阅接口，并经校办文秘科与合规岗确认自动化边界。

当前请使用 数据管理 或 对话任务。

---

主能力对照表

想做什么	数据管理	对话任务
送审一份新制度	制度送审稿 → 「上传送审稿」 + 「审查送审稿」	「我刚上传了《XX 管理办法》，请帮我审一下」
重新审查	行内 → 「重新审查」	「请重新比对《XX 制度》」
导出审查报告	行内 → 「导出审查报告」	「把这份审查报告导出 PDF」
标记状态	行内 → 「标记为已通过 / 驳回」	「把这份送审稿标记为已通过」
查看本月统计	表顶 「本月统计」	「本月一共审了多少份？」

按钮名必须与 assets/actions.json 的 label 一致。

---

常见卡住怎么办

现象	你可以先试
「上传送审稿」点不了	是否已配置 OA API；是否装错版本
审查很久没结果	看任务中心进度；送审稿过大（>5MB）可能耗时较久
冲突标注过少	制度库是否完成首次同步；送审稿是否含表格图片（OCR 漏检）
冲突标注过多	检查阈值（CONFLICT_THRESHOLD）配置；旧制度版本可能过多
结果不对	缩小范围重试，或在数据管理核对冲突条款清单

仍无法解决时，把「你用的入口 + 操作步骤 + 界面提示原文」发给支持人员。