| name | digest |
| description | 自我学习阶段。回顾本次学习会话，记录学习心得和错误到 .learnings/，当文件超阈值时自动压缩去重，更新 RULES.md，促进系统持续改进。触发时机：用户审核通过 evaluate 产出并明确要求记录学习后，Phase 6。 |
Skill: digest（自我学习）
触发时机
用户审核通过 evaluate 产出后，且用户明确要求记录会话学习时。
输入
SYSTEM_ROOT: StudySystem 根路径，如 {VAULT_PATH}/StudySystemtopic: 主题名称
执行步骤
Step 1: 检查压缩阈值
在记录新条目之前，检查是否需要先做压缩：
wc -l .learnings/LEARNINGS.md .learnings/ERRORS.md 2>/dev/null || echo "0 .learnings/LEARNINGS.md\n0 .learnings/ERRORS.md"
如果任一文件超过 100 行，先执行压缩流程：
- 读取
.learnings/LEARNINGS.md 和 .learnings/ERRORS.md 中的所有条目
- 按主题/模式分组，去重
- 写入/更新
.learnings/RULES.md：
## Do — 值得坚持的做法## Don't — 需要避免的错误## Watch For — 需要特别注意的情况- 每行一条规则，合并重复出现：
(3x) 用 X 而非 Y
- 丢弃只出现一次的孤立噪声
- 归档旧条目到
.learnings/archive/YYYY-MM-DD.md
- 截断
.learnings/LEARNINGS.md 和 .learnings/ERRORS.md 只保留头部
Step 2: 确保 .learnings/ 目录存在
mkdir -p .learnings
如果 .learnings/LEARNINGS.md 或 .learnings/ERRORS.md 不存在，创建最小头部。
Step 3: 回顾本次会话
扫描评估发现和会话过程中遇到的任何问题：
- 是否有论断被判定为不准确？ → 记录到
.learnings/LEARNINGS.md，类别 correction
- 整理资料是否有缺口？ → 记录到
.learnings/LEARNINGS.md，类别 knowledge_gap
- collect/curate/write/beautify 阶段是否有报错？ → 记录到
.learnings/ERRORS.md
- 是否有值得未来 Study System 运行时参考的模式？ → 记录到
.learnings/LEARNINGS.md，类别 best_practice
Step 4: 记录条目
使用自改进格式记录：
学习条目（追加到 .learnings/LEARNINGS.md）：
## [LRN-YYYYMMDD-XXX] category
**Logged**: ISO-8601 timestamp
**Priority**: low | medium | high
**Status**: pending
**Area**: docs
### Summary
One-line description
### Details
What happened, what was learned
### Suggested Action
What to do differently next time
---
错误条目（追加到 .learnings/ERRORS.md）：
## [ERR-YYYYMMDD-XXX] phase_name
**Logged**: ISO-8601 timestamp
**Priority**: high
**Status**: pending
**Area**: docs
### Summary
Brief description of what failed
### Error
Actual error message
### Context
What was being attempted
---
Step 4.1: 写入安全与控制字符验证
每次写入或重写 .learnings/LEARNINGS.md、.learnings/ERRORS.md、.learnings/RULES.md、归档文件时，必须执行以下安全约束：
- 含 LaTeX、反斜杠、反引号、Markdown 表格或代码块的内容，优先使用 Python raw string、
Path.write_text() 已构造字符串，或 quoted heredoc（如 <<'EOF'）；不要用普通三引号字符串保存含 \begin、\rvert 等内容。
- 写入后立刻扫描控制字符，只允许
\n、\r、\t：
bad = [(i, b) for i, b in enumerate(path.read_bytes()) if b < 32 and b not in (9, 10, 13)]
assert not bad
- 回读刚写入的关键段落，确认
\begin、\rvert、反引号、表格分隔线没有被转义污染。
- 若控制字符检查失败，必须先修复文件并重新扫描；不得把受污染的
.learnings/ 文件留给下一轮会话。
Step 4.5: RULES.md 冲突检测与同步
每次追加新条目到 LEARNINGS.md 后，必须执行本步骤，检查新条目是否与 .learnings/RULES.md 中现有规则存在冲突。
4 类冲突定义
- 方向冲突：新条目的 Suggested Action 与 RULES.md Do/Don't 区直接矛盾
- 例：RULES.md 写
Do: 表格 LaTeX 用 \lvert \rvert，新条目写 用 | 即可
- 例外冲突：新条目声明自己是某规则的例外
- 例：RULES.md 写
Don't: Callout 内不要 $$，新条目写 嵌套 callout 内层允许 $$
- 优先级冲突：新条目要求覆盖某规则
- 例：RULES.md 写
X 应该 Y，新条目写 用户明确要求时 X 可以不 Y
- 模式遗漏：新条目提到的问题模式尚未在 Watch For 区追踪
- 例：新增了"嵌套 callout 证明"问题，但 Watch For 区无
obsidian.proof_* 模式键
执行流程
-
读取新追加条目的 Summary / Details / Suggested Action
-
读取 .learnings/RULES.md 全文（Do / Don't / Watch For 三个区块）
-
逐条比对，识别冲突类型（见上）
-
输出冲突报告（无冲突时跳过本步骤）：
## 🔍 RULES.md 冲突检测报告
**新条目**: [LRN-YYYYMMDD-XXX] category
**冲突项**: N 处
| # | 类型 | 现有规则 | 新条目主张 | 建议处理 |
|---|------|----------|------------|----------|
| 1 | 例外冲突 | Don't: 单层 callout 不要 `$$` | 嵌套 callout 内层允许 `$$` | Don't 改为 "单层 callout 不要 `$$`；嵌套 callout 内层例外" |
| 2 | 模式遗漏 | Watch For 无 `obsidian.proof_*` | 新增嵌套 callout 证明模式 | Watch For 补充 `obsidian.proof_collapsible` |
-
关键：等待用户确认。使用 AskUserQuestion 询问：
- 选项 1：全部按建议处理
- 选项 2：仅处理部分冲突（让用户指明）
- 选项 3：暂不同步，保留 pending 状态
-
用户确认后：
- 按"建议处理"列修改 RULES.md 对应区块（Do/Don't/Watch For）
- 在新学习条目里追加
### Resolution 字段（说明同步动作与日期）
- 将
Status 从 pending 改为 resolved
- 若新增了 Watch For 模式键，补充
### Related Rules: Pattern-Key: xxx
- 增加原
(Nx) 计数（合并到 RULES.md 时与去重流程一致）
未确认时的回退
- 仅记录冲突报告，不修改 RULES.md
- LEARNINGS.md 条目 Status 保持
pending
- 在本步骤末尾向用户提示：
检测到 N 处冲突，请确认是否同步 RULES.md
Step 5: 无意义则不记录
如果本次会话没有错误且没有值得记录的学习点，跳过记录 —— 不创建空条目。质量比数量重要。
产出
.learnings/LEARNINGS.md：追加新学习条目（如有）.learnings/ERRORS.md：追加新错误条目（如有）.learnings/RULES.md：
- 压缩后的去重规则（仅当触发压缩时）
- 冲突同步后的更新条目（仅当 Step 4.5 检测到冲突且用户确认时）
.learnings/archive/YYYY-MM-DD.md：归档文件（如触发压缩）
禁止行为
- 不要修改笔记本身
- 不要编造学习条目
- 不要跳过压缩阈值检查
- 不要归档未压缩的条目
- 不要在无意义时强行记录
- 不要未经用户确认就修改 RULES.md — 冲突同步是确认制，不是自动制
- 不要将新规则提升到项目入口文件（AGENTS.md / CLAUDE.md） — 新规则仅写入
.learnings/RULES.md，由 hook 在 agent 启动时注入
硬停止 (Hard Stop)
本阶段任务完成。向用户展示捕获的学习摘要和压缩结果（如有）。
严禁调用其他阶段技能。
询问用户："学习记录完成。可以结束了吗？"
