create-yss-spec 2.1.2 → 2.1.4

package/template/skills-lock.json

@@ -94,7 +94,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/code-review/SKILL.md",
-        "effectiveHash": "e336f095361832fbac27866a8d1c0fc61716ea7ce266c2d6eb193781ac6f60be",
+        "effectiveHash": "e1a71372e9ef1e5dc422fdf138ba2803ad7d4f6ce82d0fe276017276b365c150",
         "upstreamHash": "1d5e7242a98674635be79ab310cdda0e555d36a9903d2526ebf4263d0b7997ca",
         "targets": [
           ".agents/skills",
@@ -894,7 +894,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-api-integration/SKILL.md",
-        "effectiveHash": "ac7223a22d83bb0b0365534ab4772847e64cb439c82e8a1d4a0b1c15b3d50a69",
+        "effectiveHash": "fb6ccf48f016b6df63c3072fc771344c29a1523b5daf08f9512e7bbd79c6a3bc",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1029,7 +1029,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-ddd-scaffold-generator/SKILL.md",
-        "effectiveHash": "2dc2ac84fac2d4a3a1da433dcb863bd8f8c77dc559c584b688876ab2ff8fac05",
+        "effectiveHash": "b0febe45515f862957742dabd2cfb1df7c56811b059f60821efee6712534a834",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1044,7 +1044,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-design-system/SKILL.md",
-        "effectiveHash": "2626e379a57a197a87e97110eb805b68aae149b4e7388c15dab2b7a2ca55ea26",
+        "effectiveHash": "b8bde50efcd0226b7bbdfd830e738a3cdb4d74d135e1b2af8715057d1557a9b0",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1179,7 +1179,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-frontend-scaffold-generator/SKILL.md",
-        "effectiveHash": "b61aa0fdbcd1026757efade8054b84a4f260f1bdf3b1f4d9b6a0315a4a933979",
+        "effectiveHash": "6b966c5824b80f5196c7fd8225238b3047d9e49f1f94c60179e4a567d82911f5",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1265,26 +1265,11 @@
           ".trae/skills"
         ]
       },
-      "yss-openapi": {
-        "source": "project",
-        "sourceType": "local",
-        "skillPath": ".agents/skills/yss-openapi/SKILL.md",
-        "effectiveHash": "2283b86f5731d58d6138895f2418dd681abc49aa5b3b753b64ef3f7d0d87b690",
-        "targets": [
-          ".agents/skills",
-          ".claude/skills",
-          ".codex/skills",
-          ".hermes/skills",
-          ".pi/skills",
-          ".qoder/skills",
-          ".trae/skills"
-        ]
-      },
       "yss-openapi-draft-review": {
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-openapi-draft-review/SKILL.md",
-        "effectiveHash": "674d1b60d4b6fc5f13814e4b0c109fe183a54e23865f853994c0d7065847d40c",
+        "effectiveHash": "dcf5c6125081e1adb3b3ee0204f2e14fec62dd2ccb7857d2f0d46c1b64e2755c",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1299,7 +1284,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-openapi-governance/SKILL.md",
-        "effectiveHash": "9d34f131880fc517e163d2f73c93c8f141cc9d9411a6c015bd867d7085c4b31a",
+        "effectiveHash": "20ea763036bc0cbf355c2a644cc65e3054cfaa29de679f699409e24d8d647088",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1329,7 +1314,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-product-lifecycle/SKILL.md",
-        "effectiveHash": "199a9f9422cdbb9e31d7517fa4ee9738e41e53a67188aeff9a0130d4f154f93a",
+        "effectiveHash": "b048cd8d1c9ab5d4d3f10e5c0a391b983a05f0c6075a710e086b093607f7f391",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1374,7 +1359,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-router/SKILL.md",
-        "effectiveHash": "5f19ae24070a93bae92fcd8731857e9a57027c27970106eb82498484f8524008",
+        "effectiveHash": "14e111cbc36e0be6aee67358f580f20b917bf213ea5994acaa0f7f32340e9567",
         "targets": [
           ".agents/skills",
           ".claude/skills",

package/template/wiki/raw/skills-lock.json

@@ -1265,21 +1265,6 @@
           ".trae/skills"
         ]
       },
