# Cognitive Update Knowledge

> 受控更新L1系统性文档：含影响范围预分析、历史版本备份、矛盾检测、级联写入。触发词：「更新[文档名]」「完善[文档名]」「修改[文档名]」「我要改[内容]」「在[文档]里加上」「[文档]需要更新」。

- **Type:** Skill
- **Install:** `agentstack add skill-tashangkd-cognitive-os-cognitive-update-knowledge`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [TashanGKD](https://agentstack.voostack.com/s/tashangkd)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [TashanGKD](https://github.com/TashanGKD)
- **Source:** https://github.com/TashanGKD/cognitive-os/tree/main/skills/cognitive-update-knowledge

## Install

```sh
agentstack add skill-tashangkd-cognitive-os-cognitive-update-knowledge
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 知识库更新 Skill（Update Knowledge）

> 受控的L1文档直接修改流程：影响分析 → 备份 → 修改 → 矛盾检测 → 强制级联写入。

---

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

| 层级 | 文档 | 需要理解的概念 |
|---|---|---|
| **D0 认知根（必读）** | `cognitive/L1_knowledge/系统架构思维维度/自进化智能体系统形式规范_v1.0.md` | 层5：ceremony(K)完整协议 = 备份+版本+修改+日志+级联；层3：C2（K1变化必须通知依赖它的所有B-objects）|
| **D3 规范参考** | `cognitive/maintenance_protocol.md` | K1文档完整修改规范；矛盾检测要求（不可跳过）|
| **D4 运行时数据** | `cognitive/L1.5_principles/principles.md` + `L0_大脑总地图.md` + 目标L1文档 | 现有原则（避免修改与原则矛盾）+ 文档关系图 + 目标文档当前版本 |

**核心概念速查**：
① ceremony(K1) = 最高风险的K-object操作：错误更新会通过C2级联传播到所有依赖此K1的B-objects
② 矛盾检测是必要步骤：新内容必须与L1.5原则库和同维度已有文档做一致性检查
③ 级联写入不可跳过：修改L1后必须更新变更记录+L0总地图+系统日志（三处同步）

---

## 激活后立即执行

```
Step 1  确认目标文档和修改意图
        → 明确：要修改哪个文档？修改哪个部分？修改成什么？
        → 如果用户没有说清楚，追问：「修改的是哪个章节？新的内容是什么？」
        → 确认后继续

Step 2  [影响范围预分析]（ [章节]
          直接依赖（依赖此文档的文档）：
          · [文档B]（会受影响：此文档为[B]的理论基础）
          · ...（无 → 「无直接依赖」）
          关联碎片：[F-XXX]（可能需要重新整合状态）
          风险级别：[🔴 高 | 🟡 中 | 🟢 低]
          建议前置动作：□ 先备份 □ 修改后运行矛盾检测
          ─────────────────────────
          [确认继续修改]【γ】 [先备份再修改]【γ】 [取消]【γ】」
        → 须等用户明确选择后才能继续，不得自行假设用户选择了「确认」

Step 3【α】 创建历史版本备份（AI 直接执行，无需再次授权——Step 2 用户已选择继续）
        → 将当前文档复制到历史版本目录：
          `cognitive/L1_knowledge/[维度目录]/历史版本/[文档名]_YYYYMMDD.md`
        → 告知用户：「✅ 已创建备份：[历史版本路径]」

Step 3.5  【F-022 全节点挑战者反思】备份完成后、正式写入前执行
          以「L1体系完整性守护者」视角执行3条挑战：
          
          1. 必要性：这次修改是基于新的碎片证据或用户明确输入，还是 AI 觉得「这里应该更完整」
             的主动补充？若是后者，置信度必须标注为「🟡 AI生成」，而非「🔵 用户原始思考」。
          2. 上游冲突：这次修改的内容，与同维度其他 L1 文档或 L1.5 原则，有没有
             任何命题级别的冲突（不是词语差异，而是「如果A成立，B就不成立」的关系）？
          3. 下游遗漏：修改之后，依赖这个文档的其他 L1 文档中，有哪段内容应该
             同步修改但当前计划里没有包含？（这些应该加入 Step 6 的级联写入任务）
          
          若发现问题 → 修改计划或提醒用户后再执行
          若确实无重大问题 → 继续 Step 4

Step 4【α】 执行用户指定的修改（用户已在 Step 2 授权，AI 直接写入）
        → Write: 精确修改目标文档的指定位置
        → 修改内容必须标注归因：
          - 用户直接输入的观点 → 🔵 用户原始思考
          - AI基于用户意图整理的 → 🟢 AI整理
          - AI推导的新内容 → 🟡 AI生成（需用户额外注意）

Step 5  [矛盾检测]（修改完成后自动执行）
        → 针对刚才修改的内容，快速检测是否与以下产生矛盾：
          · 同文档其他章节
          · 直接依赖此文档的其他L1文档
          · L1.5原则（P1/P2）
        → 如有矛盾 → 立即报告，按用户指令处理（可选：现在消解/记录待后续处理）
        → 无矛盾 → 继续

Step 6  [强制级联写入]（不可跳过，无需用户再次确认）
        a. 追加 [文档名]_变更记录.md（若不存在则新建）
           格式：[日期] [修改类型] [内容摘要] | 触发：用户直接修改 | 备份路径 | 联动文档
        b. 更新 L0_大脑总地图.md（该文档最后更新时间，如有新Gap则追加）
        c. 追加 cognitive/L3_logs/system_log.md（一行记录）
        d. 如有关联碎片，更新碎片整合索引（相关碎片状态改为「⚠️ 需重新评估」）
        e. 【语义记忆组织更新】知识图谱版本号检查（仅当本次修改新增或移动了L1节点时执行）：
           → 若本次修改使 知识图谱_正式文档.md 新增节点 → 更新文档第一行版本号递增 + 节点统计行
           → 若本次修改只更新内容、无节点增减 → 跳过此步
           认知科学依据：Tulving 语义记忆组织——知识分类账（图谱版本头）等价于语义
           记忆的「当前分类状态摘要」，节点结构变化后必须同步，否则分类账与实际知识不一致

Step 7  收尾反馈（E1B 修复：🔴高风险更新强制触发矛盾检测）
        「━━ 更新完成 ━━
          ✅ [文档名] 第[X]章已更新
          📋 历史版本已备份：[路径]
          🔍 矛盾检测（Step 5）：[通过 / 发现N个，已处理/记录]
          📝 变更记录已追加」
        
        [强制条件] Step 2 影响分析中，本次更新的风险级别是什么？
        → 🔴 高（核心论点变更/跨文档强依赖）：
          【强制执行】自动触发 cognitive-detect-contradiction
          → 检查范围：本次更新的文档 + 其直接依赖文档
          → 检测结果汇总到本步骤输出中
          → 完成后继续 Step 8
        → 🟡 中 / 🟢 低：
          「建议：本次为增量修改，可选运行全量一致性检查。」
          → 继续 Step 8

Step 8  调用 cognitive-verifier 子智能体（CS-010 修复）
        
        ⚠️ B4 任务日志写入在本步骤之后执行（非在 Step 7 之后），
           以确保任务状态反映验证结论而非仅反映写入完成。
        
        输入：{
          target_doc_path: [本次更新的 L1 文档完整路径],
          update_summary:  [Step 4 修改内容的一句话摘要],
          related_docs:    [Step 2 影响分析中识别的相关 L1 文档路径列表],
          call_context:    "update"
        }
        
        处理验证报告：
        → verdict = "通过"：
          告知用户「✅ 认知自洽验证通过（CV-1/CV-2/CV-3）」
          → B4 任务日志写入（状态：完成）
          → 继续 Step 9

        → verdict = "警告"：
          向用户展示 ⚠️ 具体警告内容，询问「是否接受并继续？」
          IF 用户接受：
            → B4 任务日志写入（状态：完成，注明"含警告：[摘要]"）
            → 继续 Step 9
          IF 用户拒绝：
            → 返回 Step 4 重新修改
        
        → verdict = "不通过"：
          向用户展示 ❌ 具体问题 + action_required 建议行动
          「请修复上述问题后重新触发 cognitive-update-knowledge」
          → B4 任务日志写入（状态：⚠️挂起待修复，问题：[CV-?失败摘要]）
          → 当前任务挂起，不继续 Step 9

Step 9  重大更新级联通知（仅当满足触发条件时执行）
        
        触发条件（调用方在此判断，满足任一即触发）：
        □ 本次修改字符变化量 > 目标文档总字符数 × 30%（默认阈值，可调）
        □ 本次修改涉及文档的核心命题、定义或框架性内容
        
        IF 满足触发条件：
          后台触发 cognitive-cascade-notifier（不阻断）
          输入：{
            change_type:    "major_l1_update",
            change_summary: [本次更新摘要],
            is_major_update: true,
            doc_name:       [目标文档名]
          }
          → 主流程继续，不等待后台执行完成
        
        IF 不满足：
          跳过本步骤，静默完成
```

---

## 变更记录格式

追加到 `[文档名]_变更记录.md`（自动在 L1 对应目录下查找或新建）：

```markdown
## [YYYY-MM-DD] [direct_edit | supplement | revise]

**修改位置**：第X章第Y节
**修改摘要**：[一句话描述]
**归因**：[🔵/🟢/🟡 说明]
**触发原因**：用户直接修改（Skill: cognitive-update-knowledge）
**备份路径**：`历史版本/[文档名]_YYYYMMDD.md`
**联动影响**：[无 | 需检查：文档Z]
**矛盾检测**：[通过 | 发现N个矛盾，处置方式：...]
```

---

## 注意事项

- **影响分析是必须的**，不能为了"快"而跳过，哪怕用户说"直接改"
- **备份是强制的**，每次修改前都要备份，即使今天已经备份过
- **矛盾检测结果即使是「通过」也要在变更记录中注明**
- **🟡 AI生成的内容**需要在对话中特别提示用户注意，因为这类内容没有原始依据
- **如果用户说的修改很模糊**（「把这章优化一下」），要追问具体方向，不要自行发挥

---

## 变更记录

### v1.1 — 2026-03-19 — F-022全节点审核：加入L1文档更新前挑战者反思（Step 3.5）

**根因**：full-node-audit.mdc 要求认知更新节点（L1文档修改）写入前内置挑战者反思，cognitive-update-knowledge 在备份后直接执行修改，缺少对写入必要性、上游冲突和下游遗漏的预检查。

**修改内容**：
- 新增：Step 3.5「F-022 全节点挑战者反思」——必要性/上游冲突/下游遗漏三视角
- 注：此步骤是写入前预检（小闭环），Step 5 矛盾检测是写入后验证（大闭环），两者互补

**验证状态**：🔵 待验证

### v1.2 — 2026-03-21 — 新增 Step 8（cognitive-verifier）+ Step 9（级联通知）+ B4 时机修订

**根因**：CS-010 沙盘确认 L1 文档更新后无独立自洽验证（创作者视角偏差）；三大闭环架构蓝图标注 Loop2→Loop3 级联触发❌缺失；H-3 问题指出 B4 在 verifier 之前触发导致任务状态不一致。

**修改内容**：
- 新增：Step 8「调用 cognitive-verifier 子智能体」——读取更新后的 L1 文档，执行 CV-1/CV-2/CV-3 三项检查，verdict 决定任务状态（通过/警告/不通过）
- 新增：Step 9「重大更新级联通知」——满足重大更新条件时，后台触发 cognitive-cascade-notifier
- 修改：Step 7 → 不再是最后一步，指向 Step 8
- 修改：B4 触发时机从 Skill 步骤完成后立即触发，改为在 Step 8 verdict 决策后触发（状态反映验证结论）
- 备份路径：`history/SKILL_v1.1_20260321.md`

**验证结果**：
- 正向验证：L1 文档更新后，Step 8 被调用，输出包含 CV-1/CV-2/CV-3 三项检查（待真实场景验证）
- 负向验证：非重大更新（<30% 字符变化）不触发 Step 9 级联通知

**验证状态**：🔵 待验证

---

### v1.1 — 2026-03-21 — Step 7 🔴高风险更新自动触发矛盾检测（E1B 强制级联修复）

**根因**：GAP-E1 分析（认知体系改进规划 v1.2）：🔴高风险 L1 更新后矛盾检测仍是建议性，风险等级与响应机制不匹配。

**修改内容**：
- 修改：Step 7 → 新增强制条件判断：🔴高风险自动触发 cognitive-detect-contradiction（限定范围为本次更新文档+直接依赖文档）；🟡/🟢 保持建议性

**验证结果**：
- 正向验证：🔴高风险 L1 更新后，Step 7 应自动触发矛盾检测（待真实场景验证）
- 负向验证：🟢低风险更新（如追加一个例子），Step 7 不强制触发矛盾检测

**验证状态**：🔵 待验证

**备份路径**：`history/SKILL_v1.0.1_20260321.md`

---

### v1.0.1 — 2026-03-19 — Step 7 加入一致性检查提示（CS-002 Gap 修复）

**根因**：CS-002 沙盘发现：UPDATE（L1更新）完成后没有触发 CONSIST（cognitive-consistency-check）的机制，全量一致性验证需用户主动触发，可能导致更新引入隐性不一致。

**修改内容**：
- 修改：Step 7 收尾反馈 → 加入建议性提示，引导用户在重大内容更新后运行全量一致性检查

**验证结果**：
- 正向验证：L1 重大更新完成后，Step 7 输出包含「建议运行一致性检查」的提示
- 负向验证：小修改（如错别字）时提示不干扰流程（建议性，非阻断）

**验证状态**：🔵 待验证

---

### v1.3 — 2026-03-25 — Step 6 新增 e（知识图谱版本号更新）

**根因**：2026-03-25 添加18个L1节点后，知识图谱主文档版本头仍是v1.6，需手动修复。Step 6 级联写入（a/b/c/d）未包含「知识图谱版本号+节点统计行更新」步骤，导致图谱分类账状态与实际知识节点不一致。

**认知科学依据**：Tulving 语义记忆组织（Semantic Memory Taxonomy Maintenance）——知识分类账（图谱）的状态头等价于语义记忆的「当前分类状态摘要」，节点结构变化后必须同步，否则分类账与实际知识内容不一致。

**修改内容**：
- 新增 Step 6e：知识图谱版本号更新（条件触发：仅当本次修改新增L1节点时执行）

**验证方法**：
- 正向：下次新增L1节点后，图谱版本头自动递增
- 负向：只修改文档内容（无节点增减）时，Step 6e 跳过

**验证状态**：🔵 待验证
**备份路径**：`history/SKILL_v1.2_before_graph-update.md`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [TashanGKD](https://github.com/TashanGKD)
- **Source:** [TashanGKD/cognitive-os](https://github.com/TashanGKD/cognitive-os)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-tashangkd-cognitive-os-cognitive-update-knowledge
- Seller: https://agentstack.voostack.com/s/tashangkd
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.