@gong-ym/ai-spec-auto 0.2.13 → 0.2.15
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/.agents/commands/README.md +33 -33
- package/.agents/commands/claude/spec-start-review.md +88 -88
- package/.agents/commands/codex/spec-continue.md +74 -74
- package/.agents/commands/codex/spec-orchestrate.md +35 -35
- package/.agents/commands/codex/spec-start-review.md +88 -88
- package/.agents/commands/codex/spec-start.md +67 -67
- package/.agents/commands/codex/spec-status.md +22 -22
- package/.agents/commands/codex/spec-stop.md +29 -29
- package/.agents/commands/codex/spec-update.md +40 -40
- package/.agents/commands/common/branch-review.md +117 -117
- package/.agents/commands/common/project-init.md +25 -25
- package/.agents/commands/common/spec-continue.md +74 -74
- package/.agents/commands/common/spec-orchestrate.md +35 -35
- package/.agents/commands/common/spec-start-review.md +82 -82
- package/.agents/commands/common/spec-start.md +67 -67
- package/.agents/commands/common/spec-status.md +22 -22
- package/.agents/commands/common/spec-stop.md +29 -29
- package/.agents/commands/common/spec-update.md +60 -40
- package/.agents/commands/cursor/opsx-apply.md +55 -55
- package/.agents/commands/cursor/opsx-archive.md +48 -48
- package/.agents/commands/cursor/opsx-explore.md +45 -45
- package/.agents/commands/cursor/opsx-propose.md +59 -59
- package/.agents/commands/cursor/spec-continue.md +63 -63
- package/.agents/commands/cursor/spec-orchestrate.md +53 -53
- package/.agents/commands/cursor/spec-start-review.md +78 -78
- package/.agents/commands/cursor/spec-start.md +59 -59
- package/.agents/commands/cursor/spec-status.md +30 -30
- package/.agents/commands/cursor/spec-stop.md +29 -29
- package/.agents/commands/cursor/spec-update.md +41 -41
- package/.agents/flows/FRONTMATTER.md +263 -263
- package/.agents/flows/RUN_OUTPUT.md +263 -263
- package/.agents/flows/common/README.md +29 -29
- package/.agents/flows/common/bugfix-to-verification.md +95 -95
- package/.agents/flows/common/change-to-architecture-review.md +89 -89
- package/.agents/flows/common/change-to-release.md +94 -94
- package/.agents/flows/common/prd-to-delivery.md +184 -184
- package/.agents/flows/common/requirement-to-observability.md +97 -97
- package/.agents/orchestration/README.md +22 -22
- package/.agents/orchestration/expert-dispatch-spec.md +155 -155
- package/.agents/orchestration/expert-executor-spec.md +84 -84
- package/.agents/orchestration/expert-runtime-action-spec.md +73 -73
- package/.agents/orchestration/runtime-state-handoff-spec.md +264 -264
- package/.agents/orchestration/task-anchor-spec.md +212 -212
- package/.agents/orchestration/task-orchestrator-adapter-payload.md +153 -153
- package/.agents/orchestration/task-orchestrator-bootstrap-payload.md +145 -145
- package/.agents/orchestration/task-orchestrator-output-extractor-spec.md +93 -93
- package/.agents/orchestration/task-orchestrator-run-plan-template.md +312 -312
- package/.agents/orchestration/task-orchestrator-runtime-hooks.md +214 -214
- package/.agents/registry/README.md +63 -63
- package/.agents/registry/flows.json +125 -125
- package/.agents/registry/profiles.json +101 -101
- package/.agents/registry/roles.json +1265 -1265
- package/.agents/registry/rules.json +148 -148
- package/.agents/registry/scenario-packages.json +123 -123
- package/.agents/registry/skills.json +130 -130
- package/.agents/roles/INDEX.md +346 -346
- package/.agents/roles/common/README.md +76 -76
- package/.agents/roles/common/archive-change.md +80 -80
- package/.agents/roles/common/backend-implementer.md +92 -92
- package/.agents/roles/common/code-guardian.md +151 -151
- package/.agents/roles/common/frontend-implementer.md +146 -146
- package/.agents/roles/common/requirement-analyst.md +138 -138
- package/.agents/roles/common/task-orchestrator-routing.md +301 -301
- package/.agents/roles/common/task-orchestrator.md +224 -224
- package/.agents/roles/common/tooling-implementer.md +92 -92
- package/.agents/roles/domains/README.md +35 -35
- package/.agents/roles/domains/delivery/README.md +11 -11
- package/.agents/roles/domains/delivery/container-specialist.md +50 -50
- package/.agents/roles/domains/delivery/deployment-specialist.md +50 -50
- package/.agents/roles/domains/delivery/pipeline-specialist.md +50 -50
- package/.agents/roles/domains/demand-design/README.md +16 -16
- package/.agents/roles/domains/demand-design/api-contract-specialist.md +52 -52
- package/.agents/roles/domains/demand-design/design-collaborator.md +58 -58
- package/.agents/roles/domains/documentation/README.md +11 -11
- package/.agents/roles/domains/documentation/api-doc-specialist.md +50 -50
- package/.agents/roles/domains/documentation/component-doc-specialist.md +49 -49
- package/.agents/roles/domains/documentation/technical-writing-specialist.md +48 -48
- package/.agents/roles/domains/engineering/README.md +17 -17
- package/.agents/roles/domains/engineering/architecture-advisor.md +53 -53
- package/.agents/roles/domains/engineering/build-specialist.md +51 -51
- package/.agents/roles/domains/engineering/dependency-governor.md +52 -52
- package/.agents/roles/domains/governance/README.md +17 -17
- package/.agents/roles/domains/governance/api-governance-specialist.md +51 -51
- package/.agents/roles/domains/governance/lint-policy-specialist.md +49 -49
- package/.agents/roles/domains/governance/route-governance-specialist.md +52 -52
- package/.agents/roles/domains/observability/README.md +11 -11
- package/.agents/roles/domains/observability/error-tracker.md +50 -50
- package/.agents/roles/domains/observability/event-instrumentation-specialist.md +51 -51
- package/.agents/roles/domains/observability/rum-analyst.md +50 -50
- package/.agents/roles/domains/performance/README.md +11 -11
- package/.agents/roles/domains/performance/asset-optimizer.md +50 -50
- package/.agents/roles/domains/performance/performance-auditor.md +56 -56
- package/.agents/roles/domains/performance/vitals-analyst.md +50 -50
- package/.agents/roles/domains/security-a11y/README.md +11 -11
- package/.agents/roles/domains/security-a11y/a11y-auditor.md +50 -50
- package/.agents/roles/domains/security-a11y/aria-specialist.md +51 -51
- package/.agents/roles/domains/security-a11y/security-reviewer.md +49 -49
- package/.agents/roles/domains/testing/README.md +12 -12
- package/.agents/roles/domains/testing/coverage-analyst.md +50 -50
- package/.agents/roles/domains/testing/e2e-test-specialist.md +51 -51
- package/.agents/roles/domains/testing/unit-test-specialist.md +56 -56
- package/.agents/roles/domains/testing/verification-reviewer.md +67 -67
- package/.agents/rules/README.md +87 -87
- package/.agents/rules/common/02-/347/274/226/347/240/201/350/247/204/350/214/203.md +45 -45
- package/.agents/rules/common/08-/351/200/232/347/224/250/347/272/246/346/235/237.md +63 -63
- package/.agents/rules/common/10-/346/226/207/346/241/243/350/247/204/350/214/203.md +101 -101
- package/.agents/rules/common/12-Superpowers/346/211/247/350/241/214/350/247/204/350/214/203.md +46 -46
- package/.agents/rules/common/14-/345/256/241/350/256/241/346/261/207/346/212/245/350/247/204/350/214/203.md +107 -107
- package/.agents/rules/common/15-visual-gate-wait.md +90 -90
- package/.agents/rules/profiles/nestjs/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +27 -27
- package/.agents/rules/profiles/nestjs/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +20 -20
- package/.agents/rules/profiles/nestjs/04-/346/250/241/345/235/227/347/273/223/346/236/204/350/247/204/350/214/203.md +24 -24
- package/.agents/rules/profiles/nestjs/05-/346/216/245/345/217/243/344/270/216/345/245/221/347/272/246/350/247/204/350/214/203.md +24 -24
- package/.agents/rules/profiles/nestjs/06-/346/225/260/346/215/256/350/256/277/351/227/256/350/247/204/350/214/203.md +24 -24
- package/.agents/rules/profiles/nestjs/07-/351/205/215/347/275/256/344/270/216/350/277/220/350/241/214/346/227/266/350/247/204/350/214/203.md +20 -20
- package/.agents/rules/profiles/nestjs/09-/345/274/202/345/270/270/344/270/216/346/227/245/345/277/227/350/247/204/350/214/203.md +20 -20
- package/.agents/rules/profiles/nestjs/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +24 -24
- package/.agents/rules/profiles/nestjs/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +20 -20
- package/.agents/rules/profiles/node-tooling/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +30 -30
- package/.agents/rules/profiles/node-tooling/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +37 -37
- package/.agents/rules/profiles/node-tooling/04-CLI/344/270/216/346/250/241/345/235/227/350/247/204/350/214/203.md +42 -42
- package/.agents/rules/profiles/node-tooling/05-Contract/344/270/216Schema/350/247/204/350/214/203.md +42 -42
- package/.agents/rules/profiles/node-tooling/06-/350/277/220/350/241/214/346/227/266/346/226/207/344/273/266/350/247/204/350/214/203.md +30 -30
- package/.agents/rules/profiles/node-tooling/07-/346/227/245/345/277/227/344/270/216/351/224/231/350/257/257/345/244/204/347/220/206/350/247/204/350/214/203.md +60 -60
- package/.agents/rules/profiles/node-tooling/09-/350/204/232/346/234/254/344/270/216/345/205/245/345/217/243/350/247/204/350/214/203.md +45 -45
- package/.agents/rules/profiles/node-tooling/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +41 -41
- package/.agents/rules/profiles/node-tooling/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +55 -55
- package/.agents/rules/profiles/react/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +29 -29
- package/.agents/rules/profiles/react/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +104 -104
- package/.agents/rules/profiles/react/04-/347/273/204/344/273/266/350/247/204/350/214/203.md +46 -46
- package/.agents/rules/profiles/react/05-API/350/247/204/350/214/203.md +67 -67
- package/.agents/rules/profiles/react/06-/350/267/257/347/224/261/350/247/204/350/214/203.md +54 -54
- package/.agents/rules/profiles/react/07-/347/212/266/346/200/201/347/256/241/347/220/206.md +226 -226
- package/.agents/rules/profiles/react/09-/346/240/267/345/274/217/350/247/204/350/214/203.md +71 -71
- package/.agents/rules/profiles/react/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +80 -80
- package/.agents/rules/profiles/react/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +159 -159
- package/.agents/rules/profiles/springboot/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +31 -31
- package/.agents/rules/profiles/springboot/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +37 -37
- package/.agents/rules/profiles/springboot/04-/345/210/206/345/261/202/350/247/204/350/214/203.md +33 -33
- package/.agents/rules/profiles/springboot/05-/346/216/245/345/217/243/344/270/216/345/245/221/347/272/246/350/247/204/350/214/203.md +51 -51
- package/.agents/rules/profiles/springboot/06-/346/225/260/346/215/256/350/256/277/351/227/256/350/247/204/350/214/203.md +34 -34
- package/.agents/rules/profiles/springboot/07-/351/205/215/347/275/256/344/270/216/350/277/220/350/241/214/346/227/266/350/247/204/350/214/203.md +38 -38
- package/.agents/rules/profiles/springboot/09-/345/274/202/345/270/270/344/270/216/346/227/245/345/277/227/350/247/204/350/214/203.md +48 -48
- package/.agents/rules/profiles/springboot/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +43 -43
- package/.agents/rules/profiles/springboot/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +48 -48
- package/.agents/rules/profiles/vue/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +47 -47
- package/.agents/rules/profiles/vue/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +106 -106
- package/.agents/rules/profiles/vue/04-/347/273/204/344/273/266/350/247/204/350/214/203.md +61 -61
- package/.agents/rules/profiles/vue/05-API/350/247/204/350/214/203.md +67 -67
- package/.agents/rules/profiles/vue/06-/350/267/257/347/224/261/350/247/204/350/214/203.md +69 -69
- package/.agents/rules/profiles/vue/07-/347/212/266/346/200/201/347/256/241/347/220/206.md +93 -93
- package/.agents/rules/profiles/vue/09-/346/240/267/345/274/217/350/247/204/350/214/203.md +67 -67
- package/.agents/rules/profiles/vue/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +80 -80
- package/.agents/rules/profiles/vue/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +159 -159
- package/.agents/skills/README.md +171 -171
- package/.agents/skills/common/archive-change/SKILL.md +180 -180
- package/.agents/skills/common/branch-code-reviewer/SKILL.md +533 -459
- package/.agents/skills/common/branch-code-reviewer/references/business-risk-guide.md +293 -293
- package/.agents/skills/common/branch-code-reviewer/references/html-template-guide.md +121 -121
- package/.agents/skills/common/config-and-secret-scan/SKILL.md +99 -99
- package/.agents/skills/common/create-proposal/SKILL.md +192 -192
- package/.agents/skills/common/create-proposal/evals/evals.json +16 -16
- package/.agents/skills/common/create-proposal/evals/train_queries.json +18 -18
- package/.agents/skills/common/create-proposal/evals/validation_queries.json +18 -18
- package/.agents/skills/common/create-proposal/references/interaction-spec-template.md +42 -42
- package/.agents/skills/common/create-test/SKILL.md +292 -292
- package/.agents/skills/common/dependency-impact-graph/SKILL.md +80 -80
- package/.agents/skills/common/execute-task/SKILL.md +206 -206
- package/.agents/skills/common/execute-task/evals/evals.json +16 -16
- package/.agents/skills/common/execute-task/evals/train_queries.json +18 -18
- package/.agents/skills/common/execute-task/evals/validation_queries.json +18 -18
- package/.agents/skills/common/find-skills/SKILL.md +144 -144
- package/.agents/skills/common/install-ai-spec-auto/SKILL.md +260 -260
- package/.agents/skills/common/install-ai-spec-auto/evals/evals.json +17 -17
- package/.agents/skills/common/install-ai-spec-auto/evals/train_queries.json +18 -18
- package/.agents/skills/common/install-ai-spec-auto/evals/validation_queries.json +18 -18
- package/.agents/skills/common/project-init/SKILL.md +178 -178
- package/.agents/skills/common/project-init/evals/evals.json +16 -16
- package/.agents/skills/common/project-init/evals/train_queries.json +18 -18
- package/.agents/skills/common/project-init/evals/validation_queries.json +18 -18
- package/.agents/skills/common/project-init/references/custom-rule-generation.md +89 -89
- package/.agents/skills/common/project-init/references/deep-scan-rules.md +67 -67
- package/.agents/skills/common/project-init/references/output-contracts.md +71 -71
- package/.agents/skills/common/project-init/references/repo-fact-gathering.md +83 -83
- package/.agents/skills/common/project-init/references/scope-resolution.md +76 -76
- package/.agents/skills/common/project-init/scripts/inspect-project.js +112 -112
- package/.agents/skills/common/skill-creator/LICENSE.txt +201 -201
- package/.agents/skills/common/skill-creator/SKILL.md +370 -370
- package/.agents/skills/common/skill-creator/evals/evals.json +16 -16
- package/.agents/skills/common/skill-creator/evals/train_queries.json +18 -18
- package/.agents/skills/common/skill-creator/evals/validation_queries.json +18 -18
- package/.agents/skills/common/skill-creator/references/output-patterns.md +82 -82
- package/.agents/skills/common/skill-creator/references/workflows.md +27 -27
- package/.agents/skills/common/skill-creator/scripts/init_skill.py +209 -209
- package/.agents/skills/common/skill-creator/scripts/package_skill.py +110 -110
- package/.agents/skills/common/skill-creator/scripts/quick_validate.py +51 -51
- package/.agents/skills/common/skill-optimizer/SKILL.md +102 -102
- package/.agents/skills/common/skill-optimizer/evals/evals.json +16 -16
- package/.agents/skills/common/skill-optimizer/evals/train_queries.json +18 -18
- package/.agents/skills/common/skill-optimizer/evals/validation_queries.json +18 -18
- package/.agents/skills/common/skill-optimizer/references/design-patterns.md +26 -26
- package/.agents/skills/common/skill-optimizer/references/review-checklist.md +22 -22
- package/.agents/skills/common/using-superpowers/SKILL.md +151 -151
- package/.agents/skills/common/wait-for-gate-signal/SKILL.md +85 -85
- package/.agents/skills/domains/README.md +19 -19
- package/.agents/skills/domains/ui-ux-pro-max/SKILL.md +58 -58
- package/.agents/skills/domains/web/design-analysis/SKILL.md +89 -89
- package/.agents/skills/domains/web/design-analysis/rules/analysis-order.md +61 -61
- package/.agents/skills/domains/web/design-analysis/rules/analysis-priorities.md +136 -136
- package/.agents/skills/domains/web/design-analysis/rules/checklist-common-misses.md +107 -107
- package/.agents/skills/domains/web/design-analysis/rules/implementation-common-errors.md +204 -204
- package/.agents/skills/domains/web/design-analysis/rules/implementation-guidelines.md +211 -211
- package/.agents/skills/domains/web/design-analysis/rules/output-analysis-checklist.md +247 -247
- package/.agents/skills/domains/web/design-analysis/rules/tools-design-guidelines.md +108 -108
- package/.agents/skills/domains/web/design-analysis/rules/workflow-element-extraction.md +162 -162
- package/.agents/skills/domains/web/design-analysis/rules/workflow-layout-map.md +131 -131
- package/.agents/skills/domains/web/design-analysis/rules/workflow-output-checklist.md +70 -70
- package/.agents/skills/domains/web/design-analysis/rules/workflow-style-summary.md +91 -91
- package/.agents/skills/domains/web/route-permission-map/SKILL.md +103 -103
- package/.agents/skills/domains/web/ui-verification/SKILL.md +114 -114
- package/.agents/skills/domains/web/ui-verification/evals/evals.json +16 -16
- package/.agents/skills/domains/web/ui-verification/evals/train_queries.json +18 -18
- package/.agents/skills/domains/web/ui-verification/evals/validation_queries.json +18 -18
- package/.agents/skills/domains/web/ui-verification/rules/comparison-content-image.md +34 -34
- package/.agents/skills/domains/web/ui-verification/rules/comparison-content-text.md +30 -30
- package/.agents/skills/domains/web/ui-verification/rules/comparison-hierarchy.md +33 -33
- package/.agents/skills/domains/web/ui-verification/rules/comparison-layout.md +35 -35
- package/.agents/skills/domains/web/ui-verification/rules/errors-alignment.md +42 -42
- package/.agents/skills/domains/web/ui-verification/rules/errors-button-dimensions.md +28 -28
- package/.agents/skills/domains/web/ui-verification/rules/errors-button-position.md +25 -25
- package/.agents/skills/domains/web/ui-verification/rules/errors-css-priority.md +50 -50
- package/.agents/skills/domains/web/ui-verification/rules/errors-flex-column-width.md +46 -46
- package/.agents/skills/domains/web/ui-verification/rules/errors-flex-layout.md +46 -46
- package/.agents/skills/domains/web/ui-verification/rules/errors-grid-container-width.md +44 -44
- package/.agents/skills/domains/web/ui-verification/rules/errors-page-container-width.md +39 -39
- package/.agents/skills/domains/web/ui-verification/rules/tools-browser-navigation.md +53 -53
- package/.agents/skills/domains/web/ui-verification/rules/tools-design-guidelines.md +53 -53
- package/.agents/skills/domains/web/ui-verification/rules/workflow-checklist.md +27 -27
- package/.agents/skills/domains/web/ui-verification/rules/workflow-problem-list.md +56 -56
- package/.agents/skills/domains/web/ui-verification/rules/workflow-reflection.md +44 -44
- package/.agents/skills/domains/web/ui-verification/rules/writing-alignment.md +44 -44
- package/.agents/skills/domains/web/ui-verification/rules/writing-element-completeness.md +63 -63
- package/.agents/skills/domains/web/ui-verification/rules/writing-list-layout.md +75 -75
- package/.agents/skills/domains/web/ui-verification/rules/writing-page-container-width.md +37 -37
- package/.agents/skills/domains/web/web-design-guidelines/SKILL.md +40 -40
- package/.agents/skills/profiles/nestjs/README.md +4 -4
- package/.agents/skills/profiles/node-tooling/README.md +9 -9
- package/.agents/skills/profiles/react/create-api/SKILL.md +145 -145
- package/.agents/skills/profiles/react/create-component/SKILL.md +160 -160
- package/.agents/skills/profiles/react/create-route/SKILL.md +168 -168
- package/.agents/skills/profiles/react/create-store/SKILL.md +262 -262
- package/.agents/skills/profiles/react/theme-variables/SKILL.md +82 -82
- package/.agents/skills/profiles/react/vercel-composition-patterns/AGENTS.md +899 -899
- package/.agents/skills/profiles/react/vercel-composition-patterns/SKILL.md +81 -81
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -100
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/architecture-compound-components.md +112 -112
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -87
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -100
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-context-interface.md +191 -191
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -113
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-lift-state.md +125 -125
- package/.agents/skills/profiles/react/vercel-react-best-practices/AGENTS.md +2934 -2934
- package/.agents/skills/profiles/react/vercel-react-best-practices/SKILL.md +136 -136
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -55
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-init-once.md +42 -42
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-use-latest.md +39 -39
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-api-routes.md +38 -38
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-defer-await.md +80 -80
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-dependencies.md +51 -51
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-parallel.md +28 -28
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -99
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-barrel-imports.md +59 -59
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-conditional.md +31 -31
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -49
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -35
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-preload.md +50 -50
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-event-listeners.md +74 -74
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -71
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -48
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-swr-dedup.md +56 -56
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -107
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-function-results.md +80 -80
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-property-access.md +28 -28
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-storage.md +70 -70
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-combine-iterations.md +32 -32
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-early-exit.md +50 -50
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -45
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-index-maps.md +37 -37
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-length-check-first.md +49 -49
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-min-max-loop.md +82 -82
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -24
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -57
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-activity.md +26 -26
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -47
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -40
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -38
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -46
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -82
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -30
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -28
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -75
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -39
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-dependencies.md +45 -45
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -40
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-derived-state.md +29 -29
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -74
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -58
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -38
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-memo.md +44 -44
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -45
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -35
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-transitions.md +40 -40
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -73
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -73
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-auth-actions.md +96 -96
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-cache-lru.md +41 -41
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-cache-react.md +76 -76
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-dedup-props.md +65 -65
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -83
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-serialization.md +38 -38
- package/.agents/skills/profiles/springboot/README.md +10 -10
- package/.agents/skills/profiles/vue/create-api/SKILL.md +105 -105
- package/.agents/skills/profiles/vue/create-component/SKILL.md +76 -76
- package/.agents/skills/profiles/vue/create-route/SKILL.md +141 -141
- package/.agents/skills/profiles/vue/create-store/SKILL.md +97 -97
- package/.agents/skills/profiles/vue/create-view/SKILL.md +81 -81
- package/.agents/skills/profiles/vue/theme-variables/SKILL.md +73 -73
- package/.agents/skills/profiles/vue/vue-best-practices/SKILL.md +166 -166
- package/.agents/skills/profiles/vue/vue-best-practices/references/animation-class-based-technique.md +254 -254
- package/.agents/skills/profiles/vue/vue-best-practices/references/animation-state-driven-technique.md +291 -291
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-async.md +97 -97
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-data-flow.md +307 -307
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-fallthrough-attrs.md +174 -174
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-keep-alive.md +137 -137
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-slots.md +216 -216
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-suspense.md +228 -228
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-teleport.md +108 -108
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-transition-group.md +128 -128
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-transition.md +125 -125
- package/.agents/skills/profiles/vue/vue-best-practices/references/composables.md +290 -290
- package/.agents/skills/profiles/vue/vue-best-practices/references/directives.md +162 -162
- package/.agents/skills/profiles/vue/vue-best-practices/references/perf-avoid-component-abstraction-in-lists.md +159 -159
- package/.agents/skills/profiles/vue/vue-best-practices/references/perf-v-once-v-memo-directives.md +182 -182
- package/.agents/skills/profiles/vue/vue-best-practices/references/perf-virtualize-large-lists.md +187 -187
- package/.agents/skills/profiles/vue/vue-best-practices/references/plugins.md +166 -166
- package/.agents/skills/profiles/vue/vue-best-practices/references/reactivity.md +344 -344
- package/.agents/skills/profiles/vue/vue-best-practices/references/render-functions.md +201 -201
- package/.agents/skills/profiles/vue/vue-best-practices/references/sfc.md +310 -310
- package/.agents/skills/profiles/vue/vue-best-practices/references/state-management.md +135 -135
- package/.agents/skills/profiles/vue/vue-best-practices/references/updated-hook-performance.md +187 -187
- package/.agents/templates/common/README.md +23 -23
- package/.agents/templates/common/bugfix.md +22 -22
- package/.agents/templates/common/create-expert-package.md +458 -458
- package/.agents/templates/common/mock-page.md +28 -28
- package/.agents/templates/common/new-component.md +25 -25
- package/.agents/templates/common/new-page.md +31 -31
- package/.cursor/mcp.json +35 -35
- package/.qoder/mcp.json +26 -26
- package/bin/archive-change.js +560 -474
- package/bin/check-command.js +62 -62
- package/bin/cli.js +0 -0
- package/bin/command-template-renderer.js +40 -40
- package/bin/context-command.js +102 -102
- package/bin/demo-runtime-smoke.js +760 -760
- package/bin/execution-semantics.js +821 -821
- package/bin/executor-command.js +93 -93
- package/bin/expert-dispatch.js +334 -334
- package/bin/expert-executor.js +1148 -1148
- package/bin/guard-command.js +52 -52
- package/bin/hub-command.js +876 -876
- package/bin/ide-command.js +242 -242
- package/bin/init-command.js +193 -193
- package/bin/install-workflow.js +35 -3
- package/bin/manifest-export.js +34 -34
- package/bin/profile-registry.js +90 -90
- package/bin/protocol-workflow.js +452 -446
- package/bin/repair-command.js +161 -161
- package/bin/repo-map.js +177 -177
- package/bin/report-command.js +236 -236
- package/bin/runtime-bootstrap.js +428 -428
- package/bin/runtime-embedded.js +101 -101
- package/bin/runtime-fallback.js +106 -106
- package/bin/runtime-launcher.js +116 -116
- package/bin/runtime-paths.js +177 -177
- package/bin/runtime-registry.js +289 -289
- package/bin/runtime-state.js +2541 -2541
- package/bin/scan.js +96 -96
- package/bin/self-upgrade.js +206 -206
- package/bin/skill-spec-validator.js +457 -457
- package/bin/spec-command.js +366 -366
- package/bin/superpowers.js +384 -384
- package/bin/sync-command.js +59 -59
- package/bin/sync.js +1904 -1904
- package/bin/task-orchestrator-adapter.js +341 -341
- package/bin/task-orchestrator-extractor.js +274 -274
- package/bin/task-orchestrator-runner.js +1208 -1208
- package/bin/telemetry/README.md +66 -66
- package/bin/telemetry/aspect.js +153 -153
- package/bin/telemetry/collect.js +67 -67
- package/bin/telemetry/config.js +114 -114
- package/bin/telemetry/defaults.json +5 -5
- package/bin/telemetry/healthcheck.js +195 -195
- package/bin/telemetry/identity.js +53 -53
- package/bin/telemetry/index.js +25 -25
- package/bin/telemetry/reporter.js +83 -83
- package/bin/telemetry/safe.js +39 -39
- package/bin/validate-registry.js +740 -740
- package/bin/visual-bridge-config.js +117 -117
- package/bin/visual-bridge.js +287 -287
- package/bin/visual-command.js +432 -432
- package/bin/worktree-command.js +194 -194
- package/configs/common/.editorconfig +15 -15
- package/configs/common/.husky/commit-msg +4 -4
- package/configs/common/.husky/pre-commit +4 -4
- package/configs/common/.lintstagedrc +11 -11
- package/configs/common/.prettierignore +11 -11
- package/configs/common/.prettierrc.json +11 -11
- package/configs/common/.stylelintignore +14 -14
- package/configs/common/.stylelintrc.json +21 -21
- package/configs/common/commitlint.config.js +3 -3
- package/configs/profiles/nestjs/.gitkeep +1 -1
- package/configs/profiles/node-tooling/.gitkeep +1 -1
- package/configs/profiles/react/.eslintignore +6 -6
- package/configs/profiles/react/.eslintrc.js +16 -16
- package/configs/profiles/react/.stylelintrc.json +18 -18
- package/configs/profiles/springboot/.gitkeep +1 -1
- package/configs/profiles/vue/.eslintignore +6 -6
- package/configs/profiles/vue/.eslintrc.cjs +17 -17
- package/contracts/README.md +28 -28
- package/contracts/fixtures/asset-package.fixture.json +26 -26
- package/contracts/fixtures/asset-usage-feedback.fixture.json +14 -14
- package/contracts/fixtures/evidence-report.fixture.json +28 -28
- package/contracts/fixtures/manifest.fixture.json +20 -20
- package/contracts/fixtures/run-event.fixture.json +15 -15
- package/contracts/schemas/asset-package.schema.json +76 -76
- package/contracts/schemas/asset-usage-feedback.schema.json +57 -57
- package/contracts/schemas/evidence-report.schema.json +60 -60
- package/contracts/schemas/manifest.schema.json +63 -63
- package/contracts/schemas/run-event.schema.json +72 -72
- package/install.ps1 +35 -35
- package/install.sh +17 -17
- package/internal/ai-protocol-workflow.js +5824 -5600
- package/internal/hub-client.js +98 -98
- package/internal/hub-sync-selection.js +69 -69
- package/internal/visual-hooks/README.md +481 -481
- package/internal/visual-hooks/config-loader.js +218 -218
- package/internal/visual-hooks/control-puller.js +206 -206
- package/internal/visual-hooks/gate-signal.js +150 -150
- package/internal/visual-hooks/inbox-consumer.js +469 -469
- package/internal/visual-hooks/index.js +197 -197
- package/internal/visual-hooks/push-client.js +189 -189
- package/internal/visual-hooks/receipt-pusher.js +176 -176
- package/internal/visual-hooks/runtime-state-pusher.js +128 -128
- package/openspec/config.yaml.template +52 -52
- package/openspec/schemas/expert-delivery/schema.yaml +68 -68
- package/openspec/schemas/expert-delivery/templates/checklist.md +39 -39
- package/openspec/schemas/expert-delivery/templates/design.md +61 -61
- package/openspec/schemas/expert-delivery/templates/iterations.md +25 -25
- package/openspec/schemas/expert-delivery/templates/proposal.md +45 -45
- package/openspec/schemas/expert-delivery/templates/spec.md +29 -29
- package/openspec/schemas/expert-delivery/templates/tasks.md +24 -24
- package/package.json +1 -1
- package/scripts/acceptance-zero-intrusion.sh +168 -168
- package/scripts/hub-sync-assets.config.example.json +296 -296
- package/scripts/hub-sync-assets.js +2038 -2038
- package/scripts/local-verify.sh +280 -280
- package/scripts/post-publish-auto-fix-check.js +404 -404
- package/scripts/post-publish-verify.sh +175 -175
- package/scripts/setup-cursor-manual-test.sh +107 -107
- package/scripts/setup-cursor-spec-archive-test.sh +111 -111
- package/scripts/setup-visual-integration.sh +225 -225
- package/scripts/test-integration.sh +176 -176
- package/scripts/update-test-project.sh +93 -93
- package/scripts/upload-four-web.sh +57 -57
- package/scripts/verify-install-ps1-bom.js +26 -26
- package/src/agent/agent-context.js +259 -259
- package/src/agent/agent-profile.js +185 -185
- package/src/agent/agent-templates.js +161 -161
- package/src/agent/agent-types.js +108 -108
- package/src/agent/collaboration-protocol.js +333 -333
- package/src/agent/conflict-handler.js +364 -364
- package/src/agent/file-permission.js +121 -121
- package/src/agent/index.js +38 -38
- package/src/agent/permission-audit.js +151 -151
- package/src/agent/review-repair-loop.js +270 -270
- package/src/agent/tool-permission.js +101 -101
- package/src/asset/asset-dependency.js +322 -322
- package/src/asset/asset-feedback.js +350 -350
- package/src/asset/asset-fork.js +300 -300
- package/src/asset/asset-install.js +278 -278
- package/src/asset/asset-installer.js +497 -497
- package/src/asset/asset-lifecycle.js +324 -324
- package/src/asset/asset-manager.js +245 -245
- package/src/asset/asset-package-manager.js +349 -349
- package/src/asset/asset-package.js +186 -186
- package/src/asset/asset-quality.js +262 -262
- package/src/asset/asset-registry.js +387 -387
- package/src/asset/asset-version.js +293 -293
- package/src/asset/index.js +86 -86
- package/src/cache/agent-profile-cache.js +59 -59
- package/src/cache/asset-cache.js +63 -63
- package/src/cache/global-cache.js +61 -61
- package/src/cache/manifest-cache.js +30 -30
- package/src/check/check-service.js +32 -32
- package/src/config/config-layer.js +343 -343
- package/src/config/config-loader.js +60 -60
- package/src/config/defaults.js +49 -49
- package/src/connectors/hub/asset-package.js +72 -72
- package/src/connectors/hub/asset-usage-feedback.js +46 -46
- package/src/connectors/hub/hub-connector.js +44 -44
- package/src/connectors/hub/index.js +21 -21
- package/src/connectors/visual/evidence-report.js +49 -49
- package/src/connectors/visual/index.js +15 -15
- package/src/connectors/visual/queue.js +41 -41
- package/src/connectors/visual/run-event.js +81 -81
- package/src/connectors/visual/visual-connector.js +77 -77
- package/src/context/context-budget.js +59 -59
- package/src/context/context-builder.js +285 -285
- package/src/context/context-loader.js +116 -116
- package/src/context/context-planner.js +158 -158
- package/src/context/types.js +96 -96
- package/src/contracts/index.js +63 -63
- package/src/executor/executor-registry.js +78 -78
- package/src/executor/executor-result-parser.js +44 -44
- package/src/executor/executor-runner.js +141 -141
- package/src/executor/executor-selector.js +139 -139
- package/src/executor/executor-timeout.js +36 -36
- package/src/executor/providers/base-provider-utils.js +189 -189
- package/src/executor/providers/claude-code-executor-provider.js +128 -128
- package/src/executor/providers/codex-executor-provider.js +126 -126
- package/src/executor/providers/cursor-executor-provider.js +99 -99
- package/src/executor/types.js +137 -137
- package/src/git/branch-manager.js +71 -71
- package/src/git/dirty-checker.js +43 -43
- package/src/git/dirty-strategy-handler.js +29 -29
- package/src/git/git-command.js +37 -37
- package/src/git/git-repository-detector.js +45 -45
- package/src/git/multi-repo-worktree-planner.js +88 -88
- package/src/git/policy.js +19 -19
- package/src/git/strategies/block-dirty-strategy.js +34 -34
- package/src/git/strategies/ignore-dirty-strategy.js +33 -33
- package/src/git/strategies/patch-snapshot-strategy.js +53 -53
- package/src/git/strategies/wip-commit-strategy.js +38 -38
- package/src/git/types.js +71 -71
- package/src/git/worktree-manager.js +85 -85
- package/src/governance/asset-review.js +351 -351
- package/src/governance/audit-log.js +368 -368
- package/src/governance/gray-release.js +312 -312
- package/src/governance/index.js +31 -31
- package/src/governance/policy-types.js +56 -56
- package/src/governance/rbac-types.js +171 -171
- package/src/governance/rbac.js +382 -382
- package/src/governance/rollback.js +360 -360
- package/src/governance/security-policy.js +354 -354
- package/src/hook/hook-config-writer.js +125 -125
- package/src/hub/hub-client.js +186 -186
- package/src/hub/hub-config.js +39 -39
- package/src/hub/project-facts.js +31 -31
- package/src/hub/runtime-feedback-reporter.js +55 -55
- package/src/ide/adapters/adapter-protocol.js +385 -385
- package/src/ide/adapters/claude-adapter.js +419 -419
- package/src/ide/adapters/codex-adapter.js +60 -60
- package/src/ide/adapters/cursor-adapter.js +484 -484
- package/src/ide/adapters/index.js +24 -24
- package/src/ide/anchors/markdown-anchor-writer.js +152 -152
- package/src/ide/ide-service.js +270 -270
- package/src/ide/ide-types.js +94 -94
- package/src/ide/links/link-mode-resolver.js +160 -160
- package/src/ide/registry/ide-registry-builder.js +165 -165
- package/src/incident/incident-writer.js +47 -47
- package/src/incident/types.js +22 -22
- package/src/init/ide-linker.js +126 -126
- package/src/init/ide-pointer-injector.js +75 -75
- package/src/init/init-applier.js +197 -197
- package/src/init/init-plan.js +294 -294
- package/src/init/init-service.js +65 -65
- package/src/init/manifest-installer.js +302 -302
- package/src/init/types.js +26 -26
- package/src/project/config-writer.js +83 -83
- package/src/project/context-index-writer.js +82 -82
- package/src/project/json-utils.js +72 -72
- package/src/project/local-state-writer.js +50 -50
- package/src/project/lock-file-writer.js +98 -98
- package/src/project/manifest-writer.js +126 -126
- package/src/project/policy-config-writer.js +91 -91
- package/src/project/project-config-writer.js +74 -74
- package/src/project/project-files.js +39 -39
- package/src/project/registry-index-writer.js +43 -43
- package/src/project/workspace-config-writer.js +63 -63
- package/src/run/index.js +11 -11
- package/src/run/run-id.js +32 -32
- package/src/run/run-service.js +269 -269
- package/src/run/run-store.js +80 -80
- package/src/scanner/aggregator/detection-aggregator.js +23 -23
- package/src/scanner/boundary/boundary-resolver.js +229 -229
- package/src/scanner/detectors/detector-registry.js +44 -44
- package/src/scanner/detectors/fastapi-detector.js +46 -46
- package/src/scanner/detectors/go-detector.js +46 -46
- package/src/scanner/detectors/nestjs-detector.js +57 -57
- package/src/scanner/detectors/nextjs-detector.js +52 -52
- package/src/scanner/detectors/react-vite-detector.js +52 -52
- package/src/scanner/detectors/react-webpack-detector.js +57 -57
- package/src/scanner/detectors/springboot-detector.js +46 -46
- package/src/scanner/detectors/springcloud-detector.js +46 -46
- package/src/scanner/detectors/springmvc-detector.js +46 -46
- package/src/scanner/detectors/vue-vite-detector.js +52 -52
- package/src/scanner/engine.js +72 -72
- package/src/scanner/facts/fact-extractor.js +211 -211
- package/src/scanner/types.js +30 -30
- package/src/security/asset-tamper-checker.js +188 -188
- package/src/security/checksum.js +40 -40
- package/src/spec/spec-writer.js +302 -302
- package/src/state-machine/circuit-breaker.js +112 -112
- package/src/state-machine/escape-hatch.js +49 -49
- package/src/state-machine/stage-runner.js +281 -281
- package/src/state-machine/state-machine.js +24 -24
- package/src/state-machine/transition-guard.js +36 -36
- package/src/state-machine/types.js +37 -37
- package/src/sync/sync-service.js +192 -192
- package/src/visual/agent-visual.js +142 -142
- package/src/visual/event-gateway.js +357 -357
- package/src/visual/event-mapper.js +128 -128
- package/src/visual/hook-dashboard.js +216 -216
- package/src/visual/index.js +27 -27
- package/src/visual/metrics.js +287 -287
- package/src/visual/privacy-filter.js +100 -100
- package/src/visual/risk-board.js +252 -252
- package/src/visual/timeline.js +245 -245
- package/src/visual/visual-client.js +94 -94
- package/src/visual/visual-config.js +40 -40
- package/src/visual/visual-reporter.js +88 -88
|
@@ -1,131 +1,131 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 第一步:建立布局 Map
|
|
3
|
-
impact: CRITICAL
|
|
4
|
-
impactDescription: 设计稿分析第一步,获取整体结构、区域划分与区域间关系
|
|
5
|
-
tags: workflow, layout-map, analysis, critical
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# 第一步:建立布局 Map
|
|
9
|
-
|
|
10
|
-
## 概述
|
|
11
|
-
|
|
12
|
-
建立布局 Map 是设计稿分析的第一步,目的是获取设计稿的整体结构,确定页面状态、整体尺寸、区域划分和区域间关系。
|
|
13
|
-
|
|
14
|
-
## 1.1 获取设计稿结构
|
|
15
|
-
|
|
16
|
-
### 打开设计稿文件或链接
|
|
17
|
-
|
|
18
|
-
根据设计稿类型选择工具:
|
|
19
|
-
|
|
20
|
-
- **.pen(Pencil 设计稿)**:
|
|
21
|
-
- 使用 **Pencil MCP** 查看结构、截图等
|
|
22
|
-
- 可用工具:`snapshot_layout`、`get_screenshot` 等
|
|
23
|
-
- 确认顶层 frame 及多状态(如有)
|
|
24
|
-
|
|
25
|
-
- **Figma 链接**:
|
|
26
|
-
- 使用 **Figma MCP** 从链接中解析 file key / node id
|
|
27
|
-
- 可用工具:`get_screenshot`、`get_design_context` 等
|
|
28
|
-
- 获取对应 frame 或节点的截图、布局与节点信息
|
|
29
|
-
|
|
30
|
-
详见 `tools-design-guidelines.md`。
|
|
31
|
-
|
|
32
|
-
### 扫描顺序
|
|
33
|
-
|
|
34
|
-
**按「从上到下、再从左到右」扫描**:
|
|
35
|
-
- 先按 y 从大到小(或从 0 起向下)确定所有横向区域顺序
|
|
36
|
-
- 再在同一行内按 x 从左到右读取
|
|
37
|
-
- 使用 Pencil MCP 或 Figma MCP 时也按此顺序逐层获取布局与节点信息
|
|
38
|
-
|
|
39
|
-
详见 `analysis-order.md`。
|
|
40
|
-
|
|
41
|
-
## 1.2 必须记录的内容
|
|
42
|
-
|
|
43
|
-
| 项目 | 说明 |
|
|
44
|
-
|------|------|
|
|
45
|
-
| 页面/界面状态 | 若有多个 frame(如「有数据 / 无数据」),分别标注 id 与用途 |
|
|
46
|
-
| 整体尺寸 | 宽度、高度(如 1440×1150) |
|
|
47
|
-
| 区域列表 | **按从上到下(y)排序**:区域名称、x / y / w / h、包含的主要子元素(**含该区内的主要文字、图片**) |
|
|
48
|
-
| 区域间间距 | 上一区域底部到下一区域顶部的垂直间距 |
|
|
49
|
-
| 主内容区起始 | 相对画布或导航栏的 x/y(如 132, 52) |
|
|
50
|
-
| **文字(每区)** | 该区域内所有可见文案:内容、字体、字号、字重、颜色、行高;**不可遗漏**,尤其页面顶部/首屏大字号文案 |
|
|
51
|
-
| **图片(每区)** | 该区域内所有图片/占位图/图标区:尺寸、位置、比例、圆角、多图时的布局关系;**不可遗漏** |
|
|
52
|
-
| **布局(每区)** | 位置、尺寸、间距、对齐、排列方向、多图拼接方式等;**不可错位或比例失调** |
|
|
53
|
-
| **层级(每区)** | 从外到里的嵌套(谁包谁)、父子/兄弟、先后与叠放顺序;**不可丢层或顺序颠倒** |
|
|
54
|
-
|
|
55
|
-
**注意**:文字、图片、布局、层级是四类重中之重,详见 `analysis-priorities.md`。
|
|
56
|
-
|
|
57
|
-
## 1.3 布局 Map 模板
|
|
58
|
-
|
|
59
|
-
```markdown
|
|
60
|
-
## 页面布局 Map
|
|
61
|
-
|
|
62
|
-
### 整体尺寸
|
|
63
|
-
- 页面宽度: ___ px
|
|
64
|
-
- 页面高度: ___ px
|
|
65
|
-
|
|
66
|
-
### 页面状态(如有多个)
|
|
67
|
-
| 状态 | Frame ID | 说明 |
|
|
68
|
-
|------|----------|------|
|
|
69
|
-
| 状态1 | id | 说明 |
|
|
70
|
-
|
|
71
|
-
### 区域列表(按从上到下 y 排序,同层内从左到右)
|
|
72
|
-
| 区域 | x | y | w | h | 包含子元素(含主要文字、图片、布局、层级) |
|
|
73
|
-
|------|---|---|---|---|------------------------------------------|
|
|
74
|
-
| ... | | | | | |
|
|
75
|
-
|
|
76
|
-
### 区域间垂直间距
|
|
77
|
-
- 区域 A 底部 → 区域 B 顶部: ___ px
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
## 使用示例
|
|
81
|
-
|
|
82
|
-
### 示例:单状态页面
|
|
83
|
-
|
|
84
|
-
```markdown
|
|
85
|
-
## 页面布局 Map
|
|
86
|
-
|
|
87
|
-
### 整体尺寸
|
|
88
|
-
- 页面宽度: 1440 px
|
|
89
|
-
- 页面高度: 1150 px
|
|
90
|
-
|
|
91
|
-
### 区域列表(按从上到下 y 排序)
|
|
92
|
-
| 区域 | x | y | w | h | 包含子元素 |
|
|
93
|
-
|------|---|---|---|---|----------|
|
|
94
|
-
| 导航栏 | 0 | 0 | 1440 | 80 | Logo、导航菜单、用户头像 |
|
|
95
|
-
| 主内容区 | 132 | 80 | 1176 | 970 | 标题、列表、分页 |
|
|
96
|
-
| 底部 | 0 | 1050 | 1440 | 100 | 版权信息、链接 |
|
|
97
|
-
|
|
98
|
-
### 区域间垂直间距
|
|
99
|
-
- 导航栏底部 → 主内容区顶部: 0 px(紧贴)
|
|
100
|
-
- 主内容区底部 → 底部顶部: 0 px(紧贴)
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
### 示例:多状态页面
|
|
104
|
-
|
|
105
|
-
```markdown
|
|
106
|
-
## 页面布局 Map
|
|
107
|
-
|
|
108
|
-
### 整体尺寸
|
|
109
|
-
- 页面宽度: 1440 px
|
|
110
|
-
- 页面高度: 1150 px
|
|
111
|
-
|
|
112
|
-
### 页面状态(如有多个)
|
|
113
|
-
| 状态 | Frame ID | 说明 |
|
|
114
|
-
|------|----------|------|
|
|
115
|
-
| 有数据 | frame-1 | 显示数据列表 |
|
|
116
|
-
| 无数据 | frame-2 | 显示空状态提示 |
|
|
117
|
-
|
|
118
|
-
### 区域列表(按从上到下 y 排序)
|
|
119
|
-
| 区域 | x | y | w | h | 包含子元素 |
|
|
120
|
-
|------|---|---|---|---|----------|
|
|
121
|
-
| 导航栏 | 0 | 0 | 1440 | 80 | Logo、导航菜单 |
|
|
122
|
-
| 主内容区(有数据) | 132 | 80 | 1176 | 970 | 标题、列表、分页 |
|
|
123
|
-
| 主内容区(无数据) | 132 | 80 | 1176 | 970 | 空状态图标、提示文字、操作按钮 |
|
|
124
|
-
```
|
|
125
|
-
|
|
126
|
-
## 相关规则
|
|
127
|
-
|
|
128
|
-
- `analysis-order.md` - 分析顺序(必守)
|
|
129
|
-
- `analysis-priorities.md` - 文字、图片、布局、层级四类重中之重
|
|
130
|
-
- `tools-design-guidelines.md` - 设计稿工具使用指南
|
|
131
|
-
- `workflow-element-extraction.md` - 第二步:区域与元素提取
|
|
1
|
+
---
|
|
2
|
+
title: 第一步:建立布局 Map
|
|
3
|
+
impact: CRITICAL
|
|
4
|
+
impactDescription: 设计稿分析第一步,获取整体结构、区域划分与区域间关系
|
|
5
|
+
tags: workflow, layout-map, analysis, critical
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# 第一步:建立布局 Map
|
|
9
|
+
|
|
10
|
+
## 概述
|
|
11
|
+
|
|
12
|
+
建立布局 Map 是设计稿分析的第一步,目的是获取设计稿的整体结构,确定页面状态、整体尺寸、区域划分和区域间关系。
|
|
13
|
+
|
|
14
|
+
## 1.1 获取设计稿结构
|
|
15
|
+
|
|
16
|
+
### 打开设计稿文件或链接
|
|
17
|
+
|
|
18
|
+
根据设计稿类型选择工具:
|
|
19
|
+
|
|
20
|
+
- **.pen(Pencil 设计稿)**:
|
|
21
|
+
- 使用 **Pencil MCP** 查看结构、截图等
|
|
22
|
+
- 可用工具:`snapshot_layout`、`get_screenshot` 等
|
|
23
|
+
- 确认顶层 frame 及多状态(如有)
|
|
24
|
+
|
|
25
|
+
- **Figma 链接**:
|
|
26
|
+
- 使用 **Figma MCP** 从链接中解析 file key / node id
|
|
27
|
+
- 可用工具:`get_screenshot`、`get_design_context` 等
|
|
28
|
+
- 获取对应 frame 或节点的截图、布局与节点信息
|
|
29
|
+
|
|
30
|
+
详见 `tools-design-guidelines.md`。
|
|
31
|
+
|
|
32
|
+
### 扫描顺序
|
|
33
|
+
|
|
34
|
+
**按「从上到下、再从左到右」扫描**:
|
|
35
|
+
- 先按 y 从大到小(或从 0 起向下)确定所有横向区域顺序
|
|
36
|
+
- 再在同一行内按 x 从左到右读取
|
|
37
|
+
- 使用 Pencil MCP 或 Figma MCP 时也按此顺序逐层获取布局与节点信息
|
|
38
|
+
|
|
39
|
+
详见 `analysis-order.md`。
|
|
40
|
+
|
|
41
|
+
## 1.2 必须记录的内容
|
|
42
|
+
|
|
43
|
+
| 项目 | 说明 |
|
|
44
|
+
|------|------|
|
|
45
|
+
| 页面/界面状态 | 若有多个 frame(如「有数据 / 无数据」),分别标注 id 与用途 |
|
|
46
|
+
| 整体尺寸 | 宽度、高度(如 1440×1150) |
|
|
47
|
+
| 区域列表 | **按从上到下(y)排序**:区域名称、x / y / w / h、包含的主要子元素(**含该区内的主要文字、图片**) |
|
|
48
|
+
| 区域间间距 | 上一区域底部到下一区域顶部的垂直间距 |
|
|
49
|
+
| 主内容区起始 | 相对画布或导航栏的 x/y(如 132, 52) |
|
|
50
|
+
| **文字(每区)** | 该区域内所有可见文案:内容、字体、字号、字重、颜色、行高;**不可遗漏**,尤其页面顶部/首屏大字号文案 |
|
|
51
|
+
| **图片(每区)** | 该区域内所有图片/占位图/图标区:尺寸、位置、比例、圆角、多图时的布局关系;**不可遗漏** |
|
|
52
|
+
| **布局(每区)** | 位置、尺寸、间距、对齐、排列方向、多图拼接方式等;**不可错位或比例失调** |
|
|
53
|
+
| **层级(每区)** | 从外到里的嵌套(谁包谁)、父子/兄弟、先后与叠放顺序;**不可丢层或顺序颠倒** |
|
|
54
|
+
|
|
55
|
+
**注意**:文字、图片、布局、层级是四类重中之重,详见 `analysis-priorities.md`。
|
|
56
|
+
|
|
57
|
+
## 1.3 布局 Map 模板
|
|
58
|
+
|
|
59
|
+
```markdown
|
|
60
|
+
## 页面布局 Map
|
|
61
|
+
|
|
62
|
+
### 整体尺寸
|
|
63
|
+
- 页面宽度: ___ px
|
|
64
|
+
- 页面高度: ___ px
|
|
65
|
+
|
|
66
|
+
### 页面状态(如有多个)
|
|
67
|
+
| 状态 | Frame ID | 说明 |
|
|
68
|
+
|------|----------|------|
|
|
69
|
+
| 状态1 | id | 说明 |
|
|
70
|
+
|
|
71
|
+
### 区域列表(按从上到下 y 排序,同层内从左到右)
|
|
72
|
+
| 区域 | x | y | w | h | 包含子元素(含主要文字、图片、布局、层级) |
|
|
73
|
+
|------|---|---|---|---|------------------------------------------|
|
|
74
|
+
| ... | | | | | |
|
|
75
|
+
|
|
76
|
+
### 区域间垂直间距
|
|
77
|
+
- 区域 A 底部 → 区域 B 顶部: ___ px
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## 使用示例
|
|
81
|
+
|
|
82
|
+
### 示例:单状态页面
|
|
83
|
+
|
|
84
|
+
```markdown
|
|
85
|
+
## 页面布局 Map
|
|
86
|
+
|
|
87
|
+
### 整体尺寸
|
|
88
|
+
- 页面宽度: 1440 px
|
|
89
|
+
- 页面高度: 1150 px
|
|
90
|
+
|
|
91
|
+
### 区域列表(按从上到下 y 排序)
|
|
92
|
+
| 区域 | x | y | w | h | 包含子元素 |
|
|
93
|
+
|------|---|---|---|---|----------|
|
|
94
|
+
| 导航栏 | 0 | 0 | 1440 | 80 | Logo、导航菜单、用户头像 |
|
|
95
|
+
| 主内容区 | 132 | 80 | 1176 | 970 | 标题、列表、分页 |
|
|
96
|
+
| 底部 | 0 | 1050 | 1440 | 100 | 版权信息、链接 |
|
|
97
|
+
|
|
98
|
+
### 区域间垂直间距
|
|
99
|
+
- 导航栏底部 → 主内容区顶部: 0 px(紧贴)
|
|
100
|
+
- 主内容区底部 → 底部顶部: 0 px(紧贴)
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### 示例:多状态页面
|
|
104
|
+
|
|
105
|
+
```markdown
|
|
106
|
+
## 页面布局 Map
|
|
107
|
+
|
|
108
|
+
### 整体尺寸
|
|
109
|
+
- 页面宽度: 1440 px
|
|
110
|
+
- 页面高度: 1150 px
|
|
111
|
+
|
|
112
|
+
### 页面状态(如有多个)
|
|
113
|
+
| 状态 | Frame ID | 说明 |
|
|
114
|
+
|------|----------|------|
|
|
115
|
+
| 有数据 | frame-1 | 显示数据列表 |
|
|
116
|
+
| 无数据 | frame-2 | 显示空状态提示 |
|
|
117
|
+
|
|
118
|
+
### 区域列表(按从上到下 y 排序)
|
|
119
|
+
| 区域 | x | y | w | h | 包含子元素 |
|
|
120
|
+
|------|---|---|---|---|----------|
|
|
121
|
+
| 导航栏 | 0 | 0 | 1440 | 80 | Logo、导航菜单 |
|
|
122
|
+
| 主内容区(有数据) | 132 | 80 | 1176 | 970 | 标题、列表、分页 |
|
|
123
|
+
| 主内容区(无数据) | 132 | 80 | 1176 | 970 | 空状态图标、提示文字、操作按钮 |
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
## 相关规则
|
|
127
|
+
|
|
128
|
+
- `analysis-order.md` - 分析顺序(必守)
|
|
129
|
+
- `analysis-priorities.md` - 文字、图片、布局、层级四类重中之重
|
|
130
|
+
- `tools-design-guidelines.md` - 设计稿工具使用指南
|
|
131
|
+
- `workflow-element-extraction.md` - 第二步:区域与元素提取
|
|
@@ -1,70 +1,70 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 第四步:输出文档要求
|
|
3
|
-
impact: HIGH
|
|
4
|
-
impactDescription: 文档路径、结构和质量要求,输出前需过质量检查清单
|
|
5
|
-
tags: workflow, output, checklist
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# 第四步:输出文档要求
|
|
9
|
-
|
|
10
|
-
## 概述
|
|
11
|
-
|
|
12
|
-
第四步是将分析结果输出为「UI 分析清单」文档,供开发与验收参照。本文档说明文档路径、结构和质量要求。
|
|
13
|
-
|
|
14
|
-
## 4.1 文档路径
|
|
15
|
-
|
|
16
|
-
```
|
|
17
|
-
docs/样式还原/<页面或模块名称>-UI分析清单.md
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
**示例**:
|
|
21
|
-
- `docs/样式还原/用户中心-UI分析清单.md`
|
|
22
|
-
- `docs/样式还原/商品列表页-UI分析清单.md`
|
|
23
|
-
|
|
24
|
-
## 4.2 文档结构(必须包含)
|
|
25
|
-
|
|
26
|
-
文档必须包含以下章节,详见 `output-analysis-checklist.md` 获取完整模板:
|
|
27
|
-
|
|
28
|
-
1. **文档说明**:设计稿路径/链接、分析日期
|
|
29
|
-
2. **一、设计稿整体分析**:页面状态、整体尺寸、区域划分、区域间间距
|
|
30
|
-
3. **二、区域详细分析**:按从上到下、从左到右、从外到里顺序,每个区域包含所有文字、图片、布局、层级
|
|
31
|
-
4. **三、样式规范汇总**:颜色、字体、圆角、间距、阴影、效果
|
|
32
|
-
5. **四、交互状态分析**:默认 / hover / active / 禁用等(如有)
|
|
33
|
-
6. **五、占位元素说明**:图标占位尺寸与位置、图片占位尺寸与比例
|
|
34
|
-
7. **六、常见遗漏检查点**:本次分析已核对项,可列 checklist
|
|
35
|
-
8. **七、实现建议**:组件划分、主流网页设计常识、常见错误模式
|
|
36
|
-
9. **八、验证检查清单**:后续验收时用的布局/样式/元素/交互检查项
|
|
37
|
-
10. **九、备注**:坐标系统、响应式、占位策略等
|
|
38
|
-
|
|
39
|
-
## 4.3 文档质量要求
|
|
40
|
-
|
|
41
|
-
| 要求 | 说明 |
|
|
42
|
-
|------|------|
|
|
43
|
-
| **分析顺序** | 区域与章节按「从上到下、从左到右、从外到里」书写,与前端布局一致,避免漏掉顶部或某一侧 |
|
|
44
|
-
| **文字、图片、布局、层级** | 四者为页面元素重中之重,均不允许出错:所有文字与图片无遗漏;布局(位置/尺寸/间距/对齐)与设计稿一致;层级(嵌套与先后)正确无丢层或颠倒 |
|
|
45
|
-
| 完整性 | 覆盖设计稿中所有关键区域与关键元素,无「略」式省略 |
|
|
46
|
-
| 准确性 | 尺寸、颜色、字号等从设计稿中读取并写明,不猜测 |
|
|
47
|
-
| 可执行 | 开发仅凭此文档即可实现布局与样式,无需反复看图 |
|
|
48
|
-
| 可维护 | 设计稿变更时,同步更新本文档并标注更新日期 |
|
|
49
|
-
|
|
50
|
-
## 质量检查清单
|
|
51
|
-
|
|
52
|
-
输出文档前,检查以下项:
|
|
53
|
-
|
|
54
|
-
- [ ] 文档路径正确,符合命名规范
|
|
55
|
-
- [ ] 文档结构完整,包含所有必需章节
|
|
56
|
-
- [ ] 分析顺序正确(从上到下、从左到右、从外到里)
|
|
57
|
-
- [ ] 所有文字、图片、布局、层级都已记录,无遗漏
|
|
58
|
-
- [ ] 样式规范汇总完整,包含颜色、字体、圆角、间距、阴影
|
|
59
|
-
- [ ] 实现建议包含组件划分、设计常识、常见错误模式
|
|
60
|
-
- [ ] 文档可执行,开发人员无需反复看图即可实现
|
|
61
|
-
- [ ] 文档可维护,设计稿变更时可同步更新
|
|
62
|
-
|
|
63
|
-
## 相关规则
|
|
64
|
-
|
|
65
|
-
- `output-analysis-checklist.md` - UI 分析清单文档完整模板
|
|
66
|
-
- `analysis-order.md` - 分析顺序(必守)
|
|
67
|
-
- `analysis-priorities.md` - 文字、图片、布局、层级四类重中之重
|
|
68
|
-
- `workflow-layout-map.md` - 第一步:建立布局 Map
|
|
69
|
-
- `workflow-element-extraction.md` - 第二步:区域与元素提取
|
|
70
|
-
- `workflow-style-summary.md` - 第三步:样式规范汇总
|
|
1
|
+
---
|
|
2
|
+
title: 第四步:输出文档要求
|
|
3
|
+
impact: HIGH
|
|
4
|
+
impactDescription: 文档路径、结构和质量要求,输出前需过质量检查清单
|
|
5
|
+
tags: workflow, output, checklist
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# 第四步:输出文档要求
|
|
9
|
+
|
|
10
|
+
## 概述
|
|
11
|
+
|
|
12
|
+
第四步是将分析结果输出为「UI 分析清单」文档,供开发与验收参照。本文档说明文档路径、结构和质量要求。
|
|
13
|
+
|
|
14
|
+
## 4.1 文档路径
|
|
15
|
+
|
|
16
|
+
```
|
|
17
|
+
docs/样式还原/<页面或模块名称>-UI分析清单.md
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
**示例**:
|
|
21
|
+
- `docs/样式还原/用户中心-UI分析清单.md`
|
|
22
|
+
- `docs/样式还原/商品列表页-UI分析清单.md`
|
|
23
|
+
|
|
24
|
+
## 4.2 文档结构(必须包含)
|
|
25
|
+
|
|
26
|
+
文档必须包含以下章节,详见 `output-analysis-checklist.md` 获取完整模板:
|
|
27
|
+
|
|
28
|
+
1. **文档说明**:设计稿路径/链接、分析日期
|
|
29
|
+
2. **一、设计稿整体分析**:页面状态、整体尺寸、区域划分、区域间间距
|
|
30
|
+
3. **二、区域详细分析**:按从上到下、从左到右、从外到里顺序,每个区域包含所有文字、图片、布局、层级
|
|
31
|
+
4. **三、样式规范汇总**:颜色、字体、圆角、间距、阴影、效果
|
|
32
|
+
5. **四、交互状态分析**:默认 / hover / active / 禁用等(如有)
|
|
33
|
+
6. **五、占位元素说明**:图标占位尺寸与位置、图片占位尺寸与比例
|
|
34
|
+
7. **六、常见遗漏检查点**:本次分析已核对项,可列 checklist
|
|
35
|
+
8. **七、实现建议**:组件划分、主流网页设计常识、常见错误模式
|
|
36
|
+
9. **八、验证检查清单**:后续验收时用的布局/样式/元素/交互检查项
|
|
37
|
+
10. **九、备注**:坐标系统、响应式、占位策略等
|
|
38
|
+
|
|
39
|
+
## 4.3 文档质量要求
|
|
40
|
+
|
|
41
|
+
| 要求 | 说明 |
|
|
42
|
+
|------|------|
|
|
43
|
+
| **分析顺序** | 区域与章节按「从上到下、从左到右、从外到里」书写,与前端布局一致,避免漏掉顶部或某一侧 |
|
|
44
|
+
| **文字、图片、布局、层级** | 四者为页面元素重中之重,均不允许出错:所有文字与图片无遗漏;布局(位置/尺寸/间距/对齐)与设计稿一致;层级(嵌套与先后)正确无丢层或颠倒 |
|
|
45
|
+
| 完整性 | 覆盖设计稿中所有关键区域与关键元素,无「略」式省略 |
|
|
46
|
+
| 准确性 | 尺寸、颜色、字号等从设计稿中读取并写明,不猜测 |
|
|
47
|
+
| 可执行 | 开发仅凭此文档即可实现布局与样式,无需反复看图 |
|
|
48
|
+
| 可维护 | 设计稿变更时,同步更新本文档并标注更新日期 |
|
|
49
|
+
|
|
50
|
+
## 质量检查清单
|
|
51
|
+
|
|
52
|
+
输出文档前,检查以下项:
|
|
53
|
+
|
|
54
|
+
- [ ] 文档路径正确,符合命名规范
|
|
55
|
+
- [ ] 文档结构完整,包含所有必需章节
|
|
56
|
+
- [ ] 分析顺序正确(从上到下、从左到右、从外到里)
|
|
57
|
+
- [ ] 所有文字、图片、布局、层级都已记录,无遗漏
|
|
58
|
+
- [ ] 样式规范汇总完整,包含颜色、字体、圆角、间距、阴影
|
|
59
|
+
- [ ] 实现建议包含组件划分、设计常识、常见错误模式
|
|
60
|
+
- [ ] 文档可执行,开发人员无需反复看图即可实现
|
|
61
|
+
- [ ] 文档可维护,设计稿变更时可同步更新
|
|
62
|
+
|
|
63
|
+
## 相关规则
|
|
64
|
+
|
|
65
|
+
- `output-analysis-checklist.md` - UI 分析清单文档完整模板
|
|
66
|
+
- `analysis-order.md` - 分析顺序(必守)
|
|
67
|
+
- `analysis-priorities.md` - 文字、图片、布局、层级四类重中之重
|
|
68
|
+
- `workflow-layout-map.md` - 第一步:建立布局 Map
|
|
69
|
+
- `workflow-element-extraction.md` - 第二步:区域与元素提取
|
|
70
|
+
- `workflow-style-summary.md` - 第三步:样式规范汇总
|
|
@@ -1,91 +1,91 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 第三步:样式规范汇总
|
|
3
|
-
impact: HIGH
|
|
4
|
-
impactDescription: 颜色、字体、圆角、间距、阴影等样式规范汇总,便于开发与验收统一使用
|
|
5
|
-
tags: workflow, style, summary
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# 第三步:样式规范汇总
|
|
9
|
-
|
|
10
|
-
## 概述
|
|
11
|
-
|
|
12
|
-
在分析清单中单独成章,便于开发与验收统一使用。汇总设计稿中的颜色、字体、圆角、间距、阴影等样式规范,形成可复用的样式指南。
|
|
13
|
-
|
|
14
|
-
## 汇总内容
|
|
15
|
-
|
|
16
|
-
### 颜色规范
|
|
17
|
-
|
|
18
|
-
提取设计稿中的主要颜色,按用途分类:
|
|
19
|
-
|
|
20
|
-
| 用途 | 颜色值 | 说明 |
|
|
21
|
-
|------|--------|------|
|
|
22
|
-
| 主文本 | `#13131c` | 主要文字颜色 |
|
|
23
|
-
| 次要文本 | `#13131c73` | 次要文字颜色(含透明度) |
|
|
24
|
-
| 边框 | `#13131c40` | 边框颜色 |
|
|
25
|
-
| 背景 | `#ffffff` | 页面背景色 |
|
|
26
|
-
| 按钮主色 | `#1890ff` | 主要按钮颜色 |
|
|
27
|
-
| 按钮禁用 | `#d9d9d9` | 禁用状态颜色 |
|
|
28
|
-
|
|
29
|
-
### 字体规范
|
|
30
|
-
|
|
31
|
-
按用途汇总字体族、字号、字重、行高:
|
|
32
|
-
|
|
33
|
-
| 用途 | 字体族 | 字号 | 字重 | 行高 | 示例 |
|
|
34
|
-
|------|--------|------|------|------|------|
|
|
35
|
-
| 大标题 | PingFang SC | 24px | 600 | 32px | 页面主标题 |
|
|
36
|
-
| 副标题 | PingFang SC | 18px | 500 | 26px | 区块标题 |
|
|
37
|
-
| 正文 | PingFang SC | 14px | 400 | 20px | 普通文本 |
|
|
38
|
-
| 说明文字 | PingFang SC | 12px | 400 | 18px | 辅助说明 |
|
|
39
|
-
| 按钮文字 | PingFang SC | 14px | 500 | 20px | 按钮内文字 |
|
|
40
|
-
|
|
41
|
-
### 圆角规范
|
|
42
|
-
|
|
43
|
-
按元素类型汇总圆角值:
|
|
44
|
-
|
|
45
|
-
| 元素类型 | 圆角值 | 说明 |
|
|
46
|
-
|----------|--------|------|
|
|
47
|
-
| 卡片 | 12px | 卡片容器 |
|
|
48
|
-
| 按钮 | 8px | 按钮圆角 |
|
|
49
|
-
| 输入框 | 8px | 输入框圆角 |
|
|
50
|
-
| 图片 | 8px | 图片圆角 |
|
|
51
|
-
| 标签 | 4px | 标签圆角 |
|
|
52
|
-
|
|
53
|
-
### 间距规范
|
|
54
|
-
|
|
55
|
-
按层级汇总间距值:
|
|
56
|
-
|
|
57
|
-
| 层级 | 间距值 | 说明 |
|
|
58
|
-
|------|--------|------|
|
|
59
|
-
| 页面边距 | 132px | 页面左右边距 |
|
|
60
|
-
| 区块间距 | 24px | 区块之间的垂直间距 |
|
|
61
|
-
| 组件内 gap | 12px | 组件内部元素间距 |
|
|
62
|
-
| 组件内 padding | 16px | 组件内边距 |
|
|
63
|
-
|
|
64
|
-
### 阴影与效果
|
|
65
|
-
|
|
66
|
-
汇总阴影和特殊效果:
|
|
67
|
-
|
|
68
|
-
| 效果类型 | 参数 | 说明 |
|
|
69
|
-
|----------|------|------|
|
|
70
|
-
| 卡片阴影 | `0 2px 8px rgba(0,0,0,0.1)` | 卡片阴影 |
|
|
71
|
-
| 按钮阴影 | `0 1px 4px rgba(0,0,0,0.1)` | 按钮阴影 |
|
|
72
|
-
| 背景模糊 | `backdrop-filter: blur(17.5px)` | 背景模糊效果 |
|
|
73
|
-
|
|
74
|
-
## 汇总方法
|
|
75
|
-
|
|
76
|
-
1. **从区域分析中提取**:在第二步「区域与元素提取」时,记录每个区域的样式信息
|
|
77
|
-
2. **按类型分类**:将相同类型的样式值归类汇总
|
|
78
|
-
3. **去重合并**:相同的样式值只记录一次,避免重复
|
|
79
|
-
4. **标注用途**:明确每个样式值的用途和使用场景
|
|
80
|
-
|
|
81
|
-
## 使用建议
|
|
82
|
-
|
|
83
|
-
- **开发时**:参考样式规范汇总,确保实现时使用统一的样式值
|
|
84
|
-
- **验收时**:对照样式规范汇总,检查实现是否符合设计稿规范
|
|
85
|
-
- **维护时**:设计稿变更时,同步更新样式规范汇总
|
|
86
|
-
|
|
87
|
-
## 相关规则
|
|
88
|
-
|
|
89
|
-
- `workflow-element-extraction.md` - 第二步:区域与元素提取(提取样式信息)
|
|
90
|
-
- `output-analysis-checklist.md` - UI 分析清单文档模板(包含样式规范汇总章节)
|
|
91
|
-
- `workflow-output-checklist.md` - 第四步:输出文档要求
|
|
1
|
+
---
|
|
2
|
+
title: 第三步:样式规范汇总
|
|
3
|
+
impact: HIGH
|
|
4
|
+
impactDescription: 颜色、字体、圆角、间距、阴影等样式规范汇总,便于开发与验收统一使用
|
|
5
|
+
tags: workflow, style, summary
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# 第三步:样式规范汇总
|
|
9
|
+
|
|
10
|
+
## 概述
|
|
11
|
+
|
|
12
|
+
在分析清单中单独成章,便于开发与验收统一使用。汇总设计稿中的颜色、字体、圆角、间距、阴影等样式规范,形成可复用的样式指南。
|
|
13
|
+
|
|
14
|
+
## 汇总内容
|
|
15
|
+
|
|
16
|
+
### 颜色规范
|
|
17
|
+
|
|
18
|
+
提取设计稿中的主要颜色,按用途分类:
|
|
19
|
+
|
|
20
|
+
| 用途 | 颜色值 | 说明 |
|
|
21
|
+
|------|--------|------|
|
|
22
|
+
| 主文本 | `#13131c` | 主要文字颜色 |
|
|
23
|
+
| 次要文本 | `#13131c73` | 次要文字颜色(含透明度) |
|
|
24
|
+
| 边框 | `#13131c40` | 边框颜色 |
|
|
25
|
+
| 背景 | `#ffffff` | 页面背景色 |
|
|
26
|
+
| 按钮主色 | `#1890ff` | 主要按钮颜色 |
|
|
27
|
+
| 按钮禁用 | `#d9d9d9` | 禁用状态颜色 |
|
|
28
|
+
|
|
29
|
+
### 字体规范
|
|
30
|
+
|
|
31
|
+
按用途汇总字体族、字号、字重、行高:
|
|
32
|
+
|
|
33
|
+
| 用途 | 字体族 | 字号 | 字重 | 行高 | 示例 |
|
|
34
|
+
|------|--------|------|------|------|------|
|
|
35
|
+
| 大标题 | PingFang SC | 24px | 600 | 32px | 页面主标题 |
|
|
36
|
+
| 副标题 | PingFang SC | 18px | 500 | 26px | 区块标题 |
|
|
37
|
+
| 正文 | PingFang SC | 14px | 400 | 20px | 普通文本 |
|
|
38
|
+
| 说明文字 | PingFang SC | 12px | 400 | 18px | 辅助说明 |
|
|
39
|
+
| 按钮文字 | PingFang SC | 14px | 500 | 20px | 按钮内文字 |
|
|
40
|
+
|
|
41
|
+
### 圆角规范
|
|
42
|
+
|
|
43
|
+
按元素类型汇总圆角值:
|
|
44
|
+
|
|
45
|
+
| 元素类型 | 圆角值 | 说明 |
|
|
46
|
+
|----------|--------|------|
|
|
47
|
+
| 卡片 | 12px | 卡片容器 |
|
|
48
|
+
| 按钮 | 8px | 按钮圆角 |
|
|
49
|
+
| 输入框 | 8px | 输入框圆角 |
|
|
50
|
+
| 图片 | 8px | 图片圆角 |
|
|
51
|
+
| 标签 | 4px | 标签圆角 |
|
|
52
|
+
|
|
53
|
+
### 间距规范
|
|
54
|
+
|
|
55
|
+
按层级汇总间距值:
|
|
56
|
+
|
|
57
|
+
| 层级 | 间距值 | 说明 |
|
|
58
|
+
|------|--------|------|
|
|
59
|
+
| 页面边距 | 132px | 页面左右边距 |
|
|
60
|
+
| 区块间距 | 24px | 区块之间的垂直间距 |
|
|
61
|
+
| 组件内 gap | 12px | 组件内部元素间距 |
|
|
62
|
+
| 组件内 padding | 16px | 组件内边距 |
|
|
63
|
+
|
|
64
|
+
### 阴影与效果
|
|
65
|
+
|
|
66
|
+
汇总阴影和特殊效果:
|
|
67
|
+
|
|
68
|
+
| 效果类型 | 参数 | 说明 |
|
|
69
|
+
|----------|------|------|
|
|
70
|
+
| 卡片阴影 | `0 2px 8px rgba(0,0,0,0.1)` | 卡片阴影 |
|
|
71
|
+
| 按钮阴影 | `0 1px 4px rgba(0,0,0,0.1)` | 按钮阴影 |
|
|
72
|
+
| 背景模糊 | `backdrop-filter: blur(17.5px)` | 背景模糊效果 |
|
|
73
|
+
|
|
74
|
+
## 汇总方法
|
|
75
|
+
|
|
76
|
+
1. **从区域分析中提取**:在第二步「区域与元素提取」时,记录每个区域的样式信息
|
|
77
|
+
2. **按类型分类**:将相同类型的样式值归类汇总
|
|
78
|
+
3. **去重合并**:相同的样式值只记录一次,避免重复
|
|
79
|
+
4. **标注用途**:明确每个样式值的用途和使用场景
|
|
80
|
+
|
|
81
|
+
## 使用建议
|
|
82
|
+
|
|
83
|
+
- **开发时**:参考样式规范汇总,确保实现时使用统一的样式值
|
|
84
|
+
- **验收时**:对照样式规范汇总,检查实现是否符合设计稿规范
|
|
85
|
+
- **维护时**:设计稿变更时,同步更新样式规范汇总
|
|
86
|
+
|
|
87
|
+
## 相关规则
|
|
88
|
+
|
|
89
|
+
- `workflow-element-extraction.md` - 第二步:区域与元素提取(提取样式信息)
|
|
90
|
+
- `output-analysis-checklist.md` - UI 分析清单文档模板(包含样式规范汇总章节)
|
|
91
|
+
- `workflow-output-checklist.md` - 第四步:输出文档要求
|