[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77Y6C9J44EVCFSSX8FZE680":3,"skill-same:01M77Y6C9J44EVCFSSX8FZE680":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":13,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M77Y6C9J44EVCFSSX8FZE680","spring-boot-standards",null,"Use when building a Spring Boot 3.x service (Java or Kotlin) in a touchstone repo — structure, DI, typed config, web\u002Fvalidation, JPA, transactions, security, testing. Triggers on `org.springframework.boot` deps, `@SpringBootApplication`, `application.yml`\u002F`application.properties`. JVM language rules live in the java-kotlin skill.","hwanngo\u002Ftouchstone","hwanngo","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F40811995?v=4","01M77Y071N2D3A6BMB2GVS4F36","01M77Y072AAS1FW736DJ42EP5S",0,"MIT","https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone\u002Fblob\u002Fmain\u002Fskills\u002Fspring-boot-standards\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: spring-boot-standards\ndescription: Use when building a Spring Boot 3.x service (Java or Kotlin) in a touchstone repo — structure, DI, typed config, web\u002Fvalidation, JPA, transactions, security, testing. Triggers on `org.springframework.boot` deps, `@SpringBootApplication`, `application.yml`\u002F`application.properties`. JVM language rules live in the java-kotlin skill.\nlicense: MIT\nmetadata:\n  version: 0.2.0\n  author: touchstone\n---\n\n# Spring Boot (framework)\n\nFull standard: **`standards\u002Fframeworks\u002Fspring-boot.md`** (layers on `standards\u002Flanguages\u002Fjava-kotlin.md`). This\nskill inlines the load-bearing rules so it stays useful standalone in `~\u002F.claude\u002Fskills\u002F`:\n\n## Always\n- **Package-by-feature**, not package-by-layer; `controller → service → repository` is the only call direction. DTOs at the edge, JPA entities in the core.\n- **Constructor injection only** — no field\u002Fsetter `@Autowired`, no `getBean` service-locator calls.\n- **Typed `@ConfigurationProperties` (`@Validated`)**, not scattered `@Value`. Secrets come from env\u002Fsecret-manager, **never** `application.yml`; profiles override structure only.\n- **`@Valid` Bean Validation at the boundary**; errors as RFC 9457 `ProblemDetail` via `@RestControllerAdvice`; never return entities or leak stack traces.\n- **`@Transactional` on services only** (`readOnly` for queries, short txns); migrations via Flyway\u002FLiquibase; `ddl-auto=validate` (never `update`); `open-in-view=false`.\n\n## Don't get burned\n- **N+1** — default associations LAZY, then `JOIN FETCH`\u002F`@EntityGraph` per query; assert query counts on hot endpoints.\n- **Self-invocation** — a `this.method()` call skips the proxy, so its `@Transactional` is silently ignored.\n- **Concurrency** — pick one model: MVC + virtual threads (`spring.threads.virtual.enabled=true`) for blocking JPA; WebFlux only for a fully non-blocking stack. One `block()` on the event loop stalls every request.\n- **Security** — Spring Security deny-by-default (`anyRequest().authenticated()`); lock down Actuator except `health`\u002F`info`.\n- **Tests** — slice it (`@WebMvcTest`\u002F`@DataJpaTest`\u002F`@SpringBootTest`); Testcontainers with a real Postgres via `@ServiceConnection`, not H2.\n\n## Defer (don't duplicate)\n- JDK\u002Fbuild\u002Fnull-safety → `..\u002F..\u002Fstandards\u002Flanguages\u002Fjava-kotlin.md`; schema\u002Fmigrations\u002FN+1 → `..\u002F..\u002Fstandards\u002Fplatform\u002Fdatabase.md`; authN\u002FauthZ → `..\u002F..\u002Fstandards\u002Fpractices\u002Fapp-security.md`; metrics\u002Ftraces → `..\u002F..\u002Fstandards\u002Fplatform\u002Fobservability.md`; HTTP contracts → `..\u002F..\u002Fstandards\u002Fdesign\u002Fapi-design.md`.\n\n## Done\nconstructor DI · typed config, secrets external · `ProblemDetail` errors · `@Transactional` on services · N+1 guarded · deny-by-default security · sliced tests + Testcontainers. See `standards\u002Fframeworks\u002Fspring-boot.md`.\n","# Spring Boot (framework)\n\nFull standard: **`standards\u002Fframeworks\u002Fspring-boot.md`** (layers on `standards\u002Flanguages\u002Fjava-kotlin.md`). This\nskill inlines the load-bearing rules so it stays useful standalone in `~\u002F.claude\u002Fskills\u002F`:\n\n## Always\n- **Package-by-feature**, not package-by-layer; `controller → service → repository` is the only call direction. DTOs at the edge, JPA entities in the core.\n- **Constructor injection only** — no field\u002Fsetter `@Autowired`, no `getBean` service-locator calls.\n- **Typed `@ConfigurationProperties` (`@Validated`)**, not scattered `@Value`. Secrets come from env\u002Fsecret-manager, **never** `application.yml`; profiles override structure only.\n- **`@Valid` Bean Validation at the boundary**; errors as RFC 9457 `ProblemDetail` via `@RestControllerAdvice`; never return entities or leak stack traces.\n- **`@Transactional` on services only** (`readOnly` for queries, short txns); migrations via Flyway\u002FLiquibase; `ddl-auto=validate` (never `update`); `open-in-view=false`.\n\n## Don't get burned\n- **N+1** — default associations LAZY, then `JOIN FETCH`\u002F`@EntityGraph` per query; assert query counts on hot endpoints.\n- **Self-invocation** — a `this.method()` call skips the proxy, so its `@Transactional` is silently ignored.\n- **Concurrency** — pick one model: MVC + virtual threads (`spring.threads.virtual.enabled=true`) for blocking JPA; WebFlux only for a fully non-blocking stack. One `block()` on the event loop stalls every request.\n- **Security** — Spring Security deny-by-default (`anyRequest().authenticated()`); lock down Actuator except `health`\u002F`info`.\n- **Tests** — slice it (`@WebMvcTest`\u002F`@DataJpaTest`\u002F`@SpringBootTest`); Testcontainers with a real Postgres via `@ServiceConnection`, not H2.\n\n## Defer (don't duplicate)\n- JDK\u002Fbuild\u002Fnull-safety → `..\u002F..\u002Fstandards\u002Flanguages\u002Fjava-kotlin.md`; schema\u002Fmigrations\u002FN+1 → `..\u002F..\u002Fstandards\u002Fplatform\u002Fdatabase.md`; authN\u002FauthZ → `..\u002F..\u002Fstandards\u002Fpractices\u002Fapp-security.md`; metrics\u002Ftraces → `..\u002F..\u002Fstandards\u002Fplatform\u002Fobservability.md`; HTTP contracts → `..\u002F..\u002Fstandards\u002Fdesign\u002Fapi-design.md`.\n\n## Done\nconstructor DI · typed config, secrets external · `ProblemDetail` errors · `@Transactional` on services · N+1 guarded · deny-by-default security · sliced tests + Testcontainers. See `standards\u002Fframeworks\u002Fspring-boot.md`.\n",{"name":5,"license":14,"metadata":23,"description":7},{"author":24,"version":25},"touchstone","0.2.0","main","d733e177953000560b4cee8f6c01c63aa7a498f0","skills\u002Fspring-boot-standards","https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone","https:\u002F\u002Fgithub.com\u002Fhwanngo","\"There is always one more bug to fix.\"","2026-08-26 01:16:05",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add hwanngo\u002Ftouchstone --skill spring-boot-standards",{"tool":39,"command":40},"bunx","bunx skills add hwanngo\u002Ftouchstone --skill spring-boot-standards",{"tool":42,"command":43},"pnpm","pnpm dlx skills add hwanngo\u002Ftouchstone --skill spring-boot-standards","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone\u002Fblob\u002Fmain\u002Fskills\u002Fspring-boot-standards\u002FSKILL.md",true,[],[48,55,62,67,72,77],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":18},"01M77YA15EH4A1SDYPZSPZSE8V","ok-standards","Use when writing shell, per standards\u002Flanguages\u002Fshell.md.","https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fstandards-known-good\u002Fskills\u002Fok-standards\u002FSKILL.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":18},"01M77Y9YK8K580BZ6GNZP6N0PW","demo-standards","Use when editing demo code in a touchstone fixture repo, a deliberately ordinary description that is long enough to clear the forty character minimum.","https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills-url-ignored\u002Fskills\u002Fdemo-standards\u002FSKILL.md",[],[],{"skillNo":63,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M77Y9VKRQH1CD8B7Y1BZX0PX","https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills-stray-xml\u002Fskills\u002Fdemo-standards\u002FSKILL.md",[],[],{"skillNo":68,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":18},"01M77Y9SZBHZJES7014P5W1A33","https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills-pointer-sentence-period\u002Fskills\u002Fdemo-standards\u002FSKILL.md",[],[],{"skillNo":73,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":18},"01M77Y9Q6PRTYDTPR8EK0TMJC6","https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills-pointer-relative-dead\u002Fskills\u002Fdemo-standards\u002FSKILL.md",[],[],{"skillNo":78,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M77Y9NH1Z2528QQ6VQ45G6RV","https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills-pointer-outside-repo\u002Fskills\u002Fdemo-standards\u002FSKILL.md",[],[]]