前言¶
技术报告、方案文档、审计材料写长了,常见问题不是错别字,而是前后对不上:前面写的客户名和后面不一致,同一指标两处数字不同,时间线前后颠倒,术语混用。人工通读成本高,单靠拼写检查也抓不到这类问题。下面介绍 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