Alibaba Java Development Guide

《阿里巴巴Java开发手册（黄山版）》总纲与路由入口。涵盖编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约七大维度。Use when writing, reviewing, or designing Java code; handling exceptions/logging; writing SQL or designing tables; writing unit tests; designing project architecture; or whenever Alibaba Java standards apply. 写/改 Java 或 SQL 代码前先读 SKILL.md「规约执行策略」。P0 红线（新代码与被改到的存量代码都必须合规，静默保留红线问题视为违规）：禁 Executors.newFixedThreadPool/newCachedThreadPool 等工厂（须 new ThreadPoolExecutor 显式参数）；禁裸 new Thread；日期禁 SimpleDateFormat 与 java.util.Date（一律 java.time + DateTimeFormatter）；SQL 禁 ${} 拼接、update/delete 必带 where；资源必须 try-with-resources；禁空 catch 吞异

60 stars 7 forksSoftware Development

Install

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

npx skills add Sxuan-Coder/alibaba-java-development-guide --skill alibaba-java-development-guide

Manual install

git clone --depth 1 https://github.com/Sxuan-Coder/alibaba-java-development-guide.git /tmp/alibaba-java-development-guide
mkdir -p ~/.claude/skills
cp -r /tmp/alibaba-java-development-guide/. ~/.claude/skills/alibaba-java-development-guide

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开发手册（黄山版）》（v1.7.1，2022.02.03 发布）的**总纲入口**。手册以 Java 开发者为中心视角，划分为七个维度。本 SKILL.md 只做**导航路由**，不内联全部条文——详细规约按需从 `data/` 目录取对应章节阅读，避免一次性载入全部内容。

## 规约分级

手册每条规约依据约束力强弱及故障敏感性分为三类，查阅 data 文件时以此判断优先级：

| 级别 | 含义 | 处理原则 |
|------|------|----------|
| **【强制】** | 必须严格遵守 | 违反可能导致严重问题或线上故障，review 时必查 |
| **【推荐】** | 建议遵循 | 有助于提升代码质量，无特殊情况应遵循 |
| **【参考】** | 参考性建议 | 可根据实际团队情况选择，灵活应用 |

每条规约通常包含：**说明**（扩展解释）、**正例**（提倡写法）、**反例**（雷区与真实故障案例）。

## 规约执行策略（三级管控）

【强制】/【推荐】/【参考】是规约**自身的严重性**；本节定义 agent **执行时的行为**——尤其在存量代码质量参差的仓库里，避免「全量强制刷屏」与「放任隐患」两个极端。

**分层判据**：违反后是否可能导致**线上故障、安全漏洞、资源泄露或数据损坏**——是则归 P0；仅影响可读性/一致性的【强制】规约归 P1。P0 清单与企业 CI 代码质量门禁的阻断项（P3C / PMD Blocker 级规则）对齐：门禁拦的是提交结果，本策略管的是生成源头——命中 P0 的代码会直接打回流水线，所以 P0 不参与渐进、不接受口头豁免。

| 执行层级 | 覆盖范围 | 一句话行为 |
|---|---|---|
| 🔴 **P0 红线** | 隐患型【强制】（见下方红线清单） | 新代码直接写合规；被改到的存量代码发现即修复；不可口头豁免 |
| 🟡 **P1 新代码强制** | 其余【强制】（命名风格、常量、格式、OOP、注释、控制语句、分层结构等风格/结构类） | 只约束新写的代码；存量不扫描、不强制改、不刷屏 |
| 🟢 **P2 建议** | 全部【推荐】/【参考】 | 提示不阻塞，用户说忽略即忽略 |

### P0 红线清单

| 红线域 | 条文位置 | 必查项 |
|---|---|---|
| 线程池 | 01-(七) | 禁 `Executors.newFixedThreadPool` / `newCachedThreadPool` / `newSingleThreadExecutor` 等工厂方法；必须 `new ThreadPoolExecutor(核心数, 最大数, keepAlive, 时间单位, 队列, 命名 ThreadFactory, 拒绝策略)` 显式创建；禁裸 `new Thread()` |
| 并发安全 | 01-(七) | 日期时间一律 `java.time`（禁 `SimpleDateFormat` 与 `java.util.Date`——前者非线程安全是真实故障源，后者已过时）；`ThreadLocal` 用完必须 try-finally `remove()`；双重检查锁字段必须 `volatile`；多线程读写用并发容器 |

Read the full skill on GitHub

Details

Skill name: alibaba-java-development-guide
Repository: Sxuan-Coder/alibaba-java-development-guide
Repo updated: 16 October 2026

FAQ

What does the Alibaba Java Development Guide skill do?

How do I install the Alibaba Java Development Guide skill?

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

Is Alibaba Java Development Guide popular?

It lives in Sxuan-Coder/alibaba-java-development-guide, which has 60 GitHub stars and 7 forks.

Related skills

Xiaobai Skills

Tyuts/xiaobai-skills

One-click starter pack and curator for Codex/agent skills. Use when a beginner wants a high-quality default skills setup across common needs, when the user asks to install useful skills without researching them one by one, or when the installed skills library needs auditing, deduplication, conflict resolution, global-vs-backup selection, restore planning, or a written skills inventory.

Software Development

Everything Search

Mayuqi-crypto/everything-search-skill

Search files and folders instantly across Windows drives or within specific project paths using Everything (HTTP REST API or es.exe CLI). Supports sandboxed agents (Docker, WSL, DevContainers) and native desktop environments with automatic dual-mode fallback.

Software Development

Shelby

shelby/shelby-skills

Shelby, a data platform with an S3-compatible API. Use when the user asks about Shelby in general or is starting a Shelby integration, to route to the right Shelby skill.

Software Development27

Dsh Plugin Guide

PerryLink/dsh-plugin-guide

Use when developing, reviewing, packaging, debugging, or answering questions about DeepSeek Harness (DSH) plugins — the plugin-based agent harness on vendored Cordis. Applies the official plugin-development constraints (plugin contract, cordis.yml layers, services/events/effects, tool DSL, bundles/profiles) backed by the dsh-plugin-guide knowledge base.

Software Development

Stata CLI

ashuiGordon/stata-cli

Run Stata commands, .do files, view data, inspect results, and get help from the terminal. Wraps PyStata with a daemon mode for fast execution. Built-in Stata reference library with 57 topics. Designed for AI agents.

Software Development

Rails Upgrade

robzolkos/skill-rails-upgrade

Analyze Rails application upgrade path. Checks current version, finds latest release, fetches upgrade notes and diffs, then performs selective upgrade preserving local customizations.

Software DevelopmentIn 1 list

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