---
name: cognitive-version-snapshot
description: 为L1文档创建新的x.0版本快照，标志一次重大变更的里程碑。触发词：「创建新版本」「打一个快照」「这是v2.0了」「这次改动很大」「记录一下这个版本」。
---

# 版本快照 Skill（Cognitive Version Snapshot）

> 当L1文档发生重大变更时，创建新的 x.0 版本快照，作为后续变更的新基准。
> 基于 `维护协议_自洽规范.md` 第0.2条：版本快照+变更日志体系。

---

## 何时使用本 Skill（vs 普通修改）

| 修改类型 | 处理方式 |
|---|---|
| 补充一个段落/修改措辞 | 直接修改 + 在变更记录追加一条 |
| 增加一个新章节 | 直接修改 + 在变更记录追加一条 |
| **核心论点发生变化** | **触发本 Skill，创建 v2.0 快照** |
| **文档结构大幅重组** | **触发本 Skill，创建 v2.0 快照** |
| **从根本上更新了主题定位** | **触发本 Skill，创建 v2.0 快照** |

---

## 激活后执行

```
Step 1  确认目标文档和版本号
        → 读取 历史版本/ 目录，找到最新的 vN.0 快照
        → 新版本号 = v(N+1).0

Step 2  对比当前版本与最近 vN.0 快照的差异
        → 确认差异确实构成「重大变更」（满足上表中的标准）
        → 如果只是增量修改，提示用户直接修改+变更记录即可

Step 3  创建新的 x.0 快照
        → Copy: [文档名].md → 历史版本/[文档名]_v(N+1).0_YYYYMMDD.md
        → 告知用户：「✅ 已创建 v(N+1).0 快照」

Step 4  在变更记录文件中追加里程碑条目
        → Write to [文档名]_变更记录.md（追加）：
        
        ## v(N+1).0 里程碑（YYYY-MM-DD）
        
        **变更性质**：[核心论点变化/结构重组/定位更新]
        **主要变更**：[一段话描述与 vN.0 的核心差异]
        **快照路径**：历史版本/[文档名]_v(N+1).0_YYYYMMDD.md
        **触发原因**：[什么事件/对话触发了这次重大变更]

Step 5  追加系统日志
        [LOG-YYYYMMDD-NN] cognitive-version-snapshot | [文档名] 创建v(N+1).0快照 | [变更性质]
```

---

## 版本历史格式示例

在变更记录文件中，版本历史应该像这样：

```
## v1.0 基准（2026-03-19）
[2026-03-19] [create] 全文 | 初次迁入认知结构 | 系统性整理
快照：历史版本/[文档名]_v1.0_20260319.md

---

[2026-03-20] [supplement] 第三章 | 补充OPC社区相关论述 | 对话触发
[2026-03-21] [revise] 第一章第二节 | 修订马斯洛层次的表述 | 矛盾消解

---

## v2.0 里程碑（2026-03-25）
**变更性质**：核心论点变化
**主要变更**：从「三类问题框架」扩展为「五类问题框架」，认知科学基础单独成维度
**快照路径**：历史版本/[文档名]_v2.0_20260325.md
**触发原因**：与郑总深入讨论认知科学后，原有框架无法容纳新的洞见

---

[2026-03-26] [supplement] 第五章 | 新增认知科学基础维度详细论述 | v2.0后补充
```

---

## 注意事项

- **不要创建过多版本快照**：不是每次修改都要打 x.0，只有真正的「里程碑」才打
- **版本快照是不可变的**：创建后不要修改快照文件，它是历史记录
- **变更记录是追加的**：只允许追加，不允许修改历史条目