Coding

元习 yotta-learn

Try it

元习 —— 跨智能体的学习闭环技能：把错误、纠正与洞见沉淀为 .learnings/ 条目，供后续会话与技能改进复用。触发：命令失败、用户纠正、发现更好的做法、请求缺失能力、外部接口故障、知识过时、需要沉淀经验时；或用户说 记一笔/学习/沉淀/self-improvement/learnings 等。边界：不写入私密/敏感信息（除非用户明确要求）；不自动改动系统文件。

What it does

元习 —— 跨智能体的学习闭环技能：把错误、纠正与洞见沉淀为 .learnings/ 条目，供后续会话与技能改进复用。触发：命令失败、用户纠正、发现更好的做法、请求缺失能力、外部接口故障、知识过时、需要沉淀经验时；或用户说 记一笔/学习/沉淀/self-improvement/learnings 等。边界：不写入私密/敏感信息（除非用户明确要求）；不自动改动系统文件。

The skill document

元习（yotta-learn）

把「这次学到的」变成「下次可复用的」：记录错误、纠正与洞见，供后续会话与技能改进复用。

  • 沉淀：log 命令把条目写入 .learnings/（LEARNINGS / ERRORS / FEATURE_REQUESTS），自动编号 + 时间戳。
  • 复用：list / review / stats 回看与统计；promote 把重要条目提升到 AGENTS.md / CLAUDE.md。
  • 改进：extract 由高价值条目生成新技能骨架；Pattern-Key 追踪复发模式。
  • 联动：log --remember 可选同步到 yotta-memory（元忆），未安装/失败自动降级，绝不阻断本地记录。

零依赖（Python 3.8+ 标准库），Windows + Linux 通用。

何时使用

  • 命令或操作意外失败；
  • 用户纠正了你（"不对，应该这样…"）；
  • 发现了更好的做法 / 知识已过时；
  • 用户请求了尚不存在的能力；
  • 解决了一个不显然的问题，值得沉淀；
  • 开始重要任务前，先 review 待处理条目。

Do NOT trigger：不记录私密信息（令牌、密钥、环境变量值、完整源码）除非用户明确要求；推荐用摘要或脱敏片段。

快速使用

# 初始化 .learnings/（幂等，不覆盖已有文件）
python3 scripts/yotta_learn.py init

# 记录一条学习（自动生成 ID 如 LRN-20260826-001）
python3 scripts/yotta_learn.py log --type learning --category correction \\
  --priority high --area git --pattern-key push-gate \\
  --message "推送前必须先跑测试并核对输出"

# 记录一条错误（第二行起进入 Details）
python3 scripts/yotta_learn.py log --type error --priority critical \\
  --message "第一行是摘要"$'\n'"第二行是详情"

# 列出 / 回看 / 统计
python3 scripts/yotta_learn.py list --status pending
python3 scripts/yotta_learn.py review
python3 scripts/yotta_learn.py stats

# 提升到 AGENTS.md / CLAUDE.md（自动去重）
python3 scripts/yotta_learn.py promote LRN-20260826-001

# 由条目生成技能骨架
python3 scripts/yotta_learn.py extract LRN-20260826-001 --slug my-skill --dry-run

# 可选：同步到元忆（yotta-memory），未安装自动降级
python3 scripts/yotta_learn.py log --message "..." --remember

数据协议（.learnings/）

  • 目录：项目根 .learnings/（可用 --dir 指定）。
  • 文件：LEARNINGS.md（LRN-）、ERRORS.md（ERR-）、FEATURE_REQUESTS.md（FEAT-）。
  • ID：LRN/ERR/FEAT-YYYYMMDD-XXX（同一天自增）。
  • 字段：Logged / Priority / Status / Area / Pattern-Key；正文分 Summary 与 Details。
  • 兼容：已有用户数据保留，初始化绝不覆盖；旧格式条目可读。

元忆联动（可选）

  • 显式开启：log --remember。
  • 运行时探测元忆：未安装 → A；已安装未初始化 → B；失败/超时 → C。
  • 降级 A/B/C 只提示，绝不阻断本地 .learnings/ 记录。
  • 不写入 package.json 依赖。

Hook 模板

见 hooks/ 目录：Claude Code（claude-settings.json）、Codex（codex-settings.json）、 OpenClaw（openclaw-setup.md）；activator.sh / error-detector.sh 为 Linux-only 的可选 bash hook。

参考

  • references/examples.md — 记录示例与字段说明
  • references/hooks-setup.md — 各智能体 hook 接入详细步骤

Related skills

元忆 yotta-memory

元忆 —— 有权限边界的文件式智能体记忆。文件式、零依赖、可 diff/可回滚：让任何 AI 智能体活过会话，开工 recall 恢复上下文、重要信息 remember 落盘、收工归档。类型体系 FACT（公共共享）/ PREF / BOUND / COMMIT（私密隔离）。触发：记住、别忘了、记一笔、记忆、remember、recall、跨会话、上次说到、续测、交接、归档、记忆盘、共享记忆、局域网记忆、画像、开工上下文、记忆守则、profile、context、越用越懂、语义检索、反馈、维护、蒸馏、feedback、maintain、distill、explain、自我学习、自我进化、自我提升、查看平台分页、recall 候选预过滤、任务相关记忆、--focus、--embedding、压缩遗忘、consolidate、周期摘要、自动合并、分类型衰减、回滚

2 installs1 stars

Lesson Learned

面向质量/项目工程师，对经验教训做结构化捕获、分类与检索沉淀，避免经验散失，输出 LL 沉淀模板与知识库索引（纯文字版 .txt + Markdown .md）。

1 installs

Learning Review

学用结合的回顾机制。包含五个回顾环节：学后复盘（每次学完）、周内化（每周一次）、应用检查（每两周一次）、压缩归档（每月一次）、知识落地（每周一次）。将学习成果转化为 Agent 实际工作能力，防止"学完就忘"。 触发词："回顾", "复盘", "内化", "学习回顾", "learning review", "r...

6 installs

元引 yotta-prompt

元引 —— 意图澄清 + 生态入口技能：用户输入一句模糊的话 / 一个词时，识别意图、给出 2-4 个候选方向、深挖（目标/范围/输出/约束），再串联到对应元阁技能输出可直接运行的提示词。常驻注入（always-load）：每次新会话开始自动生效，接住「不会用 AI、不知道怎么提问」的用户。触发：用户不知道怎么提问、不知道想要什么、输入模糊的一句话 / 一个词、想被引导到合适技能时。边界：只澄清意图、不预设立场、不做安全评审；提示词不人为设限（不违规/不犯法/不越狱即可）；不做 prompt 美化；纯本地离线。

recursive-self-improve

递归自我改进（元之元）：让技能生态对自身与子技能做递归元改进，越迭代越强。 扫描技能目录识别改进机会（缺自进化闭环/缺前置/YAML 非法），生成安全补丁提案， 在沙箱内试应用并回写元进化记忆，构成「感知→提案→试应用→校验→记忆」的递归闭环。

Workflow Dlc Agent Learning

Agent 学习循环 skill。基于 One Click 的日志 → AI 汇总 → 人工标注 → 经验沉淀三层架构,设计 Agent 的自我迭代机制。触发场景:用户说"经验学习"、"日志设计"、"Agent 迭代机制"、或 workflow-start 路由到此 skill。

3 installs