cognitive-ask

name	cognitive-ask
description	基于用户自己的认知文档回答问题，严格引用来源，标注置信度，暴露矛盾，识别知识空白。触发词：「基于我的文档」「根据我的想法」「我之前怎么想的」「我说过什么关于X」「我对X的看法是什么」「帮我回忆」「我的认知里怎么说」「我的框架里有没有」「从我的角度」「我如何看待」。

认知问答 Skill（Cognitive Ask）

严格基于用户自己的认知文档（L0/L1/L1.5/L2）回答问题。 铁律：不引入外部观点，不补充用户没有说过的内容，只用用户自己的文字和思考。

---

知识导航表（执行前必须理解的概念根）

层级	文档	需要理解的概念
D0 认知根（必读）	cognitive/L0_brain_map.md	整个K-object体系的入口索引：各L1文档的主题/位置/版本；扫描找相关K-objects
D3 规范参考	.cursor/rules/knowledge-integrity-rules.mdc（R2 NO_FABRICATION + R3 READ_FIRST）	R2：不引入用户文档中没有的观点；R3：先读相关文档再回答，不凭印象
D4 运行时数据	L0_大脑总地图.md + 根据问题确定的相关L1/L1.5/L2文档	先扫描L0找相关文档，再读相关文档后回答

核心概念速查： ① 只用用户自己的K-objects回答 = 禁止引入外部观点，禁止补充用户没有写过的内容 ② 引用必须说明来源：「在[文档名]§[章节]中提到…」——让用户能验证 ③ 知识空白 = 相关K-objects中找不到内容时，明确说「您的文档中未提及」，不自行推断

---

这个 Skill 解决的问题

用户在多处文档、多次对话中积累了大量思考，但：

• 某个话题在多个文档里都有提及，散落各处
• 不记得自己对某个问题的完整立场是什么
• 想知道自己的某个想法在整个思维体系里处于哪个位置
• 不确定自己是否已经想清楚了某个问题

---

激活后立即执行

Step 0  工作区路径探测（v2 Agent 兼容层）

        认知库有两种可能的路径布局：
        尝试读取：`docs/L0/大脑总地图.md`
        IF 成功 → **v2 模式**：L0=docs/L0/ | L1=docs/L1/ | L1.5=docs/L1_5/ | L2=docs/L2/
        ELSE 尝试：`cognitive/L0_brain_map.md`
        IF 成功 → **Cursor 模式**：使用 cognitive/ 前缀（原路径不变）
        IF 都失败 → 告知用户认知库路径未初始化，停止

        确定路径模式后，所有后续步骤中路径自动替换。
        下文中 [CL0] / [CL1] / [CL1.5] / [CL2] 分别代表对应层的实际路径前缀。

Step 1  理解问题
        → 用户的问题是什么？核心概念是什么？
        → 如果问题不清晰，追问一个最关键的问题（一次只问一个）
        → 明确问题后继续

