@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.
Files changed (640) hide show
  1. package/.agents/commands/README.md +33 -0
  2. package/.agents/commands/claude/spec-start-review.md +88 -0
  3. package/.agents/commands/codex/spec-continue.md +74 -0
  4. package/.agents/commands/codex/spec-orchestrate.md +35 -0
  5. package/.agents/commands/codex/spec-start-review.md +88 -0
  6. package/.agents/commands/codex/spec-start.md +67 -0
  7. package/.agents/commands/codex/spec-status.md +22 -0
  8. package/.agents/commands/codex/spec-stop.md +29 -0
  9. package/.agents/commands/codex/spec-update.md +40 -0
  10. package/.agents/commands/common/branch-review.md +117 -0
  11. package/.agents/commands/common/project-init.md +25 -0
  12. package/.agents/commands/common/spec-continue.md +74 -0
  13. package/.agents/commands/common/spec-orchestrate.md +35 -0
  14. package/.agents/commands/common/spec-start-review.md +82 -0
  15. package/.agents/commands/common/spec-start.md +67 -0
  16. package/.agents/commands/common/spec-status.md +22 -0
  17. package/.agents/commands/common/spec-stop.md +29 -0
  18. package/.agents/commands/common/spec-update.md +40 -0
  19. package/.agents/commands/cursor/opsx-apply.md +55 -0
  20. package/.agents/commands/cursor/opsx-archive.md +48 -0
  21. package/.agents/commands/cursor/opsx-explore.md +45 -0
  22. package/.agents/commands/cursor/opsx-propose.md +59 -0
  23. package/.agents/commands/cursor/spec-continue.md +63 -0
  24. package/.agents/commands/cursor/spec-orchestrate.md +53 -0
  25. package/.agents/commands/cursor/spec-start-review.md +78 -0
  26. package/.agents/commands/cursor/spec-start.md +59 -0
  27. package/.agents/commands/cursor/spec-status.md +30 -0
  28. package/.agents/commands/cursor/spec-stop.md +29 -0
  29. package/.agents/commands/cursor/spec-update.md +41 -0
  30. package/.agents/flows/FRONTMATTER.md +263 -0
  31. package/.agents/flows/RUN_OUTPUT.md +263 -0
  32. package/.agents/flows/common/README.md +29 -0
  33. package/.agents/flows/common/bugfix-to-verification.md +95 -0
  34. package/.agents/flows/common/change-to-architecture-review.md +89 -0
  35. package/.agents/flows/common/change-to-release.md +94 -0
  36. package/.agents/flows/common/prd-to-delivery.md +184 -0
  37. package/.agents/flows/common/requirement-to-observability.md +97 -0
  38. package/.agents/orchestration/README.md +22 -0
  39. package/.agents/orchestration/expert-dispatch-spec.md +155 -0
  40. package/.agents/orchestration/expert-executor-spec.md +84 -0
  41. package/.agents/orchestration/expert-runtime-action-spec.md +73 -0
  42. package/.agents/orchestration/runtime-state-handoff-spec.md +264 -0
  43. package/.agents/orchestration/task-anchor-spec.md +212 -0
  44. package/.agents/orchestration/task-orchestrator-adapter-payload.md +153 -0
  45. package/.agents/orchestration/task-orchestrator-bootstrap-payload.md +145 -0
  46. package/.agents/orchestration/task-orchestrator-output-extractor-spec.md +93 -0
  47. package/.agents/orchestration/task-orchestrator-run-plan-template.md +312 -0
  48. package/.agents/orchestration/task-orchestrator-runtime-hooks.md +214 -0
  49. package/.agents/registry/README.md +63 -0
  50. package/.agents/registry/flows.json +125 -0
  51. package/.agents/registry/profiles.json +101 -0
  52. package/.agents/registry/roles.json +1266 -0
  53. package/.agents/registry/rules.json +148 -0
  54. package/.agents/registry/scenario-packages.json +123 -0
  55. package/.agents/registry/skills.json +130 -0
  56. package/.agents/roles/INDEX.md +346 -0
  57. package/.agents/roles/common/README.md +76 -0
  58. package/.agents/roles/common/archive-change.md +80 -0
  59. package/.agents/roles/common/backend-implementer.md +92 -0
  60. package/.agents/roles/common/code-guardian.md +151 -0
  61. package/.agents/roles/common/frontend-implementer.md +146 -0
  62. package/.agents/roles/common/requirement-analyst.md +138 -0
  63. package/.agents/roles/common/task-orchestrator-routing.md +301 -0
  64. package/.agents/roles/common/task-orchestrator.md +224 -0
  65. package/.agents/roles/common/tooling-implementer.md +92 -0
  66. package/.agents/roles/domains/README.md +35 -0
  67. package/.agents/roles/domains/delivery/README.md +11 -0
  68. package/.agents/roles/domains/delivery/container-specialist.md +50 -0
  69. package/.agents/roles/domains/delivery/deployment-specialist.md +50 -0
  70. package/.agents/roles/domains/delivery/pipeline-specialist.md +50 -0
  71. package/.agents/roles/domains/demand-design/README.md +16 -0
  72. package/.agents/roles/domains/demand-design/api-contract-specialist.md +52 -0
  73. package/.agents/roles/domains/demand-design/design-collaborator.md +58 -0
  74. package/.agents/roles/domains/documentation/README.md +11 -0
  75. package/.agents/roles/domains/documentation/api-doc-specialist.md +50 -0
  76. package/.agents/roles/domains/documentation/component-doc-specialist.md +49 -0
  77. package/.agents/roles/domains/documentation/technical-writing-specialist.md +48 -0
  78. package/.agents/roles/domains/engineering/README.md +17 -0
  79. package/.agents/roles/domains/engineering/architecture-advisor.md +53 -0
  80. package/.agents/roles/domains/engineering/build-specialist.md +51 -0
  81. package/.agents/roles/domains/engineering/dependency-governor.md +52 -0
  82. package/.agents/roles/domains/governance/README.md +17 -0
  83. package/.agents/roles/domains/governance/api-governance-specialist.md +51 -0
  84. package/.agents/roles/domains/governance/lint-policy-specialist.md +49 -0
  85. package/.agents/roles/domains/governance/route-governance-specialist.md +52 -0
  86. package/.agents/roles/domains/observability/README.md +11 -0
  87. package/.agents/roles/domains/observability/error-tracker.md +50 -0
  88. package/.agents/roles/domains/observability/event-instrumentation-specialist.md +51 -0
  89. package/.agents/roles/domains/observability/rum-analyst.md +50 -0
  90. package/.agents/roles/domains/performance/README.md +11 -0
  91. package/.agents/roles/domains/performance/asset-optimizer.md +50 -0
  92. package/.agents/roles/domains/performance/performance-auditor.md +56 -0
  93. package/.agents/roles/domains/performance/vitals-analyst.md +50 -0
  94. package/.agents/roles/domains/security-a11y/README.md +11 -0
  95. package/.agents/roles/domains/security-a11y/a11y-auditor.md +50 -0
  96. package/.agents/roles/domains/security-a11y/aria-specialist.md +51 -0
  97. package/.agents/roles/domains/security-a11y/security-reviewer.md +49 -0
  98. package/.agents/roles/domains/testing/README.md +12 -0
  99. package/.agents/roles/domains/testing/coverage-analyst.md +50 -0
  100. package/.agents/roles/domains/testing/e2e-test-specialist.md +51 -0
  101. package/.agents/roles/domains/testing/unit-test-specialist.md +56 -0
  102. package/.agents/roles/domains/testing/verification-reviewer.md +67 -0
  103. package/.agents/rules/README.md +87 -0
  104. package/.agents/rules/common/02-/347/274/226/347/240/201/350/247/204/350/214/203.md +45 -0
  105. package/.agents/rules/common/08-/351/200/232/347/224/250/347/272/246/346/235/237.md +63 -0
  106. package/.agents/rules/common/10-/346/226/207/346/241/243/350/247/204/350/214/203.md +101 -0
  107. package/.agents/rules/common/12-Superpowers/346/211/247/350/241/214/350/247/204/350/214/203.md +46 -0
  108. 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
  109. package/.agents/rules/common/15-visual-gate-wait.md +90 -0
  110. package/.agents/rules/profiles/nestjs/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +27 -0
  111. package/.agents/rules/profiles/nestjs/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +20 -0
  112. 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
  113. 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
  114. 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
  115. 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
  116. 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
  117. package/.agents/rules/profiles/nestjs/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +24 -0
  118. 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
  119. package/.agents/rules/profiles/node-tooling/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +30 -0
  120. package/.agents/rules/profiles/node-tooling/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +37 -0
  121. 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
  122. package/.agents/rules/profiles/node-tooling/05-Contract/344/270/216Schema/350/247/204/350/214/203.md +42 -0
  123. 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
  124. 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
  125. 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
  126. package/.agents/rules/profiles/node-tooling/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +41 -0
  127. 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
  128. package/.agents/rules/profiles/react/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +29 -0
  129. package/.agents/rules/profiles/react/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +104 -0
  130. package/.agents/rules/profiles/react/04-/347/273/204/344/273/266/350/247/204/350/214/203.md +46 -0
  131. package/.agents/rules/profiles/react/05-API/350/247/204/350/214/203.md +67 -0
  132. package/.agents/rules/profiles/react/06-/350/267/257/347/224/261/350/247/204/350/214/203.md +54 -0
  133. package/.agents/rules/profiles/react/07-/347/212/266/346/200/201/347/256/241/347/220/206.md +226 -0
  134. package/.agents/rules/profiles/react/09-/346/240/267/345/274/217/350/247/204/350/214/203.md +71 -0
  135. package/.agents/rules/profiles/react/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +80 -0
  136. 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
  137. package/.agents/rules/profiles/springboot/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +31 -0
  138. package/.agents/rules/profiles/springboot/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +37 -0
  139. package/.agents/rules/profiles/springboot/04-/345/210/206/345/261/202/350/247/204/350/214/203.md +33 -0
  140. 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
  141. 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
  142. 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
  143. 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
  144. package/.agents/rules/profiles/springboot/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +43 -0
  145. 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
  146. package/.agents/rules/profiles/vue/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +47 -0
  147. package/.agents/rules/profiles/vue/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +106 -0
  148. package/.agents/rules/profiles/vue/04-/347/273/204/344/273/266/350/247/204/350/214/203.md +61 -0
  149. package/.agents/rules/profiles/vue/05-API/350/247/204/350/214/203.md +67 -0
  150. package/.agents/rules/profiles/vue/06-/350/267/257/347/224/261/350/247/204/350/214/203.md +69 -0
  151. package/.agents/rules/profiles/vue/07-/347/212/266/346/200/201/347/256/241/347/220/206.md +93 -0
  152. package/.agents/rules/profiles/vue/09-/346/240/267/345/274/217/350/247/204/350/214/203.md +67 -0
  153. package/.agents/rules/profiles/vue/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +80 -0
  154. 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
  155. package/.agents/skills/README.md +171 -0
  156. package/.agents/skills/common/archive-change/SKILL.md +180 -0
  157. package/.agents/skills/common/branch-code-reviewer/SKILL.md +459 -0
  158. package/.agents/skills/common/branch-code-reviewer/references/business-risk-guide.md +293 -0
  159. package/.agents/skills/common/branch-code-reviewer/references/html-template-guide.md +121 -0
  160. package/.agents/skills/common/config-and-secret-scan/SKILL.md +99 -0
  161. package/.agents/skills/common/create-proposal/SKILL.md +192 -0
  162. package/.agents/skills/common/create-proposal/evals/evals.json +16 -0
  163. package/.agents/skills/common/create-proposal/evals/train_queries.json +18 -0
  164. package/.agents/skills/common/create-proposal/evals/validation_queries.json +18 -0
  165. package/.agents/skills/common/create-proposal/references/interaction-spec-template.md +42 -0
  166. package/.agents/skills/common/create-test/SKILL.md +292 -0
  167. package/.agents/skills/common/dependency-impact-graph/SKILL.md +80 -0
  168. package/.agents/skills/common/execute-task/SKILL.md +206 -0
  169. package/.agents/skills/common/execute-task/evals/evals.json +16 -0
  170. package/.agents/skills/common/execute-task/evals/train_queries.json +18 -0
  171. package/.agents/skills/common/execute-task/evals/validation_queries.json +18 -0
  172. package/.agents/skills/common/find-skills/SKILL.md +144 -0
  173. package/.agents/skills/common/install-ai-spec-auto/SKILL.md +260 -0
  174. package/.agents/skills/common/install-ai-spec-auto/evals/evals.json +17 -0
  175. package/.agents/skills/common/install-ai-spec-auto/evals/train_queries.json +18 -0
  176. package/.agents/skills/common/install-ai-spec-auto/evals/validation_queries.json +18 -0
  177. package/.agents/skills/common/project-init/SKILL.md +178 -0
  178. package/.agents/skills/common/project-init/evals/evals.json +16 -0
  179. package/.agents/skills/common/project-init/evals/train_queries.json +18 -0
  180. package/.agents/skills/common/project-init/evals/validation_queries.json +18 -0
  181. package/.agents/skills/common/project-init/references/custom-rule-generation.md +89 -0
  182. package/.agents/skills/common/project-init/references/deep-scan-rules.md +67 -0
  183. package/.agents/skills/common/project-init/references/output-contracts.md +71 -0
  184. package/.agents/skills/common/project-init/references/repo-fact-gathering.md +83 -0
  185. package/.agents/skills/common/project-init/references/scope-resolution.md +76 -0
  186. package/.agents/skills/common/project-init/scripts/inspect-project.js +112 -0
  187. package/.agents/skills/common/skill-creator/LICENSE.txt +202 -0
  188. package/.agents/skills/common/skill-creator/SKILL.md +370 -0
  189. package/.agents/skills/common/skill-creator/evals/evals.json +16 -0
  190. package/.agents/skills/common/skill-creator/evals/train_queries.json +18 -0
  191. package/.agents/skills/common/skill-creator/evals/validation_queries.json +18 -0
  192. package/.agents/skills/common/skill-creator/references/output-patterns.md +82 -0
  193. package/.agents/skills/common/skill-creator/references/workflows.md +28 -0
  194. package/.agents/skills/common/skill-creator/scripts/init_skill.py +209 -0
  195. package/.agents/skills/common/skill-creator/scripts/package_skill.py +110 -0
  196. package/.agents/skills/common/skill-creator/scripts/quick_validate.py +51 -0
  197. package/.agents/skills/common/skill-optimizer/SKILL.md +102 -0
  198. package/.agents/skills/common/skill-optimizer/evals/evals.json +16 -0
  199. package/.agents/skills/common/skill-optimizer/evals/train_queries.json +18 -0
  200. package/.agents/skills/common/skill-optimizer/evals/validation_queries.json +18 -0
  201. package/.agents/skills/common/skill-optimizer/references/design-patterns.md +26 -0
  202. package/.agents/skills/common/skill-optimizer/references/review-checklist.md +22 -0
  203. package/.agents/skills/common/using-superpowers/SKILL.md +151 -0
  204. package/.agents/skills/common/wait-for-gate-signal/SKILL.md +85 -0
  205. package/.agents/skills/domains/README.md +19 -0
  206. package/.agents/skills/domains/ui-ux-pro-max/SKILL.md +58 -0
  207. package/.agents/skills/domains/web/design-analysis/SKILL.md +89 -0
  208. package/.agents/skills/domains/web/design-analysis/rules/analysis-order.md +61 -0
  209. package/.agents/skills/domains/web/design-analysis/rules/analysis-priorities.md +136 -0
  210. package/.agents/skills/domains/web/design-analysis/rules/checklist-common-misses.md +107 -0
  211. package/.agents/skills/domains/web/design-analysis/rules/implementation-common-errors.md +204 -0
  212. package/.agents/skills/domains/web/design-analysis/rules/implementation-guidelines.md +211 -0
  213. package/.agents/skills/domains/web/design-analysis/rules/output-analysis-checklist.md +247 -0
  214. package/.agents/skills/domains/web/design-analysis/rules/tools-design-guidelines.md +108 -0
  215. package/.agents/skills/domains/web/design-analysis/rules/workflow-element-extraction.md +162 -0
  216. package/.agents/skills/domains/web/design-analysis/rules/workflow-layout-map.md +131 -0
  217. package/.agents/skills/domains/web/design-analysis/rules/workflow-output-checklist.md +70 -0
  218. package/.agents/skills/domains/web/design-analysis/rules/workflow-style-summary.md +91 -0
  219. package/.agents/skills/domains/web/route-permission-map/SKILL.md +103 -0
  220. package/.agents/skills/domains/web/ui-verification/SKILL.md +114 -0
  221. package/.agents/skills/domains/web/ui-verification/evals/evals.json +16 -0
  222. package/.agents/skills/domains/web/ui-verification/evals/train_queries.json +18 -0
  223. package/.agents/skills/domains/web/ui-verification/evals/validation_queries.json +18 -0
  224. package/.agents/skills/domains/web/ui-verification/rules/comparison-content-image.md +34 -0
  225. package/.agents/skills/domains/web/ui-verification/rules/comparison-content-text.md +30 -0
  226. package/.agents/skills/domains/web/ui-verification/rules/comparison-hierarchy.md +33 -0
  227. package/.agents/skills/domains/web/ui-verification/rules/comparison-layout.md +35 -0
  228. package/.agents/skills/domains/web/ui-verification/rules/errors-alignment.md +42 -0
  229. package/.agents/skills/domains/web/ui-verification/rules/errors-button-dimensions.md +28 -0
  230. package/.agents/skills/domains/web/ui-verification/rules/errors-button-position.md +25 -0
  231. package/.agents/skills/domains/web/ui-verification/rules/errors-css-priority.md +50 -0
  232. package/.agents/skills/domains/web/ui-verification/rules/errors-flex-column-width.md +46 -0
  233. package/.agents/skills/domains/web/ui-verification/rules/errors-flex-layout.md +46 -0
  234. package/.agents/skills/domains/web/ui-verification/rules/errors-grid-container-width.md +44 -0
  235. package/.agents/skills/domains/web/ui-verification/rules/errors-page-container-width.md +39 -0
  236. package/.agents/skills/domains/web/ui-verification/rules/tools-browser-navigation.md +53 -0
  237. package/.agents/skills/domains/web/ui-verification/rules/tools-design-guidelines.md +53 -0
  238. package/.agents/skills/domains/web/ui-verification/rules/workflow-checklist.md +27 -0
  239. package/.agents/skills/domains/web/ui-verification/rules/workflow-problem-list.md +56 -0
  240. package/.agents/skills/domains/web/ui-verification/rules/workflow-reflection.md +44 -0
  241. package/.agents/skills/domains/web/ui-verification/rules/writing-alignment.md +44 -0
  242. package/.agents/skills/domains/web/ui-verification/rules/writing-element-completeness.md +63 -0
  243. package/.agents/skills/domains/web/ui-verification/rules/writing-list-layout.md +75 -0
  244. package/.agents/skills/domains/web/ui-verification/rules/writing-page-container-width.md +37 -0
  245. package/.agents/skills/domains/web/web-design-guidelines/SKILL.md +40 -0
  246. package/.agents/skills/profiles/nestjs/README.md +4 -0
  247. package/.agents/skills/profiles/node-tooling/README.md +9 -0
  248. package/.agents/skills/profiles/react/create-api/SKILL.md +145 -0
  249. package/.agents/skills/profiles/react/create-component/SKILL.md +160 -0
  250. package/.agents/skills/profiles/react/create-route/SKILL.md +168 -0
  251. package/.agents/skills/profiles/react/create-store/SKILL.md +262 -0
  252. package/.agents/skills/profiles/react/theme-variables/SKILL.md +82 -0
  253. package/.agents/skills/profiles/react/vercel-composition-patterns/AGENTS.md +899 -0
  254. package/.agents/skills/profiles/react/vercel-composition-patterns/SKILL.md +81 -0
  255. package/.agents/skills/profiles/react/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -0
  256. package/.agents/skills/profiles/react/vercel-composition-patterns/rules/architecture-compound-components.md +112 -0
  257. package/.agents/skills/profiles/react/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -0
  258. package/.agents/skills/profiles/react/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -0
  259. package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-context-interface.md +191 -0
  260. package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -0
  261. package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-lift-state.md +125 -0
  262. package/.agents/skills/profiles/react/vercel-react-best-practices/AGENTS.md +2934 -0
  263. package/.agents/skills/profiles/react/vercel-react-best-practices/SKILL.md +136 -0
  264. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  265. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  266. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  267. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  268. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-defer-await.md +80 -0
  269. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  270. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-parallel.md +28 -0
  271. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  272. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-barrel-imports.md +59 -0
  273. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  274. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  275. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  276. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  277. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  278. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  279. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  280. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  281. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  282. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  283. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  284. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  285. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  286. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  287. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  288. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  289. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  290. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  291. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  292. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  293. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  294. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  295. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  296. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  297. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  298. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  299. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  300. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  301. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  302. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  303. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  304. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  305. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  306. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  307. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  308. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  309. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  310. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  311. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  312. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  313. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  314. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  315. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  316. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  317. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  318. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  319. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  320. package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-serialization.md +38 -0
  321. package/.agents/skills/profiles/springboot/README.md +10 -0
  322. package/.agents/skills/profiles/vue/create-api/SKILL.md +105 -0
  323. package/.agents/skills/profiles/vue/create-component/SKILL.md +76 -0
  324. package/.agents/skills/profiles/vue/create-route/SKILL.md +141 -0
  325. package/.agents/skills/profiles/vue/create-store/SKILL.md +97 -0
  326. package/.agents/skills/profiles/vue/create-view/SKILL.md +81 -0
  327. package/.agents/skills/profiles/vue/theme-variables/SKILL.md +73 -0
  328. package/.agents/skills/profiles/vue/vue-best-practices/SKILL.md +166 -0
  329. package/.agents/skills/profiles/vue/vue-best-practices/references/animation-class-based-technique.md +254 -0
  330. package/.agents/skills/profiles/vue/vue-best-practices/references/animation-state-driven-technique.md +291 -0
  331. package/.agents/skills/profiles/vue/vue-best-practices/references/component-async.md +97 -0
  332. package/.agents/skills/profiles/vue/vue-best-practices/references/component-data-flow.md +307 -0
  333. package/.agents/skills/profiles/vue/vue-best-practices/references/component-fallthrough-attrs.md +174 -0
  334. package/.agents/skills/profiles/vue/vue-best-practices/references/component-keep-alive.md +137 -0
  335. package/.agents/skills/profiles/vue/vue-best-practices/references/component-slots.md +216 -0
  336. package/.agents/skills/profiles/vue/vue-best-practices/references/component-suspense.md +228 -0
  337. package/.agents/skills/profiles/vue/vue-best-practices/references/component-teleport.md +108 -0
  338. package/.agents/skills/profiles/vue/vue-best-practices/references/component-transition-group.md +128 -0
  339. package/.agents/skills/profiles/vue/vue-best-practices/references/component-transition.md +125 -0
  340. package/.agents/skills/profiles/vue/vue-best-practices/references/composables.md +290 -0
  341. package/.agents/skills/profiles/vue/vue-best-practices/references/directives.md +162 -0
  342. package/.agents/skills/profiles/vue/vue-best-practices/references/perf-avoid-component-abstraction-in-lists.md +159 -0
  343. package/.agents/skills/profiles/vue/vue-best-practices/references/perf-v-once-v-memo-directives.md +182 -0
  344. package/.agents/skills/profiles/vue/vue-best-practices/references/perf-virtualize-large-lists.md +187 -0
  345. package/.agents/skills/profiles/vue/vue-best-practices/references/plugins.md +166 -0
  346. package/.agents/skills/profiles/vue/vue-best-practices/references/reactivity.md +344 -0
  347. package/.agents/skills/profiles/vue/vue-best-practices/references/render-functions.md +201 -0
  348. package/.agents/skills/profiles/vue/vue-best-practices/references/sfc.md +310 -0
  349. package/.agents/skills/profiles/vue/vue-best-practices/references/state-management.md +135 -0
  350. package/.agents/skills/profiles/vue/vue-best-practices/references/updated-hook-performance.md +187 -0
  351. package/.agents/templates/common/README.md +23 -0
  352. package/.agents/templates/common/bugfix.md +22 -0
  353. package/.agents/templates/common/create-expert-package.md +458 -0
  354. package/.agents/templates/common/mock-page.md +28 -0
  355. package/.agents/templates/common/new-component.md +25 -0
  356. package/.agents/templates/common/new-page.md +31 -0
  357. package/.cursor/mcp.json +36 -0
  358. package/.qoder/README.md +114 -0
  359. package/.qoder/commands +1 -0
  360. package/.qoder/mcp.json +26 -0
  361. package/.qoder/rules +1 -0
  362. package/.qoder/skills +1 -0
  363. package/LICENSE +21 -0
  364. package/README.md +433 -0
  365. package/bin/archive-change.js +474 -0
  366. package/bin/check-command.js +62 -0
  367. package/bin/cli.js +295 -0
  368. package/bin/command-template-renderer.js +40 -0
  369. package/bin/context-command.js +102 -0
  370. package/bin/demo-runtime-smoke.js +760 -0
  371. package/bin/execution-semantics.js +821 -0
  372. package/bin/executor-command.js +93 -0
  373. package/bin/expert-dispatch.js +334 -0
  374. package/bin/expert-executor.js +1148 -0
  375. package/bin/guard-command.js +52 -0
  376. package/bin/hub-command.js +876 -0
  377. package/bin/ide-command.js +242 -0
  378. package/bin/init-command.js +193 -0
  379. package/bin/install-workflow.js +2983 -0
  380. package/bin/manifest-export.js +34 -0
  381. package/bin/profile-registry.js +90 -0
  382. package/bin/protocol-workflow.js +446 -0
  383. package/bin/repair-command.js +161 -0
  384. package/bin/repo-map.js +177 -0
  385. package/bin/report-command.js +236 -0
  386. package/bin/runtime-bootstrap.js +428 -0
  387. package/bin/runtime-embedded.js +101 -0
  388. package/bin/runtime-fallback.js +106 -0
  389. package/bin/runtime-launcher.js +116 -0
  390. package/bin/runtime-paths.js +177 -0
  391. package/bin/runtime-registry.js +289 -0
  392. package/bin/runtime-state.js +2541 -0
  393. package/bin/scan.js +96 -0
  394. package/bin/self-upgrade.js +206 -0
  395. package/bin/skill-spec-validator.js +457 -0
  396. package/bin/spec-command.js +366 -0
  397. package/bin/superpowers.js +384 -0
  398. package/bin/sync-command.js +59 -0
  399. package/bin/sync.js +1904 -0
  400. package/bin/task-orchestrator-adapter.js +341 -0
  401. package/bin/task-orchestrator-extractor.js +274 -0
  402. package/bin/task-orchestrator-runner.js +1208 -0
  403. package/bin/telemetry/README.md +66 -0
  404. package/bin/telemetry/aspect.js +153 -0
  405. package/bin/telemetry/collect.js +67 -0
  406. package/bin/telemetry/config.js +114 -0
  407. package/bin/telemetry/defaults.json +5 -0
  408. package/bin/telemetry/healthcheck.js +195 -0
  409. package/bin/telemetry/identity.js +53 -0
  410. package/bin/telemetry/index.js +25 -0
  411. package/bin/telemetry/reporter.js +83 -0
  412. package/bin/telemetry/safe.js +39 -0
  413. package/bin/validate-registry.js +740 -0
  414. package/bin/visual-bridge-config.js +117 -0
  415. package/bin/visual-bridge.js +287 -0
  416. package/bin/visual-command.js +432 -0
  417. package/bin/worktree-command.js +194 -0
  418. package/configs/common/.editorconfig +15 -0
  419. package/configs/common/.husky/commit-msg +4 -0
  420. package/configs/common/.husky/pre-commit +4 -0
  421. package/configs/common/.lintstagedrc +11 -0
  422. package/configs/common/.prettierignore +11 -0
  423. package/configs/common/.prettierrc.json +11 -0
  424. package/configs/common/.stylelintignore +14 -0
  425. package/configs/common/.stylelintrc.json +21 -0
  426. package/configs/common/commitlint.config.js +3 -0
  427. package/configs/profiles/nestjs/.gitkeep +1 -0
  428. package/configs/profiles/node-tooling/.gitkeep +1 -0
  429. package/configs/profiles/react/.eslintignore +6 -0
  430. package/configs/profiles/react/.eslintrc.js +16 -0
  431. package/configs/profiles/react/.stylelintrc.json +18 -0
  432. package/configs/profiles/springboot/.gitkeep +1 -0
  433. package/configs/profiles/vue/.eslintignore +7 -0
  434. package/configs/profiles/vue/.eslintrc.cjs +17 -0
  435. package/contracts/README.md +28 -0
  436. package/contracts/fixtures/asset-package.fixture.json +26 -0
  437. package/contracts/fixtures/asset-usage-feedback.fixture.json +14 -0
  438. package/contracts/fixtures/evidence-report.fixture.json +28 -0
  439. package/contracts/fixtures/manifest.fixture.json +20 -0
  440. package/contracts/fixtures/run-event.fixture.json +15 -0
  441. package/contracts/schemas/asset-package.schema.json +76 -0
  442. package/contracts/schemas/asset-usage-feedback.schema.json +57 -0
  443. package/contracts/schemas/evidence-report.schema.json +60 -0
  444. package/contracts/schemas/manifest.schema.json +63 -0
  445. package/contracts/schemas/run-event.schema.json +72 -0
  446. package/install.ps1 +35 -0
  447. package/install.sh +17 -0
  448. package/internal/ai-protocol-workflow.js +5600 -0
  449. package/internal/hub-client.js +98 -0
  450. package/internal/hub-sync-selection.js +69 -0
  451. package/internal/visual-hooks/README.md +481 -0
  452. package/internal/visual-hooks/config-loader.js +218 -0
  453. package/internal/visual-hooks/control-puller.js +206 -0
  454. package/internal/visual-hooks/gate-signal.js +150 -0
  455. package/internal/visual-hooks/inbox-consumer.js +469 -0
  456. package/internal/visual-hooks/index.js +197 -0
  457. package/internal/visual-hooks/push-client.js +189 -0
  458. package/internal/visual-hooks/receipt-pusher.js +176 -0
  459. package/internal/visual-hooks/runtime-state-pusher.js +128 -0
  460. package/openspec/changes/.gitkeep +0 -0
  461. package/openspec/changes/archive/.gitkeep +0 -0
  462. package/openspec/config.yaml.template +52 -0
  463. package/openspec/schemas/expert-delivery/schema.yaml +68 -0
  464. package/openspec/schemas/expert-delivery/templates/checklist.md +39 -0
  465. package/openspec/schemas/expert-delivery/templates/design.md +61 -0
  466. package/openspec/schemas/expert-delivery/templates/iterations.md +25 -0
  467. package/openspec/schemas/expert-delivery/templates/proposal.md +45 -0
  468. package/openspec/schemas/expert-delivery/templates/spec.md +29 -0
  469. package/openspec/schemas/expert-delivery/templates/tasks.md +24 -0
  470. package/openspec/specs/.gitkeep +0 -0
  471. package/package.json +73 -0
  472. package/scripts/acceptance-zero-intrusion.sh +168 -0
  473. package/scripts/hub-sync-assets.config.example.json +296 -0
  474. package/scripts/hub-sync-assets.js +2038 -0
  475. package/scripts/local-verify.sh +280 -0
  476. package/scripts/post-publish-auto-fix-check.js +404 -0
  477. package/scripts/post-publish-verify.sh +175 -0
  478. package/scripts/setup-cursor-manual-test.sh +107 -0
  479. package/scripts/setup-cursor-spec-archive-test.sh +111 -0
  480. package/scripts/setup-visual-integration.sh +225 -0
  481. package/scripts/test-integration.sh +176 -0
  482. package/scripts/update-test-project.sh +93 -0
  483. package/scripts/upload-four-web.sh +57 -0
  484. package/scripts/verify-install-ps1-bom.js +26 -0
  485. package/src/agent/agent-context.js +259 -0
  486. package/src/agent/agent-profile.js +185 -0
  487. package/src/agent/agent-templates.js +161 -0
  488. package/src/agent/agent-types.js +108 -0
  489. package/src/agent/collaboration-protocol.js +333 -0
  490. package/src/agent/conflict-handler.js +364 -0
  491. package/src/agent/file-permission.js +121 -0
  492. package/src/agent/index.js +38 -0
  493. package/src/agent/permission-audit.js +151 -0
  494. package/src/agent/review-repair-loop.js +270 -0
  495. package/src/agent/tool-permission.js +101 -0
  496. package/src/asset/asset-dependency.js +322 -0
  497. package/src/asset/asset-feedback.js +350 -0
  498. package/src/asset/asset-fork.js +300 -0
  499. package/src/asset/asset-install.js +278 -0
  500. package/src/asset/asset-installer.js +497 -0
  501. package/src/asset/asset-lifecycle.js +324 -0
  502. package/src/asset/asset-manager.js +245 -0
  503. package/src/asset/asset-package-manager.js +349 -0
  504. package/src/asset/asset-package.js +186 -0
  505. package/src/asset/asset-quality.js +262 -0
  506. package/src/asset/asset-registry.js +387 -0
  507. package/src/asset/asset-version.js +293 -0
  508. package/src/asset/index.js +86 -0
  509. package/src/cache/agent-profile-cache.js +59 -0
  510. package/src/cache/asset-cache.js +63 -0
  511. package/src/cache/global-cache.js +61 -0
  512. package/src/cache/manifest-cache.js +30 -0
  513. package/src/check/check-service.js +32 -0
  514. package/src/config/config-layer.js +343 -0
  515. package/src/config/config-loader.js +60 -0
  516. package/src/config/defaults.js +49 -0
  517. package/src/connectors/hub/asset-package.js +72 -0
  518. package/src/connectors/hub/asset-usage-feedback.js +46 -0
  519. package/src/connectors/hub/hub-connector.js +44 -0
  520. package/src/connectors/hub/index.js +21 -0
  521. package/src/connectors/visual/evidence-report.js +49 -0
  522. package/src/connectors/visual/index.js +15 -0
  523. package/src/connectors/visual/queue.js +41 -0
  524. package/src/connectors/visual/run-event.js +81 -0
  525. package/src/connectors/visual/visual-connector.js +77 -0
  526. package/src/context/context-budget.js +59 -0
  527. package/src/context/context-builder.js +285 -0
  528. package/src/context/context-loader.js +116 -0
  529. package/src/context/context-planner.js +158 -0
  530. package/src/context/types.js +96 -0
  531. package/src/contracts/index.js +63 -0
  532. package/src/executor/executor-registry.js +78 -0
  533. package/src/executor/executor-result-parser.js +44 -0
  534. package/src/executor/executor-runner.js +141 -0
  535. package/src/executor/executor-selector.js +139 -0
  536. package/src/executor/executor-timeout.js +36 -0
  537. package/src/executor/providers/base-provider-utils.js +189 -0
  538. package/src/executor/providers/claude-code-executor-provider.js +128 -0
  539. package/src/executor/providers/codex-executor-provider.js +126 -0
  540. package/src/executor/providers/cursor-executor-provider.js +99 -0
  541. package/src/executor/types.js +137 -0
  542. package/src/git/branch-manager.js +71 -0
  543. package/src/git/dirty-checker.js +43 -0
  544. package/src/git/dirty-strategy-handler.js +29 -0
  545. package/src/git/git-command.js +37 -0
  546. package/src/git/git-repository-detector.js +45 -0
  547. package/src/git/multi-repo-worktree-planner.js +88 -0
  548. package/src/git/policy.js +19 -0
  549. package/src/git/strategies/block-dirty-strategy.js +34 -0
  550. package/src/git/strategies/ignore-dirty-strategy.js +33 -0
  551. package/src/git/strategies/patch-snapshot-strategy.js +53 -0
  552. package/src/git/strategies/wip-commit-strategy.js +38 -0
  553. package/src/git/types.js +71 -0
  554. package/src/git/worktree-manager.js +85 -0
  555. package/src/governance/asset-review.js +351 -0
  556. package/src/governance/audit-log.js +368 -0
  557. package/src/governance/gray-release.js +312 -0
  558. package/src/governance/index.js +31 -0
  559. package/src/governance/policy-types.js +56 -0
  560. package/src/governance/rbac-types.js +171 -0
  561. package/src/governance/rbac.js +382 -0
  562. package/src/governance/rollback.js +360 -0
  563. package/src/governance/security-policy.js +354 -0
  564. package/src/hook/hook-config-writer.js +125 -0
  565. package/src/hub/hub-client.js +186 -0
  566. package/src/hub/hub-config.js +39 -0
  567. package/src/hub/project-facts.js +31 -0
  568. package/src/hub/runtime-feedback-reporter.js +55 -0
  569. package/src/ide/adapters/adapter-protocol.js +385 -0
  570. package/src/ide/adapters/claude-adapter.js +419 -0
  571. package/src/ide/adapters/codex-adapter.js +60 -0
  572. package/src/ide/adapters/cursor-adapter.js +484 -0
  573. package/src/ide/adapters/index.js +24 -0
  574. package/src/ide/anchors/markdown-anchor-writer.js +152 -0
  575. package/src/ide/ide-service.js +270 -0
  576. package/src/ide/ide-types.js +94 -0
  577. package/src/ide/links/link-mode-resolver.js +160 -0
  578. package/src/ide/registry/ide-registry-builder.js +165 -0
  579. package/src/incident/incident-writer.js +47 -0
  580. package/src/incident/types.js +22 -0
  581. package/src/init/ide-linker.js +126 -0
  582. package/src/init/ide-pointer-injector.js +75 -0
  583. package/src/init/init-applier.js +197 -0
  584. package/src/init/init-plan.js +294 -0
  585. package/src/init/init-service.js +65 -0
  586. package/src/init/manifest-installer.js +302 -0
  587. package/src/init/types.js +26 -0
  588. package/src/project/config-writer.js +83 -0
  589. package/src/project/context-index-writer.js +82 -0
  590. package/src/project/json-utils.js +72 -0
  591. package/src/project/local-state-writer.js +50 -0
  592. package/src/project/lock-file-writer.js +98 -0
  593. package/src/project/manifest-writer.js +126 -0
  594. package/src/project/policy-config-writer.js +91 -0
  595. package/src/project/project-config-writer.js +74 -0
  596. package/src/project/project-files.js +39 -0
  597. package/src/project/registry-index-writer.js +43 -0
  598. package/src/project/workspace-config-writer.js +63 -0
  599. package/src/run/index.js +11 -0
  600. package/src/run/run-id.js +32 -0
  601. package/src/run/run-service.js +269 -0
  602. package/src/run/run-store.js +80 -0
  603. package/src/scanner/aggregator/detection-aggregator.js +23 -0
  604. package/src/scanner/boundary/boundary-resolver.js +229 -0
  605. package/src/scanner/detectors/detector-registry.js +44 -0
  606. package/src/scanner/detectors/fastapi-detector.js +46 -0
  607. package/src/scanner/detectors/go-detector.js +46 -0
  608. package/src/scanner/detectors/nestjs-detector.js +57 -0
  609. package/src/scanner/detectors/nextjs-detector.js +52 -0
  610. package/src/scanner/detectors/react-vite-detector.js +52 -0
  611. package/src/scanner/detectors/react-webpack-detector.js +57 -0
  612. package/src/scanner/detectors/springboot-detector.js +46 -0
  613. package/src/scanner/detectors/springcloud-detector.js +46 -0
  614. package/src/scanner/detectors/springmvc-detector.js +46 -0
  615. package/src/scanner/detectors/vue-vite-detector.js +52 -0
  616. package/src/scanner/engine.js +72 -0
  617. package/src/scanner/facts/fact-extractor.js +211 -0
  618. package/src/scanner/types.js +30 -0
  619. package/src/security/asset-tamper-checker.js +188 -0
  620. package/src/security/checksum.js +40 -0
  621. package/src/spec/spec-writer.js +302 -0
  622. package/src/state-machine/circuit-breaker.js +112 -0
  623. package/src/state-machine/escape-hatch.js +49 -0
  624. package/src/state-machine/stage-runner.js +281 -0
  625. package/src/state-machine/state-machine.js +24 -0
  626. package/src/state-machine/transition-guard.js +36 -0
  627. package/src/state-machine/types.js +37 -0
  628. package/src/sync/sync-service.js +192 -0
  629. package/src/visual/agent-visual.js +142 -0
  630. package/src/visual/event-gateway.js +357 -0
  631. package/src/visual/event-mapper.js +128 -0
  632. package/src/visual/hook-dashboard.js +216 -0
  633. package/src/visual/index.js +27 -0
  634. package/src/visual/metrics.js +287 -0
  635. package/src/visual/privacy-filter.js +100 -0
  636. package/src/visual/risk-board.js +252 -0
  637. package/src/visual/timeline.js +245 -0
  638. package/src/visual/visual-client.js +94 -0
  639. package/src/visual/visual-config.js +40 -0
  640. 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` - 第二步:区域与元素提取