Agent skill

Mall4j

Mall4j 开源版现有功能副驾驶：本地启动、mall4v/mall4m/mall4uni、商品/SKU、购物车、下单支付、订单发货、会员、运费、权限、部署排查。适用于下载 mall4j / yami-shop 后按现有功能使用或二次开发；不要编造开源版没有的能力。

AGPL-3.0Auto-check: notesBackend & APIs

Install Mall4j

skills CLI

$ npx skills add gz-yami/mall4j --skill mall4j -a claude-code

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

GitHub CLI

$ gh skill install gz-yami/mall4j mall4j --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/gz-yami/mall4j.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/mall4j .claude/skills/mall4j && 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/

Paste into Claude Code

Install the "mall4j" agent skill from https://github.com/gz-yami/mall4j/tree/master/.agents/skills/mall4j into .claude/skills/mall4j/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mall4j", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/gz-yami/mall4j/tree/master/.agents/skills/mall4j

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add gz-yami/mall4j --skill mall4j -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install gz-yami/mall4j mall4j --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/gz-yami/mall4j.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/mall4j .agents/skills/mall4j && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "mall4j" agent skill from https://github.com/gz-yami/mall4j/tree/master/.agents/skills/mall4j into .agents/skills/mall4j/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mall4j", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add gz-yami/mall4j --skill mall4j -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install gz-yami/mall4j mall4j --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/gz-yami/mall4j.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/mall4j .cursor/skills/mall4j && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "mall4j" agent skill from https://github.com/gz-yami/mall4j/tree/master/.agents/skills/mall4j into .cursor/skills/mall4j/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mall4j", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/gz-yami/mall4j.git --path .agents/skills/mall4j

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add gz-yami/mall4j --skill mall4j -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install gz-yami/mall4j mall4j --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/gz-yami/mall4j.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/mall4j .gemini/skills/mall4j && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "mall4j" agent skill from https://github.com/gz-yami/mall4j/tree/master/.agents/skills/mall4j into .gemini/skills/mall4j/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mall4j", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install gz-yami/mall4j mall4j

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add gz-yami/mall4j --skill mall4j -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/gz-yami/mall4j.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/mall4j .github/skills/mall4j && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "mall4j" agent skill from https://github.com/gz-yami/mall4j/tree/master/.agents/skills/mall4j into .github/skills/mall4j/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mall4j", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add gz-yami/mall4j --skill mall4j -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install gz-yami/mall4j mall4j --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/gz-yami/mall4j.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/mall4j .opencode/skills/mall4j && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "mall4j" agent skill from https://github.com/gz-yami/mall4j/tree/master/.agents/skills/mall4j into .opencode/skills/mall4j/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mall4j", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: mall4j
GitHub stars: 5.3k
Token cost: ~640 tokens
SKILL.md length: 142 words
Files: 2 (incl. references)
Skills in repo: 1
Repo updated: Sep 29, 2026
First seen: Oct 7, 2026
Licence: AGPL-3.0

At a glance

Works in 4 steps: 判断场景：启动 / 排查 / 部署，或某一个现有功能点。 → 只读下方路由里该行的 1–3 篇 doc/。不要整目录读 doc/。 → 只有问到具体功能（商品、购物车、订单等）时，再读… → …
Backend & APIs work in your project
SKILL.md covers 每轮怎么做, 快速路由, 固定口径 and 不要编
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Mall4j is an agent skill from gz-yami/mall4j. Mall4j 开源版现有功能副驾驶：本地启动、mall4v/mall4m/mall4uni、商品/SKU、购物车、下单支付、订单发货、会员、运费、权限、部署排查。适用于下载 mall4j / yami-shop 后按现有功能使用或二次开发；不要编造开源版没有的能力。

