用途：通过 AGENTS.md 文件为 OpenCode 定义自定义指令，把项目约定、工作流程与个人偏好注入 LLM 上下文，无需修改配置即可定制 OpenCode 行为。
主要能力：项目规则放于项目根目录 AGENTS.md，适用于该目录及子目录，可写入代码规范、架构、技术栈、团队约定、构建与部署流程，并提交 Git 共享；全局规则放于 ~/.config/opencode/AGENTS.md，用于个人编码偏好、沟通风格与工具偏好，不提交 Git。
使用方式：在项目根运行 /init 自动扫描项目结构、技术栈并生成 AGENTS.md，也可手动创建。若 AGENTS.md 已存在，/init 会追加而非覆盖。全局规则命令：mkdir -p ~/.config/opencode 与 touch ~/.config/opencode/AGENTS.md。还可在 opencode.json 的 instructions 字段引用本地文件、glob 模式或远程 URL（5 秒超时），如 CONTRIBUTING.md、docs/*.md、https://example.com/rules.md。
规则优先级：本地 AGENTS.md（其次 CLAUDE.md）、全局 ~/.config/opencode/AGENTS.md（其次 ~/.claude/CLAUDE.md）、opencode.json 中 instructions 引用的文件，各类首个匹配生效，匹配文件合并入最终上下文。可通过环境变量禁用 Claude Code 兼容：export OPENCODE_DISABLE_CLAUDE_CODE=1 或 export OPENCODE_DISABLE_CLAUDE_CODE_PROMPT=1。
限制与建议：AGENTS.md 不会自动解析文件引用；需用 opencode.json 或手动指示模型按需读取。规则应简洁、可执行，避免通用编程概念、标准文档重复、时效信息与密钥。规则未生效时可检查文件名大小写、位置、Markdown 语法并重启会话。参考文件与示例（file-locations.md、writing-guide.md、advanced-patterns.md 及 examples/ 目录）暂未提供具体内容。