45 lines
1.6 KiB
Plaintext
45 lines
1.6 KiB
Plaintext
|
---
|
|||
|
|
description: 减少盲目搜文件、控制 Read 次数与 token 消耗
|
|||
|
|
alwaysApply: true
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Agent 探索约束（省 token）
|
|||
|
|
|
|||
|
|
## 开始前
|
|||
|
|
|
|||
|
|
1. 读根目录 `AGENTS.md` 的「代码地图」与「问题 → 文件」表
|
|||
|
|
2. 架构/API 全览只读 `docs/project/nexus-functional-development-guide.md`（或用户指定的 §），禁止为找结构全库 Grep
|
|||
|
|
3. 用户已给出路径/文件名时，只读该路径，禁止扩大范围
|
|||
|
|
|
|||
|
|
## 搜索顺序
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
AGENTS.md / 功能指南 § → Grep（带 path）→ Read（≤3 个文件）→ 仍不够再扩一圈
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- **禁止**无 `path` 的全仓库 `Grep` / `Glob`（除非用户明确要求全库）
|
|||
|
|
- **Grep 优先于 Read**；Glob 只用于定位文件名，不逐个 Read 全部匹配
|
|||
|
|
- 同一任务 **Read 不超过 5 个文件**；找到答案后立即停止
|
|||
|
|
- 不要重复 Read 已在本对话出现过的文件
|
|||
|
|
|
|||
|
|
## 分层定位（禁止跨层乱搜）
|
|||
|
|
|
|||
|
|
| 层 | 路径 |
|
|||
|
|
|----|------|
|
|||
|
|
| HTTP 路由 | `server/api/<module>.py` |
|
|||
|
|
| 业务 | `server/application/services/` |
|
|||
|
|
| 数据访问 | `server/infrastructure/` |
|
|||
|
|
| 模型 | `server/domain/models/` |
|
|||
|
|
| 前端页 | `frontend/src/pages/` |
|
|||
|
|
| 前端路由 | `frontend/src/router/index.ts` |
|
|||
|
|
| 前端 API 客户端 | `frontend/src/api/` |
|
|||
|
|
|
|||
|
|
真实前端源码在 `frontend/src/`，不是 `web/app/*.html`（那是构建产物）。
|
|||
|
|
|
|||
|
|
## 文档索引
|
|||
|
|
|
|||
|
|
- 功能 SSOT：`docs/project/nexus-functional-development-guide.md`
|
|||
|
|
- 文档导航：`docs/README.md`
|
|||
|
|
- 本地路径/MCP：`docs/project/linux-dev-paths.md`
|
|||
|
|
- 运维（连机/exec）：用户 Skill `Nexus平台` 或 `docs/project/nexus-1panel-operations-knowledge.md`
|