用 AI 写 Java 代码确实快，但Review的时候却经常让人想哭：

• List<Map<String, Object>> 满天飞，命名随心所欲；

• 还在用 Date 而不是 LocalDateTime，try-catch 直接吞异常；

• DAO 层直接返回给前端，缺少 DTO/VO 分层，架构混乱……

原因在于：Agent 缺少一份权威、结构化、可按需检索的工程规约上下文。

把整本黄山版Java规约手册塞进 Prompt 会爆上下文，让AI按照开发手册检查，直接凭感觉照着写又会丢失细节。

为此，我开源了 Alibaba Java Development Guide Skill —— 一份专为 Claude Code / Codex 打造的《阿里巴巴 Java 开发手册（黄山版）》结构化 Skill。

🌟 核心亮点：

1. 完整收录，原汁原味：完整收录黄山版 7 大维度（编程/异常/单测/安全/MySQL/工程/设计）共 2000+ 行条文。

2. 保留分级与正反例：每条规约标注【强制】/【推荐】/【参考】，附带正例与反例，AI 修复时有的放矢。

3. 智能路由，极致省 Token：SKILL.md 仅作导航，命中场景时才读取对应 data/*.md，拒绝上下文爆炸。

4. 主流Agent适配，开箱即用：完美支持 Claude Code（用户级/项目级）与 OpenAI Codex CLI。

5. 渐进式披露：当需要review Java代码或者时编写Java代码时才需要读取具体的文档。

💡 安装后，你可以这样对 AI 说：

• “这段 SQL 有没有问题？” -> AI 会自动对照 MySQL 规约检查索引和分页。

• “Service 抛异常该怎么处理？” -> AI 会按异常日志规约给出标准错误码和 try-catch 写法。

• “帮我 review 这个类” -> AI 会逐条指出违反的【强制】规约，并给出阿里标准正例。

让 AI 从“能跑就行”进化到“企业级规范”。

欢迎 Star、PR 和 Issue！让我们一起码出高效，码出质量。

🔗 项目地址：

https://github.com/Sxuan-Coder/alibaba-java-development-guide

博客文章地址：

博客原文