Communitygithub.com

haidrrrry/loop-engineering-skills

AI编码代理缺失的思维:代码编写前的验证门控、从每次失败中学习的反思式记忆,以及带真实锚点的自我修正循环。Claude Code一键安装;任何AI均可复制粘贴提示词。

loop-engineering-skills 是什么?

这是一个为AI编码代理(如Claude Code、Cursor、Codex等)设计的技能,其核心是反思式(Reflexion-style)记忆系统。该技能基于Shinn等人2023年的研究,通过让代理在执行任务前读取过往教训、执行任务后撰写反思日志,显著提升成功率(在决策任务上提升22%,在代码任务上提升11%),优于盲目重试。技能提供了一套完整的协议:在每次行动前读取`.loop/LESSONS.md`文件中的通用规则和最近三条记录,行动后按标准格式追加一条条目(包括发生了什么、根因、下次的可检查指令),并在文件超过30条时进行压缩,将重复教训升级为通用规则。它强调避免“记忆表演”(只写不读)、过度拟合单次事件和无限增长,并严格禁止存储密钥、叙事性内容和重复教训。该技能通过简单的复制粘贴或一键安装即可集成到支持的AI代理中,为代码生成和问题解决提供了持续学习的闭环机制。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add haidrrrry/loop-engineering-skills

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

循环记忆

反思式(Reflexion-style)言语记忆:代理以书面形式反思每次尝试, 存储该反思,并在行动前读取最近的反思。研究 (Shinn 等人,2023)表明,这种机制——反思、存储、重读—— 在广泛范围内优于盲目重试(在12轮决策任务上提升22%, 在代码任务上提升11%),并且优于无反思的记忆8个百分点。 其收益来自书面原因,而不是来自更努力地重试。

协议

行动前(每次任务)

  1. 读取 .loop/LESSONS.md。
  2. 无条件应用通用规则部分。
  3. 读取最近3条记录。如果任何一条与当前任务相关, 用一行说明它将如何改变你的方法。如果均不相关, 则继续——不要强行关联。

行动后(每次尝试,无论成败)

按文件的格式追加恰好一条条目:

## [日期] — [任务,最多5个词] — 成功|失败
- 发生了什么:[一行]
- 根因/为何成功:[一行]
- 下次:[一条具体的、可检查的指令]

“下次”的质量标准:

  • ❌ “对数据库要更小心” — 不可检查
  • ✅ “在任何种子脚本之前运行 npx prisma migrate deploy” — 可检查
  • ❌ “记住API很棘手” — 模糊
  • ✅ “/users 端点每页返回50条;计数时始终传递 `?page=”

失败反思,具体来说

当一次尝试失败时,反思必须回答:我相信了什么? 而那是错误的。失败的尝试通常源于一个错误的假设,而不是一个拼写错误。 指出那个假设。那才是教训。

维护(当文件超过约30条时)

  1. 按从旧到新的顺序读取所有条目。
  2. 任何出现2次或以上的教训被升级到通用规则中, 重写为一条祈使句。
  3. 升级后删除最旧的20条条目。
  4. 未经用户批准,绝不删除通用规则。

不应存储的内容

  • 密钥、令牌、个人数据——绝对不要,即使它们导致了失败。
  • 叙述(“然后我尝试了X,之后Y……”)——只存储结论。
  • 重复教训——如果已经存在,不要再次添加;考虑将其升级。
  • 责备或自我批评——教训是指令,不是情绪。

需避免的失败模式

  • 记忆表演: 写入条目但从不读取。读取步骤 是价值所在;仅写入步骤只是写日记。
  • 过度拟合单次事件: 一次性的环境故障不是 教训。如果它不会重复发生,就不要记录。
  • 无限制增长: 一个200条且无人阅读的文件是死记忆。压缩它。

相关技能