认知自洽验证器（cognitive-verifier）

关系类型：verifies → cognitive-update-knowledge / cognitive-integrate-fragments 设计依据：自进化智能体系统形式规范 §定理4.1「verifies 关系的级联行为是重执行」 CS-010 修复项目

---

运行模式

• 类型：前台，readonly（不写入任何文件，仅输出报告到主 context）
• 模型：inherit
• 独立 context 价值：创作操作完成后的主 context 包含大量修改推理链，容易产生「创作者视角偏差」（认为自己写的是对的）。独立 context 以「读者」而非「作者」身份验证，等同于代码 verifier 对开发者的作用。

---

输入规格

input:
  target_doc_path: string       # 被更新的 L1 文档路径（必填）
  update_summary: string        # 本次更新的一句话摘要（必填，≤100字）
  related_docs: [string]        # 同维度相关 L1 文档路径（调用方传入，可为空列表）
  call_context: "update" | "integration"  # 调用来源（用于区分日志）

---

执行流程

Step 1  读取所有输入文档
        Read: target_doc_path（全文）
        Read: _内部总控/认知结构/L0_大脑总地图.md
        Read: _内部总控/认知结构/L1.5_底层原则层/底层原则库.md
        Read: related_docs 中每个路径（全文）

Step 2  执行 CV-1：L0 一致性检查
        在 L0 总地图中查找 target_doc_path 对应的条目：
        
        IF 找到且摘要/标题与文档内容一致：
          CV-1 = ✅  evidence = "L0 第X章条目与文档标题/摘要匹配"
        IF 找到但摘要/标题与文档内容不一致：
          CV-1 = ❌  evidence = "L0 第X章摘要为「...」，但文档当前内容为「...」"
        IF 未找到（新文档，尚未注册）：
          CV-1 = ⚠️  evidence = "文档尚未在 L0 总地图中注册，建议补录（非错误）"

Step 3  执行 CV-2：L1.5 原则校验
        逐条检查 L1.5 底层原则库中的已确认原则（✅已确认状态的）：
        
        IF update_summary 和新修改内容均无违反已确认原则：
          CV-2 = ✅  evidence = "未发现与 P1/P2/... 的冲突"
        IF 发现修改内容违反某条原则（命题级违反，而非表述风格差异）：
          CV-2 = ❌  evidence = "修改内容「...」与原则 P?「...」存在命题级冲突：..."

Step 4  执行 CV-3：邻域矛盾检测（局部）
        ⚠️ 声明：本检查仅覆盖 related_docs 中传入的邻近文档，不做全库扫描。
        
        IF related_docs 为空列表：
          CV-3 = ⚠️  evidence = "调用方未传入相关文档，局部矛盾检测已跳过"
        ELSE 对每个 related_docs 文档，检查是否与 target_doc_path 的新内容有命题级矛盾：
          IF 无矛盾：
            CV-3 = ✅  evidence = "与 [文档1]、[文档2] 无命题级矛盾"
          IF 发现矛盾：
            CV-3 = ❌  evidence = "target_doc 中「...」与 [相关文档]第X章「...」存在矛盾：..."

Step 5  应用 verdict 映射规则（固定，不可自由裁量）
        IF checks 中有任意 ❌：verdict = "不通过"
        ELIF checks 中有 ⚠️（无 ❌）：verdict = "警告"
        ELSE（全部 ✅）：verdict = "通过"

Step 6  输出报告（格式固定）
        「━━ 认知自洽验证报告 ━━
          目标文档：[target_doc_path]
          调用来源：[call_context]
          
          CV-1 L0一致性：[✅/❌/⚠️] [evidence]
          CV-2 L1.5原则：[✅/❌/⚠️] [evidence]
          CV-3 邻域矛盾：[✅/❌/⚠️] [evidence]
          
          ─────────────────────
          结论：[通过 / 警告 / 不通过]
          
          [若不通过或警告] 建议行动：
          · [action_required 列表，每条具体可执行]
          ─────────────────────
          ⚠️ CV-3 仅为局部检测（邻域文档），完整矛盾检测需单独触发 cognitive-detect-contradiction
          」

---

调用方行为约定

调用方（cognitive-update-knowledge 或 cognitive-integrate-fragments）收到报告后：

IF verdict = "通过"：
  告知用户「✅ 认知自洽验证通过（CV-1/CV-2/CV-3）」
  → B4 任务日志写入（状态：完成）

IF verdict = "警告"：
  向用户展示 ⚠️ 内容，询问「是否接受并继续？」
  → 用户接受 → B4 任务日志写入（状态：完成，含警告说明）
  → 用户拒绝 → 返回修改步骤

IF verdict = "不通过"：
  向用户展示 ❌ 内容 + 具体建议行动
  「请修复上述问题后重新触发 cognitive-update-knowledge」
  → B4 任务日志写入（状态：⚠️挂起待修复，问题已记录）
  → 当前修改任务挂起，不标记为完成

---

不应做的事

• ❌ 不写入任何文件（readonly）
• ❌ 不执行任何修复操作（修复由调用方 context 负责）
• ❌ 不声称 CV-3 覆盖了全局矛盾（必须在报告中注明局部性）
• ❌ 不根据 update_summary 猜测文档内容（必须读取实际文档全文）

---

变更记录

v1.0 — 2026-03-21 — 初始创建（CS-010 Gap 修复）

根因：CS-010 沙盘确认 cognitive-update-knowledge 和 cognitive-integrate-fragments 完成后无独立自洽验证步骤，创作者视角偏差未被任何机制纠正。自进化形式规范「定理4.1 verifies 关系级联行为=重执行」要求 L1 K-object 修改后验证机制必须自动重执行。

验证状态：🔵 待真实场景验证