AGENTSmd
可以先理解为:用入口指令组织AI开发上下文
AGENTSmd 像贴在工作室门口的说明牌。新来的 agent 先看它,才知道哪里能动、哪里不能乱动。
关键结构图
一张入口卡片分成项目、文档、命令和停止规则四块。
What
AGENTSmd 是给 AI agent 的项目入口说明,让它先读懂边界再动手。
AGENTSmd 是面向 AI 协作的入口文档。它告诉 agent 项目是什么、文档在哪里、有哪些规则、哪些事情需要停下来确认。
StructureAGENTSmd = 项目地图 + 工作规则 + 停止边界
When
当一个项目会被多个 agent 或多轮对话接手时,AGENTSmd 能显著降低上下文丢失和误操作。
How
写清项目一句话、文档地图、技术命令、数据边界和停止规则。让后续 agent 能快速进入正确路径。
Examples
Bricks Planet 的 AGENTSmd 明确不碰 raw 1000 Bricks,不把外部工作台放回运行时链路。
一个网站项目的 AGENTSmd 可以告诉 agent 先读 PRD、DESIGN 和 ARCHITECTURE,再开始改代码。
来源
类型:项目实践模型 / AI 协作实践
事实线:AGENTSmd 是 Bricks Planet 项目把项目地图、工作规则、数据边界和停止条件写给 AI agent 的入口文件形态。
依据:Bricks Planet 与 First Flight 的多轮 AI 协作实践,以及 AI coding agent 在项目根目录读取 repo-level instructions 的工程协作模式。
边界:这是项目协作入口,不是所有团队都必须采用的行业标准;不同项目可以用其他文件名和规则结构。
常见误读:不要把 AGENTSmd 当成给人看的普通 README;它的重点是约束 agent 在不完整上下文里如何安全行动。