标准仍然是：连续两周还在用，才写进来。

1. 工具宁少勿滥

每次加工具前问：没有它，任务是否真的完不成？
少工具的 Agent，描述更准，乱调更少。

2. 过程日志当一等公民

不只记最终答案，要记：

  • 用了哪个工具
  • 关键参数
  • 失败原因
  • 重试次数

没有轨迹，线上问题基本靠猜。

3. 失败降级路径

工具连续失败就停自动重试，改成：

  • 结构化失败说明
  • 可选下一步（换参/换工具/人工粘贴）

这比继续堆提示词稳定。

4. 回传契约

子 Agent、检索工具、外部 MCP，都要求短输出格式。
没有契约，上下文隔离是假的。

5. 高危操作收口

写文件可以，外发/删除默认要确认。
Agent 越能干，越要把「不可逆动作」收窄。

为什么不是「十大框架」

框架会换名，组件习惯能带走。
这五条不管用 LangChain、LangGraph 还是自己写循环，都成立。

下次更新条件

如果某个习惯连续失效，我会删掉并写一篇为什么翻车。
清单应该变准，而不是变长。