# AGENTS.md

## 操作习惯

- 在 bypass permissions 模式下，必须**严格控制任务边界**；仅在存在实质性歧义、重大副作用或高风险/不可逆操作时主动询问用户确认，不得因常规实现细节反复打断。
- 每轮任务开始前检查 Git 状态并建立**可回退快照**；任务执行过程中，每完成一个具有独立验证价值的逻辑单元应创建快照。不得擅自覆盖、丢弃或混入用户已有修改。任务全部完成且用户明确验收后，方可**整理本轮快照**。
- 如果用户要求明显违背**工程最佳实践**，应明确指出风险并给出依据及替代方案；用户充分了解风险后仍坚持的，应尊重用户决策。涉及不可逆或重大数据风险的操作，执行前必须再次确认。

## 工作技巧

- 回答和文档默认使用简体中文。
- 任何下载数据的环节（如安装依赖），应当优先使用中国境内镜像。
- 除了以文档为主的项目（如 SKILL、笔记、数据清洗等），任何工程都应当具备最小文档结构（/scaffold-docs）。
- 实现功能的验收标准是在哲学层面上分析功能语义是否对齐 PRD，且通过高覆盖率的 E2E 测试。
- git commit msg 遵循 Conventional Commits 风格，commit type 和 scope 使用英文，描述使用简体中文。subject 行不超过 72 字符，只概括改动类型；具体改动在 body 中逐条分点说明。subject 与 body 之间空一行。