MinisSkills 自我进化教程:如何让 AI Agent 自动记录错误并越用越聪明

原创2026-11-16 18:51:581,972 阅读

MinisSkills 自我进化教程:如何让 AI Agent 自动记录错误并越用越聪明

MinisSkills 是面向 Minis 生态的 AI 技能集合,其中的 self-improving-agent 技能让 AI Agent 能够自动记录错误、纠正与最佳实践,形成可追溯的学习闭环——Agent 从此不再重复犯同样的错,越用越聪明。

为什么 AI Agent 需要"自我进化"?

用过 AI Agent 的人都有过这样的经历:同一个报错排查了三遍,同一种路径约定纠正了五次,Agent 每次会话都"失忆"重来一遍。

问题不在于 Agent 不够聪明,而在于经验没有被沉淀。self-improving-agent 就是解决这个问题的技能:它把 Agent 工作中产生的错误、用户纠正、可复用方案,结构化地写入学习日志,并在下次任务前主动检索复用。

核心模块位于 self-improving-agent/SKILL.md,配套的自动化脚本是 self-improving-agent/scripts/minis_auto_log.sh。

3 个学习日志文件:进化的"记忆库"

该技能默认使用 3 个 Markdown 文件作为学习日志(默认目录为 /var/minis/skills/self-improving-agent/data/):

日志文件 记录什么 典型场景
LEARNINGS.md 纠正、知识空白、最佳实践 用户指出理解错误、找到更优方案
ERRORS.md 命令失败、异常输出 权限、路径、依赖、网络、第三方 API 异常
FEATURE_REQUESTS.md 用户提出的新能力需求 缺少某个功能、需要新工作流

仓库中可以看到真实的学习记录示例,比如公共区日志 self-improving-agent/data/public/LEARNINGS.md 里,Agent 曾记下"脚本缺少可执行权限时应显式用 sh 调用"这条经验——这就是"踩过的坑"变成了"以后不踩的坑"。

什么情况下应该记录?

根据技能内置的触发规则(详见 SKILL.md 触发规则部分),以下 5 类事件必须记录:

  1. 命令或操作失败且原因不明显
  2. 用户纠正了 Agent 的错误理解
  3. 发现知识过时或假设不成立
  4. 出现了可复用的更优解决方案
  5. 相似问题在不同任务中反复出现

而普通闲聊、一次性的临时小改动则不需要记录,避免日志被噪音淹没。

3 个命令跑通自我进化闭环

整个工作流程只需一个脚本,按顺序执行即可上手:

# 1. 初始化日志目录
sh scripts/minis_auto_log.sh init

# 2. 记录一条学习经验(摘要 + 详情)
sh scripts/minis_auto_log.sh learning "修复了下载超时" "改用分块下载加重试"

# 3. 记录一次命令失败
sh scripts/minis_auto_log.sh error "curl 请求失败" "HTTP 429 Too Many Requests"

# 4. 检索历史经验(覆盖技能区 + 公共区 + 项目区)
sh scripts/minis_auto_log.sh search timeout

# 5. 查看当前作用域与文件位置
sh scripts/minis_auto_log.sh status

每条记录都会自动生成全局唯一 ID(如 LRN-20260317-HMO、ERR-20250115-A3F),并附带时间戳、优先级、状态、领域等元数据,方便后续追踪与检索。完整命令说明可参考 scripts/minis_auto_log.sh 用法部分。

记录长什么样?

每条学习记录都包含固定的结构:摘要、详情、建议动作、元数据。以 data/LEARNINGS.md 中的真实条目为例,Agent 记录了"默认日志位置改为技能数据目录"这一决策及其背景——后人(或未来的 Agent)一眼就能看懂当时的上下文。

从经验到资产:promote 提升机制

这是该技能最有意思的设计:学习日志是分层的,好经验会被逐级"晋升"。

项目级 .learnings/   →   技能默认区 data/   →   技能公共区 data/public/   →   Minis 长期记忆
(单次项目经验)        (默认写入位置)        (跨项目可复用)              (一句式长期规则)

promote 做了什么?

执行 promote <条目ID> 后,脚本会自动完成 4 件事:

  1. 把该条记录复制到公共区 data/public/
  2. 自动将源条目状态标记为 promoted
  3. 回写"已提升到"路径与"### 解决记录"
  4. 具备重复保护——同一条目重复 promote 不会追加副本

实现细节见 scripts/minis_auto_log.sh promote 函数。

什么时候该提升到长期记忆?

技能给出了硬标准,满足其一即可考虑 memory_write:

  • 能压缩成"当 X 发生时,做 Y"这样的规则,且不依赖具体项目细节
  • 30 天内复发 3 次以上,或出现在至少 2 个不同任务/领域
  • 明确属于你的长期偏好,且你说"记住这个"

这与日志的定位形成互补:日志是可编辑的工作复盘仓库,允许长文和细节;长期记忆是跨会话的稳定规则,应短小精悍——写坏的条目会长期"污染"后续决策,所以必须先沉淀、再精炼。

常用操作速查表

需求 命令
初始化日志 sh minis_auto_log.sh init
记录学习经验 sh minis_auto_log.sh learning "摘要" "详情"
记录错误 sh minis_auto_log.sh error "摘要" "错误输出"
记录功能需求 sh minis_auto_log.sh feature "能力" "背景"
按项目隔离记录 加 --project /路径 参数,写入项目 .learnings/
直接写入公共区 加 --public 参数
全局搜索经验 sh minis_auto_log.sh search 关键词
提升条目到公共区 sh minis_auto_log.sh promote LRN-20260317-ABC
查看当前作用域 sh minis_auto_log.sh status

定期回顾:让日志真正发挥作用

记录只是第一步,在关键时刻回顾才能形成闭环。技能建议在以下节点主动 search 历史经验:

  • 开始新的重点任务之前
  • 完成一个功能之后
  • 进入曾有历史经验的技术领域时
  • 活跃开发期每周一次

小结

self-improving-agent 用"3 个日志文件 + 1 个自动脚本 + 分层提升机制",为 MinisSkills 中的 AI Agent 建立了一套可追溯的自我进化闭环:

  • 错误会被记住:失败与异常结构化归档,下次同类问题秒查历史
  • 纠正不再丢失:用户的每次修正都沉淀为学习条目
  • 经验逐级升值:从项目级日志一路提升到长期记忆,越用越聪明

如果你想在自己的项目中启用它,直接阅读 self-improving-agent/SKILL.md 按触发规则约定好"何时记录、记录到哪",再跑通上面 3 个命令,你的 Agent 就从今天开始"成长"了。

登录后查看全文
MinisSkills