内容
# 命令、代理和技能，用于Java
<a href="https://trendshift.io/repositories/15013" target="_blank"><img src="https://trendshift.io/api/badge/repositories/15013" alt="jabrena%2Fcursor-rules-java | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
[](https://starchart.cc/jabrena/cursor-rules-java)
[](https://github.com/jabrena/cursor-rules-java/actions/workflows/maven.yaml)
> **语言：** [西班牙语](./README_ES.md) · [中文](./README_ZH.md)
>
> **帮助这个项目成长：** [成为赞助者](https://github.com/sponsors/jabrena)
## 目标
一种有偏见的AI原生工作流，用于通过可重用的`技能`、`代理`、`命令`和`MCP服务器`，演化现代Java企业`SDLC`实践。
## 项目概览
- 12个命令
- 9个代理
- 116个技能
## 最新更新
在[项目网站](https://jabrena.github.io/cursor-rules-java/)上探索最新的发布内容，并通过新的技能、改进和修复，在[更新日志](./CHANGELOG.md)中跟踪其演变。
## 60秒开始
为你偏爱的代理安装所有技能：
```bash
# Cursor
npx skills add jabrena/cursor-rules-java --skill '*' --agent cursor -y
# Claude Code
npx skills add jabrena/cursor-rules-java --skill '*' --agent claude-code -y
# Codex
npx skills add jabrena/cursor-rules-java --skill '*' --agent codex -y
# GitHub Copilot
npx skills add jabrena/cursor-rules-java --skill '*' --agent github-copilot -y
```
### 实际演示
询问你的代理：
```text
使用 @110-java-maven-best-practices 审查这个 Maven 项目。
解释发现的问题，应用批准的改进，并验证构建。
```
技能通过结构化的 Maven 审查引导代理，同时让你控制提议的更改。
## 5分钟 onboarding
通过快速指南[5分钟入门](./documentation/guides/GETTING-STARTED-IN-5-MINUTES.md)学习使用这个项目。
### 从旧规则迁移
当前的`系统提示/规则`已被弃用，将在`v0.17.0`中删除。如果你仍然使用它们，请查看[版本 0.14.0 文章](https://jabrena.github.io/cursor-rules-java/blog/2026/04/release-0.14.0.html)。
## 选择你的路径
命令通过将工作路由到正确的代理和技能集来组成工作流：
### 计划
将想法转化为可行的变更，包含用户故事、GitHub 问题或 Jira、ADRs、图表、AI 计划模式和 OpenSpec。
```text
/update-issue
@robot-business-analyst
@043-planning-github-issues
@044-planning-jira
@045-planning-azure-devops
@014-agile-user-story
/create-adr
@robot-architect
@030-architecture-adr-general
@031-architecture-adr-functional-requirements
@032-architecture-adr-non-functional-requirements
/create-diagram
@robot-architect
@033-architecture-diagrams
/create-spec
@robot-tech-lead
@042-planning-openspec
@051-design-two-steps-methods
@052-design-hamburger-method
@053-design-simple-rules
@054-design-tdd
@055-design-parallel-change
@121-java-object-oriented-design
@122-java-type-design
@123-java-design-patterns
@130-java-testing-strategies
/explore-design
@robot-architect
@034-architecture-design-exploration
/review-alignment
@robot-business-analyst
/review-breaking-changes
@robot-tech-lead
MCP 服务器
Jbang-Quarkus-JDBC
MongoDB
JavaDocs
Serena-LSP
Grafana
```
### 构建
使用 Maven 实现和改进 Java 应用程序，设计、编码、测试、安全、文档、Spring Boot、Quarkus、Micronaut、OpenAPI 和 WireMock 指导。
```text
/implement-issue
@robot-tech-lead
/create-feature-branch
/create-worktree
@robot-java-coder
@robot-java-spring-boot-coder
@robot-java-quarkus-coder
@robot-java-micronaut-coder
@robot-no-java
MCP 服务器
Jbang-Quarkus-JDBC
MongoDB
JavaDocs
Serena-LSP
```
### 运行
通过可观察性、性能测试、基准测试和性能调优，衡量和改进生产行为。
```text
/profile
@robot-java-performance
@161-java-profiling-detect
@162-java-profiling-analyze
@163-java-profiling-refactor
@164-java-profiling-verify
/benchmark
@robot-java-performance
@151-java-performance-jmeter
@152-java-performance-gatling
MCP 服务器
Jbang-Quarkus-JDBC
MongoDB
Serena-LSP
Grafana
```
### 合规性（Alpha）
审查 Java 系统、AI 模型以及 GenAI 工具在应用程序和交付管道中的使用情况，以实现法规感知工程控制、证据和合格所有者移交，涵盖 AI、数据、安全、产品、平台、市场和治理。**<u>这些技能支持工程意识，不提供法律建议。</u>**
| 法规 | 技能 |
| --- | --- |
| [欧盟人工智能法案](https://eur-lex.europa.eu/legal-content/EN/TXT/HTML/?uri=OJ:L_202401689) | `801-regulations-eu-ai-act` |
| [DORA](https://eur-lex.europa.eu/legal-content/EN/TXT/HTML/?uri=CELEX:32022R2554) | `802-regulations-dora` |
| [GDPR](https://eur-lex.europa.eu/legal-content/EN/TXT/HTML/?uri=CELEX:32016R0679) | `803-regulations-gdpr` |
| [NIS2](https://eur-lex.europa.eu/legal-content/EN/TXT/HTML/?uri=CELEX:32022L2555) | `804-regulations-eu-nis2` |
| [网络韧性法案](https://eur-lex.europa.eu/legal-content/EN/TXT/HTML/?uri=CELEX:32024R2847) | `805-regulations-eu-cyber-resilience-act` |
| [数据法案](https://eur-lex.europa.eu/legal-content/EN/TXT/HTML/?uri=CELEX:32023R2854) | `806-regulations-eu-data-act` |
| [数字服务法案](https://eur-lex.europa.eu/legal-content/EN/TXT/HTML/?uri=CELEX:32022R2065) | `807-regulations-eu-digital-services-act` |
| [数字市场法案](https://eur-lex.europa.eu/legal-content/EN/TXT/HTML/?uri=CELEX:32022R1925) | `808-regulations-eu-digital-markets-act` |
| [MiFID II](https://eur-lex.europa.eu/eli/dir/2014/65/oj/eng) | `810-regulations-eu-mifid-ii` |
| [市场滥用法规](https://eur-lex.europa.eu/eli/reg/2014/596/oj/eng) | `811-regulations-eu-market-abuse-regulation` |
| [产品责任指令](https://eur-lex.europa.eu/eli/dir/2024/2853/oj/eng) | `812-regulations-eu-product-liability-directive` |
**注意：** 此技能集可能与未来的 [OWASP EU 合规性 MCP](https://genai.owasp.org/solution/eu-compliance-mcp) 互补。
探索完整的[命令](./documentation/guides/INVENTORY-COMMANDS-JAVA.md)、[代理](./documentation/guides/INVENTORY-AGENTS-JAVA.md)、[技能](./documentation/guides/INVENTORY-SKILLS-JAVA.md)和[MCP 服务器](./documentation/guides/THIRD-PARTIES.md)清单。
## 项目组件
项目在任何迭代结束时都会生成一组交付成果。
| 清单 | 安装 | 快速入门 |
| --------------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| 1. [命令](./documentation/guides/INVENTORY-COMMANDS-JAVA.md) | `@004-commands-installation` 在项目中安装命令 | [`命令`](./documentation/guides/COMMANDS.md) |
| 2. [代理](./documentation/guides/INVENTORY-AGENTS-JAVA.md) | `@005-agents-installation` 在 Cursor/Claude 中安装代理 | [`代理`](./documentation/guides/GETTING-STARTED-AGENTS.md) |
| 3. [技能](./documentation/guides/INVENTORY-SKILLS-JAVA.md) | `npx skills add jabrena/cursor-rules-java --skill '*' --agent cursor -y` | [`技能`](./documentation/guides/GETTING-STARTED-SKILLS.md) |
### 兼容性
该项目与任何支持`命令`、`代理`、`技能`、`MCP 服务器`和`AGENTS.md`的工具兼容。
## 技能验证
每次推送都会在[CI 构建](./.github/workflows/maven.yaml)中运行以下验证检查，以保持文档和生成的技能正确、一致和安全：
| 名称 | 目的 |
| --- | --- |
| 1. [MarkdownValidator](./markdown-validator/src/main/java/info/jab/markdownvalidator/MarkdownValidator.java) | 通过捕获 Markdown 解析偏差和远程链接故障来保护文档层。 |
| 2. [技能检查](https://github.com/thedaviddias/skill-check) | 确认每个生成的技能都遵循预期的打包合同，补充扫描行为或安全风险的扫描器。 |
| 3. [思科 AI 技能扫描器](https://github.com/cisco-ai-defense/skill-scanner) 由思科提供 | 通过寻找结构化验证无法看到的风险技能流，为行为导向的安全覆盖提供支持。 |
| 4. [SkillSpector](https://github.com/NVIDIA/SkillSpector) 由 NVIDIA 提供 | 提供独立的静态质量和安全审查，有助于将发现结果与扫描器进行比较。 |
| 5. [Snyk 代理扫描](https://github.com/snyk/agent-scan) 由 SNYK 提供 | 关注代理-技能供应链和提示风险信号，在思科和 SkillSpector 基础上添加另一个安全视角。 |
## 限制
### 缺乏确定性
从一开始就要注意，与这些`技能`和代理的交互结果不是确定性的，因为模型的表现方式，但可以通过明确的目标和验证检查点来缓解。
### 并非所有模型的行为都相同
一些交互式技能需要`高级`模型进行交互；否则，它们会遵循固定的步骤序列。
### 与模型的交互限制
模型可以生成代码，但不能在本地数据上执行。要弥合这一差距，一些技能包含您在本地运行的脚本。
### 软件工程师必须保持参与
该项目支持软件工程工作；它不会取代工程判断。软件工程师必须审查、指导和验证 AI 生成的决策、代码和结果，然后再使用它们。
### 访问企业数据
使用涉及企业数据库或其他敏感组织数据的 AI 辅助工作流时要谨慎。在授予访问权限之前，请评估授权、隐私、数据泄漏、保留和意外修改风险。应用最小特权访问、人工审查、验证和监控。参见 [OWASP GenAI 数据安全风险和缓解措施 2026](https://genai.owasp.org/resource/owasp-genai-data-security-risks-mitigations-2026)，以及新的[关于欧盟法规的技能](#compliance-alpha)。
## 贡献
- 遵循 [5 分钟指南](./documentation/guides/GETTING-STARTED-IN-5-MINUTES.md)，并告诉我们哪里可以改进。
- [浏览技能清单](./documentation/guides/INVENTORY-SKILLS-JAVA.md)，并提出缺少的 Java 工作流。
- [打开问题](https://github.com/jabrena/cursor-rules-java/issues) 报告问题或建议增强功能。
- 阅读 [CONTRIBUTING.md](./CONTRIBUTING.md) 以改进技能、代理、命令或项目指南。
- 如果这些工作流有助于您的 Java 项目，请给仓库加星。
## 架构决策记录（ADR）
- 查看 [ADR 索引](./documentation/adr/README.md) 获取完整列表。
## Java 8 以来的 Java JEP
Java 使用 JEP（JDK 增强提案）来描述新的语言和平台功能。该仓库跟踪哪些 JEP 可以改进这里的技能和指导。
- [JEP 列表](./documentation/jeps/All-JEPS.md)
## 更多资源
演讲、文章、参考链接、技能门户和相关项目都存放在[项目参考](./documentation/guides/PROJECT-REFERENCES.md)中。
由 [Cursor](https://www.cursor.com/) 和 [Codex](https://openai.com/codex/) 支持，带着 ❤️ 来自 [Madrid](https://www.google.com/maps/place/Community+of+Madrid,+Madrid/@40.4983324,-6.3162283,8z/data=!3m1!4b1!4m6!3m5!1s0xd41817a40e033b9:0x10340f3be4bc880!8m2!3d40.4167088!4d-3.5812692!16zL20vMGo0eGc?entry=ttu&g_ep=EgoyMDI1MDgxOC4wIKXMDSoASAFQAw%3D%3D)。
连接信息
猜你喜欢
暂无推荐服务器