大多数人把 CLAUDE.md 写反了

Reddit r/AI_Agents 工具

摘要

本文指出,大多数 CLAUDE.md 文件都是“倒着写”的,里面堆满了过往失败的规则,而非精简的前瞻性上下文。文章主张只保留少量核心内容:当前目标、身份设定以及那些隐蔽但依然活跃的故障模式。

**每一份** **CLAUDE.md** **我接手过的(或在仓库截图中看到的,或从零搭建的)都有着相同的形态:一份错误清单。** **“不要对 ID 使用裸字符串。”“调用 Y 前务必检查 X。”“数据库对并发写入不友好。”三个月的生产事故,被格式化成了操作指令。** **文件靠不断堆砌而膨胀。每次出点问题,就加一条新规则。Agent 每次运行都要把它们全读一遍。这不是上下文工程,这是伤疤登记册。** **模型不需要知道所有出过的错。它只需要知道:** **- 它现在要做什么(目标 + 当前任务)** **- 它是谁(身份设定 + 约束条件,最多 3-5 行)** **- 3-5 个真正隐蔽且依然活跃的故障模式** **其余的都是它在干正事之前被迫阅读的噪音。** **倒写的问题在于:** **CLAUDE.md** **文件是基于过去编写的。“这是我学到的经验。”这对事故复盘很有用,但对运行上下文却很糟糕。运行上下文应该正向编写——基于我们当前的实际状况,告诉你今天要把事情做好所需的最少信息。** **最精简的** **CLAUDE.md** **只要能真正促成高效工作,永远胜过那份让你引以为傲的冗长文档。** **你的结构是怎样的?具体来说:你如何决定哪些内容配得上成为永久规则,哪些该放进单次会话的上下文文件中?**
查看原文

相似文章

multica-ai/andrej-karpathy-skills

GitHub Trending (daily)

一个单独的 CLAUDE.md 文件,实现了四项原则,以改进 Claude Code 的编码行为,源自 Andrej Karpathy 对 LLM 编码陷阱的观察。