ds-lessons

ds-lessons

Agent 可以跳过的指令只是愿望。要让重复犯错立刻暴露出来。

步骤

1. 收集错误。阅读当前会话、近期提交、回退、审查评论、Agent 指令文件和变通方案评论。将它们归类。某类错误发生两次后，才算成立。
2. 对每一类，选择有效的最高层级：
   1. 结构：每份状态只有一个所有者，每项任务只有一种受支持的做法，隐藏内部实现，删除 Agent 会照搬的旧模式。
   2. 类型：让错误状态无法写入。
   3. Lint 或 CI 检查：错误消息指出应使用的正确文件、类型或函数。如果错误模式已经很常见，只对新增内容报错。
   4. 测试：检查行为，而非内部实现。
   5. 文档或 Agent 规则：仅用于无法检查的判断。添加一个简短的失败示例。
3. 立即修复发生频率最高的错误类别，每类单独提交一次。
4. 证明每项新检查有效。重新引入一个真实的过往错误，运行检查并确认失败。然后移除错误并确认通过。
5. 在 Agent 指令文件中维护一张表：规则及其执行方式。如果规则已经存在，但没有任何机制执行，就将其视为重复错误，立即加以执行。
6. 会话结束时反思：列出出了什么问题、哪些地方多花了几轮，以及用户纠正了什么。将每项归入检查、技能修改或规则。舍弃一次性问题。

停止条件

• 每个选定的错误类别都有一项已通过真实错误验证、并确认会失败的执行机制。
• 或者本次会话已处理排名前三的错误类别。记下其余类别。

规则

• 如果修复方式是结构调整，就不要再添加说明文字。说明文字只是症状。
• 报告每个错误类别的证据、所选层级，以及更高层级为何不适用。