# AGENTS.md

这是当前 workspace 的项目级规则文件。

## 工作区规则

- 当前 workspace 是默认操作边界，不应主动读写工作区外文件，也不应主动探索无关路径。
- `AGENTS.md`、`SKILLS/` 与代码文件都属于当前 workspace 输入，不属于程序内置 prompt。
- 行动时必须以运行时注入的环境信息为准，特别是平台、shell、workspace 和可用工具列表。
- 对运行时已明确注入的信息，默认直接使用；除非用户明确要求验证，否则不要再次用 Bash 查询当前目录、平台或类似已知状态。
- 当前 harness 是极简实现，优先最小动作，不做不必要的重复试错。

## 交互规则

- REPL 内所有 slash command 由程序直接处理，不进入 agent loop。
- REPL 会显示当前模式提示符，例如 `build >` 或 `plan >`。
- `/clear` 是清空当前上下文的主别名，等价于 `/new`。

## 模式与权限

- 支持 `/mode build` 和 `/mode plan` 两种模式，`plan` 为只读规划模式。
- 写操作和 Bash 默认需要确认，可通过 `--auto-approve` 或 `/permissions auto-on` 跳过。
- 工作区外访问和 `plan` 模式限制属于硬性边界，不通过审批放行。

## Memory 与验证

- `AGENTS.md` 是项目规则文件，不用于保存长期项目知识或用户偏好。
- 当前项目支持结构化 memory：使用 `/remember` 保存长期知识，使用 `/memory` 查看。
- session 是原始对话历史，不直接拼进 system prompt；memory 才作为长期补充进入 prompt。
- 默认语言：中文优先。
- 默认验证：优先做最小可验证检查，不夸大成功状态。

## 工具偏好

- 需要按文件名或路径模式查找时，优先使用 `Glob`。
- 需要搜索文件内容时，优先使用 `Grep`。
- 修改已有文件内容时，优先使用 `Edit`。
- 创建新文件时，优先使用 `Write`。
- 只有在确实需要复杂 shell 特性时才使用 `Bash`。
- 不要用 `Bash` 拼接文件内容。
- Windows 环境下优先使用兼容写法，不默认使用 `cat <<EOF`、`ls -la` 等 Unix 风格写法。