doc-consistencylisted
Install: claude install-skill dongsheng123132/doc-consistency
# doc-consistency · 长文档一致性体检
**只做一件事**：把「这份文档跟它自己一不一致」变成一件可以按按钮复查的事。
不写作、不润色、不判断内容对错。只查那些**随篇幅指数增长、而人的注意力随篇幅衰减**的错误。
> 一份 300 页的文件，人通读要两天，且两遍会看漏不一样的地方；机器跑一遍几十秒，跑十遍结果一模一样。
## 什么时候用
用户说这些话时：
- 「帮我检查一下这份教材/标书/手册/书稿」「定稿前体检一下」「稿件体检」
- 「编号有没有跳」「图表引用还在不在」「术语前后统一吗」「合稿有没有丢东西」
- "proofread this manuscript" / "check cross-references" / "QA this proposal"
- 给出 .docx / .md / .txt 并要求核对一致性
**不要用在**：让你写内容、润色文笔、判断事实对错、做法律或技术判断。那些不是本技能的事。
## 怎么跑
```bash
node scripts/check.mjs <文件或目录…> [选项]
```
零依赖，只要有 Node 18+。**不联网、不上传、不调模型。**
| 选项 | 作用 |
|---|---|
| `--all` | 列出全部红点（默认只列前 20 条，汇总始终完整） |
| `--limit <n>` | 清单显示条数上限 |
| `--json` | 输出完整 JSON（不截断），给程序/后续步骤用 |
| `--glossary <file>` | 术语表，每行 `正名 = 变体1, 变体2` |
| `--baseline <路径…>` | 基准稿，用于**合稿丢段**比对 |
| `--fail-on high\|medium\|low` | 到该级别就退出码 1 —— 可写进 CI 或合同验收 |
| `--lang zh\|en` | 报告语言 |
### 常用姿势
```bash
# 单文件体检
node scripts/check.mjs 教材终稿.docx
# 整目录（多人分头写的章节）
node scripts/check.mjs ./书稿/ --all
# 合稿前后对比，找丢了哪几段
node scripts/check.mjs 合并稿.docx --baseline ./分册/
# 投标前自检，还有高危项就不许提交
node scripts/check.mjs 投标文件.docx --fail-on high
# 英文报告
node scripts/check.mjs manuscript.md --lang en
```
## 查什么
| 规则 | 抓的是 |
|---|---|
| **交叉引用悬空** | 正文写「见图 3-12」，但那张图不存在（也不在目录里） |
| **编号重号 / 跳号 / 起始异常** | 图/表/式/附录序列断了、重了 |
| **目录 ↔ 正文对账** | 目录列了正文没有（读者翻空）／正文有目录漏了 |
| **章节引用悬空** | 「详见第 7 章」，但没有第 7 章 |
| **章节骨架缺项** | 多数章都有「学习目标」，某一章没有 |
| **术语写法不一致** | AI Agent / AI agent / AI-Agent 混用；或违反给定术语表 |
| **占位符残留** | TODO、TBD、待填、×××公司、Lorem ipsum |
| **疑似旧版年份**