Agent skill

Java Coding Standards

by xu-xiang in xu-xiang/everything-claude-code-zh

适用于 Spring Boot 服务的 Java 编码规范：命名、不可变性、Optional 使用、流（Stream）、异常、泛型及项目布局。

Install Java Coding Standards

skills CLI

$ npx skills add xu-xiang/everything-claude-code-zh --skill java-coding-standards -a claude-code

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

GitHub CLI

$ gh skill install xu-xiang/everything-claude-code-zh java-coding-standards --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/xu-xiang/everything-claude-code-zh.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/ja-JP/skills/java-coding-standards .claude/skills/java-coding-standards && 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 "java-coding-standards" agent skill from https://github.com/xu-xiang/everything-claude-code-zh/tree/main/docs/ja-JP/skills/java-coding-standards into .claude/skills/java-coding-standards/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "java-coding-standards", 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/xu-xiang/everything-claude-code-zh/tree/main/docs/ja-JP/skills/java-coding-standards

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 xu-xiang/everything-claude-code-zh --skill java-coding-standards -a codex

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

GitHub CLI

$ gh skill install xu-xiang/everything-claude-code-zh java-coding-standards --agent codex

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

Manual copy

$ git clone --depth 1 https://github.com/xu-xiang/everything-claude-code-zh.git skills-src && mkdir -p .agents/skills && cp -r skills-src/docs/ja-JP/skills/java-coding-standards .agents/skills/java-coding-standards && 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 "java-coding-standards" agent skill from https://github.com/xu-xiang/everything-claude-code-zh/tree/main/docs/ja-JP/skills/java-coding-standards into .agents/skills/java-coding-standards/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "java-coding-standards", 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 xu-xiang/everything-claude-code-zh --skill java-coding-standards -a cursor

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

GitHub CLI

$ gh skill install xu-xiang/everything-claude-code-zh java-coding-standards --agent cursor

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

Manual copy

$ git clone --depth 1 https://github.com/xu-xiang/everything-claude-code-zh.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/docs/ja-JP/skills/java-coding-standards .cursor/skills/java-coding-standards && 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 "java-coding-standards" agent skill from https://github.com/xu-xiang/everything-claude-code-zh/tree/main/docs/ja-JP/skills/java-coding-standards into .cursor/skills/java-coding-standards/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "java-coding-standards", 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/xu-xiang/everything-claude-code-zh.git --path docs/ja-JP/skills/java-coding-standards

--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 xu-xiang/everything-claude-code-zh --skill java-coding-standards -a gemini-cli

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

GitHub CLI

$ gh skill install xu-xiang/everything-claude-code-zh java-coding-standards --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/xu-xiang/everything-claude-code-zh.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/docs/ja-JP/skills/java-coding-standards .gemini/skills/java-coding-standards && 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 "java-coding-standards" agent skill from https://github.com/xu-xiang/everything-claude-code-zh/tree/main/docs/ja-JP/skills/java-coding-standards into .gemini/skills/java-coding-standards/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "java-coding-standards", 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 xu-xiang/everything-claude-code-zh java-coding-standards

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 xu-xiang/everything-claude-code-zh --skill java-coding-standards -a github-copilot

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

Manual copy

$ git clone --depth 1 https://github.com/xu-xiang/everything-claude-code-zh.git skills-src && mkdir -p .github/skills && cp -r skills-src/docs/ja-JP/skills/java-coding-standards .github/skills/java-coding-standards && 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 "java-coding-standards" agent skill from https://github.com/xu-xiang/everything-claude-code-zh/tree/main/docs/ja-JP/skills/java-coding-standards into .github/skills/java-coding-standards/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "java-coding-standards", 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 xu-xiang/everything-claude-code-zh --skill java-coding-standards -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 xu-xiang/everything-claude-code-zh java-coding-standards --agent opencode

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

Manual copy