Step 2  搜索文档（分层检索，从顶层到底层）

        [Layer 1] L1.5 底层原则层（最先检索）
        Read: [CL1.5]/底层原则库.md
        → 这个问题是否直接触及某个已确认原则（P1/P2等）？
        → 如果是，记录：「原则层有直接答案」

        [Layer 2] L1 系统性文档（必须先读 L0，再系统覆盖相关聚类）
        
        Step 2a：Read [CL0]/大脑总地图.md
        → 从 L0 提取所有聚类列表和已登记的 L1 文档名

        Step 2a.5：全量文档索引（防止 L0 过时导致遗漏）

        ⚠️ L0 可能不包含最近新建的文档——必须执行本步骤补全。

        执行 list_files([CL1]) 或等效的文件系统扫描
        → 获得 L1 目录下所有 .md 文件的完整列表
        → 与 Step 2a 从 L0 中提取的列表做 diff
        → 若发现「L0 未登记的文档」：加入待检索列表，标注「L0 未登记，来自文件系统扫描」
        → 记录：「L0 登记 N 篇，文件系统实际 M 篇，差异 K 篇」

        → 判断「问题是全局性问题还是聚焦性问题」：
          【全局性问题判断标准】满足以下任一条件，即为全局性：
          · 问题中包含「整体」「核心」「本质」「全部」「所有」「系统」「体系」
          · 问题是「X是什么」「X有哪些观点」「X的关键是什么」形式
          · 问题话题是一个跨文档的高层概念（无法被单个文档完整回答）
          → 全局性问题：**必须覆盖所有聚类（含 L0 未登记的），无例外**
          
          【聚焦性问题】：用户明确指定了单一文档/聚类（如「[B]文档里说了什么」）
          → 聚焦性问题：可以限定在指定范围内
        
        Step 2b：分两步读取每个 L1 文档（先结构，后内容）

        对每个「待检索聚类」中的文档，执行以下两步：

        **Step 2b-①（结构扫描，必须先做）**
        Read 该文档的前 80 行（涵盖摘要 + 全部章节标题）
        → 提取所有 ## / ### 章节标题，构建「章节目录」
        → 根据用户问题的关键词，标记「高相关章节」（显式理由）
        → ⚠️ 不允许「凭直觉」跳过某个聚类——必须给出明确的跳过原因

        **Step 2b-②（定向读取，基于 ① 的结论）**
        只读被标记的「高相关章节」（不是整篇）
        IF 文档整体相关性高（全局性问题 + 核心文档）→ 读全文
        → 记录：找到了哪些相关内容，在哪里，来自哪个聚类

        Step 2c：知识图谱邻域扫描 + BM25 兜底（双轨并行）

        **轨道 A：知识图谱邻域扫描**（优先，精度高）
        认知科学依据：扩散激活（Collins & Loftus, 1975）——激活一个概念节点后，
                      激活沿关系边向邻近节点传播（priming effect）

        Read: [CL0]/知识图谱_正式文档.md（或 cognitive/knowledge_graph.md）
        → 找到 Step 2b 中已确定的「主要相关L1文档」在图谱中的节点
        → 获取该节点的全部关系边（出边+入边）
        → 按关系强度排序：depends(1.0) > extends(0.9) > cross_ref(0.7) > references(0.5)
        → 选取权重 ≥ 0.7 的邻居节点（Top-5，排除已在 Step 2b 读过的）

        IF 邻居节点与当前问题高度相关（主题相似）：
        → Read 该邻居文档的相关章节（每个最多读 300 字）
        → 记录：「从图谱邻域发现补充内容，来自 [文档名]（[关系类型] 关系）」

        **轨道 B：BM25 关键词兜底**（知识图谱缺失时，或作为补充验证）
        触发条件：知识图谱文件不存在 OR 图谱中已读文档的关系边 < 3 条（稀疏图谱）

        提取用户问题的关键词（中文字 + 英文词）
        对 Step 2a.5 中 L0 未登记但存在于文件系统的文档：
        → 读取各文档前 200 字（标题+摘要），计算关键词命中数
        → 命中 ≥ 2 个关键词的文档：加入待检索列表，执行 Step 2b 两步读取
        → 记录：「BM25 兜底发现补充文档 [文档名]，命中词：[词列表]」

        ⚠️ 约束：
        - Step 2c 是「补充」步骤，不是「替代」Step 2b 的步骤
        - 两轨道合计最多新增 3-5 个文档，避免检索范围无限扩展
        - 图谱文件不可读时轨道A静默跳过，但轨道B必须执行

        [Layer 3] L2 碎片层（以下两种情况必须执行，不允许跳过）
        
        强制触发条件（满足任一即必须读 L2）：
        ① L2 碎片整合索引中，有「🔲 待整合」碎片的关联L1文档与本问题相关
        ② 问题是全局性问题（已在 Step 2a 判断为全局性时，必须读 L2 补充 L1 之外的洞见）
        
        ⚠️ 不允许以「L1 已有足够内容」为理由跳过 L2 检索——L2 碎片常包含尚未整合进 L1 的新洞见
        
        Read: cognitive/L2_fragments/fragment_index.md
        → 搜索所有「🔲 待整合」碎片，找出与问题相关的条目
        → Read 相关碎片的内容
        → 标注：L2碎片的确认程度（confirmed / tentative / uncertain）
        → 在回答中注明：「以下来自 L2 碎片，尚未整合进 L1」

Step 3  综合分析
        整理找到的所有相关内容，判断：

        ① 「清晰明确」：某文档/碎片有直接、完整的答案
        ② 「需要综合」：答案散落在多处，需要拼合
        ③ 「有矛盾」：不同文档/碎片对这个问题给出了有张力的答案
        ④ 「有空白」：文档只涉及了部分，有明显没有覆盖到的角度
        ⑤ 「完全空白」：认知库中没有覆盖这个问题

