R524809
19 lines
1.1 KiB
Markdown
19 lines
1.1 KiB
Markdown
# AGENTS.md — 工作区工作约定
|
||
|
||
本工作区的 AI 会话必须遵守以下规则，优先级高于会话内的自行判断。
|
||
|
||
## 1. 可修改全部项目代码
|
||
|
||
- 可按任务需要修改 `apps/web/`、`apps/api/`、`apps/worker/`、`apps/extension/`、`packages/` 及相关文档。
|
||
- 修改应遵守 `docs/project/development-collaboration-contract.md` 中的领域边界、API 契约、数据安全与验证要求；跨领域改动须明确说明影响范围。
|
||
|
||
## 2. 不要启动服务端和 Worker
|
||
|
||
- API（NestJS）和 Worker 由维护者自行在其他地方启动，AI 不需要也不应该启动、重启或杀死它们。
|
||
- 开发/验证时若检测到 API 或 Worker 未运行，直接在回复中说明即可，不要尝试代为启动。
|
||
- 前端 Vite dev server 可为验证目的临时启动，用完后应停掉，并避免占用维护者已在使用的端口（如 5173/8200）。
|
||
|
||
## 3. 代码注释
|
||
|
||
- 新增或修改的代码注释必须使用中文；注释应说明职责、边界或不易从代码直接看出的业务约束，避免逐行复述实现。
|