$ git clone --depth 1 https://github.com/xu-xiang/everything-claude-code-zh.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/docs/ja-JP/skills/java-coding-standards .opencode/skills/java-coding-standards && 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 "java-coding-standards" agent skill from https://github.com/xu-xiang/everything-claude-code-zh/tree/main/docs/ja-JP/skills/java-coding-standards into .opencode/skills/java-coding-standards/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "java-coding-standards", 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: java-coding-standards
GitHub stars: 2k
Token cost: ~676 tokens
SKILL.md length: 92 words
Files: 1
Skills in repo: 78
Repo updated: Mar 5, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

适用于 Spring Boot 服务的 Java 编码规范：命名、不可变性、Optional 使用、流（Stream）、异常、泛型及项目布局。

Tasks that involve Code quality
SKILL.md covers 核心原则, 命名, 不可变性 and Optional 的使用, plus 9 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
Tasks that involve Backend development

What it does

Java Coding Standards is an agent skill from xu-xiang/everything-claude-code-zh. 适用于 Spring Boot 服务的 Java 编码规范：命名、不可变性、Optional 使用、流（Stream）、异常、泛型及项目布局。

Its SKILL.md is about 680 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Code quality and Backend development. It works with Java and Spring Boot. The repository describes itself as: everything-claude-code 中文翻译项目：完整的 Claude Code 配置集合（agents, skills, hooks, commands, rules, MCPs）。源自 Anthropic 黑客松获胜者的实战配置，助力中文工程师高效理解与使用 Claude Code。 The licence is MIT.

When your agent uses it

Tasks that involve Code quality
Tasks that involve Backend development

Example prompts

“/java-coding-standards”

What it can do on your machine

Read from SKILL.md and the folder at commit dfbf946. 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 (its code samples are java).
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

Java Coding Standards loads about 676 tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 92 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~23
When it runs · the whole SKILL.md, loaded when a task matches: ~676

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 xu-xiang/everything-claude-code-zh at commit dfbf946, republished under its MIT licence (© xu-xiang). 92 words, ~676 tokens.

