# 开发准则

## 驾驭约束

* **开始任务前先明确任务内容**：不允许为了不报错正确而随意修改架构/目录/接口，不允许为了结果不报错而随意修改测试用例
* **先读文档再动手**：涉及架构/目录/接口的修改，必须先读 `docs/design.md`
* **只实现当前要求的**：禁止预建未来可能需要的模块、方法、字段
* **最小改动范围**：每次只改最少的文件，改完一批确认一批，不要一口气创建大量文件
* **改前先读**：编辑任何文件前必须先 `read_file` 确认当前内容（用户可能已手动修改）
* **禁止 `npx tsx -e` 内联测试**：测试代码统一写到 `packages/tests/src/` 下，用 `pnpm test` 运行
* **改后必验证**：代码改动后运行 `pnpm test`，确保用例全通过

## 代码风格

* 不得为简单的需求过度抽象和设计
* 简单功能不需要写注释
* 临时文件统一放在 `tmp` 目录下，且必须在 `.gitignore` 中忽略