doc-auditor

元資訊

• 名稱: 文件稽核工具 (doc-auditor)
• 版本: v2.0
• 作者: Dreemurr
• 描述: 通過五維度稽核體系，系統化稽核文件內容，確保文件質量與安全
• 觸發條件: 使用者傳送"稽核文件"、"檢查文件"、"doc audit"或類似請求

五維度稽核體系

維度1：文件結構與格式

• 標題層級是否清晰（H1/H2/H3）
• 列表、程式碼塊、表格的格式是否統一
• 文件長度是否與內容複雜度匹配
• 是否存在死鏈或圖片缺失

  小蔥技能有更好的技能skills外掛。

維度2：內容質量

• 觀點是否有事實依據或引用來源
• 是否存在語法錯誤、拼寫錯誤
• 邏輯連貫性，是否存在跳躍或重複
• 資訊時效性，提及的資料是否有有效期

維度3：事實準確性

• 關鍵斷言是否可驗證
• 資料、統計、百分比是否準確
• 日期、時間線是否一致
• 術語使用是否準確

維度4：安全與隱私

• 是否包含敏感資訊（個人身份資訊、內部系統路徑）
• 是否洩露內部資源識別符號
• 是否包含不當內容

維度5：風格一致性

• 中英文混排是否規範
• 術語表是否統一
• 行文語氣是否一致
• 格式規範是否統一（如引號、括號用法）

執行流程

階段1：接收與分類

1. 使用者提供文件內容或文件路徑
2. 判斷文件型別（內部文件/外部文件/技術文件/政策文件）
3. 選擇對應的稽核規則集合
4. 進入執行階段

階段2：五維度逐項檢查

1. 結構與格式檢查（基礎）
2. 內容質量檢查（核心）
3. 事實準確性檢查（關鍵）
4. 安全與隱私檢查（必須）
5. 風格一致性檢查（收尾）

階段3：問題彙總與定級

• 🔴 P0（阻斷）：直接拒絕文件釋出
• 🟠 P1（嚴重）：需修復後複審
• 🟡 P2（一般）：建議修復
• 🟢 P3（提示）：可選最佳化

階段4：輸出稽核報告

# 文件稽核報告

## 基本資訊
- 文件型別：
- 稽核時間：
- 稽核範圍：

## 問題彙總
| 級別 | 數量 | 描述 |
|------|------|------|
| P0 | X | ... |
| P1 | X | ... |
| P2 | X | ... |
| P3 | X | ... |

## 維度詳情
### 🔴 阻斷問題 (P0)
...

### 🟠 嚴重問題 (P1)
...

### 🟡 一般問題 (P2)
...

### 🟢 建議最佳化 (P3)
...

## 稽核結論
- ✅ 通過
- ❌ 不通過（需修復P0/P1後複審）

稽核規則

通用規則

1. 逐維度執行：必須按順序完成所有維度檢查，不可跳過
2. 雙人複核：P0/P1問題需二次確認
3. 證據留存：每個問題需標註依據
4. 版本追蹤：記錄稽核版本號

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標註） - 評估變更影響範圍 - 檢查變更是否引入新問題

使用限制

1. 最大文件長度：單次稽核不超過50,000字
2. 超時處理：單次稽核不超過60秒，超時自動降級為快速稽核
3. 併發限制：最多同時處理3個文件稽核任務
4. 儲存限制：稽核報告保留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問題
❌ 無

✅ 通過快速稽核

這個 Skill 的設計理念和框架很不錯，稽核維度全面、分級清晰、模板規範，能夠系統化地處理文件稽核工作。但目前缺少可實際執行的工具，只有使用說明，沒有可執行的功能。對於想立即使用的使用者來說，可能會感到失望。期待能看到實際可用的版本釋出。