菜单
📝 学习记录器技能 - 自动捕获错误、纠正、最佳实践，持续进化项目知识 触发场景： - 说"记录这个错误" - 说"记住这个教训" - 测试失败被修复 - 用户纠正了错误 - 发现更好方案 - 任何"学到了"时刻 功能： - 错误捕获 → 归类 → 存储 - 纠正记录 → 原因分析 → 规则提取 - 最佳实践 → 模式识别 → 复用 - 自动提炼 → 更新到 CLAUDE.md
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | learning-recorder |
| description | 📝 学习记录器技能 - 自动捕获错误、纠正、最佳实践，持续进化项目知识 触发场景： - 说"记录这个错误" - 说"记住这个教训" - 测试失败被修复 - 用户纠正了错误 - 发现更好方案 - 任何"学到了"时刻 功能： - 错误捕获 → 归类 → 存储 - 纠正记录 → 原因分析 → 规则提取 - 最佳实践 → 模式识别 → 复用 - 自动提炼 → 更新到 CLAUDE.md |
| version | 1.0.0 |
| author | mcp agent |
| trigger_patterns | ["记录这个","记住这个","学习到","这次学到了","capture","learning"] |
| tags | ["learning","memory","knowledge","self-improvement","capture"] |
项目自我进化的核心：把每一次错误和纠正都变成知识
学习循环：
错误发生 → [学习记录器] → 捕获上下文 → 归类存储
↓
下次遇到类似问题
↓
自动应用已有知识 → 避免重复犯错
| 类型 | 说明 | 存储位置 |
|---|---|---|
| ERROR | 命令/操作失败 | .learnings/ERRORS.md |
| CORRECTION | 用户纠正 | .learnings/LEARNINGS.md (category: correction) |
| BEST_PRACTICE | 发现更好方案 | .learnings/LEARNINGS.md (category: best_practice) |
| FEATURE_REQUEST | 用户请求功能 | .learnings/FEATURE_REQUESTS.md |
## [标题]
- **日期**: 2026-05-11
- **类别**: ERROR | CORRECTION | BEST_PRACTICE
- **问题**: 描述问题
- **原因**: 分析根本原因
- **解决方案**: 修复方案
- **关键词**: 用于检索
- **应用场景**: 何时使用这个知识
# 记录错误
python3 .claude/skills/learning-recorder/scripts/record.py --type error --content "ruff check 失败: unused import" --solution "使用 ruff check --fix"
# 记录纠正
python3 .claude/skills/learning-recorder/scripts/record.py --type correction --content "用户说不要用mock测试数据库" --reason "mock和实际行为不一致"
# 记录最佳实践
python3 .claude/skills/learning-recorder/scripts/record.py --type best-practice --content "使用 contextlib 简化资源清理" --solution "with contextlib"
from learning_recorder import LearningRecorder
recorder = LearningRecorder()
# 记录错误
recorder.record_error(
problem="Element not found",
cause="定位符失效",
solution="使用 accessibility_label"
)
# 记录纠正
recorder.record_correction(
original="使用 mock 数据库",
corrected="使用真实数据库测试",
reason="mock 和实际行为不一致"
)
# 在 self-healing 修复成功后自动调用
result = executor.heal(error, context)
if result.success:
recorder.record_error(
problem=error,
cause=result.strategy_used,
solution=result.fix_applied
)
📝 Learning Recorded
==================================================
Type: ERROR
Problem: Element not found: accessibility_id:submit
Cause: 定位符在页面变化后失效
Solution: 使用 accessibility_label 作为备用定位符
Keywords: locator, element_not_found, accessibility
Added to: .learnings/ERRORS.md
==================================================
python3 .claude/skills/learning-recorder/scripts/query.py --keyword "locator"
# 找出重复出现的错误模式，提炼成规则
python3 .claude/skills/learning-recorder/scripts/synthesize.py
在以下情况自动记录：
self-healing-executor 修复成功 → 记录修复方案| 状态码 | 含义 |
|---|---|
| 0 | 记录成功 |
| 1 | 记录失败 |
| 2 | 参数错误 |
.learnings/
├── ERRORS.md # 错误记录
├── LEARNINGS.md # 学习记录（纠正 + 最佳实践）
├── FEATURE_REQUESTS.md # 功能请求
└── PATTERNS.md # 提炼的模式规则
⚡ 自动触发器技能 - 基于文件变更类型自动判定并触发对应技能 触发场景： - 说"设置自动触发" - 说"配置 auto-trigger" - 说"当文件变更时自动执行" - git hook 或 CI/CD 中调用 功能： - 文件变更检测 - 变更类型判定（.py, .md, .json 等） - 技能选择和触发 - 结果汇总报告
✅ 提交验证器技能 - git commit 前自动运行 lint + 测试，确保代码质量 触发场景： - git commit 时自动触发（pre-commit hook） - 说"验证提交" - 说"检查代码质量" - 说"commit 前的检查" - pre-commit hook 配置 功能： - 运行 ruff lint 检查 - 运行快速测试 - 失败时阻断提交 - 成功时显示检查通过 - 可配置跳过某些检查
🚀 部署检查器技能 - 部署前自动验证项目状态、依赖、环境、风险评估 触发场景： - 说"部署前检查" - 说"检查部署就绪" - 说"deployment check" - 说"发布前验证" - CI/CD 管道中的部署阶段 功能： - 依赖完整性检查 - 环境变量验证 - 代码完整性检查 - 风险评估 - 部署清单生成
🔔 统一通知中心技能 - 聚合多个技能的失败/成功通知，去重后统一发送 触发场景： - 说"配置通知" - 说"设置通知中心" - 说"notification hub" - 任意技能需要发送通知时 功能： - 接收来自各技能的通知 - 去重（同类型消息合并） - 聚合（多条消息合并为一条） - 统一渠道发送（系统通知、Slack、邮件等） - 免打扰模式（静默时段）
⚡ 并行执行器 - 并行执行多个选中的技能 触发场景： - 说"并行执行技能" - 说"同时运行多个任务" - skill-chain 中需要并行执行技能时 - auto-trigger 中需要加速执行时 功能： - 技能并行执行 - 线程池管理 - 结果汇总 - 错误收集
🏥 项目健康监控技能 - 定时检查项目状态、自动发现问题、触发修复流程 触发场景： - 说"检查项目健康" - 说"运行健康检查" - 说"监控项目状态" - 说"定时健康检查" - 说"设置每小时检查" - Cron 定时任务触发 功能： - 运行测试套件 - 检查熔断器状态 - 验证工具注册表 - 检查 lint 问题 - 报告最近提交 - 失败时发送系统通知