用 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。
🌟 核心亮点:
完整收录,原汁原味:完整收录黄山版 7 大维度(编程/异常/单测/安全/MySQL/工程/设计)共 2000+ 行条文。
保留分级与正反例:每条规约标注【强制】/【推荐】/【参考】,附带正例与反例,AI 修复时有的放矢。
智能路由,极致省 Token:
SKILL.md仅作导航,命中场景时才读取对应data/*.md,拒绝上下文爆炸。主流Agent适配,开箱即用:完美支持 Claude Code(用户级/项目级)与 OpenAI Codex CLI。
渐进式披露:当需要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

