simple-template/.codex/skills/agileboot-backend-feature/SKILL.md

---

name: agileboot-backend-feature

description: 在 AgileBoot/Spring Boot 项目中开发新的后端业务功能，并严格按照当前仓库已有架构组织代码。适用于新增或修改后台管理端模块、CRUD 功能、业务流程、数据库资源、Controller、ApplicationService、领域模型、Command、Query、DTO、MyBatis Plus Entity/Mapper/Service、权限、操作日志和测试；必须先阅读项目后端开发规范并复用既有分层方式，而不是使用通用 Spring 三层写法。

AgileBoot 后端业务功能开发

本 skill 是 Codex 的执行入口，不是完整规范副本。完整规范以 docs/backend-feature-development.md 为准。

必读

• docs/backend-feature-development.md
• AGENTS.md

执行要求

1. 先阅读必读文档。
2. 再检索并阅读最相似的现有后端模块，优先看 post、user、role、notice 和 admin/controller/system。
3. 按 docs 中的架构、目录、类型边界、权限、日志、异常和测试规则实现。
4. 如果 docs 未覆盖某个决策，先参考现有模块；不要自行引入新架构风格。
5. 完成后按 docs 的验收清单自检，并运行相关 Maven 测试或说明未运行原因。

不要做

• 不要把本文当成规范来源来扩写；需要补充规范时更新 docs/backend-feature-development.md。
• 不要绕过 Controller -> ApplicationService -> Model -> db Service/Mapper。
• 不要直接返回 Entity 或 DO 给前端。