41 lines
2.0 KiB
Markdown
41 lines
2.0 KiB
Markdown
# 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 与验证
|
||
|
||
- 当前项目支持最小 memory：使用 `/remember` 保存长期信息，使用 `/memory` 查看。
|
||
- session 是原始对话历史，不直接拼进 system prompt；memory 才作为长期补充进入 prompt。
|
||
- 默认语言：中文优先。
|
||
- 默认验证：优先做最小可验证检查，不夸大成功状态。
|
||
|
||
## 工具偏好
|
||
|
||
- 需要按文件名或路径模式查找时，优先使用 `Glob`。
|
||
- 需要搜索文件内容时，优先使用 `Grep`。
|
||
- 修改已有文件内容时，优先使用 `Edit`。
|
||
- 创建新文件时，优先使用 `Write`。
|
||
- 只有在确实需要复杂 shell 特性时才使用 `Bash`。
|
||
- 不要用 `Bash` 拼接文件内容。
|
||
- Windows 环境下优先使用兼容写法，不默认使用 `cat <<EOF`、`ls -la` 等 Unix 风格写法。
|