[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74NFRFG8GZH8GDG61RR7CJ9":3,"skill-same:01M74NFRFG8GZH8GDG61RR7CJ9":53},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":29,"commitSha":30,"skillDirectory":31,"forksCount":32,"repositoryHtmlUrl":33,"repositoryHomepageUrl":34,"ownerHtmlUrl":35,"ownerBlogUrl":36,"ownerDescription":37,"updatedAt":38,"install":39,"resources":52},"01M74NFRFG8GZH8GDG61RR7CJ9","stack-java",null,"Java coding standards for Spring Boot and Quarkus services — naming, immutability, Optional, streams, DI","Snakeblack\u002Fospec-workflow","Snakeblack","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F49766621?v=4","01M74NA5A4XHJYFRMG9JHM2R4K","Michael Snake","01M74NA5ASKTH7DG1P6DKC8WTX",3,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FSnakeblack\u002Fospec-workflow\u002Fblob\u002Fmain\u002Fskills\u002Fstack-java\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: stack-java\ndescription: \"Java coding standards for Spring Boot and Quarkus services — naming, immutability, Optional, streams, DI\"\nlicense: Apache-2.0\nmetadata:\n  author: manuel-retamozo-garcia\n  version: \"1.0\"\ncapabilities: [java]\n---\n\n## Critical Rules\n\n- Any executor sub-agent using this skill must first determine the framework from the build file (e.g., Maven `pom.xml` or Gradle `build.gradle`):\n  - If build file contains `quarkus` -> apply **[QUARKUS]** conventions.\n  - If build file contains `spring-boot` -> apply **[SPRING]** conventions.\n  - If neither is detected -> apply shared conventions only.\n- Prefer clarity over cleverness. Java 17+ features (records, sealed classes, pattern matching) should be used where appropriate.\n- Minimize shared mutable state; prefer immutability by default.\n- Fail fast with meaningful, domain-specific exceptions.\n- **[QUARKUS]**: Favor build-time processing over runtime processing. Avoid runtime reflection where possible.\n\n## Naming & Code Style\n\n- Classes & Records must use `PascalCase` (e.g., `MarketService`, `Money`).\n- Methods & fields must use `camelCase` (e.g., `marketRepository`, `findBySlug`).\n- Constants must use `UPPER_SNAKE_CASE` (e.g., `MAX_PAGE_SIZE = 100`).\n- **[QUARKUS]**: Name JAX-RS resources as `*Resource` (e.g., `MarketResource`), not `*Controller`.\n- **[SPRING]**: Name REST controllers as `*Controller` (e.g., `MarketController`).\n\n## Immutability\n\n- Favor records and final fields for data transfer objects (DTOs) and value objects:\n  ```java\n  public record MarketDto(Long id, String name, MarketStatus status) {}\n  ```\n- **[QUARKUS]**: Panache active-record entities use public fields (as idiomatic Quarkus behavior since Quarkus generates accessors at build time):\n  ```java\n  @Entity\n  public class Market extends PanacheEntity {\n      public String name;\n      public MarketStatus status;\n  }\n  ```\n\n## Optional & Streams Best Practices\n\n- Return `Optional` from `find*` query methods instead of returning null or throwing immediate exceptions.\n- Prefer mapping and chaining operations over calling `.get()` directly:\n  ```java\n  return market\n      .map(MarketResponse::from)\n      .orElseThrow(() -> new EntityNotFoundException(\"Market not found\"));\n  ```\n- Keep Stream pipelines short and readable. Use them primarily for clean transformations. Do not use complex nested streams; prefer structured loops for readability when logic is complex.\n\n## Dependency Injection\n\n- **[SPRING]**: Use constructor injection for dependencies; avoid field-level `@Autowired` injection:\n  ```java\n  @Service\n  public class MarketService {\n      private final MarketRepository marketRepository;\n\n      public MarketService(MarketRepository marketRepository) {\n          this.marketRepository = marketRepository;\n      }\n  }\n  ```\n- **[QUARKUS]**: Use constructor injection with `@Inject`:\n  ```java\n  @ApplicationScoped\n  public class MarketService {\n      private final MarketRepository marketRepository;\n\n      @Inject\n      public MarketService(MarketRepository marketRepository) {\n          this.marketRepository = marketRepository;\n      }\n  }\n  ```\n","## Critical Rules\n\n- Any executor sub-agent using this skill must first determine the framework from the build file (e.g., Maven `pom.xml` or Gradle `build.gradle`):\n  - If build file contains `quarkus` -> apply **[QUARKUS]** conventions.\n  - If build file contains `spring-boot` -> apply **[SPRING]** conventions.\n  - If neither is detected -> apply shared conventions only.\n- Prefer clarity over cleverness. Java 17+ features (records, sealed classes, pattern matching) should be used where appropriate.\n- Minimize shared mutable state; prefer immutability by default.\n- Fail fast with meaningful, domain-specific exceptions.\n- **[QUARKUS]**: Favor build-time processing over runtime processing. Avoid runtime reflection where possible.\n\n## Naming & Code Style\n\n- Classes & Records must use `PascalCase` (e.g., `MarketService`, `Money`).\n- Methods & fields must use `camelCase` (e.g., `marketRepository`, `findBySlug`).\n- Constants must use `UPPER_SNAKE_CASE` (e.g., `MAX_PAGE_SIZE = 100`).\n- **[QUARKUS]**: Name JAX-RS resources as `*Resource` (e.g., `MarketResource`), not `*Controller`.\n- **[SPRING]**: Name REST controllers as `*Controller` (e.g., `MarketController`).\n\n## Immutability\n\n- Favor records and final fields for data transfer objects (DTOs) and value objects:\n  ```java\n  public record MarketDto(Long id, String name, MarketStatus status) {}\n  ```\n- **[QUARKUS]**: Panache active-record entities use public fields (as idiomatic Quarkus behavior since Quarkus generates accessors at build time):\n  ```java\n  @Entity\n  public class Market extends PanacheEntity {\n      public String name;\n      public MarketStatus status;\n  }\n  ```\n\n## Optional & Streams Best Practices\n\n- Return `Optional` from `find*` query methods instead of returning null or throwing immediate exceptions.\n- Prefer mapping and chaining operations over calling `.get()` directly:\n  ```java\n  return market\n      .map(MarketResponse::from)\n      .orElseThrow(() -> new EntityNotFoundException(\"Market not found\"));\n  ```\n- Keep Stream pipelines short and readable. Use them primarily for clean transformations. Do not use complex nested streams; prefer structured loops for readability when logic is complex.\n\n## Dependency Injection\n\n- **[SPRING]**: Use constructor injection for dependencies; avoid field-level `@Autowired` injection:\n  ```java\n  @Service\n  public class MarketService {\n      private final MarketRepository marketRepository;\n\n      public MarketService(MarketRepository marketRepository) {\n          this.marketRepository = marketRepository;\n      }\n  }\n  ```\n- **[QUARKUS]**: Use constructor injection with `@Inject`:\n  ```java\n  @ApplicationScoped\n  public class MarketService {\n      private final MarketRepository marketRepository;\n\n      @Inject\n      public MarketService(MarketRepository marketRepository) {\n          this.marketRepository = marketRepository;\n      }\n  }\n  ```\n",{"name":5,"license":15,"metadata":24,"description":7,"capabilities":27},{"author":25,"version":26},"manuel-retamozo-garcia","1.0",[28],"java","main","e5fa11517ba3d433260f3077a2b8fadfad290896","skills\u002Fstack-java",0,"https:\u002F\u002Fgithub.com\u002FSnakeblack\u002Fospec-workflow","https:\u002F\u002Fospec-workflow.mretamozo.com","https:\u002F\u002Fgithub.com\u002FSnakeblack","mretamozo.com","Full Stack Developer | Lifelong learner","2026-11-15 04:24:36",{"source":8,"skillName":5,"commands":40,"prompt":50,"zipAvailable":51},[41,44,47],{"tool":42,"command":43},"npx","npx skills add Snakeblack\u002Fospec-workflow --skill stack-java",{"tool":45,"command":46},"bunx","bunx skills add Snakeblack\u002Fospec-workflow --skill stack-java",{"tool":48,"command":49},"pnpm","pnpm dlx skills add Snakeblack\u002Fospec-workflow --skill stack-java","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSnakeblack\u002Fospec-workflow\u002Fblob\u002Fmain\u002Fskills\u002Fstack-java\u002FSKILL.md",true,[],[54,61,68,75,82,89],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M74NGTKSC65ZZZMZH9SVP86D","work-unit-commits","Plan commits as reviewable work units. Trigger: implementation, commit splitting, chained PRs, or keeping tests and docs with code.","https:\u002F\u002Fgithub.com\u002FSnakeblack\u002Fospec-workflow\u002Fblob\u002Fmain\u002Fskills\u002Fwork-unit-commits\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M74NGQBZ2BPFSNGREJJ2RKHG","stack-webmcp","Trigger: WebMCP, document.modelContext, web tools, AI browser agent. Web Model Context Protocol client-side tool standard.","https:\u002F\u002Fgithub.com\u002FSnakeblack\u002Fospec-workflow\u002Fblob\u002Fmain\u002Fskills\u002Fstack-webmcp\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M74NGM8GVVSMC8T2CHGR8DFZ","stack-vite","Vite frontend build tool — configuration, plugins, asset loading","https:\u002F\u002Fgithub.com\u002FSnakeblack\u002Fospec-workflow\u002Fblob\u002Fmain\u002Fskills\u002Fstack-vite\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M74NGHF902XYK25R6AZ1XK2T","stack-starlight","Astro Starlight documentation framework — setup, sidebar navigation, frontmatter, built-in components, asides, theming, i18n, search","https:\u002F\u002Fgithub.com\u002FSnakeblack\u002Fospec-workflow\u002Fblob\u002Fmain\u002Fskills\u002Fstack-starlight\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M74NGFD2Q6GKDA7C233756X8","stack-sqlserver","Microsoft SQL Server database — indexing, RCSI, set-based operations, SARGable queries, transaction scopes","https:\u002F\u002Fgithub.com\u002FSnakeblack\u002Fospec-workflow\u002Fblob\u002Fmain\u002Fskills\u002Fstack-sqlserver\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M74NGACCR2QG9EE5HPN51QBD","stack-springboot","Spring Boot architecture patterns — REST API design, layered services, JPA, caching, Spring Security, TDD with MockMvc and Testcontainers, and pre-release verification","https:\u002F\u002Fgithub.com\u002FSnakeblack\u002Fospec-workflow\u002Fblob\u002Fmain\u002Fskills\u002Fstack-springboot\u002FSKILL.md",[],[]]