通用：质量门

在 Markdown 或 Skill 修改后、宣布构建完成前，或执行 wiki 健康检查时使用。验证不会自行扩大任务的变更范围。

先读

• 归档或移动页面时读取 knowledge-engine/skills/common/filing-rules.md。
• 读取被检查页面所属领域的负责 Skill。
• 检查解释性查询或构建时读取 knowledge-engine/skills/common/reasoning-lenses/SKILL.md，验证人物视角没有污染中性证据或越过领域边界。

内容检查

• 每个非显然判断都能追溯到原始笔记、已标注的对话材料或既有综合页。推断标为 推断 或 待查。
• 模板只提供结构，不构成生成占位内容的许可。省略无证据支持的项目、表格行、引文和章节。
• 按主要对象归档，并维护有用的双向导航。
• 不要在不同章节机械重复同一证据。
• 使用与领域匹配的语言；人物、城市、系统、状态、事件和人生阶段需要不同类型的判断。
• 当措辞本身是可沉淀证据时，保留用户准确原话。
• 优先做局部、精确的更新，避免宽泛重写。
• 使用人物视角时，执行共享协议的忠实度检查与证据护栏，按成品段落定位结果；本质量门不复制人物规则。协议实质修改时，还须检查实际候选的多视角对照结果，不能以章节齐全代替语义审阅。
• 重大重解释应在日志记录主视角、辅助任务和重跑范围。新增人物必须由动态发现脚本自动出现，下游 Skill 不得复制人物名单。

连接来源检查

检查连接目录时读取 knowledge-engine/skills/build/wiki-build/references/linked-sources.md。确认原文已解引用、来源链接使用稳定目标、反向导航可发现，且失效来源没有被冒充为有效证据。标签工具不得写入外部原文或系统引用文件。

验证模式

只读维护

当前目标只检查健康状况、不包含修复时，运行：

python3 knowledge-engine/tools/validate_wiki_links.py
python3 knowledge-engine/tools/validate_skill_system.py
python3 knowledge-engine/tools/diary_entity_audit.py --check
python3 knowledge-engine/tools/diary_entity_deep_audit.py --check

实体检查可能以非零状态报告生成索引陈旧；这是检查结果，不等于必须立即重新生成。

Markdown 修改后

在仓库根目录运行：

python3 knowledge-engine/tools/update_obsidian_tags.py
python3 knowledge-engine/tools/update_obsidian_tags.py
python3 knowledge-engine/tools/validate_wiki_links.py

第二次标签运行必须报告 updated=0；链接验证必须报告 missing=0 ambiguous=0。

Skill 或配套工具修改后

还要运行：

python3 knowledge-engine/tools/validate_skill_system.py

可用时，对每个规范 Skill 运行系统自带的快速验证器。

重新生成实体索引

只有任务明确包含摄取/重新生成，或来源数量变化使生成索引陈旧时，才运行：

python3 knowledge-engine/tools/diary_entity_audit.py --write
python3 knowledge-engine/tools/diary_entity_deep_audit.py --write

只读审计绝不使用写入模式。

需要人工复核的情况

修改格式错误的 YAML、已改名的原始笔记来源、歧义别名、生成索引数量的意外变化，以及需要用户判断的证据冲突前，先人工复核。

完成审计

1. 把目标重述为具体交付物。
2. 将每个请求类别映射到已修改或有意保持不变的产物。
3. 检查代表性文件内容和验证器实际输出。
4. 报告跳过的检查和未解决风险。
5. 只要请求中的要求仍不确定，就继续处理。

验证器通过只能证明它覆盖的约束成立，不能证明用户要求的语义工作已经完成。