-      "yss-openapi": {
-        "source": "project",
-        "sourceType": "local",
-        "skillPath": ".agents/skills/yss-openapi/SKILL.md",
-        "effectiveHash": "2283b86f5731d58d6138895f2418dd681abc49aa5b3b753b64ef3f7d0d87b690",
-        "targets": [
-          ".agents/skills",
-          ".claude/skills",
-          ".codex/skills",
-          ".hermes/skills",
-          ".pi/skills",
-          ".qoder/skills",
-          ".trae/skills"
-        ]
-      },
       "yss-openapi-draft-review": {
         "source": "project",
         "sourceType": "local",

package/template/wiki/wiki/OpenAPI/345/245/221/347/272/246.md

@@ -6,4 +6,4 @@ OpenAPI Freeze 指已通过评审、可作为前后端实现和契约测试输
 
 OpenAPI 契约文件存放于 `docs/api/specs/`，评审检查清单与 Freeze 记录模板见 `docs/api/templates/`。OpenAPI Freeze 或无 API 影响记录完成后，使用 `to-tickets` 拆分成窄垂直切片（见 [[垂直切片Ticket]]）。OpenAPI Draft 属于待冻结资产，使用 `ready-for-human`；只有 Freeze 后的契约才支撑 `ready-for-agent` 的切片。
 
-YSS 的 OpenAPI 契约在实现后通过 `yss-openapi` 技能生成 OpenAPI JSON 并刷新前端 Orval API 客户端（见 [[YSS工程技能体系]]）。
+YSS 的 OpenAPI 契约以冻结的 OpenAPI 3.1 YAML 为唯一权威。`yss-openapi-governance` 使用锁定的 Redocly CLI 派生 JSON，随后由 `api-integration` 刷新前端 Orval API 客户端；JSON 与生成代码均不得手工修改（见 [[YSS工程技能体系]]）。

package/template/wiki/wiki/YSS/345/267/245/347/250/213/346/212/200/350/203/275/344/275/223/347/263/273.md

@@ -2,7 +2,7 @@
 
 YSS skills 是项目内置的 YSS 工程规范技能，用于 DDD、UI、OpenAPI、Repository、Controller、DTO、组件和编码规范，与 Matt Pocock 的轻量流程技能互补（见 [[Matt技能体系]]）。
 
-按领域划分：后端脚手架（`yss-ddd-scaffold-generator` 及 Domain / Application / Infrastructure / Web / Adapter 分层技能）、领域建模（`yss-domain`）、持久层（`yss-repository`、`yss-mybatis`、`yss-db2mybatis`）、Web 契约（`yss-web-controller`、`yss-dto`、`yss-openapi`）、前端（`yss-ui`、`yss-components`、`yss-formily`、`yss-hook`、`yss-page-module-development`）、以及横切组件（`yss-cache`、`yss-exception`、`yss-log`、`yss-userinfo`、`yss-distributed-id`、`yss-security-algorithm`、`yss-resilience4j` 等）。
+按领域划分：后端脚手架（`yss-ddd-scaffold-generator` 及 Domain / Application / Infrastructure / Web / Adapter 分层技能）、领域建模（`yss-domain`）、持久层（`yss-repository`、`yss-mybatis`、`yss-db2mybatis`）、Web 契约（`yss-web-controller`、`yss-dto`、`yss-openapi-governance`、`yss-openapi-draft-review`）、前端（`yss-ui`、`yss-components`、`yss-formily`、`yss-hook`、`yss-page-module-development`、`api-integration`）、以及横切组件（`yss-cache`、`yss-exception`、`yss-log`、`yss-userinfo`、`yss-distributed-id`、`yss-security-algorithm`、`yss-resilience4j` 等）。
 
 技能路由纪律：核心 YSS skills 必须消费批准合同并返回 YSS Skill Execution Result（见 [[切片实现合同]]）；路径越界、证据缺失、未执行验证、`drift`、`violation` 或 `new_impacts` 阻断继续实现或触发重路由。禁止绕过合同与检查清单直接在 `AGENTS.md` 中自行发明细则。
 

package/template/yss-public-skills.json

@@ -28,7 +28,6 @@
     "yss-log",
     "yss-microapp-commit",
     "yss-mybatis",
-    "yss-openapi",
     "yss-openapi-draft-review",
     "yss-openapi-governance",
     "yss-page-module-development",
@@ -74,7 +73,8 @@
         "yss-dto",
         "yss-jdbc",
         "yss-mybatis",
-        "yss-repository"
+        "yss-repository",
+        "yss-web-controller"
       ]
     },
     {
@@ -90,8 +90,7 @@
         "yss-page-module-development",
         "yss-ui",
         "yss-use-table-height",
-        "yss-use-tree-height",
-        "yss-web-controller"
+        "yss-use-tree-height"
       ]
     },
     {
@@ -99,7 +98,6 @@
       "description": "用于 YSS API 设计、审查、治理和生成集成的技能。",
       "skills": [
         "yss-api-integration",
-        "yss-openapi",
         "yss-openapi-draft-review",
         "yss-openapi-governance"
       ]

package/template.snapshot.json

@@ -3,8 +3,8 @@
   "templateName": "yss-spec-project-template",
   "templateSource": "github:iloveZzz/yss-spec-project-template",
   "templateRepository": "https://github.com/iloveZzz/yss-spec-project-template.git",
-  "requestedRef": "b61c5668d717822c2a69a8e8327fc45b1891b29b",
-  "templateCommit": "b61c5668d717822c2a69a8e8327fc45b1891b29b",
+  "requestedRef": "b6e005a538daae46309daaf9ade7ce8dc6bb93a7",
+  "templateCommit": "b6e005a538daae46309daaf9ade7ce8dc6bb93a7",
   "encodedPaths": {
     ".agents/skills/beautiful-article/assets/scaffold-template/.npmrc": ".agents/skills/beautiful-article/assets/scaffold-template/__yss_dotfile__.npmrc",
     ".agents/skills/drawio-academic-skills/.gitignore": ".agents/skills/drawio-academic-skills/__yss_dotfile__.gitignore",
@@ -32,6 +32,6 @@
     ".trae/skills/drawio-academic-skills/.gitignore": ".trae/skills/drawio-academic-skills/__yss_dotfile__.gitignore",
     ".trae/skills/excalidraw-diagram-generator/scripts/.gitignore": ".trae/skills/excalidraw-diagram-generator/scripts/__yss_dotfile__.gitignore"
   },
-  "snapshotHash": "93231767f7b762d0247e2db3f075c620b15a2820382e16d6d5e424d50ff922f4",
-  "generatedAt": "2026-08-13T05:40:01.242Z"
+  "snapshotHash": "067f8feda878be6e69e94e7248e34afa3c099234ad7009da0c49aefc03265366",
+  "generatedAt": "2026-08-16T18:16:16.070Z"
 }

