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:
142
TUTORIAL.md
Normal file
142
TUTORIAL.md
Normal 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`)配置;旧制度版本可能过多 |
|
||||
| 结果不对 | 缩小范围重试,或在数据管理核对冲突条款清单 |
|
||||
|
||||
仍无法解决时,把「你用的入口 + 操作步骤 + 界面提示原文」发给支持人员。
|
||||
Reference in New Issue
Block a user