code-generation

# Code Generation Skill — Forge 项目约定 ## 核心原则（Forge 强制规则） 1. **Design-First**: 无设计不编码。必须先读架构设计（C4/ADR）、详细设计、API 契约、数据库 Schema 2. **Convention-First**: 编码前先加载 Foundation Skills，读 2-3 个同包已有文件了解本地模式 3. **实现 + 测试同步**: 每个代码单元必须同时生成测试，禁止无测试代码提交 4. **增量生成**: 不重写已有代码，只修改设计要求的部分，保留未变更区域的注释和格式 5. **编译验证**: 提交前必须验证编译通过（`./gradlew compileKotlin` 或等效命令） ## 生成流程 ``` 读设计 → 生成清单 → 数据层 → 服务层 → API 层 → 测试 → 编译验证 → Baseline 检查 ``` ### 生成清单模板 | 设计元素 | 代码产出 | 测试产出 | |----------|----------|----------| | Entity 类图 | Entity + Value Object | Entity 单元测试 | | Repository 接口 | Repository 接口 + 实现 | Repository 集成测试 | | Service 序列图 | Service 类 + 方法 | Service 单元测试 | | Controller 端点 | Controller + DTO + Mapper | Controller 集成测试 | | 错误场景 | Exception 类 + Handler | 错误处理测试 | | 数据库 Schema | Migration 脚本 | Migration 验证测试 | ## 代码质量规则 1. 编译无错误 2. 所有测试通过 3. 无 TODO/FIXME（必须关联 Issue） 4. 无注释代码（git 有历史） 5. 无未使用 import 6. 有意义的命名 7. 函数单一职责 8. 错误消息含上下文（ID、值） 9. 日志级别恰当：INFO=业务事件 / DEBUG=细节 / ERROR=故障 10. 无硬编码值 ## 增量生成检查清单 - [ ] 变更集只含新建/修改文件 - [ ] 已有文件未变更部分完全保留 - [ ] 新代码遵循相邻代码模式 - [ ] Import 排序符合项目约定 - [ ] 文件位置符合包结构 - [ ] 无重复逻辑（复用已有工具类） ## 验证脚本 - `scripts/compile_check.py` — 检测常见编译错误（括号匹配、缺失声明） - `scripts/import_check.py` — 检测未使用 import 和通配符 import - `scripts/naming_check.py` — 检测命名规范违规（PascalCase/camelCase/UPPER_SNAKE）