R524809
1.1 KiB
1.1 KiB
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. 代码注释
- 新增或修改的代码注释必须使用中文；注释应说明职责、边界或不易从代码直接看出的业务约束，避免逐行复述实现。