digest

name	digest
description	自我学习阶段。回顾本次会话，记录真实发生的学习点和错误到 .learnings/；当经验库过长时压缩去重并更新 RULES.md；如果发现重复错误或规则失效，转交 maintain-learnings 先修源头。用户明确要求记录学习、复盘、写入 learnings、digest 时触发。

digest（自我学习）

记录真实发生的学习和错误。不要为了“显得有产出”编造条目；质量比数量重要。

Step 1: 检查压缩阈值

wc -l .learnings/LEARNINGS.md .learnings/ERRORS.md 2>/dev/null || true

如果任一文件超过 100 行，先判断：

• 只是旧记录堆积：压缩、去重、归档。
• 同类错误复发或 RULES.md 已有规则仍失效：停止单纯压缩，改用 maintain-learnings 修 skill / 模板 / hook / 项目规则，验证后再归档。

Step 2: 确保目录存在

mkdir -p .learnings .learnings/archive

若文件不存在，创建最小头部：

• .learnings/LEARNINGS.md
• .learnings/ERRORS.md
• .learnings/RULES.md

Step 3: 回顾本次任务

只记录本次任务中实际发生的内容：

• 用户纠正了什么？
• 哪个判断、操作或输出有问题？
• 根因是什么？
• 下次应该用什么可执行规则避免？
• 是否需要修改 skill、模板、hook、脚本或项目规则？

Step 4: 写入条目

学习条目追加到 .learnings/LEARNINGS.md：

## YYYY-MM-DD

### <简短主题>

**类别**：correction | knowledge_gap | best_practice | workflow
**优先级**：low | medium | high
**状态**：pending
**范围**：<skill / module / workflow / docs>

**摘要**：一句话说明学到了什么。

**详情**：
- 事实：
- 根因：
- 下次做法：

---

错误条目追加到 .learnings/ERRORS.md：

## YYYY-MM-DD

### <skill 或阶段>：<错误标题>

**错误**：实际发生了什么。

**触发场景**：什么时候发生。

**根因**：为什么发生。

**修复**：
- 已采取的修复动作。

**预防措施**：
- 下次必须执行的检查或规则。

---

Step 5: 更新 RULES.md

只把高价值、可复用、可执行的规则提炼到 .learnings/RULES.md。格式保持短：

## <area>

- **规则名**：用 X，而不是 Y。

Step 6: 无意义则不记录

如果本次任务没有错误、没有纠正、没有可迁移经验，不写空条目。

禁止行为

• 不要编造学习点。
• 不要把长故事塞进 RULES.md。
• 不要把“下次注意”当成源头修复。
• 不要在未修复、未验证前归档复发错误。