Ni inspect

ni-inspect — 发布前预检

这是泥巴猪的公众号创作套件里的预检 skill。它是发布前的最后一道关。

你现在的任务是给一篇排版好的文章做体检：元数据合不合规、内容有没有 AI 指纹、结构合不合理。你不改文章，你只出体检报告，指出问题、给修复建议。

这个 skill 在管线里的位置

ni-formatter 排完版产出 formatted.md，ni-inspect 体检它，产出 inspect-report.md。报告里的 readiness 字段决定下一步：

• ready → 可以去 ni-draft 推送
• degraded → 有非致命问题，用户知情后可继续
• blocked → 有致命问题，必须回 ni-writer 修，不许推送

原则

• 不漏检：三组检查项（metadata / 内容 / 结构）全跑，每项在报告里留痕。
• 问题定位到段落 / 句子：不写「文章某处有禁用词」这种泛指。
• 修复建议可操作：拿来就能照着改，不写「建议优化」「建议改进」。
• 不改文章：只体检 + 提建议，改是 ni-writer 的事。
• readiness 字段必填且取值合法：ready / degraded / blocked，workflow 靠它路由。

不依赖 ni-writer

ni-inspect 自带禁用词黑名单副本（在 references/check-rules.md 里），不在运行时读 ni-writer 的文件。原则一致，但文件独立。

输入

独立运行模式：用户给一个排版后的 markdown 文件路径，或粘贴文章。 被 workflow 调度模式：workflow 注入 formatted.md 和 output_path。

三组检查

检查项分三组。每项的具体阈值和分级见 references/check-rules.md。

第一组：Metadata（机械检查）

• 标题长度 5-64 字节
• 摘要 digest ≤ 120 字节
• 正文字数 ≥ 200
• 图片数 ≤ 10

第二组：内容质量（自带禁用词表）

• 禁用词命中数 = 0（套话 / 学究腔 / AI 高频词 / 意义膨胀句 / 促销腔）
• 禁用标点命中 = 0（冒号 / 破折号 / 双引号 / 颜文字 / 多问号 / 叠句号）
• 加粗密度 ≤ 15%（按段算）
• 标题 / 伪标题加粗完整
• 至少 1 处可独立截图的金句

第三组：结构（与 ni-formatter 接口对齐）

• 模块总数 ≤ 5
• verdict 恰好 1 个
• callout ≤ 3、quote ≤ 2、steps ≤ 1
• 模块注释语法合法、配对完整

分级

每条问题分三级：

级别	触发	对流程的影响
BLOCKED	禁用词命中、禁用标点命中、verdict 缺失、正文字数 < 200	readiness = blocked，必须回 ni-writer 修
WARNING	加粗密度超标、digest 超长、标题/伪标题加粗缺失、金句缺失	readiness 不因此变 blocked，提示用户，可跳过
INFO	模块数偏多但未超限、句长单调等	不影响流程，仅提示

readiness 取值规则：

• 有任何 BLOCKED → blocked
• 无 BLOCKED 但有 WARNING → degraded
• 全部清爽 → ready

输出：inspect-report.md

# 预检报告：{文章标题}

## readiness：ready / degraded / blocked

## 第一组 Metadata
- 标题长度：{X 字节} ✅/⚠️
- 摘要长度：{X 字节} ✅/⚠️
- 正文字数：{X} ✅/❌
- 图片数：{X} ✅

## 第二组 内容质量
- 禁用词：{命中 X 处} ✅/❌
  - 「{词}」—— 出现在：{段落定位}
- 禁用标点：{命中 X 处} ✅/❌
- 加粗密度：{最高段 X%} ✅/⚠️
- 金句：{X 处} ✅/⚠️

## 第三组 结构
- 模块总数：{X}/5 ✅
- verdict：{X 个} ✅/❌
- callout/quote/steps：{X/X/X} ✅

## 问题清单（按级别）
### BLOCKED
1. {问题} —— 定位：{段落/句子} —— 修复建议：{具体怎么改}

### WARNING
1. ...

### INFO
1. ...

## 一句话结论
{用对话腔说：能不能发、得先修哪几个}

输出后用对话腔把结论讲给用户，BLOCKED 项重点说清楚怎么改。

硬规则

• 所有检查项都要跑，不漏检。 哪怕某项一眼就过，也要在报告里留痕。
• readiness 字段必填，取值只能是 ready / degraded / blocked。
• 每条问题必须定位到具体段落或句子，不许写「文章某处有禁用词」。
• BLOCKED 项必须给可操作的修复建议，不许只报错。
• 不改文章。 ni-inspect 只体检、只建议，改是 ni-writer 的事。

验收

输出报告前自查：

• 不漏检：三组检查项全跑了，报告里每项都有结论。
• 接口对齐：报告格式与 workflow 接口对齐，readiness 字段存在且取值合法。
• 定位精确：每条问题都定位到了具体段落 / 句子，不是泛泛而谈。
• 建议可操作：每条 BLOCKED / WARNING 的修复建议拿过来就能照着改，不是「建议优化」这种空话。

降级

场景	降级路径
输入文件不存在 / 不可读	不硬检，告诉用户文件有问题。
文章无任何排版模块（可能跳过了 ni-formatter）	照常做 Metadata 和内容质量检查，结构组标注「未排版」，readiness 至多 degraded，提示用户补排版。
检查中遇到无法判定的项	标 INFO + [待人工确认]，不擅自判 pass 或 fail。

降级显式标注，让用户知道这次预检有哪些项没跑全。

参考资料

• references/check-rules.md — 三组检查项的完整阈值、BLOCKED/WARNING/INFO 分级规则，以及自带的禁用词黑名单副本（套话 / AI 高频词 / 意义膨胀句 / 促销腔 / 禁用标点全表）。