一个精心策划、面向生产环境的库，包含AI Agent Skills、Checkstyle 规则集和Maven质量门，专为Java开发者量身定制。

旨在让AI编码助手（Claude、Antigravity、Cursor、Windsurf、Copilot）扎根于企业级Java 21标准、有效Java实践和干净代码原则。

📖 “为什么”

AI代理开箱即用的Java写得还行，但他们常常会误会过时的API，忽视企业标准，或者写出无法通过CI流水线Checkstyle或SonarQube门的代码。

这个仓库弥合了这一鸿沟。通过将这些精心打造的“技能”注入AI代理的上下文中，你可以强迫它像一位真正关心以下事务的首席Java工程师一样行动：

• 干净代码与高效Java
• 正确的内存管理和线程
• 现代弹簧靴3范式
• 零容忍质量门

---

📑 目录

• “为什么”
• 为什么要用这些技能？
• 存储库结构
• 使用与安装
• 🌟 Skill目录（当前与路线图）
• ⚙️ 包含优质门和模板
• 🤝 贡献

---

💡 为什么要用这些技能？

• 消除幻觉： 将人工智能建立在特定的 Java 21 LTS API（例如：

Awesome Java Agent Skills 🚀

A curated, production-ready library of AI Agent Skills, Checkstyle rulesets, and Maven quality gates tailored for Java developers.

Designed to ground AI coding assistants (Claude, Antigravity, Cursor, Windsurf, Copilot) in enterprise Java 21 standards, Effective Java practices, and clean code principles.

📖 The “Why”

AI agents write okay Java out of the box, but they often hallucinate outdated APIs, ignore enterprise standards, or write code that fails your CI pipeline’s Checkstyle or SonarQube gates.

This repository bridges the gap. By injecting these meticulously crafted “skills” into your AI agent’s context, you can force it to act like a Principal Java Engineer who actually cares about:

• Clean Code & Effective Java
• Proper Memory Management & Threading
• Modern Spring Boot 3 Paradigms
• Zero-Tolerance Quality Gates

---

📑 Table of Contents

• The “Why”
• Why Use These Skills?
• Repository Structure
• Usage & Installation
• 🌟 The Skill Catalog (Current & Roadmap)
• ⚙️ Included Quality Gates & Templates
• 🤝 Contributing

---

💡 Why Use These Skills?

• Eliminate Hallucinations: Ground the AI in specific Java 21 LTS APIs (e.g., Virtual Threads, Records, Pattern Matching).
• Pass CI/CD First Time: AI code is pre-conditioned to respect 100-character line limits, explicit imports, and strict JavaDoc rules.
• Enterprise Ready: Stop your AI from returning “hello world” code. Force it to implement proper exception handling, immutable DTOs, and robust tests.
• Agent Agnostic: Use the provided adapters to export skills to Cursor, Windsurf, Antigravity, or Copilot.

---

📂 Repository Structure

While many “awesome” repos are just flat lists of links, this repository is a living library of configurations and rules.

awesome-java-agent-skills/
├── .github/
│   └── workflows/
│       └── validate-skills.yml              # CI workflow verifying SKILL.md format
├── adapters/
│   └── export_to_cursor.py                  # Helper tool to convert SKILL.md -> Cursor .mdc
├── skills/                                  # Core skills categorized by domain
│   ├── clean-code/
│   │   └── java-clean-code/                 # Available NOW!
│   │       └── SKILL.md                     
│   └── ...                                  # (See Roadmap below)
├── templates/
│   └── quality-gates/