| name | digest |
| description | 自我学习阶段。回顾本次学习会话,记录学习心得和错误到 .claude/rules/learnings/,当文件超阈值时自动压缩去重,更新 RULES.md,促进系统持续改进。 |
Skill: digest(自我学习)
执行步骤
Step 1: 检查压缩阈值
在记录新条目之前,检查是否需要先做压缩:
wc -l .claude/rules/learnings/LEARNINGS.md .claude/rules/learnings/ERRORS.md 2>/dev/null || echo "0 .claude/rules/learnings/LEARNINGS.md\n0 .claude/rules/learnings/ERRORS.md"
如果任一文件超过 100 行,先执行压缩流程:
- 读取
.claude/rules/learnings/LEARNINGS.md 和 .claude/rules/learnings/ERRORS.md 中的所有条目
- 按主题/模式分组,去重
- 写入/更新
.claude/rules/learnings/RULES.md:
## Do — 值得坚持的做法
## Don't — 需要避免的错误
## Watch For — 需要特别注意的情况
- 每行一条规则,合并重复出现:
(3x) 用 X 而非 Y
- 丢弃只出现一次的孤立噪声
- 如果某规则对核心 Study System 流程至关重要,提升到 CLAUDE.md
- 归档旧条目到
.claude/rules/learnings/archive/YYYY-MM-DD.md
- 截断
.claude/rules/learnings/LEARNINGS.md 和 .claude/rules/learnings/ERRORS.md 只保留头部
Step 2: 确保目录存在
mkdir -p .claude/rules/learnings
如果 .claude/rules/learnings/LEARNINGS.md 或 .claude/rules/learnings/ERRORS.md 不存在,创建最小头部。
Step 3: 回顾本次会话
扫描评估发现和会话过程中遇到的任何问题:
- 是否有论断被判定为不准确? → 记录到
.claude/rules/learnings/LEARNINGS.md,类别 correction
- 整理资料是否有缺口? → 记录到
.claude/rules/learnings/LEARNINGS.md,类别 knowledge_gap
- collect/curate/write/beautify 阶段是否有报错? → 记录到
.claude/rules/learnings/ERRORS.md
- 是否有值得未来 Study System 运行时参考的模式? → 记录到
.claude/rules/learnings/LEARNINGS.md,类别 best_practice
Step 4: 记录条目
使用自改进格式记录:
学习条目(追加到 .claude/rules/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
---
错误条目(追加到 .claude/rules/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 5: 无意义则不记录
如果本次会话没有错误且没有值得记录的学习点,跳过记录 —— 不创建空条目。质量比数量重要。
产出
.claude/rules/learnings/LEARNINGS.md:追加新学习条目(如有)
.claude/rules/learnings/ERRORS.md:追加新错误条目(如有)
.claude/rules/learnings/RULES.md:去重压缩后的规则(如触发压缩)
.claude/rules/learnings/archive/YYYY-MM-DD.md:归档文件(如触发压缩)
禁止行为
- 不要修改笔记本身
- 不要编造学习条目
- 不要跳过压缩阈值检查
- 不要归档未压缩的条目
- 不要在无意义时强行记录