refactor: add docs and skills

This commit is contained in:
gin
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 给前端。
@@ -0,0 +1,4 @@
interface:
display_name: "AgileBoot 后端功能"
short_description: "按现有 AgileBoot 架构组织后端业务功能开发流程"
default_prompt: "Use $agileboot-backend-feature to develop a new admin backend business feature following this repository's existing architecture."