create-yss-spec 3.5.6 → 3.5.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/create-yss-spec.js +3 -1
- package/cli-core.lock.json +10 -6
- package/package.json +4 -1
- package/src/api/_sync-service.js +3 -1
- package/src/command-runner.mjs +44 -9
- package/src/commands/doctor.js +40 -0
- package/src/commands/skills.js +7 -2
- package/src/content-identity.js +111 -0
- package/src/runtime-store.mjs +650 -0
- package/src/template/asset-runtime.js +124 -22
- package/src/template/instance-runtime.js +23 -7
- package/src/validation/metadata.js +8 -0
- package/template/.agents/skills/.strategic-design-skills-manifest.json +3 -3
- package/template/.agents/skills/alibaba-java-code-style/SKILL.md +30 -36
- package/template/.agents/skills/archify/SKILL.md +2 -2
- package/template/.agents/skills/archify/scripts/yss-safe-deliver.mjs +10 -6
- package/template/.agents/skills/archify/test/yss-safe-deliver.test.mjs +9 -2
- package/template/.agents/skills/code-review/SKILL.md +19 -11
- package/template/.agents/skills/code-review/references/candidate-capture.md +1 -1
- package/template/.agents/skills/code-review/references/legacy-convergence.md +3 -1
- package/template/.agents/skills/code-review/references/review-axis-checklists.md +2 -0
- package/template/.agents/skills/code-review/references/yss-review-standards.md +4 -2
- package/template/.agents/skills/competitive-intelligence/SKILL.md +32 -74
- package/template/.agents/skills/file-export-download/SKILL.md +4 -73
- package/template/.agents/skills/file-export-download/references/binary-contract-example.md +26 -0
- package/template/.agents/skills/file-export-download/references/download-call-example.md +45 -0
- package/template/.agents/skills/formily-foundation/SKILL.md +6 -105
- package/template/.agents/skills/formily-foundation/references/async-save-example.md +57 -0
- package/template/.agents/skills/formily-foundation/references/query-layout.md +50 -0
- package/template/.agents/skills/formily-linkage-effects/SKILL.md +3 -116
- package/template/.agents/skills/formily-linkage-effects/references/linkage-example.md +116 -0
- package/template/.agents/skills/formily-mode-slot-detail/SKILL.md +3 -81
- package/template/.agents/skills/formily-mode-slot-detail/references/mode-slot-example.md +81 -0
- package/template/.agents/skills/formily-step-flow/SKILL.md +3 -143
- package/template/.agents/skills/formily-step-flow/references/step-flow-example.md +143 -0
- package/template/.agents/skills/handoff/SKILL.md +3 -1
- package/template/.agents/skills/i-have-adhd/SKILL.md +2 -2
- package/template/.agents/skills/i-have-adhd/references/yss-adaptation.md +2 -2
- package/template/.agents/skills/i-have-adhd/tests/verify-integration.mjs +7 -2
- package/template/.agents/skills/implement/SKILL.md +2 -2
- package/template/.agents/skills/llm-wiki/references/transactions.md +2 -2
- package/template/.agents/skills/llm-wiki/scripts/core.mjs +40 -2
- package/template/.agents/skills/llm-wiki/scripts/transaction.mjs +30 -27
- package/template/.agents/skills/llm-wiki/scripts/v2.test.mjs +38 -2
- package/template/.agents/skills/lombok/SKILL.md +2 -0
- package/template/.agents/skills/mapstruct/SKILL.md +2 -0
- package/template/.agents/skills/tdd/SKILL.md +2 -2
- package/template/.agents/skills/theme-token-usage/SKILL.md +6 -5
- package/template/.agents/skills/wayfinder/references/chart-map.md +2 -2
- package/template/.agents/skills/wayfinder/references/ticket-types.md +1 -1
- package/template/.agents/skills/yss-api-integration/SKILL.md +13 -50
- package/template/.agents/skills/yss-api-integration/references/orval-list-example.md +38 -0
- package/template/.agents/skills/yss-application/SKILL.md +11 -5
- package/template/.agents/skills/yss-audit-log/SKILL.md +8 -6
- package/template/.agents/skills/yss-audit-log/references/README.md +5 -5
- package/template/.agents/skills/yss-cache/SKILL.md +4 -4
- package/template/.agents/skills/yss-ddd-scaffold-generator/SKILL.md +7 -8
- package/template/.agents/skills/yss-ddd-scaffold-generator/references/USAGE_EXAMPLES.md +13 -6
- package/template/.agents/skills/yss-ddd-scaffold-generator/references/command-examples.md +2 -0
- package/template/.agents/skills/yss-ddd-scaffold-generator/scripts/scaffold-generator.test.mjs +28 -1
- package/template/.agents/skills/yss-design-system/SKILL.md +2 -2
- package/template/.agents/skills/yss-distributed-id/SKILL.md +4 -4
- package/template/.agents/skills/yss-dto/SKILL.md +9 -9
- package/template/.agents/skills/yss-dto/references/README.md +4 -4
- package/template/.agents/skills/yss-dto/references/wire-validation-checklist.md +4 -4
- package/template/.agents/skills/yss-excel-mvc/SKILL.md +4 -4
- package/template/.agents/skills/yss-exception/SKILL.md +42 -48
- package/template/.agents/skills/yss-formily-schema-generator/SKILL.md +26 -170
- package/template/.agents/skills/yss-formily-schema-generator/references/workflow.md +49 -193
- package/template/.agents/skills/yss-frontend-scaffold-generator/SKILL.md +14 -10
- package/template/.agents/skills/yss-implementation-contract-compiler/SKILL.md +4 -6
- package/template/.agents/skills/yss-implementation-contract-compiler/references/yss-skill-execution-result.md +15 -1
- package/template/.agents/skills/yss-layered-mvc-scaffold-generator/SKILL.md +1 -1
- package/template/.agents/skills/yss-mybatis/SKILL.md +4 -4
- package/template/.agents/skills/yss-openapi-draft-review/SKILL.md +6 -4
- package/template/.agents/skills/yss-openapi-draft-review/references/review-output.md +2 -0
- package/template/.agents/skills/yss-openapi-draft-review/references/semantic-review.md +3 -3
- package/template/.agents/skills/yss-openapi-governance/SKILL.md +5 -7
- package/template/.agents/skills/yss-openapi-governance/references/governance-output.md +2 -0
- package/template/.agents/skills/yss-openapi-governance/references/governance-workflow.md +3 -3
- package/template/.agents/skills/yss-product-lifecycle/SKILL.md +32 -26
- package/template/.agents/skills/yss-product-lifecycle/references/artifact-dependencies.md +1 -1
- package/template/.agents/skills/yss-product-lifecycle/references/matt-yss-adapter.md +28 -6
- package/template/.agents/skills/yss-product-lifecycle/references/orchestration-contract.yaml +143 -4
- package/template/.agents/skills/yss-product-lifecycle/references/orchestration.md +38 -13
- package/template/.agents/skills/yss-product-lifecycle/references/plan-requirements.md +7 -6
- package/template/.agents/skills/yss-product-lifecycle/references/state-model.md +3 -1
- package/template/.agents/skills/yss-product-lifecycle/references/user-decisions.md +3 -3
- package/template/.agents/skills/yss-prototype-stage/SKILL.md +1 -5
- package/template/.agents/skills/yss-prototype-stage/scripts/verify-prototype-design.mjs +1 -0
- package/template/.agents/skills/yss-repository/SKILL.md +2 -2
- package/template/.agents/skills/yss-research/SKILL.md +39 -48
- package/template/.agents/skills/yss-research/assets/competitive-evidence-template.yaml +146 -0
- package/template/.agents/skills/yss-research/references/competitive-analysis.md +76 -0
- package/template/.agents/skills/yss-research/references/competitive-analysis.schema.json +324 -0
- package/template/.agents/skills/yss-research/references/evidence-contract.md +8 -0
- package/template/.agents/skills/yss-research/scripts/lib/competitive-analysis.mjs +185 -0
- package/template/.agents/skills/yss-research/scripts/render-competitive-outputs.mjs +16 -0
- package/template/.agents/skills/yss-research/scripts/validate-research-package.mjs +6 -2
- package/template/.agents/skills/yss-research/tests/competitive-scenarios.test.mjs +270 -0
- package/template/.agents/skills/yss-resilience4j/SKILL.md +25 -31
- package/template/.agents/skills/yss-security-algorithm/SKILL.md +37 -43
- package/template/.agents/skills/yss-skill-source-index-refresh/SKILL.md +29 -36
- package/template/.agents/skills/yss-skill-source-index-refresh/references/backend-component-platform-compatibility.md +1 -1
- package/template/.agents/skills/yss-stage-decision/SKILL.md +2 -5
- package/template/.agents/skills/yss-stage-decision/scripts/validate-domain-strategy.mjs +8 -5
- package/template/.agents/skills/yss-stage-decision/scripts/validate-stage-decision-package.mjs +8 -5
- package/template/.agents/skills/yss-stage-decision/tests/run-scenarios.mjs +83 -13
- package/template/.agents/skills/yss-tactical-design/SKILL.md +1 -1
- package/template/.agents/skills/yss-tactical-design/references/output-template.md +3 -3
- package/template/.agents/skills/yss-tactical-design/references/tactical-design-contract.md +1 -1
- package/template/.agents/skills/yss-technical-design/SKILL.md +6 -5
- package/template/.agents/skills/yss-ui/SKILL.md +7 -1
- package/template/.agents/skills/yss-ui/assets/docs/guide/gitlab-ci-integration.md +2 -2
- package/template/.agents/skills/yss-ui/references/checklist.md +38 -96
- package/template/.agents/skills/yss-ui/references/component-routing.md +3 -1
- package/template/.agents/skills/yss-ui/references/quick-recipes.md +17 -272
- package/template/.agents/skills/yss-ui/references/specialized-components.md +3 -3
- package/template/.agents/skills/yss-ui-business-page-generation/SKILL.md +1 -1
- package/template/.agents/skills/yss-up-springboot3/SKILL.md +19 -21
- package/template/.agents/skills/yss-userinfo/SKILL.md +27 -33
- package/template/.agents/skills/yss-validation/SKILL.md +26 -32
- package/template/.agents/skills/yss-web-controller/SKILL.md +11 -44
- package/template/.agents/skills/yss-web-controller/references/crud-generation.md +38 -0
- package/template/.agents/skills/ytable-usage/SKILL.md +2 -2
- package/template/.agents/skills/ytree-usage/SKILL.md +2 -80
- package/template/.agents/skills/ytree-usage/references/tree-and-confirmation-example.md +81 -0
- package/template/.codex/skills/alibaba-java-code-style/SKILL.md +30 -36
- package/template/.codex/skills/archify/SKILL.md +2 -2
- package/template/.codex/skills/archify/scripts/yss-safe-deliver.mjs +10 -6
- package/template/.codex/skills/archify/test/yss-safe-deliver.test.mjs +9 -2
- package/template/.codex/skills/code-review/SKILL.md +19 -11
- package/template/.codex/skills/code-review/references/candidate-capture.md +1 -1
- package/template/.codex/skills/code-review/references/legacy-convergence.md +3 -1
- package/template/.codex/skills/code-review/references/review-axis-checklists.md +2 -0
- package/template/.codex/skills/code-review/references/yss-review-standards.md +4 -2
- package/template/.codex/skills/competitive-intelligence/SKILL.md +32 -74
- package/template/.codex/skills/file-export-download/SKILL.md +4 -73
- package/template/.codex/skills/file-export-download/references/binary-contract-example.md +26 -0
- package/template/.codex/skills/file-export-download/references/download-call-example.md +45 -0
- package/template/.codex/skills/formily-foundation/SKILL.md +6 -105
- package/template/.codex/skills/formily-foundation/references/async-save-example.md +57 -0
- package/template/.codex/skills/formily-foundation/references/query-layout.md +50 -0
- package/template/.codex/skills/formily-linkage-effects/SKILL.md +3 -116
- package/template/.codex/skills/formily-linkage-effects/references/linkage-example.md +116 -0
- package/template/.codex/skills/formily-mode-slot-detail/SKILL.md +3 -81
- package/template/.codex/skills/formily-mode-slot-detail/references/mode-slot-example.md +81 -0
- package/template/.codex/skills/formily-step-flow/SKILL.md +3 -143
- package/template/.codex/skills/formily-step-flow/references/step-flow-example.md +143 -0
- package/template/.codex/skills/handoff/SKILL.md +3 -1
- package/template/.codex/skills/i-have-adhd/SKILL.md +2 -2
- package/template/.codex/skills/i-have-adhd/references/yss-adaptation.md +2 -2
- package/template/.codex/skills/i-have-adhd/tests/verify-integration.mjs +7 -2
- package/template/.codex/skills/implement/SKILL.md +2 -2
- package/template/.codex/skills/llm-wiki/references/transactions.md +2 -2
- package/template/.codex/skills/llm-wiki/scripts/core.mjs +40 -2
- package/template/.codex/skills/llm-wiki/scripts/transaction.mjs +30 -27
- package/template/.codex/skills/llm-wiki/scripts/v2.test.mjs +38 -2
- package/template/.codex/skills/lombok/SKILL.md +2 -0
- package/template/.codex/skills/mapstruct/SKILL.md +2 -0
- package/template/.codex/skills/product-design/references/communication-protocol.md +3 -3
- package/template/.codex/skills/product-design/references/critical-overrides.md +4 -5
- package/template/.codex/skills/product-design/skills/audit/SKILL.md +2 -4
- package/template/.codex/skills/product-design/skills/get-context/SKILL.md +6 -8
- package/template/.codex/skills/product-design/skills/ideate/SKILL.md +3 -3
- package/template/.codex/skills/product-design/skills/image-to-code/SKILL.md +3 -5
- package/template/.codex/skills/product-design/skills/index/SKILL.md +1 -1
- package/template/.codex/skills/product-design/skills/prototype/SKILL.md +2 -4
- package/template/.codex/skills/product-design/skills/research/SKILL.md +4 -6
- package/template/.codex/skills/product-design/skills/research/assets/research-brief-template.md +3 -3
- package/template/.codex/skills/product-design/skills/share/SKILL.md +2 -4
- package/template/.codex/skills/product-design/skills/url-to-code/SKILL.md +2 -4
- package/template/.codex/skills/product-design/skills/user-context/SKILL.md +1 -1
- package/template/.codex/skills/tdd/SKILL.md +2 -2
- package/template/.codex/skills/theme-token-usage/SKILL.md +6 -5
- package/template/.codex/skills/wayfinder/references/chart-map.md +2 -2
- package/template/.codex/skills/wayfinder/references/ticket-types.md +1 -1
- package/template/.codex/skills/yss-api-integration/SKILL.md +13 -50
- package/template/.codex/skills/yss-api-integration/references/orval-list-example.md +38 -0
- package/template/.codex/skills/yss-application/SKILL.md +11 -5
- package/template/.codex/skills/yss-audit-log/SKILL.md +8 -6
- package/template/.codex/skills/yss-audit-log/references/README.md +5 -5
- package/template/.codex/skills/yss-cache/SKILL.md +4 -4
- package/template/.codex/skills/yss-ddd-scaffold-generator/SKILL.md +7 -8
- package/template/.codex/skills/yss-ddd-scaffold-generator/references/USAGE_EXAMPLES.md +13 -6
- package/template/.codex/skills/yss-ddd-scaffold-generator/references/command-examples.md +2 -0
- package/template/.codex/skills/yss-ddd-scaffold-generator/scripts/scaffold-generator.test.mjs +28 -1
- package/template/.codex/skills/yss-design-system/SKILL.md +2 -2
- package/template/.codex/skills/yss-distributed-id/SKILL.md +4 -4
- package/template/.codex/skills/yss-dto/SKILL.md +9 -9
- package/template/.codex/skills/yss-dto/references/README.md +4 -4
- package/template/.codex/skills/yss-dto/references/wire-validation-checklist.md +4 -4
- package/template/.codex/skills/yss-excel-mvc/SKILL.md +4 -4
- package/template/.codex/skills/yss-exception/SKILL.md +42 -48
- package/template/.codex/skills/yss-formily-schema-generator/SKILL.md +26 -170
- package/template/.codex/skills/yss-formily-schema-generator/references/workflow.md +49 -193
- package/template/.codex/skills/yss-frontend-scaffold-generator/SKILL.md +14 -10
- package/template/.codex/skills/yss-implementation-contract-compiler/SKILL.md +4 -6
- package/template/.codex/skills/yss-implementation-contract-compiler/references/yss-skill-execution-result.md +15 -1
- package/template/.codex/skills/yss-layered-mvc-scaffold-generator/SKILL.md +1 -1
- package/template/.codex/skills/yss-mybatis/SKILL.md +4 -4
- package/template/.codex/skills/yss-openapi-draft-review/SKILL.md +6 -4
- package/template/.codex/skills/yss-openapi-draft-review/references/review-output.md +2 -0
- package/template/.codex/skills/yss-openapi-draft-review/references/semantic-review.md +3 -3
- package/template/.codex/skills/yss-openapi-governance/SKILL.md +5 -7
- package/template/.codex/skills/yss-openapi-governance/references/governance-output.md +2 -0
- package/template/.codex/skills/yss-openapi-governance/references/governance-workflow.md +3 -3
- package/template/.codex/skills/yss-product-lifecycle/SKILL.md +32 -26
- package/template/.codex/skills/yss-product-lifecycle/references/artifact-dependencies.md +1 -1
- package/template/.codex/skills/yss-product-lifecycle/references/matt-yss-adapter.md +28 -6
- package/template/.codex/skills/yss-product-lifecycle/references/orchestration-contract.yaml +143 -4
- package/template/.codex/skills/yss-product-lifecycle/references/orchestration.md +38 -13
- package/template/.codex/skills/yss-product-lifecycle/references/plan-requirements.md +7 -6
- package/template/.codex/skills/yss-product-lifecycle/references/state-model.md +3 -1
- package/template/.codex/skills/yss-product-lifecycle/references/user-decisions.md +3 -3
- package/template/.codex/skills/yss-prototype-stage/SKILL.md +1 -5
- package/template/.codex/skills/yss-prototype-stage/scripts/verify-prototype-design.mjs +1 -0
- package/template/.codex/skills/yss-repository/SKILL.md +2 -2
- package/template/.codex/skills/yss-research/SKILL.md +39 -48
- package/template/.codex/skills/yss-research/assets/competitive-evidence-template.yaml +146 -0
- package/template/.codex/skills/yss-research/references/competitive-analysis.md +76 -0
- package/template/.codex/skills/yss-research/references/competitive-analysis.schema.json +324 -0
- package/template/.codex/skills/yss-research/references/evidence-contract.md +8 -0
- package/template/.codex/skills/yss-research/scripts/lib/competitive-analysis.mjs +185 -0
- package/template/.codex/skills/yss-research/scripts/render-competitive-outputs.mjs +16 -0
- package/template/.codex/skills/yss-research/scripts/validate-research-package.mjs +6 -2
- package/template/.codex/skills/yss-research/tests/competitive-scenarios.test.mjs +270 -0
- package/template/.codex/skills/yss-resilience4j/SKILL.md +25 -31
- package/template/.codex/skills/yss-security-algorithm/SKILL.md +37 -43
- package/template/.codex/skills/yss-skill-source-index-refresh/SKILL.md +29 -36
- package/template/.codex/skills/yss-skill-source-index-refresh/references/backend-component-platform-compatibility.md +1 -1
- package/template/.codex/skills/yss-stage-decision/SKILL.md +2 -5
- package/template/.codex/skills/yss-stage-decision/scripts/validate-domain-strategy.mjs +8 -5
- package/template/.codex/skills/yss-stage-decision/scripts/validate-stage-decision-package.mjs +8 -5
- package/template/.codex/skills/yss-stage-decision/tests/run-scenarios.mjs +83 -13
- package/template/.codex/skills/yss-tactical-design/SKILL.md +1 -1
- package/template/.codex/skills/yss-tactical-design/references/output-template.md +3 -3
- package/template/.codex/skills/yss-tactical-design/references/tactical-design-contract.md +1 -1
- package/template/.codex/skills/yss-technical-design/SKILL.md +6 -5
- package/template/.codex/skills/yss-ui/SKILL.md +7 -1
- package/template/.codex/skills/yss-ui/assets/docs/guide/gitlab-ci-integration.md +2 -2
- package/template/.codex/skills/yss-ui/references/checklist.md +38 -96
- package/template/.codex/skills/yss-ui/references/component-routing.md +3 -1
- package/template/.codex/skills/yss-ui/references/quick-recipes.md +17 -272
- package/template/.codex/skills/yss-ui/references/specialized-components.md +3 -3
- package/template/.codex/skills/yss-ui-business-page-generation/SKILL.md +1 -1
- package/template/.codex/skills/yss-up-springboot3/SKILL.md +19 -21
- package/template/.codex/skills/yss-userinfo/SKILL.md +27 -33
- package/template/.codex/skills/yss-validation/SKILL.md +26 -32
- package/template/.codex/skills/yss-web-controller/SKILL.md +11 -44
- package/template/.codex/skills/yss-web-controller/references/crud-generation.md +38 -0
- package/template/.codex/skills/ytable-usage/SKILL.md +2 -2
- package/template/.codex/skills/ytree-usage/SKILL.md +2 -80
- package/template/.codex/skills/ytree-usage/references/tree-and-confirmation-example.md +81 -0
- package/template/.cursor/skills/alibaba-java-code-style/SKILL.md +30 -36
- package/template/.cursor/skills/archify/SKILL.md +2 -2
- package/template/.cursor/skills/archify/scripts/yss-safe-deliver.mjs +10 -6
- package/template/.cursor/skills/archify/test/yss-safe-deliver.test.mjs +9 -2
- package/template/.cursor/skills/code-review/SKILL.md +19 -11
- package/template/.cursor/skills/code-review/references/candidate-capture.md +1 -1
- package/template/.cursor/skills/code-review/references/legacy-convergence.md +3 -1
- package/template/.cursor/skills/code-review/references/review-axis-checklists.md +2 -0
- package/template/.cursor/skills/code-review/references/yss-review-standards.md +4 -2
- package/template/.cursor/skills/competitive-intelligence/SKILL.md +32 -74
- package/template/.cursor/skills/file-export-download/SKILL.md +4 -73
- package/template/.cursor/skills/file-export-download/references/binary-contract-example.md +26 -0
- package/template/.cursor/skills/file-export-download/references/download-call-example.md +45 -0
- package/template/.cursor/skills/formily-foundation/SKILL.md +6 -105
- package/template/.cursor/skills/formily-foundation/references/async-save-example.md +57 -0
- package/template/.cursor/skills/formily-foundation/references/query-layout.md +50 -0
- package/template/.cursor/skills/formily-linkage-effects/SKILL.md +3 -116
- package/template/.cursor/skills/formily-linkage-effects/references/linkage-example.md +116 -0
- package/template/.cursor/skills/formily-mode-slot-detail/SKILL.md +3 -81
- package/template/.cursor/skills/formily-mode-slot-detail/references/mode-slot-example.md +81 -0
- package/template/.cursor/skills/formily-step-flow/SKILL.md +3 -143
- package/template/.cursor/skills/formily-step-flow/references/step-flow-example.md +143 -0
- package/template/.cursor/skills/handoff/SKILL.md +3 -1
- package/template/.cursor/skills/i-have-adhd/SKILL.md +2 -2
- package/template/.cursor/skills/i-have-adhd/references/yss-adaptation.md +2 -2
- package/template/.cursor/skills/i-have-adhd/tests/verify-integration.mjs +7 -2
- package/template/.cursor/skills/implement/SKILL.md +2 -2
- package/template/.cursor/skills/llm-wiki/references/transactions.md +2 -2
- package/template/.cursor/skills/llm-wiki/scripts/core.mjs +40 -2
- package/template/.cursor/skills/llm-wiki/scripts/transaction.mjs +30 -27
- package/template/.cursor/skills/llm-wiki/scripts/v2.test.mjs +38 -2
- package/template/.cursor/skills/lombok/SKILL.md +2 -0
- package/template/.cursor/skills/mapstruct/SKILL.md +2 -0
- package/template/.cursor/skills/tdd/SKILL.md +2 -2
- package/template/.cursor/skills/theme-token-usage/SKILL.md +6 -5
- package/template/.cursor/skills/wayfinder/references/chart-map.md +2 -2
- package/template/.cursor/skills/wayfinder/references/ticket-types.md +1 -1
- package/template/.cursor/skills/yss-api-integration/SKILL.md +13 -50
- package/template/.cursor/skills/yss-api-integration/references/orval-list-example.md +38 -0
- package/template/.cursor/skills/yss-application/SKILL.md +11 -5
- package/template/.cursor/skills/yss-audit-log/SKILL.md +8 -6
- package/template/.cursor/skills/yss-audit-log/references/README.md +5 -5
- package/template/.cursor/skills/yss-cache/SKILL.md +4 -4
- package/template/.cursor/skills/yss-ddd-scaffold-generator/SKILL.md +7 -8
- package/template/.cursor/skills/yss-ddd-scaffold-generator/references/USAGE_EXAMPLES.md +13 -6
- package/template/.cursor/skills/yss-ddd-scaffold-generator/references/command-examples.md +2 -0
- package/template/.cursor/skills/yss-ddd-scaffold-generator/scripts/scaffold-generator.test.mjs +28 -1
- package/template/.cursor/skills/yss-design-system/SKILL.md +2 -2
- package/template/.cursor/skills/yss-distributed-id/SKILL.md +4 -4
- package/template/.cursor/skills/yss-dto/SKILL.md +9 -9
- package/template/.cursor/skills/yss-dto/references/README.md +4 -4
- package/template/.cursor/skills/yss-dto/references/wire-validation-checklist.md +4 -4
- package/template/.cursor/skills/yss-excel-mvc/SKILL.md +4 -4
- package/template/.cursor/skills/yss-exception/SKILL.md +42 -48
- package/template/.cursor/skills/yss-formily-schema-generator/SKILL.md +26 -170
- package/template/.cursor/skills/yss-formily-schema-generator/references/workflow.md +49 -193
- package/template/.cursor/skills/yss-frontend-scaffold-generator/SKILL.md +14 -10
- package/template/.cursor/skills/yss-implementation-contract-compiler/SKILL.md +4 -6
- package/template/.cursor/skills/yss-implementation-contract-compiler/references/yss-skill-execution-result.md +15 -1
- package/template/.cursor/skills/yss-layered-mvc-scaffold-generator/SKILL.md +1 -1
- package/template/.cursor/skills/yss-mybatis/SKILL.md +4 -4
- package/template/.cursor/skills/yss-openapi-draft-review/SKILL.md +6 -4
- package/template/.cursor/skills/yss-openapi-draft-review/references/review-output.md +2 -0
- package/template/.cursor/skills/yss-openapi-draft-review/references/semantic-review.md +3 -3
- package/template/.cursor/skills/yss-openapi-governance/SKILL.md +5 -7
- package/template/.cursor/skills/yss-openapi-governance/references/governance-output.md +2 -0
- package/template/.cursor/skills/yss-openapi-governance/references/governance-workflow.md +3 -3
- package/template/.cursor/skills/yss-product-lifecycle/SKILL.md +32 -26
- package/template/.cursor/skills/yss-product-lifecycle/references/artifact-dependencies.md +1 -1
- package/template/.cursor/skills/yss-product-lifecycle/references/matt-yss-adapter.md +28 -6
- package/template/.cursor/skills/yss-product-lifecycle/references/orchestration-contract.yaml +143 -4
- package/template/.cursor/skills/yss-product-lifecycle/references/orchestration.md +38 -13
- package/template/.cursor/skills/yss-product-lifecycle/references/plan-requirements.md +7 -6
- package/template/.cursor/skills/yss-product-lifecycle/references/state-model.md +3 -1
- package/template/.cursor/skills/yss-product-lifecycle/references/user-decisions.md +3 -3
- package/template/.cursor/skills/yss-prototype-stage/SKILL.md +1 -5
- package/template/.cursor/skills/yss-prototype-stage/scripts/verify-prototype-design.mjs +1 -0
- package/template/.cursor/skills/yss-repository/SKILL.md +2 -2
- package/template/.cursor/skills/yss-research/SKILL.md +39 -48
- package/template/.cursor/skills/yss-research/assets/competitive-evidence-template.yaml +146 -0
- package/template/.cursor/skills/yss-research/references/competitive-analysis.md +76 -0
- package/template/.cursor/skills/yss-research/references/competitive-analysis.schema.json +324 -0
- package/template/.cursor/skills/yss-research/references/evidence-contract.md +8 -0
- package/template/.cursor/skills/yss-research/scripts/lib/competitive-analysis.mjs +185 -0
- package/template/.cursor/skills/yss-research/scripts/render-competitive-outputs.mjs +16 -0
- package/template/.cursor/skills/yss-research/scripts/validate-research-package.mjs +6 -2
- package/template/.cursor/skills/yss-research/tests/competitive-scenarios.test.mjs +270 -0
- package/template/.cursor/skills/yss-resilience4j/SKILL.md +25 -31
- package/template/.cursor/skills/yss-security-algorithm/SKILL.md +37 -43
- package/template/.cursor/skills/yss-skill-source-index-refresh/SKILL.md +29 -36
- package/template/.cursor/skills/yss-skill-source-index-refresh/references/backend-component-platform-compatibility.md +1 -1
- package/template/.cursor/skills/yss-stage-decision/SKILL.md +2 -5
- package/template/.cursor/skills/yss-stage-decision/scripts/validate-domain-strategy.mjs +8 -5
- package/template/.cursor/skills/yss-stage-decision/scripts/validate-stage-decision-package.mjs +8 -5
- package/template/.cursor/skills/yss-stage-decision/tests/run-scenarios.mjs +83 -13
- package/template/.cursor/skills/yss-tactical-design/SKILL.md +1 -1
- package/template/.cursor/skills/yss-tactical-design/references/output-template.md +3 -3
- package/template/.cursor/skills/yss-tactical-design/references/tactical-design-contract.md +1 -1
- package/template/.cursor/skills/yss-technical-design/SKILL.md +6 -5
- package/template/.cursor/skills/yss-ui/SKILL.md +7 -1
- package/template/.cursor/skills/yss-ui/assets/docs/guide/gitlab-ci-integration.md +2 -2
- package/template/.cursor/skills/yss-ui/references/checklist.md +38 -96
- package/template/.cursor/skills/yss-ui/references/component-routing.md +3 -1
- package/template/.cursor/skills/yss-ui/references/quick-recipes.md +17 -272
- package/template/.cursor/skills/yss-ui/references/specialized-components.md +3 -3
- package/template/.cursor/skills/yss-ui-business-page-generation/SKILL.md +1 -1
- package/template/.cursor/skills/yss-up-springboot3/SKILL.md +19 -21
- package/template/.cursor/skills/yss-userinfo/SKILL.md +27 -33
- package/template/.cursor/skills/yss-validation/SKILL.md +26 -32
- package/template/.cursor/skills/yss-web-controller/SKILL.md +11 -44
- package/template/.cursor/skills/yss-web-controller/references/crud-generation.md +38 -0
- package/template/.cursor/skills/ytable-usage/SKILL.md +2 -2
- package/template/.cursor/skills/ytree-usage/SKILL.md +2 -80
- package/template/.cursor/skills/ytree-usage/references/tree-and-confirmation-example.md +81 -0
- package/template/.pi/skills/alibaba-java-code-style/SKILL.md +30 -36
- package/template/.pi/skills/archify/SKILL.md +2 -2
- package/template/.pi/skills/archify/scripts/yss-safe-deliver.mjs +10 -6
- package/template/.pi/skills/archify/test/yss-safe-deliver.test.mjs +9 -2
- package/template/.pi/skills/code-review/SKILL.md +19 -11
- package/template/.pi/skills/code-review/references/candidate-capture.md +1 -1
- package/template/.pi/skills/code-review/references/legacy-convergence.md +3 -1
- package/template/.pi/skills/code-review/references/review-axis-checklists.md +2 -0
- package/template/.pi/skills/code-review/references/yss-review-standards.md +4 -2
- package/template/.pi/skills/competitive-intelligence/SKILL.md +32 -74
- package/template/.pi/skills/file-export-download/SKILL.md +4 -73
- package/template/.pi/skills/file-export-download/references/binary-contract-example.md +26 -0
- package/template/.pi/skills/file-export-download/references/download-call-example.md +45 -0
- package/template/.pi/skills/formily-foundation/SKILL.md +6 -105
- package/template/.pi/skills/formily-foundation/references/async-save-example.md +57 -0
- package/template/.pi/skills/formily-foundation/references/query-layout.md +50 -0
- package/template/.pi/skills/formily-linkage-effects/SKILL.md +3 -116
- package/template/.pi/skills/formily-linkage-effects/references/linkage-example.md +116 -0
- package/template/.pi/skills/formily-mode-slot-detail/SKILL.md +3 -81
- package/template/.pi/skills/formily-mode-slot-detail/references/mode-slot-example.md +81 -0
- package/template/.pi/skills/formily-step-flow/SKILL.md +3 -143
- package/template/.pi/skills/formily-step-flow/references/step-flow-example.md +143 -0
- package/template/.pi/skills/handoff/SKILL.md +3 -1
- package/template/.pi/skills/i-have-adhd/SKILL.md +2 -2
- package/template/.pi/skills/i-have-adhd/references/yss-adaptation.md +2 -2
- package/template/.pi/skills/i-have-adhd/tests/verify-integration.mjs +7 -2
- package/template/.pi/skills/implement/SKILL.md +2 -2
- package/template/.pi/skills/llm-wiki/references/transactions.md +2 -2
- package/template/.pi/skills/llm-wiki/scripts/core.mjs +40 -2
- package/template/.pi/skills/llm-wiki/scripts/transaction.mjs +30 -27
- package/template/.pi/skills/llm-wiki/scripts/v2.test.mjs +38 -2
- package/template/.pi/skills/lombok/SKILL.md +2 -0
- package/template/.pi/skills/mapstruct/SKILL.md +2 -0
- package/template/.pi/skills/tdd/SKILL.md +2 -2
- package/template/.pi/skills/theme-token-usage/SKILL.md +6 -5
- package/template/.pi/skills/wayfinder/references/chart-map.md +2 -2
- package/template/.pi/skills/wayfinder/references/ticket-types.md +1 -1
- package/template/.pi/skills/yss-api-integration/SKILL.md +13 -50
- package/template/.pi/skills/yss-api-integration/references/orval-list-example.md +38 -0
- package/template/.pi/skills/yss-application/SKILL.md +11 -5
- package/template/.pi/skills/yss-audit-log/SKILL.md +8 -6
- package/template/.pi/skills/yss-audit-log/references/README.md +5 -5
- package/template/.pi/skills/yss-cache/SKILL.md +4 -4
- package/template/.pi/skills/yss-ddd-scaffold-generator/SKILL.md +7 -8
- package/template/.pi/skills/yss-ddd-scaffold-generator/references/USAGE_EXAMPLES.md +13 -6
- package/template/.pi/skills/yss-ddd-scaffold-generator/references/command-examples.md +2 -0
- package/template/.pi/skills/yss-ddd-scaffold-generator/scripts/scaffold-generator.test.mjs +28 -1
- package/template/.pi/skills/yss-design-system/SKILL.md +2 -2
- package/template/.pi/skills/yss-distributed-id/SKILL.md +4 -4
- package/template/.pi/skills/yss-dto/SKILL.md +9 -9
- package/template/.pi/skills/yss-dto/references/README.md +4 -4
- package/template/.pi/skills/yss-dto/references/wire-validation-checklist.md +4 -4
- package/template/.pi/skills/yss-excel-mvc/SKILL.md +4 -4
- package/template/.pi/skills/yss-exception/SKILL.md +42 -48
- package/template/.pi/skills/yss-formily-schema-generator/SKILL.md +26 -170
- package/template/.pi/skills/yss-formily-schema-generator/references/workflow.md +49 -193
- package/template/.pi/skills/yss-frontend-scaffold-generator/SKILL.md +14 -10
- package/template/.pi/skills/yss-implementation-contract-compiler/SKILL.md +4 -6
- package/template/.pi/skills/yss-implementation-contract-compiler/references/yss-skill-execution-result.md +15 -1
- package/template/.pi/skills/yss-layered-mvc-scaffold-generator/SKILL.md +1 -1
- package/template/.pi/skills/yss-mybatis/SKILL.md +4 -4
- package/template/.pi/skills/yss-openapi-draft-review/SKILL.md +6 -4
- package/template/.pi/skills/yss-openapi-draft-review/references/review-output.md +2 -0
- package/template/.pi/skills/yss-openapi-draft-review/references/semantic-review.md +3 -3
- package/template/.pi/skills/yss-openapi-governance/SKILL.md +5 -7
- package/template/.pi/skills/yss-openapi-governance/references/governance-output.md +2 -0
- package/template/.pi/skills/yss-openapi-governance/references/governance-workflow.md +3 -3
- package/template/.pi/skills/yss-product-lifecycle/SKILL.md +32 -26
- package/template/.pi/skills/yss-product-lifecycle/references/artifact-dependencies.md +1 -1
- package/template/.pi/skills/yss-product-lifecycle/references/matt-yss-adapter.md +28 -6
- package/template/.pi/skills/yss-product-lifecycle/references/orchestration-contract.yaml +143 -4
- package/template/.pi/skills/yss-product-lifecycle/references/orchestration.md +38 -13
- package/template/.pi/skills/yss-product-lifecycle/references/plan-requirements.md +7 -6
- package/template/.pi/skills/yss-product-lifecycle/references/state-model.md +3 -1
- package/template/.pi/skills/yss-product-lifecycle/references/user-decisions.md +3 -3
- package/template/.pi/skills/yss-prototype-stage/SKILL.md +1 -5
- package/template/.pi/skills/yss-prototype-stage/scripts/verify-prototype-design.mjs +1 -0
- package/template/.pi/skills/yss-repository/SKILL.md +2 -2
- package/template/.pi/skills/yss-research/SKILL.md +39 -48
- package/template/.pi/skills/yss-research/assets/competitive-evidence-template.yaml +146 -0
- package/template/.pi/skills/yss-research/references/competitive-analysis.md +76 -0
- package/template/.pi/skills/yss-research/references/competitive-analysis.schema.json +324 -0
- package/template/.pi/skills/yss-research/references/evidence-contract.md +8 -0
- package/template/.pi/skills/yss-research/scripts/lib/competitive-analysis.mjs +185 -0
- package/template/.pi/skills/yss-research/scripts/render-competitive-outputs.mjs +16 -0
- package/template/.pi/skills/yss-research/scripts/validate-research-package.mjs +6 -2
- package/template/.pi/skills/yss-research/tests/competitive-scenarios.test.mjs +270 -0
- package/template/.pi/skills/yss-resilience4j/SKILL.md +25 -31
- package/template/.pi/skills/yss-security-algorithm/SKILL.md +37 -43
- package/template/.pi/skills/yss-skill-source-index-refresh/SKILL.md +29 -36
- package/template/.pi/skills/yss-skill-source-index-refresh/references/backend-component-platform-compatibility.md +1 -1
- package/template/.pi/skills/yss-stage-decision/SKILL.md +2 -5
- package/template/.pi/skills/yss-stage-decision/scripts/validate-domain-strategy.mjs +8 -5
- package/template/.pi/skills/yss-stage-decision/scripts/validate-stage-decision-package.mjs +8 -5
- package/template/.pi/skills/yss-stage-decision/tests/run-scenarios.mjs +83 -13
- package/template/.pi/skills/yss-tactical-design/SKILL.md +1 -1
- package/template/.pi/skills/yss-tactical-design/references/output-template.md +3 -3
- package/template/.pi/skills/yss-tactical-design/references/tactical-design-contract.md +1 -1
- package/template/.pi/skills/yss-technical-design/SKILL.md +6 -5
- package/template/.pi/skills/yss-ui/SKILL.md +7 -1
- package/template/.pi/skills/yss-ui/assets/docs/guide/gitlab-ci-integration.md +2 -2
- package/template/.pi/skills/yss-ui/references/checklist.md +38 -96
- package/template/.pi/skills/yss-ui/references/component-routing.md +3 -1
- package/template/.pi/skills/yss-ui/references/quick-recipes.md +17 -272
- package/template/.pi/skills/yss-ui/references/specialized-components.md +3 -3
- package/template/.pi/skills/yss-ui-business-page-generation/SKILL.md +1 -1
- package/template/.pi/skills/yss-up-springboot3/SKILL.md +19 -21
- package/template/.pi/skills/yss-userinfo/SKILL.md +27 -33
- package/template/.pi/skills/yss-validation/SKILL.md +26 -32
- package/template/.pi/skills/yss-web-controller/SKILL.md +11 -44
- package/template/.pi/skills/yss-web-controller/references/crud-generation.md +38 -0
- package/template/.pi/skills/ytable-usage/SKILL.md +2 -2
- package/template/.pi/skills/ytree-usage/SKILL.md +2 -80
- package/template/.pi/skills/ytree-usage/references/tree-and-confirmation-example.md +81 -0
- package/template/.template-spec/agents/backend-architecture-profiles.md +1 -1
- package/template/.template-spec/agents/digital-human-roles.md +5 -1
- package/template/.template-spec/agents/digital-human-roles.yaml +49 -1
- package/template/.template-spec/engineering/backend-platforms.json +1 -1
- package/template/.template-spec/plan/entry-review.md +2 -1
- package/template/.template-spec/plan/templates/competitive-analysis-template.md +38 -36
- package/template/.template-spec/plan/templates/competitive-matrix-template.md +37 -17
- package/template/.template-spec/plan/templates/plan-template.md +11 -5
- package/template/.template-spec/process/document-writing.md +22 -3
- package/template/.template-spec/process/harness-process-tailoring.md +5 -1
- package/template/.template-spec/process/implementation-repo-integration.md +26 -8
- package/template/.template-spec/process/research-completion.md +2 -0
- package/template/.template-spec/process/runtime-storage.md +78 -0
- package/template/.template-spec/process/schemas/approval-context.schema.json +67 -0
- package/template/.template-spec/process/schemas/approval-record.schema.json +179 -16
- package/template/.template-spec/process/schemas/backend-delivery.schema.json +16 -0
- package/template/.template-spec/process/schemas/delivery-preflight-input.schema.json +4 -0
- package/template/.template-spec/process/schemas/digital-human-task-package.schema.json +236 -1
- package/template/.template-spec/process/schemas/implementation-repository-preparation-result.schema.json +335 -52
- package/template/.template-spec/process/schemas/lifecycle-checkpoint.schema.json +11 -0
- package/template/.template-spec/process/schemas/project-scaffold-contract.schema.json +3 -0
- package/template/.template-spec/process/schemas/review-bundle.schema.json +347 -35
- package/template/.template-spec/process/schemas/strategic-design-handoff-v3.schema.json +504 -0
- package/template/.template-spec/process/schemas/strategic-design-handoff-v4.schema.json +544 -8
- package/template/.template-spec/process/schemas/strategic-design-handoff-v5.schema.json +616 -0
- package/template/.template-spec/process/schemas/strategic-design-handoff.schema.json +616 -0
- package/template/.template-spec/process/schemas/strategic-handoff-domain-strategy-v3.schema.json +712 -109
- package/template/.template-spec/process/schemas/strategic-handoff-domain-strategy.schema.json +595 -90
- package/template/.template-spec/process/schemas/strategic-handoff-export-v2.schema.json +448 -0
- package/template/.template-spec/process/schemas/strategic-handoff-export.schema.json +392 -0
- package/template/.template-spec/process/schemas/strategic-handoff-stage-decision-package-v3.schema.json +556 -83
- package/template/.template-spec/process/schemas/strategic-handoff-stage-decision-package.schema.json +418 -57
- package/template/.template-spec/process/script-execution.md +37 -0
- package/template/.template-spec/process/subagent-collaboration.md +7 -1
- package/template/.template-spec/templates/approval-record-template.json +7 -3
- package/template/.template-spec/templates/approval-record-template.yaml +8 -2
- package/template/.template-spec/templates/examples/lifecycle-writing-examples.md +92 -2
- package/template/.template-spec/templates/retro-report-template.md +10 -3
- package/template/.template-spec/templates/review-bundle-template.yaml +19 -10
- package/template/.template-spec/user-guide//347/224/250/346/210/267/346/211/213/345/206/214.md +2 -0
- package/template/AGENTS.md +4 -3
- package/template/CONTEXT.md +2 -2
- package/template/README.md +2 -2
- package/template/scripts/advance-maintenance-iteration +51 -0
- package/template/scripts/lib/approval-checkpoint-discovery.mjs +26 -0
- package/template/scripts/lib/approval-consumption.mjs +35 -0
- package/template/scripts/lib/approval-current.mjs +111 -0
- package/template/scripts/lib/approval-record-io.mjs +56 -0
- package/template/scripts/lib/approval-record.mjs +79 -184
- package/template/scripts/lib/approved-execution-context.mjs +8 -6
- package/template/scripts/lib/asset-transactions.mjs +5 -1
- package/template/scripts/lib/backend-delivery.mjs +1 -1
- package/template/scripts/lib/backend-review.mjs +2 -1
- package/template/scripts/lib/backend-scaffold-prerequisites.mjs +3 -2
- package/template/scripts/lib/business-ticket-lifecycle.mjs +2 -1
- package/template/scripts/lib/checkpoint-commit.mjs +50 -0
- package/template/scripts/lib/command-runner.mjs +44 -9
- package/template/scripts/lib/content-identity.mjs +273 -0
- package/template/scripts/lib/delivery-preflight.mjs +2 -1
- package/template/scripts/lib/digital-human-roles.mjs +12 -5
- package/template/scripts/lib/drift-report.mjs +110 -0
- package/template/scripts/lib/existing-backend-architecture.mjs +4 -1
- package/template/scripts/lib/lifecycle-context-query.mjs +172 -11
- package/template/scripts/lib/lifecycle-controls.mjs +9 -19
- package/template/scripts/lib/lifecycle-presentation.mjs +5 -0
- package/template/scripts/lib/lifecycle-status.mjs +63 -12
- package/template/scripts/lib/lifecycle-transition.mjs +2 -1
- package/template/scripts/lib/maintenance-candidate.mjs +24 -30
- package/template/scripts/lib/maintenance-research.mjs +52 -8
- package/template/scripts/lib/maintenance-storage.mjs +81 -0
- package/template/scripts/lib/plan-spec-entry.mjs +2 -1
- package/template/scripts/lib/project-governance.mjs +2 -1
- package/template/scripts/lib/read-only-intake.mjs +44 -9
- package/template/scripts/lib/review-capabilities.mjs +234 -0
- package/template/scripts/lib/review-package.mjs +100 -0
- package/template/scripts/lib/runtime-store.mjs +650 -0
- package/template/scripts/lib/skill-registry.mjs +4 -4
- package/template/scripts/lib/strategic-handoff.mjs +22 -9
- package/template/scripts/lib/task-package.mjs +47 -16
- package/template/scripts/lifecycle-status +26 -1
- package/template/scripts/maintenance-path +11 -0
- package/template/scripts/prepare-review-package +8 -0
- package/template/scripts/project-ci +13 -3
- package/template/scripts/query-lifecycle-context +8 -1
- package/template/scripts/run-read-only-intake +2 -2
- package/template/scripts/runtime-store +40 -0
- package/template/scripts/verify-approval-record +21 -13
- package/template/scripts/verify-lifecycle-checkpoint +7 -3
- package/template/scripts/verify-project-instance +21 -1
- package/template/skills-lock.json +64 -63
- package/template.snapshot.json +4 -4
- package/vendor/cli-core/cli.mjs +2 -0
- package/vendor/cli-core/command-runner.mjs +44 -9
- package/vendor/cli-core/package.json +1 -1
- package/vendor/cli-core/runtime-store.mjs +650 -0
- package/vendor/cli-core/scaffold.mjs +4 -2
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
|
|
30
30
|
**位置**: `../assets/PageQuery.java`
|
|
31
31
|
|
|
32
|
-
|
|
32
|
+
用于 Application/Infrastructure 内部分页协作;是否继承按批准的工程 Profile 决定。公开 HTTP Page Request 默认不继承此类,只声明冻结 OpenAPI 允许的字段,再由 WebConvertor 转换,避免内部协作字段进入绑定面。
|
|
33
33
|
|
|
34
34
|
**核心字段**:
|
|
35
35
|
|
|
@@ -57,11 +57,11 @@
|
|
|
57
57
|
|
|
58
58
|
基础 DTO 抽象类,用于区分命令(写操作)和查询(读操作)对象。
|
|
59
59
|
|
|
60
|
-
- **CommandDTO**: 实现 `Serializable`
|
|
61
|
-
- **QueryDTO**: 继承自 `CommandDTO
|
|
60
|
+
- **CommandDTO**: 实现 `Serializable` 接口;当前工程采用此体系时,写操作参数优先继承。
|
|
61
|
+
- **QueryDTO**: 继承自 `CommandDTO`;Application/Infrastructure 内部读参数按批准 Profile 使用它或 `PageQuery`,不据此扩大公开请求字段。
|
|
62
62
|
|
|
63
63
|
## 使用场景
|
|
64
64
|
|
|
65
|
-
1. **API 响应**:
|
|
65
|
+
1. **API 响应**: 普通接口已采用 YSS wrapper 时保持 `Result` 或其派生体系。下载、流式和第三方回调按批准协议核验媒体类型、状态、Header、错误与权限边界,不强套 wrapper,也不豁免契约证据。
|
|
66
66
|
2. **分页查询**: `PageQuery` 用于 Application/Infrastructure 内部协作;公开 HTTP Page Request 默认只声明冻结 OpenAPI 允许的字段,再由 WebConvertor 转换,避免内部字段被继承到绑定面。MyBatis 拦截器所需形状必须由 Query Port 集成测试证明。
|
|
67
67
|
3. **参数封装**: 使用 `CommandDTO` 封装增删改参数,使用 `QueryDTO` 封装查询参数,保持代码语义清晰。
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
## 检查清单
|
|
2
2
|
|
|
3
|
-
-
|
|
3
|
+
- 分页字段名是否与已批准公开协议一致;采用 YSS 分页协议时对齐 wire profile。
|
|
4
4
|
<a id="dto.sort"></a>
|
|
5
5
|
<!-- yss-rule {"id":"dto.sort","when":"pagination","level":"mandatory","evidence":"code-and-verification"} -->
|
|
6
6
|
- `orderBy` / `groupBy` 是否经过 Repository 白名单映射,禁止直接拼接 SQL。
|
|
7
7
|
- Application Query Port / Infrastructure 是否收到批准的分页语义;Domain Gateway 不接收 `PageQuery`。
|
|
8
8
|
- 新增 DTO 是否与现有序列化和校验方式兼容。
|
|
9
9
|
- 返回结构是否和前端或上游调用方契约一致。
|
|
10
|
-
-
|
|
11
|
-
- wrapper extension、`YssResultMeta`、`allOf`、具体 data schema
|
|
12
|
-
-
|
|
10
|
+
- 采用 YSS wrapper / 分页协议时,是否通过 `scripts/verify-yss-dto-openapi-profile`,并引用 profile 版本。
|
|
11
|
+
- 采用 YSS wrapper 的 endpoint,其 wrapper extension、`YssResultMeta`、`allOf`、具体 data schema 和方向性是否对齐;特殊协议检查实际媒体类型、状态、Header、错误与权限边界。
|
|
12
|
+
- 采用 YSS 分页协议时,是否有针对内部 `offset` / `needTotalCount` / `tempTotalCount` 泄露的负向断言;其他批准协议是否逐项绑定冻结公开字段。公开 `totalPages` 是否有目标 mapper / fixture 证据。
|
|
13
13
|
- Controller、Application Service、Domain、Repository 之间是否存在 DTO/VO/DO/PO 混穿。
|
|
14
14
|
- 前端 Orval 或调用方是否依赖当前返回包装结构。
|
|
@@ -7,6 +7,10 @@ description: "实现或排查 YSS Spring MVC Excel 导入导出、RequestExcel
|
|
|
7
7
|
|
|
8
8
|
用于处理基于注解的 Excel 导入导出能力。
|
|
9
9
|
|
|
10
|
+
## 平台与源码门禁
|
|
11
|
+
|
|
12
|
+
接入、修改、代码生成或提供精确类名/配置前,必须读取并执行 [共享平台与源码门禁](../yss-skill-source-index-refresh/references/backend-component-platform-compatibility.md),以 `--skill yss-excel-mvc` 校验批准的平台线及匹配源码根。缺失、错配或漂移返回 `blocked`;不跨代回退,不在业务实现中升级、降级或替换组件。只读分诊可继续,但须标注未完成源码核验,不能据此宣称跨 Boot/JDK 兼容。
|
|
13
|
+
|
|
10
14
|
## 何时使用
|
|
11
15
|
|
|
12
16
|
- 用户要新增 Excel 导入接口。
|
|
@@ -64,7 +68,3 @@ description: "实现或排查 YSS Spring MVC Excel 导入导出、RequestExcel
|
|
|
64
68
|
- 源码索引:`references/source-index.md`
|
|
65
69
|
- 注解与返回结构:`assets/RequestExcel.java`、`assets/ResponseExcel.java`、`assets/ExcelDynamicData.java`
|
|
66
70
|
- MVC 解析器:`assets/RequestFastExcelArgumentResolver.java`、`assets/ResponseFastExcelReturnValueHandler.java`
|
|
67
|
-
|
|
68
|
-
## 平台与源码门禁
|
|
69
|
-
|
|
70
|
-
接入、修改、代码生成或给出精确类名/配置前,读取 [后端组件平台与源码门禁](../yss-skill-source-index-refresh/references/backend-component-platform-compatibility.md),从批准的 `platform_configuration.component_platform_line` 选择 `source-index.boot2-java8.md` 或 `source-index.boot3-java17.md`,并以 `--skill yss-excel-mvc --platform-line <line> --source-root <matching-root>` 运行统一 freshness 校验。平台线与源码根不匹配、组件 tree 不一致、组件子树 dirty、索引缺少平台信号,或 Manifest / 组件 GAV 缺少 verified 兼容证据时返回 `blocked`;不得回退另一代索引,也不在业务实现中升级、降级或替换 YSS 组件。既有工程只读分诊可继续,但不得据此宣称跨 Boot/JDK 兼容。
|
|
@@ -5,61 +5,55 @@ description: "接入或排查 YSS 统一异常、错误码、异常处理器与
|
|
|
5
5
|
|
|
6
6
|
# yss-exception
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
处理 YSS 业务、系统及未知异常的错误码、日志和 HTTP 映射;结论使用当前项目契约及匹配的平台源码。
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
## 平台与源码门禁
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
接入、修改、代码生成或提供精确类名/配置前,必须读取并执行 [共享平台与源码门禁](../yss-skill-source-index-refresh/references/backend-component-platform-compatibility.md),以 `--skill yss-exception` 校验批准的平台线及匹配源码根。缺失、错配或漂移返回 `blocked`;不跨代回退,不在业务实现中升级、降级或替换组件。只读分诊可继续,但须标注未完成源码核验,不能据此宣称跨 Boot/JDK 兼容。
|
|
13
13
|
|
|
14
|
-
|
|
15
|
-
- Generated index: `references/source-index.md`
|
|
16
|
-
- Component path hints: `yss-microservice-components/yss-component-exception`
|
|
14
|
+
## 源码定位
|
|
17
15
|
|
|
18
|
-
|
|
16
|
+
按 [源码定位策略](../yss-skill-source-index-refresh/references/source-location.md) 确认真实位置,再从 [平台索引](references/source-index.md) 定位当前任务需要的源码。`yss-microservice-components/yss-component-exception` 仅是模块路径提示。
|
|
19
17
|
|
|
20
|
-
##
|
|
18
|
+
## 工作流
|
|
21
19
|
|
|
22
|
-
1.
|
|
23
|
-
2.
|
|
24
|
-
3.
|
|
25
|
-
4.
|
|
26
|
-
5.
|
|
27
|
-
6.
|
|
20
|
+
1. 修改异常行为前,按平台索引定位当前组件源码与可读取的 `readme.md`。
|
|
21
|
+
2. 区分业务异常、已知系统异常和未知异常。
|
|
22
|
+
3. 创建 YSS 组件错误时使用 `ExceptionFactory` 与 `ResultErrorCode` 约定,不临时构造无明确语义的 runtime exception。
|
|
23
|
+
4. 命中全局异常输出或日志配置时核验 `YssGlobalExceptionProperties`。
|
|
24
|
+
5. 保持异常与日志语义一致:业务异常通常不记 Error 堆栈;系统和未知异常通常需要。
|
|
25
|
+
6. `target-domain-model` 的稳定错误含义与参数归 Domain,不直接依赖 YSS `BizException` 或 HTTP;先验证组件 handler 优先级,再在 Web 边界翻译。
|
|
28
26
|
7. MVC Profile 的稳定业务错误归 service/core;Repository 保留 cause;server 持有 HTTP 映射与脱敏。不要为了复用错误码引入 Domain 层或让 core 依赖 client。分层依据 `.template-spec/agents/backend-architecture-profiles.md`。
|
|
29
27
|
|
|
30
|
-
## Boot 3
|
|
28
|
+
## Boot 3 行为
|
|
31
29
|
|
|
32
30
|
- 以下当前行为针对 `boot3-java17`;Boot 2 旧工程必须读取其独立索引,旧行为只用于迁移识别。
|
|
33
|
-
- `GlobalExceptionAdvice`
|
|
34
|
-
- `MaxUploadSizeExceededException`
|
|
35
|
-
-
|
|
36
|
-
-
|
|
37
|
-
-
|
|
38
|
-
|
|
39
|
-
##
|
|
40
|
-
|
|
41
|
-
- `BizException
|
|
42
|
-
- `SysException
|
|
43
|
-
-
|
|
44
|
-
|
|
45
|
-
##
|
|
46
|
-
|
|
47
|
-
-
|
|
48
|
-
-
|
|
49
|
-
-
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
- Endpoint
|
|
56
|
-
|
|
57
|
-
##
|
|
58
|
-
|
|
59
|
-
-
|
|
60
|
-
-
|
|
61
|
-
-
|
|
62
|
-
|
|
63
|
-
## 平台与源码门禁
|
|
64
|
-
|
|
65
|
-
接入、修改、代码生成或给出精确类名/配置前,读取 [后端组件平台与源码门禁](../yss-skill-source-index-refresh/references/backend-component-platform-compatibility.md),从批准的 `platform_configuration.component_platform_line` 选择 `source-index.boot2-java8.md` 或 `source-index.boot3-java17.md`,并以 `--skill yss-exception --platform-line <line> --source-root <matching-root>` 运行统一 freshness 校验。平台线与源码根不匹配、组件 tree 不一致、组件子树 dirty、索引缺少平台信号,或 Manifest / 组件 GAV 缺少 verified 兼容证据时返回 `blocked`;不得回退另一代索引,也不在业务实现中升级、降级或替换 YSS 组件。既有工程只读分诊可继续,但不得据此宣称跨 Boot/JDK 兼容。
|
|
31
|
+
- `GlobalExceptionAdvice` 将 `BizException` 映射到 HTTP 400;未知 `Exception`、`RuntimeException` 和 `NullPointerException` 映射到 HTTP 500,返回脱敏的 `SysException` 与 `ResultErrorCode.INTERNAL_ERROR`,不返回异常原文。
|
|
32
|
+
- `MaxUploadSizeExceededException` 映射到 HTTP 413(`PAYLOAD_TOO_LARGE`)与 `ResultErrorCode.MAX_UPLOAD_SIZE_EXCEEDED`。
|
|
33
|
+
- 系统和未知失败使用 SLF4J logger;`yss.exception.level=debug` 增加 logger debug 堆栈,不调用 `Throwable#printStackTrace()`。
|
|
34
|
+
- 每个处理响应在 MDC 中附加或复用 trace id,并通过 `X-Trace-Id` 响应头公开;正文不含原始 localized exception 或堆栈。
|
|
35
|
+
- 校验绑定失败转为 `SysException(PARAM_VALIDATION_ERROR)`;修改时协同 `yss-validation` 与契约测试。
|
|
36
|
+
|
|
37
|
+
## 异常语义
|
|
38
|
+
|
|
39
|
+
- `BizException`:有明确业务含义,通常不记 Error 日志、不重试。
|
|
40
|
+
- `SysException`:已知系统问题,记 Error 日志,是否可重试需按场景判断。
|
|
41
|
+
- 未知 `Exception`:保留完整堆栈日志,是否可重试需按场景判断。
|
|
42
|
+
|
|
43
|
+
## 验收
|
|
44
|
+
|
|
45
|
+
- 核验所需依赖或 starter 已进入实际工程。
|
|
46
|
+
- 错误码与消息对 API 消费方有明确含义。
|
|
47
|
+
- 公开消息已脱敏,不暴露原始 RuntimeException 或 localized exception 细节。
|
|
48
|
+
- 对受影响的 `boot3-java17` HTTP seam 验证业务 4xx、未知/runtime 5xx 与 trace header;仅上传限制影响验证 413。Boot 2 使用其独立源码与冻结合同,不引入 Boot 3 断言。
|
|
49
|
+
- 业务校验失败不归为未知系统错误。
|
|
50
|
+
- 未知/系统失败的堆栈保留在结构化日志中,不直接打印 stderr 或序列化给客户端。
|
|
51
|
+
- 重试建议与异常类型及实际用例一致。
|
|
52
|
+
- 已知系统失败使用 `ExceptionFactory.sysException(..., cause)`,Application 不改为无明确语义的 `RuntimeException`。
|
|
53
|
+
- Endpoint 测试覆盖实际受影响的失败类型;仅上传端点或上传处理变更执行上传限制测试。公开消息符合所选平台合同,不泄露受保护异常细节。
|
|
54
|
+
|
|
55
|
+
## 修改边界
|
|
56
|
+
|
|
57
|
+
- 类名和配置 key 先核验当前索引与源码,不凭记忆补造。
|
|
58
|
+
- 使用组件已有扩展 seam,不以业务本地框架代码替换。
|
|
59
|
+
- 保持当前组件任务范围;扩展到其他组件须有用户要求或重新路由依据。
|
|
@@ -3,187 +3,43 @@ name: yss-formily-schema-generator
|
|
|
3
3
|
description: "从需求或设计图生成 YFormily JSON Schema 与表单代码;仅用于生产表单实现。"
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# YFormily Schema
|
|
6
|
+
# YFormily Schema 生成
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
将文字需求、产品 / UX 说明、截图、本地图片或 Figma 设计输入转成生产表单的 `JSON Schema` / `ISchema`、推荐 model,以及按需的 scope、effects、插槽和 Vue 渲染示例。本技能设计 schema;精确组件行为由 [YFormily 路由](../yss-formily/SKILL.md)及实际命中的基础、联动、模式和分步专项决定。
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
## 触发与必要输入
|
|
11
11
|
|
|
12
|
-
|
|
13
|
-
- product or UX requirements
|
|
14
|
-
- screenshots and local images
|
|
15
|
-
- Figma links or node-based design references
|
|
12
|
+
用户要求根据需求、原型图、截图、Figma 或业务字段生成 YFormily schema / 渲染代码时使用。这里将已提供的设计转为生产表单,不生成产品原型。
|
|
16
13
|
|
|
17
|
-
|
|
14
|
+
确认表单用途、目标模式(查询 / 新增 / 编辑 / 查看 / 混合)、允许输出范围和可读上游输入。正式生产实现继续消费当前批准的 Slice Implementation Contract;本技能输出不授予实现或批准资格。字段语义、校验和接口模型以已确认需求与冻结合同为准,目标组件事实以工程版本、类型和真实导出为准。
|
|
18
15
|
|
|
19
|
-
|
|
20
|
-
- a recommended `v-model` data shape
|
|
21
|
-
- optional `scope`, `effects`, and slot plan
|
|
22
|
-
- optional Vue render snippet showing how to mount `YFormily`
|
|
16
|
+
转换字段、布局、校验、联动或插槽时,读取 [转换工作流](references/workflow.md)相应部分;不要求为了单一字段调整读取全部样例。
|
|
23
17
|
|
|
24
|
-
|
|
25
|
-
For implementation rules and exact YFormily behavior, also read:
|
|
18
|
+
## 按输入选择方法
|
|
26
19
|
|
|
27
|
-
|
|
20
|
+
| 输入 | 提取内容 | 不能从输入补造的内容 |
|
|
21
|
+
|---|---|---|
|
|
22
|
+
| 文字需求 | 用途、模式、分组、字段、必填规则、字典、联动和动作区 | 缺失的后端字典、阈值、权限和业务承诺 |
|
|
23
|
+
| 截图 / 图片 | 区域、标签、控件、按钮、必填标记与可见依赖;先区分 placeholder 和标签 | 隐藏校验、异步规则、唯一性或服务端行为。只有视觉线索时输出 schema 骨架并标明不确定项 |
|
|
24
|
+
| Figma 链接 / 节点 | 先发现可用设计读取能力,再提取语义标签、控件、分组、helper、必填提示、只读模式和底部动作 | 不猜工具名称或声称读取成功;能力缺失时使用已有导出 / 截图,仍不足以确认必要细节时报告访问缺口 |
|
|
28
25
|
|
|
29
|
-
|
|
26
|
+
按“业务意图 → 字段语义 → 已确认的校验与依赖 → 布局分组 → schema”转换,不机械照搬像素或设计图层名。合理默认只用于明确标注的控件与布局建议;业务规则缺口保持未确认。
|
|
30
27
|
|
|
31
|
-
|
|
28
|
+
## Schema 与默认选择
|
|
32
29
|
|
|
33
|
-
|
|
30
|
+
- 新代码使用 `YFormily`;历史 `YssFormily` 只在当前已安装兼容导出得到确认时使用。
|
|
31
|
+
- 布局为 `FormLayout -> FormGrid -> 字段`,普通字段使用 `FormItem`;新建 / 编辑 / 查看可共用 schema 时优先复用。
|
|
32
|
+
- 查看态按 `mode=2` 与必要的 `detail-*` 插槽处理;富输入使用 `Slot`。不依赖 React Formily UI 包,底层行为按安装的 Ant Design Vue。
|
|
33
|
+
- 字段 key 稳定且有业务含义,分组反映领域语义;清楚区分已确认的必填 / 可选、联动 / 只读与待确认项,不臆造字典或隐藏异步校验。
|
|
34
|
+
- 不因视觉有分组就将所有字段压平。无法推断的业务规则留在假设 / 未决项中,不转换成已确认校验。
|
|
34
35
|
|
|
35
|
-
|
|
36
|
+
未提供其他选择时,可建议:文本 `Input`,长说明 `Input.TextArea`,布尔 `Switch`,单选 `Select` / `Radio.Group`,日期 `DatePicker`,分组 `GroupHeader`。纯 Formily 提交的底部动作可用 `AutoButtonGroup`;业务列表查询区按 `formily-foundation` 使用外部 YButton 查询 / 重置。默认建议以保守、可解释为准,不能覆盖已有代码或用户输入。
|
|
36
37
|
|
|
37
|
-
|
|
38
|
-
- “根据原型图生成 YFormily”
|
|
39
|
-
- “根据图片/截图还原表单”
|
|
40
|
-
- “根据 Figma 生成表单 JSON Schema”
|
|
41
|
-
- “把业务字段整理成 YFormily schema”
|
|
42
|
-
- “输出 schema 和渲染代码”
|
|
38
|
+
## 执行与输出
|
|
43
39
|
|
|
44
|
-
|
|
40
|
+
1. 确认输入来源、业务用途与模式,规范化字段列表。
|
|
41
|
+
2. 选择字段类型、控件、分组和跨度,提取已确认的校验、enum 与联动;对不确定推断保留来源和假设。
|
|
42
|
+
3. 生成 schema 与 model,按实际命中的 Formily 专项校验;请求代码时再生成必要的 scope、effects、插槽计划和 Vue 挂载示例。
|
|
43
|
+
4. 核对稳定字段、业务分组、必填 / 可选、只读 / 联动与上游输入一致。冲突或必要细节不可读时保留缺口,回交原所有者,不能写成已确认结果。
|
|
45
44
|
|
|
46
|
-
|
|
47
|
-
Translate the input into a stable form model:
|
|
48
|
-
|
|
49
|
-
1. business intent
|
|
50
|
-
2. field semantics
|
|
51
|
-
3. validation and dependency rules
|
|
52
|
-
4. layout grouping
|
|
53
|
-
5. YFormily schema
|
|
54
|
-
|
|
55
|
-
The schema must reflect business meaning, not just pixel arrangement.
|
|
56
|
-
|
|
57
|
-
## Input-specific workflow
|
|
58
|
-
|
|
59
|
-
### Text requirement
|
|
60
|
-
|
|
61
|
-
Extract, in order:
|
|
62
|
-
|
|
63
|
-
1. form purpose
|
|
64
|
-
2. mode: query, create, edit, detail, mixed
|
|
65
|
-
3. sections or groups
|
|
66
|
-
4. fields
|
|
67
|
-
5. required rules
|
|
68
|
-
6. options or dictionaries
|
|
69
|
-
7. linkage rules
|
|
70
|
-
8. submit and action area
|
|
71
|
-
|
|
72
|
-
If some details are missing, make reasonable defaults and state the assumptions.
|
|
73
|
-
|
|
74
|
-
### Screenshot or image
|
|
75
|
-
|
|
76
|
-
Treat image understanding as approximate.
|
|
77
|
-
First identify:
|
|
78
|
-
|
|
79
|
-
- section boundaries
|
|
80
|
-
- labels
|
|
81
|
-
- control types
|
|
82
|
-
- action buttons
|
|
83
|
-
- required markers
|
|
84
|
-
- visible dependency hints
|
|
85
|
-
|
|
86
|
-
Infer likely field types from UI controls, but do not overclaim hidden business rules from appearance alone.
|
|
87
|
-
If the image contains only visual cues and no validation semantics, generate a schema skeleton and explicitly mark uncertain fields.
|
|
88
|
-
|
|
89
|
-
### Figma input
|
|
90
|
-
|
|
91
|
-
When a Figma link or node is provided, discover an available design-inspection capability first. If unavailable, use supplied design exports or screenshots; report the missing access when those cannot establish a required detail. Do not invent a tool name or claim inspection succeeded.
|
|
92
|
-
Extract:
|
|
93
|
-
|
|
94
|
-
- field labels
|
|
95
|
-
- control kinds
|
|
96
|
-
- layout groups
|
|
97
|
-
- helper text
|
|
98
|
-
- required indicators
|
|
99
|
-
- readonly versus editable patterns
|
|
100
|
-
- footer actions
|
|
101
|
-
|
|
102
|
-
Then convert that structure to YFormily, following local YSS conventions instead of raw design-tool naming.
|
|
103
|
-
|
|
104
|
-
## Required outputs
|
|
105
|
-
|
|
106
|
-
Unless the user asks for less, produce these artifacts:
|
|
107
|
-
|
|
108
|
-
1. schema
|
|
109
|
-
2. model shape
|
|
110
|
-
3. assumptions
|
|
111
|
-
4. open questions only if they block correctness
|
|
112
|
-
|
|
113
|
-
If the user asks for code generation, also produce:
|
|
114
|
-
|
|
115
|
-
5. `scope` plan
|
|
116
|
-
6. `effects` plan if needed
|
|
117
|
-
7. Vue usage snippet
|
|
118
|
-
|
|
119
|
-
## Schema design rules
|
|
120
|
-
|
|
121
|
-
Always align with `yss-formily`:
|
|
122
|
-
|
|
123
|
-
- wrapper component for new code is `YFormily`; the historical `YssFormily` alias is accepted only when an existing installed export is verified
|
|
124
|
-
- schema is `FormLayout -> FormGrid -> fields`
|
|
125
|
-
- use `FormItem` for ordinary fields
|
|
126
|
-
- prefer one shared schema for create/edit/detail when feasible
|
|
127
|
-
- for detail rendering, plan `mode=2` and `detail-*` slots where needed
|
|
128
|
-
- rich custom input uses `Slot`
|
|
129
|
-
|
|
130
|
-
Do not emit schema that depends on React Formily UI packages.
|
|
131
|
-
Treat Ant Design Vue semantics as the underlying component behavior.
|
|
132
|
-
|
|
133
|
-
## Output quality bar
|
|
134
|
-
|
|
135
|
-
A good generated schema should:
|
|
136
|
-
|
|
137
|
-
- have stable field keys
|
|
138
|
-
- use domain-oriented group names
|
|
139
|
-
- distinguish required from optional fields
|
|
140
|
-
- choose plausible component types
|
|
141
|
-
- reflect obvious linkage and readonly behavior
|
|
142
|
-
- leave non-inferable business rules as assumptions instead of hallucinating them
|
|
143
|
-
|
|
144
|
-
## Generation sequence
|
|
145
|
-
|
|
146
|
-
Follow this sequence every time:
|
|
147
|
-
|
|
148
|
-
1. Classify the input source.
|
|
149
|
-
2. Extract business structure.
|
|
150
|
-
3. Normalize field list.
|
|
151
|
-
4. Decide field types and components.
|
|
152
|
-
5. Decide sections and layout spans.
|
|
153
|
-
6. Identify validation, enum, and linkage requirements.
|
|
154
|
-
7. Produce YFormily schema.
|
|
155
|
-
8. Produce render snippet if requested.
|
|
156
|
-
9. Call out assumptions and uncertain inferences.
|
|
157
|
-
|
|
158
|
-
## When the input is incomplete
|
|
159
|
-
|
|
160
|
-
Use these defaults unless the existing code or user input says otherwise:
|
|
161
|
-
|
|
162
|
-
- text fields -> `Input`
|
|
163
|
-
- long description -> `Input.TextArea`
|
|
164
|
-
- boolean toggle -> `Switch`
|
|
165
|
-
- single choice -> `Select` or `Radio.Group`
|
|
166
|
-
- date -> `DatePicker`
|
|
167
|
-
- grouped sections -> `GroupHeader`
|
|
168
|
-
- footer buttons -> `AutoButtonGroup`
|
|
169
|
-
|
|
170
|
-
Prefer conservative defaults over speculative complexity.
|
|
171
|
-
|
|
172
|
-
## Do not do these things
|
|
173
|
-
|
|
174
|
-
- Do not invent backend dictionaries that were never described.
|
|
175
|
-
- Do not infer hidden async validation from visuals alone.
|
|
176
|
-
- Do not flatten all fields into one group if the input clearly has sections.
|
|
177
|
-
- Do not produce only a screenshot-level description when the user asked for schema.
|
|
178
|
-
- Do not skip assumptions when confidence is low.
|
|
179
|
-
|
|
180
|
-
## Recommended final structure
|
|
181
|
-
|
|
182
|
-
When delivering a full conversion, prefer this output order:
|
|
183
|
-
|
|
184
|
-
1. brief understanding
|
|
185
|
-
2. assumptions
|
|
186
|
-
3. field model
|
|
187
|
-
4. schema
|
|
188
|
-
5. optional render snippet
|
|
189
|
-
6. optional next-step questions
|
|
45
|
+
除非用户要求更少,返回简短理解、假设、字段 model、schema,以及真正阻断正确性的未决问题。请求代码时追加 scope 计划、必要的 effects 计划和 Vue 示例;不只描述截图,也不在低置信度时省略假设。
|