taojianmin
cd71f49709
基于匠厂 skill-template 主仓 v1.0.108 派生的业务技能。 核心业务： - 起草人在 OA 上传新制度送审稿时，自动比对校内现行制度库（约 300+ 份） - 条款级冲突检测 + 程序合规性体检 + 疑似重复发文检测 - 在 Word 侧栏生成批注清单，一键跳转冲突原文 输出形态： - 制度送审稿表状态更新（可送审 → 审查中 → 已通过 / 冲突中 / 驳回） - 冲突条款清单 + HTML 审查报告 + 可选 PDF 导出 预期提效：制度出台后因"与 XX 文件冲突"而被要求暂停/修订的事件减少至零起。 业务行生命周期：可送审 → 审查中 → 已通过 / 冲突中 / 驳回 / 已跳过 Co-Authored-By: Claude Code <noreply@anthropic.com>
143 lines
5.7 KiB
Markdown
143 lines
5.7 KiB
Markdown
# 使用教程
|
||
|
||
本技能有两种**平行**的使用方式：
|
||
|
||
- **数据管理**：在左侧「制度送审稿」表上点工具栏 / 行内按钮
|
||
- **对话任务**：用自然语言让 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`）配置；旧制度版本可能过多 |
|
||
| 结果不对 | 缩小范围重试，或在数据管理核对冲突条款清单 |
|
||
|
||
仍无法解决时，把「你用的入口 + 操作步骤 + 界面提示原文」发给支持人员。
|