doc-auditor
元信息
- 名称: 文档审核工具 (doc-auditor)
- 版本: v2.0
- 作者: Dreemurr
- 描述: 通过五维度审核体系,系统化审核文档内容,确保文档质量与安全
- 触发条件: 用户发送"审核文档"、"检查文档"、"doc audit"或类似请求
五维度审核体系
维度1:文档结构与格式
- 标题层级是否清晰(H1/H2/H3)
- 列表、代码块、表格的格式是否统一
- 文档长度是否与内容复杂度匹配
- 是否存在死链或图片缺失
维度2:内容质量
- 观点是否有事实依据或引用来源
- 是否存在语法错误、拼写错误
- 逻辑连贯性,是否存在跳跃或重复
- 信息时效性,提及的数据是否有有效期
维度3:事实准确性
- 关键断言是否可验证
- 数据、统计、百分比是否准确
- 日期、时间线是否一致
- 术语使用是否准确
维度4:安全与隐私
- 是否包含敏感信息(个人身份信息、内部系统路径)
- 是否泄露内部资源标识符
- 是否包含不当内容
维度5:风格一致性
- 中英文混排是否规范
- 术语表是否统一
- 行文语气是否一致
- 格式规范是否统一(如引号、括号用法)
执行流程
阶段1:接收与分类
- 用户提供文档内容或文档路径
- 判断文档类型(内部文档/外部文档/技术文档/政策文档)
- 选择对应的审核规则集合
- 进入执行阶段
阶段2:五维度逐项检查
- 结构与格式检查(基础)
- 内容质量检查(核心)
- 事实准确性检查(关键)
- 安全与隐私检查(必须)
- 风格一致性检查(收尾)
阶段3:问题汇总与定级
- 🔴 P0(阻断):直接拒绝文档发布
- 🟠 P1(严重):需修复后复审
- 🟡 P2(一般):建议修复
- 🟢 P3(提示):可选优化
阶段4:输出审核报告
# 文档审核报告
## 基本信息
- 文档类型:
- 审核时间:
- 审核范围:
## 问题汇总
| 级别 | 数量 | 描述 |
|------|------|------|
| P0 | X | ... |
| P1 | X | ... |
| P2 | X | ... |
| P3 | X | ... |
## 维度详情
### 🔴 阻断问题 (P0)
...
### 🟠 严重问题 (P1)
...
### 🟡 一般问题 (P2)
...
### 🟢 建议优化 (P3)
...
## 审核结论
- ✅ 通过
- ❌ 不通过(需修复P0/P1后复审)
审核规则
通用规则
- 逐维度执行:必须按顺序完成所有维度检查,不可跳过
- 双人复核:P0/P1问题需二次确认
- 证据留存:每个问题需标注依据
- 版本追踪:记录审核版本号
P0判定规则
以下情况直接判定P0:
- 泄露内部系统路径(/Users/xxx/...、/home/xxx/...、C:\xxx\...)
- 泄露内部资源标识符(工号/ID/UUID/内部域名)
- 包含个人身份信息(身份证/手机号/邮箱/地址)
- 包含金融敏感信息(银行卡号/支付密码)
- 违反法律法规或平台政策的内容
- 核心技术方案或商业机密
P1判定规则
以下情况判定P1:
- 关键数据错误(影响用户决策)
- 缺失必要信息(导致流程无法执行)
- 严重逻辑错误(误导用户)
- 安全漏洞描述(可能被恶意利用)
变体版本区分
变体A:快速审核(Fast Track)
适用场景:时间敏感的低风险文档
规则:
- 仅执行维度1、4(P0必检)
- 问题直接输出,不汇总
- 不生成完整报告
变体B:深度审核(Deep Dive)
适用场景:高风险文档(公开文档、技术文档)
规则:
- 五维度全部执行
- 每个维度独立报告
- 变体检测(检查是否与其他文档高度相似)
- 模拟用户视角测试
变体C:变更审核(Change Review)
适用场景:文档已存在,审核变更部分
规则:
- 仅检查变更段落(diff标注)
- 评估变更影响范围
- 检查变更是否引入新问题
使用限制
- 最大文档长度:单次审核不超过50,000字
- 超时处理:单次审核不超过60秒,超时自动降级为快速审核
- 并发限制:最多同时处理3个文档审核任务
- 存储限制:审核报告保留30天后自动清理
错误处理
| 错误类型 | 处理方式 |
|---|
| ---------- | ---------- |
| 文档无法读取 | 提示用户提供纯文本内容 |
| 文档过长 | 自动拆分为多个部分,依次审核 |
| 格式混乱 | 尝试解析,失败则要求用户整理 |
| 内容加密/水印 | 提示版权问题,拒绝审核 |
执行示例
示例1:内部技术文档审核
用户:审核一下这个文档 ~/docs/api-guide.md
系统:
# 文档审核报告
## 基本信息
- 文档类型:内部技术文档
- 审核时间:2024-01-15 14:30
- 审核范围:全文
## 问题汇总
| 级别 | 数量 | 描述 |
|------|------|------|
| P0 | 1 | 泄露内部系统路径 |
| P1 | 2 | 数据准确性存疑 |
| P2 | 3 | 格式不一致 |
## 维度详情
### 🔴 阻断问题 (P0)
1. [维度4] 第23行包含内部路径 `/Users/dev/internal/...`
- 依据:路径格式符合内部开发机特征
### 🟠 严重问题 (P1)
1. [维度3] 第45行提及"响应时间<100ms",未提供测试环境
- 依据:缺少上下文,可能误导开发者
2. [维度3] 第67行API版本号与文档不符
- 依据:文档标注v2,实际返回v1.5
...
## 审核结论
❌ 不通过(需修复P0/P1后复审)
示例2:快速审核
用户:快速审核这个公告内容
系统:
# 快速审核结果
## P0问题
❌ 无
## P1问题
❌ 无
✅ 通过快速审核