Alibaba Java Coding Guidelines Skill

Use when 需要按 Alibaba Java Coding Guidelines（阿里巴巴 Java 编码规范）审查、生成或重构 Java、Spring、MyBatis、Maven、MySQL、SQL、日志、异常、安全或数据库相关代码。

14 stars 3 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add ns3154/alibaba-java-coding-guidelines-skill --skill alibaba-java-coding-guidelines-skill

Manual install

git clone --depth 1 https://github.com/ns3154/alibaba-java-coding-guidelines-skill.git /tmp/alibaba-java-coding-guidelines-skill
mkdir -p ~/.claude/skills
cp -r /tmp/alibaba-java-coding-guidelines-skill/. ~/.claude/skills/alibaba-java-coding-guidelines-skill

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 阿里巴巴 Java 开发规约

## 概览

使用本 skill 时，把《阿里巴巴 Java 开发手册》当作 Java 代码生成、重构和审查的默认质量基线。优先处理强制规则，再处理推荐规则；如果项目本地约定和规约冲突，说明冲突点并以用户或项目约定为准。

详细规则摘要见 `references/alibaba-java-rules.md`。需要精确出处或完整条文时，打开官方页面：`https://alibaba.github.io/Alibaba-Java-Coding-Guidelines/`。

## 兼容性

这是通用 Agent Skill，不绑定单个应用或运行器。Claude Code、Codex 以及其他支持 Agent Skills 目录规范的工具都应只依赖 `SKILL.md` 和按需读取的 `references/` 内容。

`agents/openai.yaml` 只是 OpenAI/Codex UI 元数据，属于可选增强；不应作为 Claude Code 或其他 agent 使用本 skill 的前提。

校验入口提供 Python、Node.js、Go 三种等价实现：`scripts/validate_skill.py`、`scripts/validate_skill.mjs`、`scripts/validate_skill.go`。使用者可以按本地运行时任选其一；需要验证三者一致时运行 `tests/test_validators.sh`。

## 使用场景

- 审查 Java、Spring、MyBatis、Maven、SQL、DDL、日志、异常处理或安全相关改动。
- 生成新类、接口、DTO、VO、DO、枚举、异常类、测试类、Mapper、Service、DAO 或 SQL。
- 重构命名、常量、集合、并发、控制流、日志、异常和数据库访问代码。
- 给出代码评审意见、整改清单、规范符合性报告或自动修复建议。

## 工作流程

1. 先识别任务类型：代码生成、代码审查、重构、SQL/DDL 审查、依赖治理、安全检查。
2. 读取当前项目的已有风格、包结构、测试框架和持久层写法，避免只按通用规约硬套。
3. 按严重级别处理：
   - 强制：发现违反时必须指出或修复。
   - 推荐：默认遵循；如果不采用，说明权衡。
   - 参考：作为设计建议，不阻塞交付。
4. 针对相关模块读取 `references/alibaba-java-rules.md` 中对应小节。
5. 输出结果时按影响排序：正确性和安全性、稳定性和性能、可维护性、风格一致性。

## 代码生成规则

- 命名必须清晰准确：类名用 UpperCamelCase，方法、参数、成员变量和局部变量用 lowerCamelCase，常量用大写加下划线。
- 代码注释使用中文；公开 API、复杂业务规则、异常含义和空值语义要写清楚。
- 不使用魔法值；固定范围值优先使用枚举。
- 日志使用 SLF4J 门面，不直接绑定具体日志实现；低级别日志使用占位符或级别判断。
- 资源关闭优先使用 try-with-resources；不要在 finally 中 return 或抛出新异常。
- MyBatis 参数默认使用 `#{}`，禁止把用户输入拼进 SQL。
- Web、Open API、SQL、HTML 输出和用户输入必须做权限、参数校验、转义或脱敏。

## 代码审查输出

审查时优先给出可执行意见。每条意见包含：

- 级别：强制、推荐或参考。

Read the full skill on GitHub

Details

Skill name: alibaba-java-coding-guidelines-skill
Repository: ns3154/alibaba-java-coding-guidelines-skill
License: Apache-2.0
Repo updated: 24 May 2026

FAQ

What does the Alibaba Java Coding Guidelines Skill skill do?

How do I install the Alibaba Java Coding Guidelines Skill skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add ns3154/alibaba-java-coding-guidelines-skill --skill alibaba-java-coding-guidelines-skill. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Alibaba Java Coding Guidelines Skill popular?

It lives in ns3154/alibaba-java-coding-guidelines-skill, which has 14 GitHub stars and 3 forks.

Related skills

Planmysaas

creationskiro/planmysaas-claude-skill

Use this skill when the user wants to plan a SaaS product end-to-end — turn a one-line idea into a full blueprint with research, analysis, architecture, feature specs, frontend wireframes, phases, and a deep step-by-step build playbook for Claude Code. Triggers on phrases like "plan my saas", "/planmysaas", "build a saas blueprint", "I want to build a saas for X", "turn this idea into a plan", or when the user describes a product idea and asks for structure.

Software Development

Grok Search

Autsunset/grok-search

Use when the user explicitly asks to search the web, check latest/current facts, fetch a URL, or discover pages on a website. Also use when the user asks to install, configure, or setup grok-search (API URL/key, chat vs responses). Do not use for local code search or stable offline knowledge unless the user asks for live web access.

Software Development

Generate Code

lunashia/code-generation-skill

Use when the task involves generating, modifying, debugging, validating, or reviewing code. Do not use for non-code tasks.

Software Development

Codex Pet Generator

wyddy7/codex-pet-generator

Create Codex desktop pets from character references by defining row semantics, generating tiny-UI-readable loops, approving or rejecting rows, following slicing guidance, packing a 1536x1872 spritesheet with the bundled packer, validating it, and installing under ~/.codex/pets.

Software Development

Claude Codex Collaboration

thelearningest/Byterover-Claude-Codex-Collaboration-

Enable automated collaboration between Claude Code and Codex CLI using Byterover as shared memory. This skill should be used when architectural review or code validation from Codex is desired before or after implementation. Claude creates plans, directly invokes Codex for expert review via Bash, and implements based on feedback - all automatically without manual user intervention. All context persists in Byterover.

Software Development

Setup Structure Index

shannonbay/setup-structure-index

This skill should be used when the user asks to "set up structure index", "add codebase structure tracking", "create structure files", "set up code structure YAML", or needs to set up the codebase structure index system in a project. It creates a two-tier structure index (compact file map in CLAUDE.md + detailed YAML files) and configures a TaskCompleted hook to enforce updates.

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.