Its SKILL.md is about 640 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/feature-map.md`).

It sits in Backend & APIs. It works with Vue.js, Java and Spring Boot. The repository describes itself as: ⭐️⭐️⭐️ 电商商城小程序电商商城系统 PC商城 H5商城 APP商城 Java商城 O2O商城跨境商城. The licence is AGPL-3.0.

When your agent uses it

Backend & APIs work in your project

Example prompts

“/mall4j”

Workflow steps

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

判断场景：启动 / 排查 / 部署，或某一个现有功能点。
只读下方路由里该行的 1–3 篇 doc/。不要整目录读 doc/。
只有问到具体功能（商品、购物车、订单等）时，再读 references/feature-map.md。启动、401、端口问题不要读地图。
先说当前实现，再给基于现有文件的改法。

What it can do on your machine

Read from SKILL.md and the folder at commit 0ab454d. 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
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
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

Mall4j loads about 640 tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 35 tokens; SKILL.md has 142 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NoteMentions a .env fileSKILL.md:45

| uni-app | `front-end/mall4uni` | `.env.*` → `8086` |

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 gz-yami/mall4j at commit 0ab454d, republished under its AGPL-3.0 licence (© gz-yami). 142 words, ~640 tokens.

Download SKILL.mdSave it as .claude/skills/mall4j/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: mall4j
description: Mall4j 开源版现有功能副驾驶：本地启动、mall4v/mall4m/mall4uni、商品/SKU、购物车、下单支付、订单发货、会员、运费、权限、部署排查。适用于下载 mall4j / yami-shop 后按现有功能使用或二次开发；不要编造开源版没有的能力。

Mall4j 开源版现有功能副驾驶

给已下载本仓库的人用：按现有功能点说明怎么用、改哪。细节以 doc/ 和源码为准。路径相对仓库根目录（含 pom.xml、yami-shop-admin、front-end、doc）。这是 B2C 单商户开源版，不要套 mall4cloud / 跨境版。使用通用 SKILL.md（Agent Skills），Cursor、Codex、Claude Code 均可加载。

每轮怎么做

判断场景：启动 / 排查 / 部署，或某一个现有功能点。
只读下方路由里该行的 1–3 篇 doc/。不要整目录读 doc/。
只有问到具体功能（商品、购物车、订单等）时，再读 references/feature-map.md。启动、401、端口问题不要读地图。
先说当前实现，再给基于现有文件的改法。

快速路由

场景	最少阅读
第一次启动、登录后台	`doc/2-环境搭建/1-30分钟启动路线.md`、`doc/2-环境搭建/2-环境要求.md`、`doc/2-环境搭建/3-数据库初始化.md`
接口地址、401、验证码	`doc/2-环境搭建/6-前端接口地址配置.md`、`doc/9-故障排查/1-常见问题.md`
启动失败	`doc/9-故障排查/2-启动失败.md`
模块怎么分	`doc/1-项目概览/1-项目介绍.md`、`doc/1-项目概览/3-后端模块说明.md`、`doc/1-项目概览/4-前端项目说明.md`
商品 / SKU / 分类 / 规格	`doc/6-核心业务/2-商品与SKU.md`
购物车	`doc/6-核心业务/3-购物车.md`
确认 / 提交订单	`doc/6-核心业务/4-确认订单.md`、`doc/6-核心业务/5-提交订单.md`
支付	`doc/6-核心业务/6-支付流程.md`
订单 / 发货	`doc/6-核心业务/7-订单管理.md`
交易总览	`doc/6-核心业务/1-核心交易链路.md`
权限 / 菜单	`doc/4-技术实现/1-权限体系.md`
改现有后台页、菜单不显示	`doc/5-二次开发/3-二开文件位置速查.md`、`doc/5-二次开发/9-二开常见卡点.md`
部署上线	`doc/8-部署运维/1-部署路径选择.md`、`doc/8-部署运维/3-生产配置.md`

表名、Controller、页面对应关系：问到该功能时再打开 feature-map.md。分层/配置按问题补 doc/3-技术框架/ 或 doc/4-技术实现/ 对应篇。

固定口径

端	位置	本地
管理端	`yami-shop-admin`（`WebApplication`）	`8085`
用户端	`yami-shop-api`（`ApiApplication`）	`8086`
管理后台	`front-end/mall4v`	`9527` → `8085`
小程序	`front-end/mall4m`	`utils/config.js` → `8086`
uni-app	`front-end/mall4uni`	`.env.*` → `8086`
库	`db/yami_shop.sql`	`yami_shops`

后台账号 admin / 123456。第一次只跑 MySQL + Redis + admin + mall4v。mall4v 接口用 VITE_APP_BASE_API，资源用 VITE_APP_RESOURCES_URL。菜单 url = front-end/mall4v/src/views/modules/<url>/index.vue。

后台功能放 yami-shop-admin，浏览/购物车/下单/支付放 yami-shop-api。规则放 Service。改菜单时同时核 tz_sys_menu、@PreAuthorize、前端 isAuth()。

交易主线：商品/SKU → 购物车 → 确认订单 → 提交订单 → 支付 → 后台发货。金额看 tz_order_settlement，不接受前端传应付金额。开源支付会直接 paySuccess()，回调在 PayNoticeController 里是注释；不要把同步返回或支付结果页当成生产支付成功。

库存、订单/支付状态、OrderTask 自动取消/确认收货，改前先读对应 doc/6 并跑通链路。

不要编

开源版没有：多商户、SaaS、跨境、分销、营销中台、完整优惠券（couponIds 仅保留字段）、完整退款（有 tz_order_refund 无 Controller）、生产微信/支付宝。不要改成 mall4cloud 微服务。用户要这些时说明现状即可。

分不清 8085/8086 或三端、要把开源支付当三方上线、或能力不在现有功能点里：先停下来问一句，再改代码。

不重写订单状态机；不把密钥写入仓库或前端；不把 `doc/` 全文贴进回答。

Files

SKILL.md and 1 other file (references) in .agents/skills/mall4j of gz-yami/mall4j.

SKILL.md
references/feature-map.md

Open the folder on GitHubat commit 0ab454d

Compare with similar skills

Mall4j 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.

Mall4j compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Mall4j this skillgz-yami/mall4j	5.3k	—	~640	Automated safety check: Notes	AGPL-3.0	11 days ago
Flycms Devsunkaifei/FlyCms	656	—	~827	Automated safety check: Pass	MIT	yesterday
Project GeneratorLeoYeAI/openclaw-master-skills	2.2k	—	~4.5k	Automated safety check: Pass	MIT	2 mo ago
Spring Bootpiomin/claude-ai-spring-boot	1.3k	—	~2k	Automated safety check: Pass	Apache-2.0	5 mo ago
Dr Jskilljdubois/dr-jskill	342	—	~4.6k	Automated safety check: Notes	Apache-2.0	10 days ago
WxJava Integration Guidebinarywang/WxJava	33k	—	~123	Automated safety check: Pass	Apache-2.0	today

Similar skills

Flycms Dev
sunkaifei/FlyCms
FlyCms 项目（backend/ Spring Boot 4.1.1 + frontend/ vue-vben-admin v5）的架构地图与开发规范总纲。凡在本仓库做任何开发——写后端接口、新增/修改模块、管理页面、数据库变更、修 bug、重构——都要先加载本 skill 再动手，即使用户只说"改一下""加个功能"；前端登录/菜单/权限专项另见…
656 GitHub stars~827 tokensUpdated yesterday
Backend & APIsAuto-check passed
Project Generator
LeoYeAI/openclaw-master-skills
Automatically transform requirement documents or natural language descriptions into complete full-stack projects (Java backend + Vue frontend) with MANDATORY interactive tech stack selection.
2.2k GitHub stars~4.5k tokensUpdated 2 mo ago
DevelopmentAuto-check passed
Spring Boot
piomin/claude-ai-spring-boot
Spring Boot 3.x development - REST APIs, JPA, Security, Testing, and Cloud-native patterns.
1.3k GitHub stars~2k tokensUpdated 5 mo ago
Backend & APIsAuto-check passed
Dr Jskill
jdubois/dr-jskill
Creates Java + Spring Boot projects: Web applications, full-stack apps with Vue.js or Angular or React or vanilla JS, PostgreSQL, REST APIs, and Docker.
342 GitHub stars~4.6k tokensUpdated 10 days ago
Backend & APIsAuto-check: notes
WxJava Integration Guide
binarywang/WxJava
Plans a WxJava setup for Java, Spring Boot or Solon projects that call WeChat services, from module and BOM choice to config and a minimal working call.
33k GitHub stars~123 tokensUpdated today
Backend & APIsAuto-check passed
Intelliconnect Service Style
ruanrongman/IntelliConnect
Create or update IntelliConnect Spring Boot service/serviceimpl code in this repository style.
147 GitHub stars~2.4k tokensUpdated 3 days ago
Backend & APIsAuto-check passed

Works with

Questions about Mall4j

What does Mall4j do?

Mall4j 开源版现有功能副驾驶：本地启动、mall4v/mall4m/mall4uni、商品/SKU、购物车、下单支付、订单发货、会员、运费、权限、部署排查。适用于下载 mall4j / yami-shop 后按现有功能使用或二次开发；不要编造开源版没有的能力。. Mall4j is an agent skill from gz-yami/mall4j.

When should I use Mall4j?

Mall4j fits situations like: backend & APIs work in your project.

How do I install Mall4j in Claude Code?

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

How do I install Mall4j in Codex?

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

Can I use Mall4j 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 gz-yami/mall4j --skill mall4j -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mall4j, .gemini/skills/mall4j, .github/skills/mall4j and .opencode/skills/mall4j in your project.

What does Mall4j need to run?

SKILL.md names no scripts, command-line tools or credentials: Mall4j is instructions for the agent only.

Does Mall4j 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 Mall4j safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Mall4j use?

Mall4j is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mall4j use?

About 640 tokens (SKILL.md is roughly 2.6k 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 2.1k tokens, read only when the agent opens those files.

What are the alternatives to Mall4j?

Skills that share tags, products or a category with Mall4j: Flycms Dev (sunkaifei/FlyCms, 656 stars), Project Generator (LeoYeAI/openclaw-master-skills, 2.2k stars), Spring Boot (piomin/claude-ai-spring-boot, 1.3k stars) and Dr Jskill (jdubois/dr-jskill, 342 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mall4j?

gz-yami (a GitHub user) maintains it in gz-yami/mall4j, which has 5,271 GitHub stars. The repository was last updated on September 29, 2026.

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

Install Mall4j

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Mall4j 开源版现有功能副驾驶

每轮怎么做

快速路由

固定口径

不要编

不重写订单状态机；不把密钥写入仓库或前端；不把 doc/ 全文贴进回答。

Files

Compare with similar skills

Similar skills

Flycms Dev

Project Generator

Spring Boot

Dr Jskill

WxJava Integration Guide

Intelliconnect Service Style

Related

Questions about Mall4j

不重写订单状态机；不把密钥写入仓库或前端；不把 `doc/` 全文贴进回答。