| name | cognitive-detect-contradiction |
| description | 检测L1文档之间或文档内部的矛盾，基于L1.5原则提出消解方案。触发词：「矛盾」「不一致」「这里有问题」「检查一致性」「[文档A]和[文档B]是否一致」「有没有冲突」「逻辑漏洞」。 |
矛盾检测 Skill（Detect Contradiction）
识别认知结构中的逻辑矛盾，基于L1.5更高层原则提出消解方案，确保知识体系保持自洽。
认知根（L1.5 P15 共性优先）：当检测到多个文档存在相似矛盾时，优先识别共同根因，生成统一消解方案；而非逐个矛盾单独处理。
激活后立即执行
Step 1 确定检测范围
→ 用户指定了具体文档/章节 → 精确检测
→ 用户说"全库"或"全部" → 系统级扫描（较慢，提前告知用户）
→ 用户说"刚才修改的地方" → 针对最近变更的文档
→ 不确定时，询问：「要检测哪个范围？[特定文档] [两文档之间] [全库] [最近更新]」
Step 2 读取目标文档
Read: 指定的L1文档（相关章节，不是整篇）
Read: cognitive/L1.5_principles/principles.md（P1/P2全文）
Read: cognitive/L0_brain_map.md（了解文档间依赖关系）
Step 3 矛盾检测分析
逐一检查以下矛盾类型：
[直接冲突] 两处明确相反的表述
例："文档A说「先做调研再决策」，文档B说「直接MVP不做调研」"
[隐式张力] 两处在字面上不矛盾，但推论相冲突
例："文档A的原则A暗示X，文档B的原则B暗示非X"
[范围不一致] 同一概念在不同文档的定义/边界不同
例："「闭环」在文档A指用户路径，在文档B指组织协作流程"
[层次混淆] L2碎片级别的具体观察被当作L1原则表述
例："一次具体经历被写成了通用规律"
[价值优先级冲突] 两条都成立的原则，在特定场景下建议方向相反（T4C 新增）
例："原则A要求先路由再执行，原则B要求自动捕捉不依赖触发——当用户说了一句模糊但可能是碎片的话时，两条原则冲突"
→ 处理方式：不是哪条原则错了，而是需要明确优先级仲裁
→ 将冲突场景记录到「底层原则库.md §五 候选原则间已知优先级冲突」
Step 4【γ】 对每个发现的矛盾，展示分析结果（矛盾消解方案涉及认知方向选择，须用户决策）
「━━ 矛盾发现 ━━
类型：[直接冲突 | 隐式张力 | 范围不一致 | 层次混淆]
严重程度：[🔴 致命 | 🟡 中等 | 🟢 轻微]
位置A：[文档X] 第Y章 — 「...原文摘录...」
位置B：[文档Z] 第W章 — 「...原文摘录...」
矛盾描述：[一句话说清楚矛盾在哪里]
基于L1.5原则（P?「...」）推导消解方案：
选项A：修改[文档X]的[位置]：将「...」改为「...」
选项B：修改[文档Z]的[位置]：将「...」改为「...」
选项C：两者均成立，在[文档X]的[位置]添加前提说明：「适用场景为...时」
─────────────────────────
AI推荐：选项[?]（原因：[一句话]）
[选A] [选B] [选C] [我来决定] [这不是矛盾，跳过（需填原因）]」
→ 等用户明确选择后才能执行修改
价值优先级冲突（E类）的展示格式：
「━━ 价值优先级冲突 ━━
类型：价值优先级冲突（E类）
严重程度：🟡 中等
原则A：P??「...」— 在此场景建议：[X]
原则B：P??「...」— 在此场景建议：[Y]
冲突场景：[具体描述]
不是哪条原则错了，而是需要明确优先级仲裁：
选项A：此场景 A > B（原因：[...]）
选项B：此场景 B > A（原因：[...]）
选项C：场景再细分，A 和 B 各适用不同子场景
─────────────────────────
[选A] [选B] [选C] [我来决定] [这不是冲突，跳过（需填原因）]
→ 用户决策后，将结果追加到「底层原则库.md §五」仲裁表」
Step 5【α】 执行用户选择的消解方案（用户已在 Step 4 授权，AI 直接写入）（T7A 修复：跳过时强制记录原因）
→ 用户确认后，Write 修改对应文档
→ 追加 [文档名]_变更记录.md
→ 追加 cognitive/L3_logs/system_log.md
→ 写入 cognitive/L3_logs/consistency_record.md（新增检查结果条目）
→ 更新 L0_大脑总地图.md
[强制条件] 用户选择「跳过」时：
→ 【强制询问原因】「请简述跳过原因（必填）：
[两者适用场景不同，不冲突] [已有更高层原则解决] [暂时不确定，需要更多证据] [自定义：...]」
→ 将跳过记录写入 cognitive/L3_logs/consistency_record.md，格式：
`[SKIP-JUDGMENT] 日期 | 文档对：[A]×[B] | 跳过原因：[用户选择的原因] | 矛盾描述：[简述]`
→ 告知：「已记录跳过理由。若此对文档累计跳过 ≥3 次，cognitive-consistency-check C13 将触发提醒。」
Step 6 如果无矛盾
「✅ 在[检测范围]内未发现矛盾。知识体系在该范围内保持自洽。」
→ 仍然追加一条 cognitive/L3_logs/consistency_record.md（记录「通过」）
→ 追加 cognitive/L3_logs/system_log.md
矛盾消解记录格式
写入 cognitive/L3_logs/consistency_record.md：
## 检查记录 #XXX
**日期**：YYYY-MM-DD
**触发原因**：[用户主动检查 | 文档更新后自动触发 | Skill执行收尾]
**检查范围**：[文档名1] vs [文档名2] / 全库
**发现矛盾**：N 个 / 无
[矛盾列表（如有）：类型 + 位置 + 消解选项 + 用户选择]
**结论**：[发现并消解了N个矛盾 | 无矛盾，一致性通过]
注意事项
- 矛盾不一定要立刻消解：严重程度🟢时，可以记录下来留待后续处理
- 消解前不要自作主张修改文档，必须用户确认
- 理解偏差不算矛盾：有时候是措辞不同但本意相同，要先判断是否真实冲突
- AI推荐的消解方案不是唯一答案，用户有最终决策权
- 跳过时必须填写原因（T7A）：「这不是矛盾」是合理判断，但需要记录，供 C13 防御模式追踪使用
- E类（价值优先级冲突）不等于矛盾：两条原则都可以是正确的，需要仲裁而非消解其中一条
D5：任务完成后的 Loop 反馈
本次执行产出：K3 矛盾消解报告（写入一致性检查记录.md 或系统日志）
产出位置：cognitive/L1_knowledge/[相关维度]/知识库/一致性检查记录.md（若该文件不存在，追加到系统日志.md）
Loop 路由：
- 通路B（Loop 3 → Loop 2）：
→ 若检测到新的矛盾模式（未在历史中出现过）：记录到 cognitive/L3_logs/todo.md（待处理洞见）
→ 若发现 L1.5 原则存在逻辑漏洞：触发 cognitive-extract-principle（F 信号）
→ 若矛盾成功消解：静默完成（记录已写入一致性检查记录）
- 通路D（Loop 3 → Loop 1）：
变更记录
v1.1 — 2026-03-21 — Step 3 新增 E类矛盾 + Step 5 跳过原因强制记录（T4C + T7A 修复）
根因：
- T4C（GAP-T4）：价值优先级冲突（两条原则都成立但方向相反）无法被原四类矛盾检测捕捉
- T7A（GAP-T7）：「跳过」时无原因记录，无法区分「合理判断」和「防御性回避」，C13 无法运作
修改内容：
- 修改：Step 3 → 新增第5类矛盾「价值优先级冲突（E类）」，含展示格式和处置路径（追加 §五 仲裁表）
- 修改：Step 5 → 用户跳过时强制询问原因，并以 [SKIP-JUDGMENT] 格式写入一致性检查记录
验证结果：
- 正向验证：描述「P8先路由 vs P14自动捕捉」场景，Step 3 应识别为 E 类（待真实场景验证）
- 负向验证：普通「直接冲突」场景仍被识别为原类型，不误判为 E 类
验证状态：🔵 待验证
备份路径：history/SKILL_v1.0_20260321.md
