用途
he-learn(Hard Eng Learn)用于处理两类情况:一是可验证的重复失败,需要建立预防措施;二是需要长期保留的决策或指导,需要以简洁的 ADR 形式记录。当失败反复出现、预防措施需要加强,或已有决策需要被接受和保存时,可调用该技能。
输入与输出
输入为当前任务加上已观察到的尝试/结果,或明确的决策/指导。该技能复用其授权与参与模式。Hook 检查点会请求此判断,但检查点本身不确立重复性、原因,也不授予修改其他项目或全局记忆的权限。
输出为在最窄责任方处经过验证的预防措施、一份适用的决策记录,或明确的空操作/阻塞项。证明与待办工作保留在同一计划中;不引入学习台账或新的任务状态。如果现有测试或文档已经保留了该教训,则无需重复记录。
主要流程
技能以流程图描述判断路径:
- 从当前证据出发,判断“什么发生了变化”。
- 若为重复失败,进入研究环节,确认共同原因。
- 若为长期决策或指导,进入决策捕获环节。
- 若无持久性缺口,则继续工作,不新增文件。
- 对重复失败,修复原因及现有的确定性预防措施。
- 判断是否已有足够的可执行预防:若有,则用原始失败用例加邻近有效用例验证;若无且已证明存在局限,则按 Writing Great Skills 进行最小的流程性修复,再进行验证。
- 对决策捕获,检查权限、适用性与未来可检索性。
- 记录实际结果,恢复当前阶段。
重复失败与预防
重复性判断需要比较实际尝试、失败边界与条件;仅错误措辞相同不足以判定重复。在再次进行类似重试前,应使用 Research 获取区分性证据。首次确认的假通过或受保护边界缺陷,仍应立即通过其当前责任方修复。
预防的优先顺序为:移除原因 → 修复现有的不变量/类型/测试/检查器/lint/hook/CI → 添加最小的缺失确定性检查。应复用项目原生工具。新增脚本仅在存在反复出现的脆弱逻辑,或现有命令无法检查所需边界时才需要;不应为每次事件新增检查器。
证明要求:真实的违规用例必须在修复前失败、修复后通过;邻近的有效用例必须保持有效。检查应放在复发会被捕获的位置,保留必需的关卡,并说明覆盖范围限制。不得削弱检查,也不得在未检查结果的情况下把通过的命 令当作证明。
技能作为最后手段
技能仅用于可执行预防无法充分覆盖的部分。需从证据出发说明该局限;在新增技能前应先复用或修复现有技能。应遵循 Writing Great Skills,包括其修复路径。规范位置为 .agents/skills/<name>/SKILL.md;只有必要的 references/scripts 才放在其旁边。
行为证明要求:演练原始请求加邻近的有效/非触发用例。触发条件、权限、操作顺序或完成条件发生实质变化时,需要实际执行智能体;仅做措辞或元数据检查不足。需验证未来的消费者在相关时能触达该规则。失败或未知的证明保持未完成状态;绝不承诺普遍不再复发。
应用与继续
决策/指导以简洁的 ADR 捕获。在应用过往教训前,应检查相关的已接受 ADR;当前用户指令与经验证的适用性起决定作用。代码与决策冲突可能是产品回归,而非文档过时。
范围:经授权的本地预防通过 HE Build 连同受影响的检查继续;发布后的编辑需要新的证明,并需单独授权的 HE Ship 交付。源工具包/全局/跨项目变更需要其自身已有的授权。
进度:在受影响的阶段修复风险;学习不会夺取无关工作。没有有用的持久性缺口,就不新增产物。缺少证据或授权时,在现有计划中保留具体的下一步行动。检查点、ADR 或技能永远不能替代实现与证明。
适用场景
- 同一失败反复出现,需要确认共同原因并建立预防。
- 需要将长期有效的决策或指导以 ADR 形式保存。
- 需要判断是否应新增技能,或复用/修复现有技能。
- 需要验证预防措施是否真正覆盖复发场景。
限制
- 检查点本身不确立重复性、原因或修改权限。
- 技能仅作为可执行预防无法覆盖时的最后手段。
- 不得承诺普遍不再复发。
- 缺少证据或授权时,只能保留下一步行动,不能擅自扩大范围。
- 关于收费、价格、平台支持等具体信息,资料中暂未提供。