package/template/.agents/skills/yss-ddd-scaffold-generator/assets/templates/config/smart-doc.json.template

@@ -1,17 +0,0 @@
-{
-  "isStrict": false,
-  "allInOne": true,
-  "outPath": "target/openapi",
-  "coverOld": true,
-  "createDebugPage": false,
-  "packageFilters": "{{base_package}}.*",
-  "showAuthor": true,
-  "requestFieldToUnderline": false,
-  "responseFieldToUnderline": false,
-  "inlineEnum": true,
-  "componentType": "NORMAL",
-  "recursionLimit": 7,
-  "requestExample": false,
-  "responseExample": false,
-  "displayActualType": false
-}

package/template/.agents/skills/yss-openapi/SKILL.md

@@ -1,116 +0,0 @@
----
-name: yss-openapi
-description: Use when an implemented YSS Java controller/DTO contract must generate OpenAPI JSON and refresh frontend Orval API clients.
----
-
-# YSS OpenAPI
-
-Use this skill to move an already implemented backend controller/DTO contract into the frontend generated API layer.
-
-This is an implementation/generation skill, not the product API design step and not the unified OpenAPI specification governance skill. It generates `openapi.json` from controller methods, request DTOs, response DTOs, annotations, and Java comments; it does not decide naming conventions, resource modeling, error taxonomy, pagination policy, permission semantics, or organization-wide OpenAPI style rules.
-
-For new or changed API contracts, first produce an OpenAPI Draft in the repository's agreed API draft location, pass engineering baseline, architecture / Spec Delta design, and Design Review, then Freeze the contract before using this skill to refresh generated clients. When the backend is already the implemented source of truth, use this skill to regenerate and inspect the emitted contract before updating call sites.
-
-## Scope Boundary
-
-Use this skill for:
-
-- Running `smart-doc-maven-plugin` to generate an OpenAPI JSON file from implemented backend code.
-- Copying generated `openapi.json` into the frontend OpenAPI input path expected by Orval.
-- Running frontend API client generation and inspecting generated TypeScript changes.
-- Verifying that implemented controllers/DTOs emit the expected OpenAPI shape before call-site updates.
-
-Do not use this skill for:
-
-- Designing a new API contract from Spec, prototype, or architecture inputs.
-- Defining the unified OpenAPI style guide or reusable API governance rules.
-- Reviewing design-time OpenAPI Draft files before OpenAPI Freeze.
-- Choosing REST resource boundaries, error models, permission behavior, pagination standards, or contract test policy.
-
-For design-time contract review, use `yss-openapi-draft-review`. For a stronger organization-wide OpenAPI governance baseline, prefer a separate OpenAPI lint/style skill backed by a maintained ruleset tool such as Stoplight Spectral or Redocly CLI, then layer YSS-specific response wrappers, permission, pagination, and security-red-line rules on top.
-
-## Core Flow
-
-1. Locate the backend module that owns smart-doc generation.
-   - Search the repository for `smart-doc-maven-plugin`, `configFile`, `outPath`, and `smart-doc.json`.
-   - Confirm which module contains the controllers/DTOs being changed and which plugin execution includes them.
-   - Read the smart-doc config instead of assuming a directory. Its `outPath` determines where the generated OpenAPI JSON is emitted.
-   - For a newly generated YSS scaffold, use the generated `bootstrap/src/main/resources/smart-doc.json` as the baseline and replace `packageFilters` with the actual controller package if needed.
-
-2. Generate the backend OpenAPI contract from the repository root.
-   - Use the exact Maven wrapper, profiles, and module selector already used by the repository.
-   - The YSS `smart-doc-maven-plugin` version is fixed at `yss-4.0.0`; verify the selected POM declares `<version>yss-4.0.0</version>` before generation.
-   - Prefer the repo's documented generation command if one exists in scripts, docs, CI, or previous command history.
-   - Do not add IntelliJ-specific listener or `-Didea.*` parameters.
-
-```bash
-./mvnw <repo profiles/options> <smart-doc plugin goal> -f <root-or-module-pom>
-```
-
-3. Find the generated `openapi.json`.
-   - Use the smart-doc `outPath` from the selected config as the primary source of truth.
-   - If the exact file name is not obvious, search under the configured output directory for OpenAPI JSON files.
-   - If multiple files exist, choose the one from the module whose config and plugin includes cover the controllers/DTOs being changed.
-
-4. Copy the generated contract into the frontend OpenAPI input.
-   - Locate the frontend root by finding `orval.config.*` and the package script that runs Orval or API generation.
-   - Read the Orval config to identify the OpenAPI input path.
-   - Preserve the frontend input path expected by Orval; do not invent a new input path unless the config is updated too.
-
-```bash
-cp <generated-openapi-json> <orval-input-openapi-json>
-```
-
-5. Regenerate the frontend API client from the frontend root.
-   - Use the API generation script already defined by the frontend package when present.
-   - If there is no wrapper script, run the configured Orval command and any local cleanup/format scripts referenced by the package scripts.
-
-```bash
-pnpm <api-generation-script>
-```
-
-6. Inspect generated changes before touching call sites.
-   - Check the Orval input JSON path from the config.
-   - Check the generated client output paths from the Orval config.
-   - Update handwritten call sites only after seeing the regenerated function names, request body shape, params type, and result type.
-
-## How It Works
-
-- `smart-doc-maven-plugin` scans Java controller methods, request/response DTOs, annotations, comments, and configured dependency source jars. It emits an OpenAPI contract under the configured `outPath`.
-- The YSS baseline config uses `allInOne: true`, `outPath: "target/openapi"`, a service package filter, `componentType: "NORMAL"`, and disables debug pages and request/response examples by default.
-- Do not copy environment-specific `serverUrl`, `debugEnvUrl`, `openUrl`, Torna `appToken`, or project-specific `revisionLogs` into a reusable scaffold.
-- The backend module is the source of truth for routes, HTTP verbs, DTO field names, enum descriptions, binary responses, multipart inputs, and operation IDs.
-- The frontend `orval.config.*` determines which OpenAPI input file is read and where TypeScript schema types plus client functions are generated.
-- Local cleanup, export-flattening, or formatting scripts may post-process generated files. Use them only when they are part of the repository's generation script.
-
-## Repo Checks
-
-Run these discovery commands when the layout is uncertain:
-
-```bash
-rg -n "smart-doc-maven-plugin|configFile|outPath|openapi" -S pom.xml '**/pom.xml' '**/smart-doc.json'
-find . -maxdepth 6 \( -name 'orval.config.*' -o -name 'package.json' -o -name 'smart-doc.json' \) -print
-rg -n "orval|format:generated|api-schema-cleanup|api-flatten-exports" -S '**/package.json' '**/orval.config.*'
-```
-
-## Troubleshooting
-
-- If a controller or DTO is missing, check `smart-doc.json` `packageFilters`, the plugin `<includes>`, module dependencies, and whether source jars are available in the local Maven repository.
-- If schema names look unstable or invalid, check `componentType` and the repository's smart-doc configuration.
-- If binary download or Excel upload contracts are wrong, inspect backend annotations and any OpenAPI normalizer/override code in the repo before manually editing generated JSON.
-- If Orval changes a client function signature, update frontend call sites to match the generated contract. Do not preserve old call shapes by hand-editing generated files.
-- If `api-flatten-exports.cjs` cannot parse `getApi`, inspect the generated `index.ts`; an Orval version or mode change may have changed the output shape.
-- If formatting or generation fails in nested workspaces, run from the frontend root that owns `orval.config.*` and the API generation script.
-
-## Verification
-
-Prefer targeted checks:
-
-```bash
-test -s <generated-openapi-json>
-test -s <orval-input-openapi-json>
-cd <frontend-root> && pnpm <api-generation-script>
-git diff -- <orval-input-openapi-json> <generated-client-output-paths>
-```
-
-For frontend behavior after API signature changes, run the smallest build or type check that is reliable for the repository and the affected frontend package.

