Cognitive Version Snapshot

版本快照 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，只有真正的「里程碑」才打
• 版本快照是不可变的：创建后不要修改快照文件，它是历史记录
• 变更记录是追加的：只允许追加，不允许修改历史条目

Source & license

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

• Author: TashanGKD
• Source: TashanGKD/tashan-cursor-skills
• License: MIT

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