Step 4  生成回答（严格格式）

        ━━ 基于您的认知文档 ━━

        【核心答案】
        [直接回答问题，只用用户文档中的原话或紧密推论]

        【来源（必须列出每一条依据）】
        · [文档名/碎片ID] > [章节/位置]：「原文摘录」
        · [文档名/碎片ID] > [章节/位置]：「原文摘录」

        【置信度】
        [🟢 高]：文档中有明确表述，直接引用
        [🟡 中]：需要综合多处推论，可能有偏差
        [🔴 低]：仅有碎片级别的提及，尚未系统化

        【矛盾（如有）】
        发现以下不一致：
        · [文档A]说：「...」
        · [碎片F-XXX]说：「...」
        → 这两处存在[直接冲突/隐式张力]，尚未消解。

        **若为🔴 致命冲突（两个结论直接互斥，任一成立另一必然错误）**：
          ⚠️ 致命矛盾——此矛盾未消解将影响本答案的可信度，强烈建议立即运行矛盾检测
          [立即运行矛盾检测] [了解但暂不检测]

        **若为🟡 隐式张力或🟢 轻微不一致**：
          是否要现在运行矛盾检测？[是] [暂时不用]

        【知识空白（如有）】
        您的文档对以下角度尚未覆盖：
        · [空白点1]：[一句话说明缺了什么]
        · [空白点2]
        是否要记录为待思考的碎片？[记录为碎片] [不用]
        ━━━━━━━━━━━━━━━━━━━━━━━━

Step 5  处理后续
        → 用户说「是」（运行矛盾检测）→ 触发 cognitive-detect-contradiction Skill
        → 用户说「记录为碎片」→ 触发 cognitive-capture-fragment Skill，预填充「待思考：[空白点]」
        → 用户有追问 → 继续在文档范围内回答（不引入外部内容）
        → 用户说「这块没想清楚」→ 询问「要运行 self-reflect（自我反思）来帮你想清楚吗？」

---

严格边界（铁律，不可突破）

✅ 可以做：

• 引用用户文档中的原话
• 综合多个文档/碎片的观点
• 指出文档间的矛盾
• 指出文档的覆盖空白
• 基于用户的L1.5原则推论（必须说明是推论）

❌ 不可以做：

• 用外部知识（学术文献、行业标准、其他人的观点）来补充答案
• 「根据一般来说...」「通常认为...」「理论上...」→ 禁止
• 在回答中不标注来源
• 把「用户没有说过」的内容放进【核心答案】里
• 把置信度标为🟢，但答案里其实包含了AI的推论

---

特殊情况处理

情况1：完全空白 「您的认知文档中没有覆盖「[问题话题]」这个问题。 这是一个认知空白——意味着您可能： · 还没想过这个问题 · 想过但没有记录 建议：[记录为「待思考」碎片] [现在用self-reflect来想一想] [不处理]」

情况2：问题跨越多个L1文档，需要大量阅读 「这个问题涉及多个文档（[文档列表]），完整回答需要逐一读取。 我先给一个基于L0和L1.5的快速预答案，再深入检索。 [快速预答案内容] 现在深入检索更多细节...」

情况3：用户问的是「我有没有想过X」 「在您的文档中： · [文档A] 第X章 提到了相关概念：「...」 · [碎片F-XXX] 触及了这个话题：「...」 但没有系统性地专门讨论「X」。 覆盖程度：⚠️ 有提及但不完整」

情况4：用户问的是跟今日对话相关的内容（非文档内） 「您在本次对话中提到了「...」（但尚未写入文档）。 如果您希望基于已文档化的内容，当前文档里这部分的状态是：[...] 需要先把刚才的想法写入文档吗？[记录为碎片]」

---

变更记录

v1.1 — 2026-03-19 — Step 2 Layer 2 改为「先读 L0 系统聚类映射，再逐聚类检索」

根因：在「数字大脑有哪几个核心观点」的问答中，AI 凭直觉将问题映射到 [B][B']，跳过了 [PV]（包含 LLM=算子、多粒子动力学）和 [B']§7（用户感知界面），导致回答严重不完整。根本原因是 Step 2 的「根据问题关键词，判断哪些L1文档最相关」是主观判断而非系统检索。

修改内容：

• 修改：Step 2 Layer 2 → 从「凭关键词直觉选文档」改为「先读L0提取聚类列表，逐一判断相关性，生成待读聚类列表，再检索」
• 新增约束：全局性概念默认覆盖所有聚类；不允许在没有明确理由的情况下跳过某个聚类

验证结果：

• 正向验证：「数字大脑核心观点」类问题 → 应先从 L0 识别聚类1+2+4，主动读 [PV] 和研究文档
• 负向验证：「P1原则有哪些应用场景」类聚焦问题 → 仍可合理限定在1-2个聚类

验证状态：🔵 待验证（已有正式沙盘 SK-014）

---

v1.4 — 2026-03-22 — 致命矛盾强化触发提示（GAP-CS016-1 修复）

根因：scenario-sandbox-builder Phase 2 验证（CS-016沙盘）发现：cognitive-ask 的矛盾检测触发设计为统一的「是否运行？[是][暂时不用]」，对致命矛盾（两个结论直接互斥）与轻微张力处理方式相同，用户容易选「暂时不用」跳过，导致致命矛盾积压影响答案可信度。

