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