为此仓库创建或更新 `AGENTS.md`。

目标是一份精简的指令文件，帮助未来的 OpenCode 会话避免错误并快速上手。每一行都应回答："没有帮助的情况下 Agent 很可能会遗漏此项吗？"如果不会，就省略掉。

用户提供的关注点或约束条件（请遵守）：
$ARGUMENTS

## 如何调研

首先阅读最高价值的资料：
- `README*`、根清单文件、工作区配置、锁定文件
- 构建、测试、lint、格式化、类型检查和代码生成配置
- CI 工作流及 pre-commit / 任务运行器配置
- 现有的指令文件（`AGENTS.md`、`CLAUDE.md`、`.cursor/rules/`、`.cursorrules`、`.github/copilot-instructions.md`）
- 仓库本地 OpenCode 配置，如 `opencode.json`

如果在阅读配置和文档后架构仍不清晰，检查少量代表性代码文件，以找到真正的入口点、包边界和执行流程。优先阅读解释系统如何组合在一起的文件，而不是随机的叶子文件。

优先选择可执行的真相来源而非文本描述。如果文档与配置或脚本冲突，以可执行来源为准，并只保留你能验证的内容。

## 提取什么

寻找对在此仓库中工作的 Agent 最有价值的信号：
- 确切的开发者命令，尤其是非显而易见的命令
- 如何运行单个测试、单个包或一个聚焦的验证步骤
- 有顺序要求时的必要命令顺序，如 `lint -> typecheck -> test`
- 单体仓库或多包边界、主要目录的归属关系、以及真正的应用/库入口点
- 框架或工具链的特殊之处：生成的代码、迁移、代码生成、构建产物、特殊的环境加载、开发服务器、基础设施部署流程
- 仓库特定的风格或工作流约定（与默认值不同之处）
- 测试的特殊之处：测试夹具、集成测试先决条件、快照工作流、所需服务、不稳定或耗时的测试套件
- 来自现有指令文件中值得保留的重要约束

好的 `AGENTS.md` 内容通常是需要通过阅读多个文件才能推断出的来之不易的上下文。

## 问题

仅当仓库无法回答某些重要问题时才向用户提问。最多使用 `question` 工具进行一次简短的提问。

好的问题：
- 未文档化的团队约定
- 分支 / PR / 发布预期
- 已知但未记录的缺失设置或测试先决条件

不要询问仓库已经明确说明的任何内容。

## 写作规则

仅包含高信号、仓库特定的指导，例如：
- Agent 否则可能会猜错的确切命令和快捷方式
- 从文件名无法直观看出架构说明
- 与语言或框架默认值不同的约定
- 设置要求、环境特殊之处和操作坑点
- 对重要的现有指令来源的引用

排除：
- 通用的软件建议
- 长教程或详尽的文件树
- 显而易见的语言约定
- 推测性声明或任何你无法验证的内容
- 更适合通过 `opencode.json` `instructions` 引用存储在另一个文件中的内容

如有疑问，则省略。

倾向于使用简短章节和要点。如果仓库很简单，保持文件简单。如果仓库很大，总结少数几个真正改变 Agent 工作方式的结构性事实。

如果 `${path}` 下已存在 `AGENTS.md`，则就地改进，而不是盲目重写。保留已验证有用的指导，删除冗余或过时的声明，并与当前代码库保持一致。