让Java代码更可读：我把阿里Java开发手册黄山版的Skill开源了！

众所周知：用 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 等 AI编程场景、Java后端开发场景 打造的《阿里巴巴 Java 开发手册（黄山版）》Skill。

🌟 核心亮点：

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

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

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

• 主流Agent适配，开箱即用：完美支持 Claude Code 与 Codex，cursor等第三方IDE也能通过接受cc规范使用该skill。

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

使用方法

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

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

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

让 AI 从能跑就行、凭感觉做事进化到“大厂P7规范”。

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

🔗 项目开源地址： https://github.com/Sxuan-Coder/alibaba-java-development-guide