Download SKILL.mdSave it as .claude/skills/java-coding-standards/SKILL.md (or your agent's skills folder).

name: java-coding-standards
description: 适用于 Spring Boot 服务的 Java 编码规范：命名、不可变性、Optional 使用、流（Stream）、异常、泛型及项目布局。

Java 编码规范

适用于 Spring Boot 服务中易读且可维护的 Java (17+) 代码标准。

核心原则

清晰度优先于巧妙性
默认不可变；最小化共享的可变状态
抛出有意义的异常以实现早期失败（Fail fast）
一致的命名与包结构

命名

java

// ✅ 类/记录（Record）: PascalCase
public class MarketService {}
public record Money(BigDecimal amount, Currency currency) {}

// ✅ 方法/字段: camelCase
private final MarketRepository marketRepository;
public Market findBySlug(String slug) {}

// ✅ 常量: UPPER_SNAKE_CASE
private static final int MAX_PAGE_SIZE = 100;

不可变性

java

// ✅ 优先使用 record 和 final 字段
public record MarketDto(Long id, String name, MarketStatus status) {}

public class Market {
  private final Long id;
  private final String name;
  // 仅有 getter，没有 setter
}

Optional 的使用

java

// ✅ find* 方法返回 Optional
Optional<Market> market = marketRepository.findBySlug(slug);

// ✅ 使用 map/flatMap 代替 get()
return market
    .map(MarketResponse::from)
    .orElseThrow(() -> new EntityNotFoundException("Market not found"));

流（Stream）最佳实践

java

// ✅ 使用流进行转换，保持流水线（Pipeline）简洁
List<String> names = markets.stream()
    .map(Market::name)
    .filter(Objects::nonNull)
    .toList();

// ❌ 避免复杂的嵌套流；为了清晰起见，优先使用循环

异常

对于领域错误（Domain errors）使用非检查异常（Unchecked Exceptions）；使用上下文包装技术异常
创建领域特定的异常（例如：MarketNotFoundException）
避免捕获过于宽泛的 catch (Exception ex)（除非在中心位置重新抛出或记录日志）

java

throw new MarketNotFoundException(slug);

泛型与类型安全

避免使用原始类型（Raw types）；声明泛型参数
优先在可重用的工具类中使用受限泛型（Bounded Generics）

java

public <T extends Identifiable> Map<Long, T> indexById(Collection<T> items) { ... }

项目结构 (Maven/Gradle)

src/main/java/com/example/app/
  config/
  controller/
  service/
  repository/
  domain/
  dto/
  util/
src/main/resources/
  application.yml
src/test/java/... (镜像 main 目录)

格式与样式

始终一致地使用 2 或 4 个空格（遵循项目标准）
每个文件仅包含一个 public 顶级类型
保持方法短小且专注；提取助手方法（Helper methods）
成员顺序：常量、字段、构造函数、public 方法、protected、private

应避免的代码异味 (Code Smells)

过长的参数列表 -> 使用 DTO 或建造者模式（Builder）
过深的嵌套 -> 使用早期返回（Early Return）
魔术数字 -> 使用命名常量
静态可变状态 -> 优先使用依赖注入（Dependency Injection）
沉默的 catch 块 -> 记录日志并采取行动，或者重新抛出

日志记录

java

private static final Logger log = LoggerFactory.getLogger(MarketService.class);
log.info("fetch_market slug={}", slug);
log.error("failed_fetch_market slug={}", slug, ex);

Null 处理

仅在万不得已时接受 @Nullable；否则使用 @NonNull
对输入使用 Bean 校验（Bean Validation，如 @NotNull、@NotBlank）

测试预期

JUnit 5 + AssertJ 实现流式断言（Fluent Assertions）
使用 Mockito 进行打桩；尽可能避免使用部分打桩（Partial mocks）
优先选择确定性测试；严禁隐藏的 sleep

记住：保持代码的意图清晰、类型安全且可观测。除非证明确有必要，否则应优先优化可维护性而非微小的性能优化。

Files

Just SKILL.md in docs/ja-JP/skills/java-coding-standards of xu-xiang/everything-claude-code-zh.

Open the folder on GitHubat commit dfbf946

Compare with similar skills

Java Coding Standards 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.

Java Coding Standards compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Java Coding Standards this skillxu-xiang/everything-claude-code-zh	2k	—	~676	Automated safety check: Pass	MIT	7 mo ago
Java Coding Standardsaffaan-m/ECC	274k	2 repos	~668	Automated safety check: Pass	MIT	2 days ago
Java Coding StandardsSnailclimb/AIGuide	667	—	~1k	Automated safety check: Pass	None	3 mo ago
Java Coding Standardsaffaan-m/ECC	274k	3 repos	~675	Automated safety check: Pass	MIT	2 days ago
Java Coding Standardsaffaan-m/ECC	274k	1 repos	~2.9k	Automated safety check: Pass	MIT	2 days ago
Java Coding Standardsvibeeval/vibecosystem	531	3 repos	~877	Automated safety check: Pass	MIT	1 mo ago

Similar skills

Java Coding Standards
affaan-m/ECC
Spring Bootサービス向けのJavaコーディング標準：命名、不変性、Optional使用、ストリーム、例外、ジェネリクス、プロジェクトレイアウト。
274k GitHub starsUsed in 2 repos~668 tokens
Backend & APIsAuto-check passed
Java Coding Standards
Snailclimb/AIGuide
Java/Spring Boot 编码规范：用于编写、审查、重构和讲解 Java 代码。适用于 Java 风格、Spring Boot 架构、Controller/Service/Manager/DAO 分层、API 边界、Entity/VO/Form/DTO/BO 设计、MyBatis/MyBatis-Plus 持久化、事务、异常、日志、安全、性能、测试和 Java 代码评审等场景。默认结合…
667 GitHub stars~1k tokensUpdated 3 mo ago
Backend & APIsAuto-check passed
Java Coding Standards
affaan-m/ECC
Spring Boot服务的Java编码标准：命名、不可变性、Optional用法、流、异常、泛型和项目布局. An agent skill from affaan-m/ECC.
274k GitHub starsUsed in 3 repos~675 tokens
Backend & APIsAuto-check passed
Java Coding Standards
affaan-m/ECC
Java coding standards for Spring Boot and Quarkus services: naming, immutability, Optional usage, streams, exceptions, generics, CDI, reactive patterns, and project layout.
274k GitHub starsUsed in 1 repo~2.9k tokens
DevelopmentAuto-check passed
Java Coding Standards
vibeeval/vibecosystem
Java coding standards for Spring Boot services: naming, immutability, Optional usage, streams, exceptions, generics, and project layout.
531 GitHub starsUsed in 3 repos~877 tokens
DevelopmentAuto-check passed
Java Rules
softspark/ai-toolkit
Java coding rules: style, patterns, security, testing. An agent skill from softspark/ai-toolkit.
179 GitHub stars~3.1k tokensUpdated today
Backend & APIsAuto-check passed

Questions about Java Coding Standards

What does Java Coding Standards do?

适用于 Spring Boot 服务的 Java 编码规范：命名、不可变性、Optional 使用、流（Stream）、异常、泛型及项目布局。. Java Coding Standards is an agent skill from xu-xiang/everything-claude-code-zh.

When should I use Java Coding Standards?

Java Coding Standards fits situations like: tasks that involve Code quality; tasks that involve Backend development.

How do I install Java Coding Standards in Claude Code?

Run `npx skills add xu-xiang/everything-claude-code-zh --skill java-coding-standards -a claude-code`. Or copy the skill folder (docs/ja-JP/skills/java-coding-standards in xu-xiang/everything-claude-code-zh) into .claude/skills/java-coding-standards in your project. Claude Code loads it when a task matches its description.

How do I install Java Coding Standards in Codex?

Run `npx skills add xu-xiang/everything-claude-code-zh --skill java-coding-standards -a codex`. Or copy the skill folder (docs/ja-JP/skills/java-coding-standards in xu-xiang/everything-claude-code-zh) into .agents/skills/java-coding-standards in your project. Codex loads it when a task matches its description.

Can I use Java Coding Standards 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 xu-xiang/everything-claude-code-zh --skill java-coding-standards -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/java-coding-standards, .gemini/skills/java-coding-standards, .github/skills/java-coding-standards and .opencode/skills/java-coding-standards in your project.

What does Java Coding Standards need to run?

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

Does Java Coding Standards 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 Java Coding Standards 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 Java Coding Standards use?

Java Coding Standards 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 Java Coding Standards use?

About 676 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Java Coding Standards?

Skills that share tags, products or a category with Java Coding Standards: Java Coding Standards (affaan-m/ECC, 274k stars), Java Coding Standards (Snailclimb/AIGuide, 667 stars), Java Coding Standards (affaan-m/ECC, 274k stars) and Java Coding Standards (affaan-m/ECC, 274k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Java Coding Standards?

xu-xiang (a GitHub user) maintains it in xu-xiang/everything-claude-code-zh, which has 1,971 GitHub stars. The repository holds 78 skills in this directory. The repository was last updated on March 5, 2026.

Source: xu-xiang/everything-claude-code-zh on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Java Coding Standards

Facts

At a glance

What it does

When your agent uses it

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Java 编码规范

核心原则

命名

不可变性

Optional 的使用

流（Stream）最佳实践

异常

泛型与类型安全

项目结构 (Maven/Gradle)

格式与样式

应避免的代码异味 (Code Smells)

日志记录

Null 处理

测试预期

Files

Compare with similar skills

Similar skills

More from xu-xiang/everything-claude-code-zh

Related

Questions about Java Coding Standards