CLAUDE.md and Agents.md Explained: Stop Repeating Yourself to AI

章节 1：引言：上下文工程与“复利工程”理念

📝 本节摘要：

本节作为全篇的开场，Alex 提出了核心概念——上下文工程（Context Engineering）。他引用了 Anthropic 的官方指南和 GitHub 对 2500 多个仓库的分析，旨在解决 AI 辅助编程中“重复劳动”的问题。本节重点介绍了“复利工程”（Compounding Engineering）的定义：即通过每一次互动教会 AI 你的模式和偏好，使其随时间推移变得越来越聪明，从而从被动反应转变为主动出击。同时，他还梳理了不同工具（Claude.md, Agents.md, Cursor rules）中通用的“持久化上下文”机制。

[原文] [Alex]: in my top 10 video I said context is king and a lot of you asked for the deep dive how do you actually do context engineering what goes into these markdown files or rule files how do you structure them so that the AI stops making the same mistakes

[译文] [Alex]: 在我的“十大技巧”视频中，我说过上下文为王，你们很多人要求进行深入探讨：究竟如何进行上下文工程（context engineering）？这些 markdown 文件或规则文件中应该包含什么？如何构建它们以便 AI 不再犯同样的错误？

[原文] [Alex]: today I'm going all in on this this is the ultimate guide to rule files for your AI assisted coding let's go

[译文] [Alex]: 今天我将全力以赴探讨这个问题，这是针对你的 AI 辅助编程的规则文件的终极指南，我们要开始了。

[原文] [Alex]: hey Alex here from Grit AI Studio anthropic just published their official guide to Claude MD files and GitHub analyzed over 2,500 repositories to find what actually works and I'm going to break down exactly how to build these files step by step so you can stop repeating yourself and start getting consistent results

[译文] [Alex]: 嘿，我是来自 Grit AI Studio 的 Alex。Anthropic 刚刚发布了关于 Claude.md 文件的官方指南，GitHub 分析了超过 2,500 个仓库以找出真正有效的方法，我将逐步拆解如何构建这些文件，这样你就可以停止自我重复，开始获得一致的结果。

[原文] [Alex]: if you watch the 10 tips video you know I'm obsessed with compounding engineering the idea that every interaction should teach your AI tools your patterns your preferences your corrections over time they generate better code with less guidance eventually we move from reactive to proactive

[译文] [Alex]: 如果你看了那个“十大技巧”视频，你就知道我痴迷于“复利工程”（compounding engineering），即每一次互动都应该教给你的 AI 工具你的模式、你的偏好、你的纠正，随着时间的推移，它们能在更少的指导下生成更好的代码，最终我们从被动反应转变为主动出击。

[原文] [Alex]: these rule files play a big role in how you make that happen they're the foundation of compounding engineering set them up right and every future session starts smarter set them up wrong or not at all and you're back to explaining the same things over and over again ai slop waiting to happen

[译文] [Alex]: 这些规则文件在你如何实现这一目标中扮演着重要角色，它们是复利工程的基础。如果设置得当，每一个未来的会话开始时都会更聪明；如果设置错误或根本不设置，你就只能一次又一次地解释同样的事情，这简直就是等着产生 AI 垃圾（AI slop）。

[原文] [Alex]: claude MD is Antropics approach for Claude code it lives in your repository and Claude reads it at the start of every conversation it becomes part of the system prompt persistent context loaded automatically

[译文] [Alex]: Claude.md 是 Anthropic 针对 Claude Code 的解决方案，它存在于你的仓库中，Claude 会在每次对话开始时读取它，它变成了系统提示词的一部分，即自动加载的持久化上下文。

[原文] [Alex]: agents MD is equivalent for GitHub copilot or codeex just to name a few and cursor rules work similar in cursor same concept but different file name cursor also support claude MD files

[译文] [Alex]: Agents.md 是 GitHub Copilot 或 Codex 等工具的等效文件，仅举几例；Cursor 规则（Rules）在 Cursor 中的工作方式也类似，概念相同但文件名不同，Cursor 也支持 Claude.md 文件。

[原文] [Alex]: the underlying principle is identical across all of them give persistent context so you stop repeating yourself whatever tool you're using these principles apply

[译文] [Alex]: 它们的基本原理都是一样的：提供持久化上下文，这样你就不用重复自己了。无论你使用的是什么工具，这些原则都适用。