jugs-demo
一个用于安全生成Java代码的演示项目，结合AI代理、技能与防护栏。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：jugs-demo。 它的用途是：一个用于安全生成Java代码的演示项目，结合AI代理、技能与防护栏。 详细介绍见：https://321skill.com/skills/jugs-demo/ 请根据该页面的说明完成安装。
使用示例
“请根据`specs/negocio/produtos-negocio-parte1.md`中的业务规范，使用`agente-java`代理和`cleancode`技能，为我生成对应的Spring Boot Controller和Service层代码。”，它会遵循项目定义的技能（如代码简洁性）和防护栏（如不使用特定危险API），生成结构清晰、符合Java 21和Spring Boot 4.1.0规范的代码骨架。
介绍
该仓库是一个教学演示项目，旨在展示如何利用AI代理、技能（Skills）和防护栏（Guardrails）从规范（Specs）安全、可控地生成Java代码。它解决了在AI辅助编程中，如何确保生成的代码符合特定技术栈、架构规范和安全边界的问题。
使用方式是通过配置好的AI代理（如专注于整洁代码的agente-java或教学演示的agente-professor），结合项目中的业务规范文档（位于src/resources/specs/）和技能定义（如cleancode.md），来引导AI生成符合Spring Boot 4.1.0和Java 21规范的代码。项目结构清晰，包含了代理配置、技能定义和规范文档。
它非常适合正在学习或研究如何将AI智能体集成到企业级Java开发流程中的开发者、架构师或技术布道师。对于希望建立可预测、安全代码生成管线的团队也有参考价值。
请注意，此项目为特定演讲的简化演示，结构和命名都做了精简，旨在阐明概念而非用于生产。实际使用时，需要根据自身项目复杂度扩展其技能和防护栏规则。
核心特点
核心区别在于其明确的“教学演示”定位，提供了从业务规范到代码生成的完整、可运行的示例，并清晰地分离了“技能”（指导AI如何写代码）和“防护栏”（限制AI不能做什么）的概念，而非仅仅提供一个代码生成工具。
注意事项
这是一个为演讲定制的简化演示项目，不适合直接用于复杂的生产环境开发。
常见问题
这个项目能直接用来生成我的业务代码吗？
不能直接使用，它是一个教学演示，结构和规范都极度简化，需要你根据自身项目进行大量改造和扩展。
它支持哪些AI代理或工具？
项目本身提供了针对Claude等AI的代理配置（.agent.md文件）和技能定义，理论上可适配支持类似配置的AI编码助手。