package/template/.agents/skills/yss-openapi/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "YSS OpenAPI"
-  short_description: "Generate YSS OpenAPI and Orval clients"
-  default_prompt: "Use $yss-openapi to regenerate backend OpenAPI and frontend API clients."

package/template/.claude/skills/yss-ddd-scaffold-generator/assets/templates/config/smart-doc.json.template

@@ -1,17 +0,0 @@
-{
-  "isStrict": false,
-  "allInOne": true,
-  "outPath": "target/openapi",
-  "coverOld": true,
-  "createDebugPage": false,
-  "packageFilters": "{{base_package}}.*",
-  "showAuthor": true,
-  "requestFieldToUnderline": false,
-  "responseFieldToUnderline": false,
-  "inlineEnum": true,
-  "componentType": "NORMAL",
-  "recursionLimit": 7,
-  "requestExample": false,
-  "responseExample": false,
-  "displayActualType": false
-}

package/template/.claude/skills/yss-openapi/SKILL.md

@@ -1,116 +0,0 @@
----
-name: yss-openapi
-description: Use when an implemented YSS Java controller/DTO contract must generate OpenAPI JSON and refresh frontend Orval API clients.
----
-
-# YSS OpenAPI
-
-Use this skill to move an already implemented backend controller/DTO contract into the frontend generated API layer.
-
-This is an implementation/generation skill, not the product API design step and not the unified OpenAPI specification governance skill. It generates `openapi.json` from controller methods, request DTOs, response DTOs, annotations, and Java comments; it does not decide naming conventions, resource modeling, error taxonomy, pagination policy, permission semantics, or organization-wide OpenAPI style rules.
-
-For new or changed API contracts, first produce an OpenAPI Draft in the repository's agreed API draft location, pass engineering baseline, architecture / Spec Delta design, and Design Review, then Freeze the contract before using this skill to refresh generated clients. When the backend is already the implemented source of truth, use this skill to regenerate and inspect the emitted contract before updating call sites.
-
-## Scope Boundary
-
-Use this skill for:
-
-- Running `smart-doc-maven-plugin` to generate an OpenAPI JSON file from implemented backend code.
-- Copying generated `openapi.json` into the frontend OpenAPI input path expected by Orval.
-- Running frontend API client generation and inspecting generated TypeScript changes.
-- Verifying that implemented controllers/DTOs emit the expected OpenAPI shape before call-site updates.
-
-Do not use this skill for:
-
-- Designing a new API contract from Spec, prototype, or architecture inputs.
-- Defining the unified OpenAPI style guide or reusable API governance rules.
-- Reviewing design-time OpenAPI Draft files before OpenAPI Freeze.
-- Choosing REST resource boundaries, error models, permission behavior, pagination standards, or contract test policy.
-
-For design-time contract review, use `yss-openapi-draft-review`. For a stronger organization-wide OpenAPI governance baseline, prefer a separate OpenAPI lint/style skill backed by a maintained ruleset tool such as Stoplight Spectral or Redocly CLI, then layer YSS-specific response wrappers, permission, pagination, and security-red-line rules on top.
-
-## Core Flow
-
-1. Locate the backend module that owns smart-doc generation.
-   - Search the repository for `smart-doc-maven-plugin`, `configFile`, `outPath`, and `smart-doc.json`.
-   - Confirm which module contains the controllers/DTOs being changed and which plugin execution includes them.
-   - Read the smart-doc config instead of assuming a directory. Its `outPath` determines where the generated OpenAPI JSON is emitted.
-   - For a newly generated YSS scaffold, use the generated `bootstrap/src/main/resources/smart-doc.json` as the baseline and replace `packageFilters` with the actual controller package if needed.
-
-2. Generate the backend OpenAPI contract from the repository root.
-   - Use the exact Maven wrapper, profiles, and module selector already used by the repository.
-   - The YSS `smart-doc-maven-plugin` version is fixed at `yss-4.0.0`; verify the selected POM declares `<version>yss-4.0.0</version>` before generation.
-   - Prefer the repo's documented generation command if one exists in scripts, docs, CI, or previous command history.
-   - Do not add IntelliJ-specific listener or `-Didea.*` parameters.
-
-```bash
-./mvnw <repo profiles/options> <smart-doc plugin goal> -f <root-or-module-pom>
-```
-
-3. Find the generated `openapi.json`.
-   - Use the smart-doc `outPath` from the selected config as the primary source of truth.
-   - If the exact file name is not obvious, search under the configured output directory for OpenAPI JSON files.
-   - If multiple files exist, choose the one from the module whose config and plugin includes cover the controllers/DTOs being changed.
-
-4. Copy the generated contract into the frontend OpenAPI input.
-   - Locate the frontend root by finding `orval.config.*` and the package script that runs Orval or API generation.
-   - Read the Orval config to identify the OpenAPI input path.
-   - Preserve the frontend input path expected by Orval; do not invent a new input path unless the config is updated too.
-
-```bash
-cp <generated-openapi-json> <orval-input-openapi-json>
-```
-
-5. Regenerate the frontend API client from the frontend root.
-   - Use the API generation script already defined by the frontend package when present.
-   - If there is no wrapper script, run the configured Orval command and any local cleanup/format scripts referenced by the package scripts.
-
-```bash
-pnpm <api-generation-script>
-```
-
-6. Inspect generated changes before touching call sites.
-   - Check the Orval input JSON path from the config.
-   - Check the generated client output paths from the Orval config.
-   - Update handwritten call sites only after seeing the regenerated function names, request body shape, params type, and result type.
-
-## How It Works
-
-- `smart-doc-maven-plugin` scans Java controller methods, request/response DTOs, annotations, comments, and configured dependency source jars. It emits an OpenAPI contract under the configured `outPath`.
-- The YSS baseline config uses `allInOne: true`, `outPath: "target/openapi"`, a service package filter, `componentType: "NORMAL"`, and disables debug pages and request/response examples by default.
-- Do not copy environment-specific `serverUrl`, `debugEnvUrl`, `openUrl`, Torna `appToken`, or project-specific `revisionLogs` into a reusable scaffold.
-- The backend module is the source of truth for routes, HTTP verbs, DTO field names, enum descriptions, binary responses, multipart inputs, and operation IDs.
-- The frontend `orval.config.*` determines which OpenAPI input file is read and where TypeScript schema types plus client functions are generated.
-- Local cleanup, export-flattening, or formatting scripts may post-process generated files. Use them only when they are part of the repository's generation script.
-
-## Repo Checks
-
-Run these discovery commands when the layout is uncertain:
-
-```bash
-rg -n "smart-doc-maven-plugin|configFile|outPath|openapi" -S pom.xml '**/pom.xml' '**/smart-doc.json'
-find . -maxdepth 6 \( -name 'orval.config.*' -o -name 'package.json' -o -name 'smart-doc.json' \) -print
-rg -n "orval|format:generated|api-schema-cleanup|api-flatten-exports" -S '**/package.json' '**/orval.config.*'
-```
-
-## Troubleshooting
-
-- If a controller or DTO is missing, check `smart-doc.json` `packageFilters`, the plugin `<includes>`, module dependencies, and whether source jars are available in the local Maven repository.
-- If schema names look unstable or invalid, check `componentType` and the repository's smart-doc configuration.
-- If binary download or Excel upload contracts are wrong, inspect backend annotations and any OpenAPI normalizer/override code in the repo before manually editing generated JSON.
-- If Orval changes a client function signature, update frontend call sites to match the generated contract. Do not preserve old call shapes by hand-editing generated files.
-- If `api-flatten-exports.cjs` cannot parse `getApi`, inspect the generated `index.ts`; an Orval version or mode change may have changed the output shape.
-- If formatting or generation fails in nested workspaces, run from the frontend root that owns `orval.config.*` and the API generation script.
-
-## Verification
-
-Prefer targeted checks:
-
-```bash
-test -s <generated-openapi-json>
-test -s <orval-input-openapi-json>
-cd <frontend-root> && pnpm <api-generation-script>
-git diff -- <orval-input-openapi-json> <generated-client-output-paths>
-```
-
-For frontend behavior after API signature changes, run the smallest build or type check that is reliable for the repository and the affected frontend package.

