SuperAPI AI 工具集

he-learn

编程与开发

查看项目

更新于 10-16 10:18

技能介绍

he-learn(Hard Eng Learn)是一个工程学习类流程技能,来源为 sgaabdu4/appwrite-backend。它用于在失败反复出现、需要加强预防,或需要固化已接受决策时,提供判断与执行路径。

用途与输入 输入是当前任务,加上观察到的尝试与结果,或明确的决策/引导。技能复用其已有的授权与参与模式。Hook 检查点会请求这一判断,但检查点本身不构成“复发”的判定、原因认定,也不构成改动其他项目或全局记忆的许可。

产出 产出是:在最窄归属处经过验证的预防措施、一条适用的决策记录,或明确的 no-op/阻塞项。证明与待办工作保留在同一计划中,不新增学习台账,也不新增任务状态。若已有测试或文档已保存该教训,则无需重复记录。

流程概述 文档给出一个流程图,起点是“当前证据”,随后判断“发生了什么变化”:

  • 反复失败:进入研究环节,确认共同原因;修复原因与既有确定性防护;再判断可执行防护是否充分;若已证明存在局限,则按 Writing Great Skills 做最小的流程性修复。
  • 长期决策或引导:进入决策捕获。
  • 无持久缺口:不新建文件,继续。 之后检查授权、适用性与未来可检索性,记录实际结果并恢复当前阶段。

反复失败到预防 复发的定义参照 troubleshooting,包括再次进行类似重试之前所需的区分性证据。首次确认的假通过或受保护边界缺陷,即使尚未复发,也仍需通过其当前归属立即修复。

预防的优先顺序 移除原因 → 修复已有的不变量/类型/测试/检查器/lint/hook/CI → 添加最小的缺失确定性检查。复用项目原生工具。只有当反复出现脆弱逻辑,或既有命令无法检查所要求的边界时,才新增脚本;不为单个事件新增检查器。

证明要求 真实违规用例必须在修复前失败、修复后通过;相邻的有效用例必须保持有效。检查应放在复发会被捕获的位置,保留必需的关卡,并说明覆盖范围的限制。不得削弱检查,也不得在未检查结果的情况下把通过的命命令当成证明。

技能作为最后手段 仅当可执行预防无法充分覆盖时,才使用技能。需从证据说明该限制;新增前优先复用或修复已有技能。遵循 Writing Great Skills 及其修复路径。规范位置为 .agents/skills/<name>/SKILL.md,只有必要的 references/scripts 才放在旁边。

行为证明 需演练原始请求以及相邻的有效/不触发用例。触发条件、授权、操作顺序或完成定义发生实质变化时,需要实际执行智能体;仅检查措辞或元数据不足。需验证未来的使用者在相关时能触达该规则。失败或未知的证明属于未完成;不得承诺普遍不再复发。

应用与继续 决策/引导采用简短 ADR 记录。应用旧教训前,先检查相关的已接受 ADR;以当前用户指令与已验证的适用性为准。代码与决策冲突可能是产品回归,而非文档过时。

范围 已授权的本地预防在受影响检查的范围内通过 HE Build 继续;发布后修改需要新的证明,并经单独授权的 HE Ship 交付。源工具包、全局或跨项目更改需要各自已有的授权。

进展 在受影响的阶段修复风险;学习不应夺取无关工作。没有有用的持久缺口则不产生新产物。缺少证据或授权时,把具体的下一步动作保留在现有计划中。检查点、ADR 或技能都不能替代实现与证明。

分类 根据其围绕工程失败预防、测试、检查器与不变量修复的开发工程内容,归入 coding 类别。