Agent skill

Flycms Dev

by sunkaifei in sunkaifei/FlyCms

FlyCms 项目(backend/ Spring Boot 4.1.1 + frontend/ vue-vben-admin v5)的架构地图与开发规范总纲。凡在本仓库做任何开发——写后端接口、新增/修改模块、管理页面、数据库变更、修 bug、重构——都要先加载本 skill 再动手,即使用户只说"改一下""加个功能";前端登录/菜单/权限专项另见…

MITAuto-check passedBackend & APIs

Install Flycms Dev

skills CLI
$ npx skills add sunkaifei/FlyCms --skill flycms-dev -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sunkaifei/FlyCms flycms-dev --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sunkaifei/FlyCms.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/flycms-dev .claude/skills/flycms-dev && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
flycms-dev
GitHub stars
656
Token cost
~827 tokens
SKILL.md length
178 words
Files
3 (incl. references)
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

FlyCms 项目(backend/ Spring Boot 4.1.1 + frontend/ vue-vben-admin v5)的架构地图与开发规范总纲。凡在本仓库做任何开发——写后端接口、新增/修改模块、管理页面、数据库变更、修 bug、重构——都要先加载本 skill 再动手,即使用户只说"改一下""加个功能";前端登录/菜单/权限专项另见…

  • Works in 7 steps: DAO XML 统一放… → Controller 归位:前台页面 → web/front;管理后台页面(含… → 响应与分页:JSON 一律 DataVo(成功… → …
  • Tasks that involve Backend development
  • SKILL.md covers 项目一张图, 铁律(每条都有原因,违反即返工), 改完怎么验证(本项目无自动化测试,验证 = 编译 + 冒烟) and 禁止事项(防腐化边界)
  • Calls mvn and pnpm

What it does

Flycms Dev is an agent skill from sunkaifei/FlyCms. FlyCms 项目(backend/ Spring Boot 4.1.1 + frontend/ vue-vben-admin v5)的架构地图与开发规范总纲。凡在本仓库做任何开发——写后端接口、新增/修改模块、管理页面、数据库变更、修 bug、重构——都要先加载本 skill 再动手,即使用户只说"改一下""加个功能";前端登录/菜单/权限专项另见 flycms-frontend-access skill。

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/backend-conventions.md` and `references/tech-debt.md`).

It sits in Backend & APIs, covering Backend development. It works with Spring Boot, Vue.js, MySQL and Java. The repository describes itself as: FlyCms 是一个类似知乎以问答为基础的完全开源的JAVA语言开发的社交网络建站程序,基于 Spring Boot+Bootstrap3+MyBatis+MySql+Solr +Ehcache应用架构,专注于社区内容的整理、归类和检索,它集合了问答,digg,wiki…. The licence is MIT.

When your agent uses it

  • Tasks that involve Backend development

Example prompts

  • “Use the flycms-dev skill to flycm 项目(backend/ Spring Boot 4.1.1 + frontend/ vue-vben-admin v5)的架构地图与开发规范总纲。凡在本仓库做任何开发——写后端接口、新增/修改模块、管理页面、数据库变更、修…”
  • “/flycms-dev”

Workflow steps

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

  1. DAO XML 统一放 src/main/resources/mapper/(2026-09-29 G26 归位后的现行约定;文件名用 模块__XxxDao.xml 平铺)。application.yml 的 mapper-locations 扫…
  2. Controller 归位:前台页面 → web/front;管理后台页面(含 Freemarker 渲染 + 局部 @ResponseBody)→ web/system,视图一律 theme.getAdminTemplate("admin/xxx") 返回;给 vben…
  3. 响应与分页:JSON 一律 DataVo(成功 DataVo.success(message, data) 两参重载——单参重载有 message/data 分派陷阱);分页一律 PageVo(service 里 new…
  4. ID 与表:主键 SnowFlake.nextId()(core/utils/SnowFlake.java),表名 fly_ 前缀、bigint 主键。SQL 全部走 DAO XML 的 #{} 预编译,禁止字符串拼接。
  5. 校验与密码:入参用 jakarta validation 注解 + @Valid ... BindingResult 逐条 DataVo.failure(error.getDefaultMessage());密码存取只经…
  6. 权限闭环:/system/ 下的新端点自动被 AdminInterceptor 按 URL 权限拦截——上线前必须 GET /system/admin/permission_sync 注册 action_key 并在角色组勾选,否则所有人 403;/api/…
  7. 依赖卫生:新代码用 commons-lang3 / commons-io 等现代坐标;org.apache.commons.lang(2.x)只出现在遗留代码里,不要模仿。

What it can do on your machine

Read from SKILL.md and the folder at commit 3de5509. 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

    Shell commands in SKILL.md call:

    • mvn
    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, 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 no API keys, tokens, secrets or passwords.

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

Context cost

Flycms Dev loads about 827 tokens when it runs, and up to ~6.6k if it reads all its reference files. Until then it costs about 54 tokens; SKILL.md has 178 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~827
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.6k

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

Auto-check passed

The automated check found no risky patterns in SKILL.md.

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from sunkaifei/FlyCms at commit 3de5509, republished under its MIT licence (© sunkaifei). 178 words, ~827 tokens.

Download SKILL.mdSave it as .claude/skills/flycms-dev/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
flycms-dev
description
FlyCms 项目(backend/ Spring Boot 4.1.1 + frontend/ vue-vben-admin v5)的架构地图与开发规范总纲。凡在本仓库做任何开发——写后端接口、新增/修改模块、管理页面、数据库变更、修 bug、重构——都要先加载本 skill 再动手,即使用户只说"改一下""加个功能";前端登录/菜单/权限专项另见 flycms-frontend-access skill。

FlyCms 开发总纲

目标是让每次改动都长得像这个项目已有的代码,而不是像通用教程。细节 SOP 和决策记录在 references/ 里,先按需读:

  • 新增后端模块/接口/管理页面 → 读 references/backend-conventions.md(含可直接套用的代码模板)
  • 想引入新框架、改架构、或发现代码"不顺眼"想顺手重构 → 先读 references/tech-debt.md(技术债台账 + 已定的架构决策,多数"顺手改进"已被明确否决过)
  • 前端登录/菜单/权限/按钮控制 → 触发 flycms-frontend-access skill,完整手册在 docs/frontend-access-guide.md

项目一张图

FlyCms/
├── backend/    Spring Boot 4.1.1 / JDK 25 / MyBatis(XML) / Freemarker / Ehcache / MySQL,端口 80
│   └── src/main/java/com/flycms/
│       ├── module/<域>/{dao,model,service}/   # 业务三层,DAO 接口与 XML 同目录
│       ├── web/front|system/                  # 前台页面 / 管理后台(Freemarker 渲染)
│       ├── web/api/                           # 给 vben 前端的 REST(/api/**,DataVo)
│       ├── interceptor/                       # AdminInterceptor(/system/** URL 权限)、UserInterceptor
│       ├── core/{base,controller,entity,utils}/
│       └── config/                            # WebMvcConfig(拦截器注册)、CorsConfig、Druid…
├── frontend/   vue-vben-admin v5 pnpm monorepo;主力应用 apps/web-antd,dev 端口 5666
└── docs/frontend-access-guide.md               # 前后端权限对接手册(唯一信息源)

铁律(每条都有原因,违反即返工)

  1. DAO XML 统一放 src/main/resources/mapper/(2026-09-29 G26 归位后的现行约定;文件名用 模块__XxxDao.xml 平铺)。application.yml 的 mapper-locations 扫 classpath:mapper/**/*.xml;pom.xml 已不再把 src/main/java 当资源目录——新 Mapper XML 放回 java 目录会静默不打包,启动报绑定失败。
  2. Controller 归位:前台页面 → web/front;管理后台页面(含 Freemarker 渲染 + 局部 @ResponseBody)→ web/system,视图一律 theme.getAdminTemplate("admin/xxx") 返回;给 vben 前端的新 REST → web/api,路径 /api/**,返回 DataVo。不要在老 controller 里继续堆纯 JSON 端点。
  3. 响应与分页:JSON 一律 DataVo(成功 DataVo.success(message, data) 两参重载——单参重载有 message/data 分派陷阱);分页一律 PageVo<T>(service 里 new PageVo<>(pageNum)、setRows、setList(dao.getXxx(pageVo.getOffset(), pageVo.getRows()))、setCount(dao.countXxx()),XML 里手写 limit #{offset}, #{rows})。
  4. ID 与表:主键 SnowFlake.nextId()(core/utils/SnowFlake.java),表名 fly_ 前缀、bigint 主键。SQL 全部走 DAO XML 的 #{} 预编译,禁止字符串拼接。
  5. 校验与密码:入参用 jakarta validation 注解 + @Valid ... BindingResult 逐条 DataVo.failure(error.getDefaultMessage());密码存取只经 BCryptUtils;登录失败锁定逻辑(attempts)沿用 AdminService 现状,不要另造。
  6. 权限闭环:/system/** 下的新端点自动被 AdminInterceptor 按 URL 权限拦截——上线前必须 GET /system/admin/permission_sync 注册 action_key 并在角色组勾选,否则所有人 403;/api/** 不在拦截范围,端点内必须自查 session 并对未登录抛 HTTP 401(vben 只认 401)。
  7. 依赖卫生:新代码用 commons-lang3 / commons-io 等现代坐标;org.apache.commons.lang(2.x)只出现在遗留代码里,不要模仿。

改完怎么验证(本项目无自动化测试,验证 = 编译 + 冒烟)

  1. 后端:cd backend && mvn -q compile 过了再谈下一步;涉及启动行为的,mvn spring-boot:run 起服务后按"登录 → 菜单 → 目标页面/接口"冒烟。
  2. 前端:cd frontend && pnpm dev:antd 起开发服(5666),改动涉及类型的跑 pnpm check:type;涉及登录/权限的按手册 §3 验收。
  3. 数据库变更:在 doc/ 下同步维护 SQL 变更说明,保持 doc/flycms_date.sql 是可建库的完整基线。

禁止事项(防腐化边界)

  • 不引入新框架/新 ORM/新安全框架(Shiro、Spring Security、MyBatis-Plus、JWT…)。现行选型及理由见 references/tech-debt.md 的决策记录;确有必要,先在对话中提出权衡再动。
  • 不改 DataVo 字段语义、拦截器路径规则、/api 代理契约——前端手册与 skill 都建立在这些契约上。
  • 不做"顺手大重构"。发现坏味道记入 tech-debt 台账,单独立任务处理。
  • 提交信息沿用仓库惯例:中文一行式动词开头(如"修复表名BUG")。

© sunkaifei, MIT. 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 2 other files (references) in .agents/skills/flycms-dev of sunkaifei/FlyCms.

  • SKILL.md
  • references/backend-conventions.md
  • references/tech-debt.md

Open the folder on GitHubat commit 3de5509

Compare with similar skills

Flycms Dev next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Flycms Dev compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flycms Dev this skillsunkaifei/FlyCms656—~827Automated safety check: PassMIT
Springboot Init Skilljiushiwon/wg-skills112—~2.2kAutomated safety check: NotesApache-2.0
Qk Devycf1998/money-pos120—~993Automated safety check: PassNone
Spring Bootericrisco/rsc-harness167—~4kAutomated safety check: PassMIT
704 Technologies SQLjabrena/plinth446—~1kAutomated safety check: PassApache-2.0
Otel Javaollygarden/opentelemetry-agent-skills106—~1.4kAutomated safety check: PassApache-2.0

Similar skills

  • Springboot Init Skill

    jiushiwon/wg-skills

    Spring Boot 项目一键初始化技能。面向零基础小白,提供环境探测、自动安装、完整 Web 骨架生成、SSE 流式框架、JWT 鉴权、统一响应封装、文件上传接口、一键启动/重启脚本、Swagger 文档,内置 MySQL(默认)/ PostgreSQL / MongoDB 数据库选择。用户只需说"帮我搭一个 Spring Boot…

    112 GitHub stars~2.2k tokensUpdated yesterday
    Backend & APIsAuto-check: notes
  • Qk Dev

    ycf1998/money-pos

    QK-Money 框架的全流程开发助手。当用户在 QK-Money 项目中需要开发一个具体的管理功能(如供应商管理、商品品牌管理、优惠券管理)时触发。典型触发语:开发某个管理功能、新增一个XX模块、做个XX列表页面。涵盖需求澄清 → 设计文档 → 编码交付三个阶段。需求范围过大、需要拆解为多个子模块时不应直接触发,应先做整体设计。

    120 GitHub stars~993 tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Spring Boot

    ericrisco/rsc-harness

    A skill your agent uses when building, reviewing, testing, securing or configuring a Spring Boot 4 / Framework 7 backend — controllers, services, Spring Data JPA, application.yml…

    167 GitHub stars~4k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • 704 Technologies SQL

    jabrena/plinth

    A skill your agent uses when you need framework-agnostic SQL guidance — schema naming, relational table design, query readability, indexes, transactions, database security, migrations, testing, and…

    446 GitHub stars~1k tokensUpdated yesterday
    DatabasesAuto-check passed
  • Otel Java

    ollygarden/opentelemetry-agent-skills

    OpenTelemetry in Java — Javaagent zero-code instrumentation, Spring Boot Starter, manual autoconfigure SDK, declarative YAML configuration, BOM dependency management, sensitive-data capture and…

    106 GitHub stars~1.4k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Java conventions for the Opik backend: layered resource, service and DAO classes, naming rules, Lombok and Guice usage, and notes on MySQL, ClickHouse, migrations and testing.

    22k GitHub stars~2.4k tokensUpdated today
    Backend & APIsAuto-check passed

More from sunkaifei/FlyCms

  • Flycms Frontend Access

    sunkaifei/FlyCms

    FlyCms 前端(frontend/,vue-vben-admin v5)与后端(backend/,Spring Boot Session 认证)对接的领域知识与开发规范。凡在本仓库开发管理端登录、动态菜单、角色/权限/按钮控制、新增给前端调用的后端接口、或新建任何 /system 管理页面时都要使用——即使用户只说"加个页面""接一下登录""加个权限",也应主动加载本 skill。

    656 GitHub stars~725 tokensUpdated 6 days ago
    Auto-check: notes

Questions about Flycms Dev

What does Flycms Dev do?

FlyCms 项目(backend/ Spring Boot 4.1.1 + frontend/ vue-vben-admin v5)的架构地图与开发规范总纲。凡在本仓库做任何开发——写后端接口、新增/修改模块、管理页面、数据库变更、修 bug、重构——都要先加载本 skill 再动手,即使用户只说"改一下""加个功能";前端登录/菜单/权限专项另见…. Flycms Dev is an agent skill from sunkaifei/FlyCms.

When should I use Flycms Dev?

Flycms Dev fits situations like: tasks that involve Backend development.

How do I install Flycms Dev in Claude Code?

Run `npx skills add sunkaifei/FlyCms --skill flycms-dev -a claude-code`. Or copy the skill folder (.agents/skills/flycms-dev in sunkaifei/FlyCms) into .claude/skills/flycms-dev in your project. Claude Code loads it when a task matches its description.

How do I install Flycms Dev in Codex?

Run `npx skills add sunkaifei/FlyCms --skill flycms-dev -a codex`. Or copy the skill folder (.agents/skills/flycms-dev in sunkaifei/FlyCms) into .agents/skills/flycms-dev in your project. Codex loads it when a task matches its description.

Can I use Flycms Dev in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sunkaifei/FlyCms --skill flycms-dev -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flycms-dev, .gemini/skills/flycms-dev, .github/skills/flycms-dev and .opencode/skills/flycms-dev in your project.

What does Flycms Dev need to run?

Going by SKILL.md and its folder, Flycms Dev needs the command-line tools its instructions call (mvn and pnpm).

Does Flycms Dev access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Flycms Dev safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Flycms Dev use?

Flycms Dev is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Flycms Dev use?

About 827 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.8k tokens, read only when the agent opens those files.

What are the alternatives to Flycms Dev?

Skills that share tags, products or a category with Flycms Dev: Springboot Init Skill (jiushiwon/wg-skills, 112 stars), Qk Dev (ycf1998/money-pos, 120 stars), Spring Boot (ericrisco/rsc-harness, 167 stars) and 704 Technologies SQL (jabrena/plinth, 446 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flycms Dev?

sunkaifei (a GitHub user) maintains it in sunkaifei/FlyCms, which has 656 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 2, 2026.

Source: sunkaifei/FlyCms on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.