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