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