前言¶
技術報告、方案文檔、審計材料寫長了，常見問題不是錯別字，而是前後對不上：前面寫的客戶名和後面不一致，同一指標兩處數字不同，時間線前後顛倒，術語混用。人工通讀成本高，單靠拼寫檢查也抓不到這類問題。下面介紹 SkillHub 上的「文檔一致性校對助手」，用 Agent Skill 的方式，在對話裏對整份或局部文檔做上下文一致性檢查，並在需要時配合備份與修正。
這是什麼¶
「文檔一致性校對助手」是 SkillHub 社區來源（community）的辦公效率類 Skill，座標爲 @user_7180264c/doc-consistency-checker，當前版本 2.4.6，由發佈者 user_7180264c 維護。標籤標明 requires_api_key=false，即按 SkillHub 頁面說明，不依賴額外 API Key 配置。
它面向報告、文檔類長文本，自動查找上下文不一致，包括實體矛盾、術語不統一、數據衝突、邏輯與時序異常，並提供版本備份與一鍵修正能力。校對範圍可以是全文，也可以按指定章節或頁碼（支持多範圍）提取後再校對。
核心功能¶
以下能力均來自 SkillHub 官方頁面與已抓取資料中的簡介說明：
- 不一致類型覆蓋：實體矛盾、術語不統一、數據衝突、邏輯與時序異常。
- 範圍可選：支持全文校對，或指定章節/頁碼；多範圍提取後分別或合併校對（以 Skill 內具體指令爲準）。
- 版本與修正：提供版本備份；發現可修正項時支持一鍵修正（具體交互由安裝後的 SKILL 定義）。
- 自然語言觸發：當用戶表達校對、一致性檢查等意圖時，Agent 應選用本 Skill。官方給出的典型說法包括：「幫我校對這份報告」「檢查文檔前後是否一致」「找出報告裏的低級錯誤」「文檔一致性檢查」。
安裝與啓用¶
安裝流程遵循 SkillHub 通用說明 skillhub.md。也可將下面提示交給當前 AI，由其按同一文檔完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_7180264c/doc-consistency-checker`。
檢查 SkillHub CLI¶
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
若未安裝，可按 SkillHub 文檔執行完整安裝（CLI + 默認 Skill）或僅 CLI：
# 完整安裝（CLI + 默認 Skill，推薦）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
# 僅安裝 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安裝到當前 Agent 的 skills 目錄¶
SkillHub 要求安裝時必須用 --dir 指向當前 Agent 識別的 skills 目錄，否則默認落在 ./skills/ 可能無法被加載。常用路徑如下（摘自官方安裝文檔）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝命令示例（將 <skills 目錄> 換成上表中對應路徑）：
skillhub install user_7180264c/doc-consistency-checker --dir <skills 目錄>
也可先搜索再安裝：
skillhub search doc-consistency-checker
skillhub install user_7180264c/doc-consistency-checker --dir <skills 目錄>
安裝後需按所用 Client 的規則重啓或刷新，使新 Skill 生效。Cursor、Codex CLI、Claude Code 的差異僅體現在 skills 目錄路徑 上，安裝命令形式相同；未在官方資料中出現的 Client 配置項本文不展開。
典型用法¶
本 Skill 基於通用 SKILL.md 格式，具體步驟與輸出格式以安裝包內 SKILL 爲準。可復現的入口來自官方簡介中的觸發語與能力描述：
- 在 Cursor（或其它已安裝該 Skill 的 Agent）中打開待校對的報告或文檔（或提供文件路徑）。
- 用自然語言說明任務，例如：「幫我校對這份報告，重點看術語和數據是否前後一致。」
- 若只需局部檢查，在對話中說明章節名、頁碼或範圍；Skill 支持多範圍提取校對。
- 根據 Skill 返回的不一致項覈對原文；需要時可使用其提供的版本備份與一鍵修正（以 Skill 實際提示爲準）。
官方未提供獨立 REST 調用示例；日常使用即通過 Agent 對話觸發上述流程。
適用場景與注意¶
適合誰
- 經常撰寫或審閱長報告、投標書、技術方案、合規材料的團隊或個人。
- 已在 Cursor、Claude Code、Codex 等支持 SkillHub 安裝路徑的環境中工作的用戶。
使用注意
- 一致性檢查依賴模型對上下文的理解，複雜表格、掃描 PDF 或強格式文檔的效果以實際文檔質量爲準；重要結論仍建議人工複覈。
- 一鍵修正會改動正文，應優先利用 Skill 提供的版本備份，並在提交前 diff 確認。
- SkillHub 頁面統計（截至資料抓取）：評分 100000，下載 45946，安裝 97；分類爲 office-efficiency。數據隨 SkillHub 更新可能變化，以商店頁爲準。
結尾¶
「文檔一致性校對助手」把長文檔裏最難肉眼掃全的那類錯誤——前後實體、術語、數據與時序不一致——收攏成可對話觸發的 Skill 能力，並支持局部範圍校對與備份修正，適合納入日常寫稿與審閱流程。
官方地址：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_7180264c/doc-consistency-checker
- API 座標頁：https://api.skillhub.cn/user_7180264c/doc-consistency-checker
