技能教训

技能教训是 Agent 读取 Skill 时一并获得的简短注意事项，每条都带有日期。它们帮助 Agent 避免反复出现的工具错误、环境陷阱和工作方式偏差。共享的 SKILL.md 保持不变。

技能教训受 GBrain 的 Skill 优化实验启发，是 Agent 在使用某个 Skill 过程中积累的带日期的笔记。Ankole 将机器写入限制为带租约、Agent 专属的过程提示，不允许改写 Skill 正文。

一条教训只属于一个 Agent 和一个 Skill。若规则需要适用于所有 Agent，应把它写入 Skill 来源。

什么内容可以成为教训

Ankole 可以保留两类过程注意事项：

教训可以说明何时停止、需要检查什么，或应怎样调用工具。它不能规定结果应该多好、多深、多完整，也不能规定观点、语气或风格。Ankole 不会根据任务结果评分来判断教训是否有效。

只适用于一个任务的指示不是教训。一次性的范围、格式或术语要求只约束当前任务。大多数证据批次不会产生教训。

Ankole 检查已经结束的后台 Agent Job。Job 中必须出现失败的命令或工具调用，或在 Job 启动后收到人工消息。系统只使用最近 30 天的记录。

当一个 Agent 积累了足够多尚未处理的信号 Job 后，Dreaming 才会创建复盘 Job。默认阈值为 10。复盘最多读取最近 30 个符合条件的 Job。

机器教训通常需要至少两个不同 Job 的证据。只有当某个 Job 中的人工消息本身明确给出了可复用纠正时，一条 Job 证据才足够。

复盘可以在本地环境中执行只读检查。它不能修改文件、访问网络或修复问题。错误信息和工具输出都按不可信数据处理。

生效中的教训显示在完整 Skill 说明后的 Agent-specific additions 区块中，每条都标明日期。人工教训排在 Dreaming 教训之前。

已退场的教训，以及超过复审宽限期的机器教训，不会进入 Agent 上下文。关闭 Skill 也会停止投递对应教训。存储中的历史仍可供运维人员检查。

Dreaming 教训创建时持有 7 天租约。租约即将到期、Ankole 版本变化或 Skill 正文变化时，定时 Dreaming 会复审该教训。

复审有三种结果：

未得到复审结果的教训会在 7 天宽限期后停止投递。该记录仍保留在历史中，便于运维人员检查原因。

人工教训没有租约。Dreaming 不会修改或让人工教训退场。

只有已启用的 Skill 可以新增人工教训。人工教训不受机器内容长度限制，但不能包含 URL。需要修正教训时，先让旧条目退场，再新增条目；教训正文不能原地修改。

Console 会显示作者、创建时间、复审日期、核对版本、证据 Job 和退场原因。人工撤销的内容会进入 Dreaming 的禁止再学习清单，因此 Dreaming 不会再次加入等价教训。Agent 会从下一轮开始停止读取已退场的教训。

以下 brain.* 配置控制技能教训：

配置	默认值	作用
`brain.skill_learning_enabled`	`true`	控制复盘、复审和教训投递。设为 `false` 时，已存的人工教训和 Dreaming 教训都会隐藏，但不会删除。
`brain.skill_learning_reflection_threshold`	`10`	设置创建一次复盘 Job 所需的未处理信号 Job 数，最小值为 `2`。
`brain.maintainer_agent_uid`	未设置	选择负责维护 Brain 的 Agent，并使用其 `heavy` profile 复审租约教训。`heavy` profile 不可用时，跳过依赖模型的复审。
`brain.dreaming_task_cron`	`0 5 * * *`	设置 Dreaming 评估复盘触发条件和复审到期教训的时间。

打开 Brain → 健康，可以查看技能学习是否启用、每个 Agent 的生效教训数、最近 7 天的新增与退场数量，以及最老生效 Dreaming 教训的年龄。