Springboot Init Skill

What it does

When your agent uses it

• Tasks that involve Backend development
• Tasks that involve Authentication
• Tasks that involve NoSQL databases

Example prompts

• “帮我搭一个 Spring Boot 项目”
• “Spring Boot 脚手架”
• “Spring Boot 一键生成”
• “/springboot-init-skill”

Requirements

• Python 3
• Node.js
• A Bash shell
• Docker
• A credential in JWT_SECRET

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

1. 1检测 JDK 是否安装 / 版本（需 >= 17 LTS）
2. 2检测 Maven 是否可用（或生成 Maven Wrapper）
3. 3检测操作系统（Linux / macOS / Windows）
4. 4若未安装：给出明确的中文提示 + 下载链接（Adoptium / Oracle / Azul Zulu）
5. 5若已安装但版本过低：给出升级指引

What it can do on your machine

Read from SKILL.md and the folder at commit a4a640b. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/ (Batch and Shell, from the files we listed), which the agent can run.

  Shell commands in SKILL.md call:

  • curl
  • python
  • npm

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md. Its commands use curl and npm, which can reach the network depending on how they are called.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • JWT_SECRET

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Springboot Init Skill loads about 2.2k tokens when it runs, and up to ~32k if it reads all its reference files. Until then it costs about 122 tokens; SKILL.md has 478 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~122

When it runs · the whole SKILL.md, loaded when a task matches

~2.2k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~32k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NoteMentions a .env fileSKILL.md:79

  m.xml`、`application.yml`、`.env.example`、`.env`、`.gitignore`）

• NoteMentions a .env fileSKILL.md:91

  2. 从 `.env.example` 复制生成 `.env`（如不存在）

• NoteMentions a .env fileSKILL.md:130

  请编辑 .env 文件修改 JWT_SECRET（搜索 change-me）

• NoteMentions a .env fileSKILL.md:142

  - 表前缀：`wg`（可在 `.env` 中修改）

• NoteMentions a .env fileSKILL.md:199

  9. **`.env` 与 `.gitignore` 必须随脚手架一起生成，且 `.env` 中的配置必须被服务加载**：`application.yml` 通过 `${ENV_VAR:default}` 读取 `.env` 全部配置（Sp

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from jiushiwon/wg-skills at commit a4a640b, republished under its Apache-2.0 licence (© jiushiwon). 478 words, ~2,152 tokens.

name

springboot-init-skill

description

Spring Boot 项目一键初始化技能。面向零基础小白，提供环境探测、自动安装、完整 Web 骨架生成、SSE 流式框架、JWT 鉴权、统一响应封装、文件上传接口、一键启动/重启脚本、Swagger 文档，内置 MySQL（默认）/ PostgreSQL / MongoDB 数据库选择。用户只需说"帮我搭一个 Spring Boot 项目"即可一条命令完成从零到跑的完整链路。触发词："Spring Boot 脚手架"、"Spring Boot 一键生成"、"初始化 Spring Boot 项目"、"Spring Boot 快速开始"、"springboot init"、"搭建 Spring Boot 服务"、"Java Web 骨架"、"Spring Boot 开箱即用"、"Spring Boot 零基础"、"Spring Boot 小白"、"帮我搭一个 Spring Boot"、"新建 Spring Boot"、"create springboot project"、"springboot starter"。

1. 项目名叫什么？（默认 my-springboot-app）
2. 用哪个数据库？
   A. MySQL（默认，推荐）
   B. PostgreSQL
   C. MongoDB
   D. 暂时不用数据库
3. 是否需要 Redis？（默认不需要）

✅ 项目 {{project}} 生成完毕！

📁 生成的文件（约 25 个）：
  - 核心模块：Application.java, application.yml, common/*, config/*
  - API 路由：health / auth / users / sse / upload
  - 启动脚本：restart.sh, restart.bat（dev/prod 双模式）
  - 数据库：MySQL（已配置 docker-compose.yml，可选 PG / MongoDB / 无数据库）
  - 文档：api-contract.md, docs/project-guide.md

🚀 启动方式：
  开发模式：  ./restart.sh dev        （热重载，日志 logs/dev.log）
  生产模式：  ./restart.sh prod       （后台运行，日志 logs/app.log）
  默认：      ./restart.sh            （同 dev）

📖 接口文档：
  Swagger UI：  http://localhost:8080/swagger-ui.html
  OpenAPI 3：   http://localhost:8080/v3/api-docs

🔌 SSE 示例：
  curl http://localhost:8080/api/sse/chat

📎 上传示例：
  curl -F "file=@test.png" http://localhost:8080/api/upload

🔑 默认账号：
  注册接口：POST /api/auth/register
  登录接口：POST /api/auth/login

⚠️ 安全提醒：
  请编辑 .env 文件修改 JWT_SECRET（搜索 change-me）
  生产环境务必使用随机密钥（至少 256 位）！

# 1. 启动
./restart.sh dev &
# 2. 登录拿 token
TOKEN=$(curl -s -X POST localhost:8080/api/auth/login -H 'Content-Type: application/json' \
  -d '{"username":"admin","password":"admin123"}' | python -c "import sys,json;print(json.load(sys.stdin)['data']['accessToken'])")
# 3. 分页接口断言 list 字段存在且为数组
curl -s "localhost:8080/api/users?page=1&pageSize=10" -H "Authorization: Bearer $TOKEN" \
  | python -c "import sys,json;d=json.load(sys.stdin)['data'];assert 'list' in d and isinstance(d['list'],list),'分页字段必须是 list（非 items）';print('OK list=',len(d['list']))"

Spring Boot 脚手架、Spring Boot 一键生成、初始化 Spring Boot 项目、Spring Boot 快速开始、
springboot init、搭建 Spring Boot 服务、Java Web 骨架、Spring Boot 开箱即用、
Spring Boot 零基础、Spring Boot 小白、帮我搭一个 Spring Boot、新建 Spring Boot、
create springboot project、springboot starter

© jiushiwon, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 87 other files (scripts, references) in vibeCoding/backend/java/springboot-init-skill of jiushiwon/wg-skills.

• SKILL.md
• README.md
• SPEC.md
• demo/.env.example
• demo/.gitignore
• demo/.mvn/wrapper/maven-wrapper.jar
• demo/.mvn/wrapper/maven-wrapper.properties
• demo/Dockerfile
• demo/README.md
• demo/api-contract.md
• demo/docker-compose.yml
• demo/docs/project-guide.md
• demo/mvnw
• demo/mvnw.cmd
• demo/pom.xml
• demo/restart.bat
• demo/restart.sh
• … and 71 more

Open the folder on GitHubat commit a4a640b