package/template/.claude/skills/yss-openapi/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "YSS OpenAPI"
-  short_description: "Generate YSS OpenAPI and Orval clients"
-  default_prompt: "Use $yss-openapi to regenerate backend OpenAPI and frontend API clients."

package/template/.codex/skills/yss-ddd-scaffold-generator/assets/templates/config/smart-doc.json.template

@@ -1,17 +0,0 @@
-{
-  "isStrict": false,
-  "allInOne": true,
-  "outPath": "target/openapi",
-  "coverOld": true,
-  "createDebugPage": false,
-  "packageFilters": "{{base_package}}.*",
-  "showAuthor": true,
-  "requestFieldToUnderline": false,
-  "responseFieldToUnderline": false,
-  "inlineEnum": true,
-  "componentType": "NORMAL",
-  "recursionLimit": 7,
-  "requestExample": false,
-  "responseExample": false,
-  "displayActualType": false
-}

package/template/.codex/skills/yss-openapi/SKILL.md

@@ -1,116 +0,0 @@
----
-name: yss-openapi
-description: Use when an implemented YSS Java controller/DTO contract must generate OpenAPI JSON and refresh frontend Orval API clients.
----
-
-# YSS OpenAPI
-
-Use this skill to move an already implemented backend controller/DTO contract into the frontend generated API layer.
-
-This is an implementation/generation skill, not the product API design step and not the unified OpenAPI specification governance skill. It generates `openapi.json` from controller methods, request DTOs, response DTOs, annotations, and Java comments; it does not decide naming conventions, resource modeling, error taxonomy, pagination policy, permission semantics, or organization-wide OpenAPI style rules.
-
-For new or changed API contracts, first produce an OpenAPI Draft in the repository's agreed API draft location, pass engineering baseline, architecture / Spec Delta design, and Design Review, then Freeze the contract before using this skill to refresh generated clients. When the backend is already the implemented source of truth, use this skill to regenerate and inspect the emitted contract before updating call sites.
-
-## Scope Boundary
-
-Use this skill for:
-
-- Running `smart-doc-maven-plugin` to generate an OpenAPI JSON file from implemented backend code.
-- Copying generated `openapi.json` into the frontend OpenAPI input path expected by Orval.
-- Running frontend API client generation and inspecting generated TypeScript changes.
-- Verifying that implemented controllers/DTOs emit the expected OpenAPI shape before call-site updates.
-
-Do not use this skill for:
-
-- Designing a new API contract from Spec, prototype, or architecture inputs.
-- Defining the unified OpenAPI style guide or reusable API governance rules.
-- Reviewing design-time OpenAPI Draft files before OpenAPI Freeze.
-- Choosing REST resource boundaries, error models, permission behavior, pagination standards, or contract test policy.
-
-For design-time contract review, use `yss-openapi-draft-review`. For a stronger organization-wide OpenAPI governance baseline, prefer a separate OpenAPI lint/style skill backed by a maintained ruleset tool such as Stoplight Spectral or Redocly CLI, then layer YSS-specific response wrappers, permission, pagination, and security-red-line rules on top.
-
-## Core Flow
-
-1. Locate the backend module that owns smart-doc generation.
-   - Search the repository for `smart-doc-maven-plugin`, `configFile`, `outPath`, and `smart-doc.json`.
-   - Confirm which module contains the controllers/DTOs being changed and which plugin execution includes them.
-   - Read the smart-doc config instead of assuming a directory. Its `outPath` determines where the generated OpenAPI JSON is emitted.
-   - For a newly generated YSS scaffold, use the generated `bootstrap/src/main/resources/smart-doc.json` as the baseline and replace `packageFilters` with the actual controller package if needed.
-
-2. Generate the backend OpenAPI contract from the repository root.
-   - Use the exact Maven wrapper, profiles, and module selector already used by the repository.
-   - The YSS `smart-doc-maven-plugin` version is fixed at `yss-4.0.0`; verify the selected POM declares `<version>yss-4.0.0</version>` before generation.
-   - Prefer the repo's documented generation command if one exists in scripts, docs, CI, or previous command history.
-   - Do not add IntelliJ-specific listener or `-Didea.*` parameters.
-
-```bash
-./mvnw <repo profiles/options> <smart-doc plugin goal> -f <root-or-module-pom>
-```
-
-3. Find the generated `openapi.json`.
-   - Use the smart-doc `outPath` from the selected config as the primary source of truth.
-   - If the exact file name is not obvious, search under the configured output directory for OpenAPI JSON files.
-   - If multiple files exist, choose the one from the module whose config and plugin includes cover the controllers/DTOs being changed.
-
-4. Copy the generated contract into the frontend OpenAPI input.
-   - Locate the frontend root by finding `orval.config.*` and the package script that runs Orval or API generation.
-   - Read the Orval config to identify the OpenAPI input path.
-   - Preserve the frontend input path expected by Orval; do not invent a new input path unless the config is updated too.
-
-```bash
-cp <generated-openapi-json> <orval-input-openapi-json>
-```
-
-5. Regenerate the frontend API client from the frontend root.
-   - Use the API generation script already defined by the frontend package when present.
-   - If there is no wrapper script, run the configured Orval command and any local cleanup/format scripts referenced by the package scripts.
-
-```bash
-pnpm <api-generation-script>
-```
-
-6. Inspect generated changes before touching call sites.
-   - Check the Orval input JSON path from the config.
-   - Check the generated client output paths from the Orval config.
-   - Update handwritten call sites only after seeing the regenerated function names, request body shape, params type, and result type.
-
-## How It Works
-
-- `smart-doc-maven-plugin` scans Java controller methods, request/response DTOs, annotations, comments, and configured dependency source jars. It emits an OpenAPI contract under the configured `outPath`.
-- The YSS baseline config uses `allInOne: true`, `outPath: "target/openapi"`, a service package filter, `componentType: "NORMAL"`, and disables debug pages and request/response examples by default.
-- Do not copy environment-specific `serverUrl`, `debugEnvUrl`, `openUrl`, Torna `appToken`, or project-specific `revisionLogs` into a reusable scaffold.
-- The backend module is the source of truth for routes, HTTP verbs, DTO field names, enum descriptions, binary responses, multipart inputs, and operation IDs.
-- The frontend `orval.config.*` determines which OpenAPI input file is read and where TypeScript schema types plus client functions are generated.
-- Local cleanup, export-flattening, or formatting scripts may post-process generated files. Use them only when they are part of the repository's generation script.
-
-## Repo Checks
-
-Run these discovery commands when the layout is uncertain:
-
-```bash
-rg -n "smart-doc-maven-plugin|configFile|outPath|openapi" -S pom.xml '**/pom.xml' '**/smart-doc.json'
-find . -maxdepth 6 \( -name 'orval.config.*' -o -name 'package.json' -o -name 'smart-doc.json' \) -print
-rg -n "orval|format:generated|api-schema-cleanup|api-flatten-exports" -S '**/package.json' '**/orval.config.*'
-```
-
-## Troubleshooting
-
-- If a controller or DTO is missing, check `smart-doc.json` `packageFilters`, the plugin `<includes>`, module dependencies, and whether source jars are available in the local Maven repository.
-- If schema names look unstable or invalid, check `componentType` and the repository's smart-doc configuration.
-- If binary download or Excel upload contracts are wrong, inspect backend annotations and any OpenAPI normalizer/override code in the repo before manually editing generated JSON.
-- If Orval changes a client function signature, update frontend call sites to match the generated contract. Do not preserve old call shapes by hand-editing generated files.
-- If `api-flatten-exports.cjs` cannot parse `getApi`, inspect the generated `index.ts`; an Orval version or mode change may have changed the output shape.
-- If formatting or generation fails in nested workspaces, run from the frontend root that owns `orval.config.*` and the API generation script.
-
-## Verification
-
-Prefer targeted checks:
-
-```bash
-test -s <generated-openapi-json>
-test -s <orval-input-openapi-json>
-cd <frontend-root> && pnpm <api-generation-script>
-git diff -- <orval-input-openapi-json> <generated-client-output-paths>
-```
-
-For frontend behavior after API signature changes, run the smallest build or type check that is reliable for the repository and the affected frontend package.

package/template/.codex/skills/yss-openapi/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "YSS OpenAPI"
-  short_description: "Generate YSS OpenAPI and Orval clients"
-  default_prompt: "Use $yss-openapi to regenerate backend OpenAPI and frontend API clients."