用途：在创建、审计或修订 AGENTS.md 前阅读，指导如何为编码智能体编写仓库级与嵌套级指令文件。
主要能力与原则：先检查目标范围、适用的祖先文件、相关嵌套文件，以及足以验证拟议指导的代码或配置；判断目标是普通存量仓库根目录、嵌套子树、绿地产品指导，还是个人与全局策略。每条规则应放在最近且持久的归属位置；能用代码、配置或可执行检查强制执行的，优先采用；面向人的解释留在 README 或相应文档中。AGENTS.md 用于非显而易见的意图、约束、风险、归属边界，以及会改变智能体加载或行为的指针。
嵌套文件：仅用于真实的局部差异，如子树归属、公共 API 或导入边界、生成或冻结区域、必需包装器或本地工具、放置陷阱、仅子树使用的技能或文档，以及智能体无法低成本推断的重复错误。不要用于任务历史、实现摘要、目录导览或重复祖先指导。
写法：目标文件以第一条有用规则或范围声明开头，直接以“你”称呼阅读的智能体；除非目标运行环境要求，否则不加文件名标题、目的前言、frontmatter 或包装。语气与范围匹配：普通存量根目录和嵌套文件用紧凑、机器优先的条目或明确片段；个人与全局文件可用第一人称、幽默、隐喻和独特声音；绿地指导可保留表达性的创始人语言。表达性段落须具体且影响决策，删除不改变任何行为的通用激励与装饰。
限制：不要罗列技术栈、源码树、包脚本、常规命令、任务历史或代码配置中廉价可见的行为；仅当命令的选择、时机、包装、例外或危险会改变智能体行为时才收录。保留用户撰写的意图与本地术语；删除可能削弱模糊的根、全局或个人策略时，应保留或询问。本地核实路径、命令、归属、工具名与声称的约定，不把猜测、一次性观察或当前任务细节提升为长期规则。普通存量根目录约 20 行，嵌套文件 1 至 10 行；超过 40 行视为可疑，超过 100 行视为放错位置的文档，除非有强上下文证明。绿地与个人文件在承载别处没有的持久意图时可更长。完成标准：每一保留行都改变行为、保留意图或路由必要上下文，事实与仓库真实一致，嵌套指导仅为限定范围的差异。