修改内容：

• 修改：Step 4 矛盾展示格式 → 按矛盾严重程度区分：🔴 致命冲突使用「强烈建议立即运行」语气 + [立即运行矛盾检测] 触发词；🟡/🟢 保持原有「是否运行？[是][暂时不用]」
• 备份路径：history/SKILL_v1.3_20260322_before_cs016.md

验证方法：发现🔴 致命矛盾时，Step 4 应输出「⚠️ 致命矛盾——强烈建议立即运行」而非普通询问 验证状态：🔵 待验证

---

v1.3 — 2026-03-19 — Layer 3 强制触发（SK-014 沙盘 + 新任务实证修复）

根因：新会话AI回答「数字大脑核心观点」时，找到6条L1观点后认为「已完整」，跳过L2检索，导致F-019（智能体演化框架）和F-020（层次与闭环关键词）等重要洞见缺失。「如L1没有完整答案时」是主观条件，不可靠。

修改内容：

• 修改：Layer 3 触发条件 → 从「如L1没有完整答案时」改为「两种强制触发情况：①有相关待整合碎片 / ②全局性问题」
• 新增：「不允许以L1已足够为理由跳过L2」的明确禁止语句
• 新增：L2碎片在回答中的标注要求

验证状态：🔵 待验证

---

v1.2 — 2026-03-19 — 全局性问题判断标准明确化（SK-014 沙盘残留风险修复）

根因：SK-014 沙盘分析发现 v1.1 残留风险：「全局性概念」的判断仍是 AI 主观决定，可能将「数字大脑」错判为「聚焦概念」而跳过全聚类覆盖。

修改内容：

• 修改：Step 2a → 在「全局性概念默认覆盖」的基础上，明确定义「全局性问题」的判断标准（含关键词列表 + 问题形式 + 跨文档特征），将主观判断改为客观标准

验证状态：🔵 待验证（已有正式沙盘 SK-014 覆盖）

---

注意事项

• 不要跳过"找不到"的情况：如果某个角度文档里没有，就明说，不要用自己的知识补全
• L2碎片要标注确认程度：确认程度「uncertain」的碎片，回答时要说「您有过这个想法，但标注为存疑」
• 综合推论要透明：如果是「A+B→C」的推论，要说「根据您文档中的A和B，可以推论出C，但您没有直接表述过C」
• 不要因为「显而易见」就省略来源

2026-03-23 — 新增 Step 0 / Step 2a.5 / Step 2b 两步读取 / Step 2c BM25 兜底（v2 兼容 + 遗漏修复）

根因：三处系统性遗漏： ① L0 可能过时（Step 2a 仅读 L0，文件系统里新建文档对 AI 不可见） ② Step 2b「定向读取章节」依赖 AI 猜测，章节针对性不足 ③ Step 2c 依赖知识图谱文件，v2 workspace 里该文件路径不同或不存在，导致邻域扫描静默跳过

修改内容：

• 新增：Step 0「工作区路径探测」——自动检测 v2/Cursor 两种路径布局，向后兼容
• 新增：Step 2a.5「全量文档索引」——file system 扫描，diff L0 登记 vs 实际文件，补充遗漏
• 改造：Step 2b → 两步读取（先扫标题结构 → 再定向读高相关章节），减少「凭直觉」的不确定性
• 改造：Step 2c → 双轨并行（轨道A知识图谱邻域扫描 + 轨道B BM25关键词兜底），图谱缺失时不丢失覆盖

验证方向：

• 正向：新建一篇 L1 文档但未更新 L0 → Step 2a.5 应发现它并加入检索
• 正向：v2 workspace（docs/ 布局）→ Step 0 应切换到 v2 路径
• 负向：图谱文件存在且关系边丰富 → 轨道 B 不触发，不增加不必要开销

2026-03-23 — 新增 Step 2c（知识图谱邻域扫描，启动效应实现）

认知科学依据：

• 扩散激活（Collins & Loftus, 1975）：激活一个概念节点后，激活向相邻节点传播
• 启动效应（Priming）：先前刺激无意识地激活相关概念，加速后续检索
• 文档系统等价：知识图谱关系边 = 语义网络关系强度

修改内容：

• 在 Step 2b（L1文档阅读）之后、Step [Layer 3]（L2碎片）之前，插入 Step 2c
• Step 2c：读取知识图谱，找到已阅文档的邻居节点，按关系强度选取高相关邻居补充阅读
• 限制：最多新增2-3个文档（避免过度扩展），知识图谱不可读时静默跳过