refactor: add docs and skills

2026-05-12 14:07:54 +08:00
parent e9eb0eaef8
commit 50a36e2241
7 changed files with 429 additions and 0 deletions
@@ -0,0 +1,27 @@
+---
+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 给前端。