---
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 给前端。
