v1.0.1: 制度文件冲突检测与合规审查 - 初版骨架

基于匠厂 skill-template 主仓 v1.0.108 派生的业务技能。

核心业务:
- 起草人在 OA 上传新制度送审稿时,自动比对校内现行制度库(约 300+ 份)
- 条款级冲突检测 + 程序合规性体检 + 疑似重复发文检测
- 在 Word 侧栏生成批注清单,一键跳转冲突原文

输出形态:
- 制度送审稿表状态更新(可送审 → 审查中 → 已通过 / 冲突中 / 驳回)
- 冲突条款清单 + HTML 审查报告 + 可选 PDF 导出

预期提效:制度出台后因"与 XX 文件冲突"而被要求暂停/修订的事件减少至零起。

业务行生命周期:可送审 → 审查中 → 已通过 / 冲突中 / 驳回 / 已跳过

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
2026-09-14 12:19:05 +08:00
commit cd71f49709
38 changed files with 1626 additions and 0 deletions

142
TUTORIAL.md Normal file
View File

@@ -0,0 +1,142 @@
# 使用教程
本技能有两种**平行**的使用方式:
- **数据管理**:在左侧「制度送审稿」表上点工具栏 / 行内按钮
- **对话任务**:用自然语言让 Agent 完成同一能力
定时任务是否提供:**见下方「入口三」**(当前为占位,按需启用)。
---
## 本技能做什么
```text
【新制度送审稿】 → 【条款向量化 + 制度库全库比对】 → 【冲突 / 缺程序 / 重复发文标注】 → 【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`)配置;旧制度版本可能过多 |
| 结果不对 | 缩小范围重试,或在数据管理核对冲突条款清单 |
仍无法解决时,把「你用的入口 + 操作步骤 + 界面提示原文」发给支持人员。