@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,16 @@
1
+ {
2
+ "skill_name": "create-proposal",
3
+ "evals": [
4
+ {
5
+ "id": "proposal-output-1",
6
+ "prompt": "用户要发起一个带设计稿和未就绪接口的新页面需求,请给出提案前置分析、上下文注入重点和后置检查项。",
7
+ "files": [],
8
+ "expected_output": "输出应覆盖设计稿、接口状态、交付形态、复杂交互、后置检查和下一步 apply/execute-task 提示。",
9
+ "assertions": [
10
+ "说明何时触发 design-analysis",
11
+ "明确 mock 与真实接口边界",
12
+ "包含后置检查与下一步建议"
13
+ ]
14
+ }
15
+ ]
16
+ }
@@ -0,0 +1,18 @@
1
+ [
2
+ {
3
+ "query": "帮我给这个新页面需求起一个 OpenSpec 提案",
4
+ "should_trigger": true
5
+ },
6
+ {
7
+ "query": "我要发起一个包含 UI 和接口的需求 proposal",
8
+ "should_trigger": true
9
+ },
10
+ {
11
+ "query": "开始按 tasks.md 写代码",
12
+ "should_trigger": false
13
+ },
14
+ {
15
+ "query": "把这个变更归档",
16
+ "should_trigger": false
17
+ }
18
+ ]
@@ -0,0 +1,18 @@
1
+ [
2
+ {
3
+ "query": "在 /opsx:propose 之前先帮我梳理需求和设计稿输入",
4
+ "should_trigger": true
5
+ },
6
+ {
7
+ "query": "我要新增一个带 mock 数据的页面提案",
8
+ "should_trigger": true
9
+ },
10
+ {
11
+ "query": "执行下一个开发任务",
12
+ "should_trigger": false
13
+ },
14
+ {
15
+ "query": "检查页面和设计稿差异",
16
+ "should_trigger": false
17
+ }
18
+ ]
@@ -0,0 +1,42 @@
1
+ # 交互说明模板
2
+
3
+ 当需求包含搜索、表单、弹窗、批量操作、复杂状态切换等交互时,可先按这份模板收口,再写入 `proposal / design / tasks`。
4
+
5
+ ```md
6
+ ## 交互说明
7
+
8
+ ### 页面概述
9
+ - 目标:
10
+ - 入口:
11
+ - 关键用户路径:
12
+
13
+ ### 布局与区域
14
+ - 主区域:
15
+ - 次区域:
16
+ - 响应式注意点:
17
+
18
+ ### 关键交互
19
+ #### 搜索 / 筛选
20
+ - 字段:
21
+ - 查询时机:
22
+ - 重置行为:
23
+
24
+ #### 表单 / 弹窗
25
+ - 打开条件:
26
+ - 校验规则:
27
+ - 提交成功 / 失败反馈:
28
+
29
+ #### 列表 / 批量操作
30
+ - 批量选择:
31
+ - 空态 / 加载态 / 错误态:
32
+ - 分页与筛选联动:
33
+
34
+ ### 数据与状态
35
+ - 数据来源:
36
+ - mock / 真实接口边界:
37
+ - 本地状态与全局状态分工:
38
+
39
+ ### 验收关注点
40
+ - 用户是否能完成关键路径:
41
+ - 是否存在易错或易漏状态:
42
+ ```
@@ -0,0 +1,292 @@
1
+ ---
2
+ name: create-test
3
+ description: 当需要为功能模块编写单元测试或集成测试时使用本技能。指导按团队规范创建 Vitest 测试文件,涵盖命名约定、断言模式、Mock 策略与覆盖率要求。
4
+ compatibility: Assumes a local TypeScript/JavaScript repository with Vitest-compatible tooling and .agents/rules/common testing conventions.
5
+ ---
6
+
7
+ # 创建测试
8
+
9
+ ## 使用时机
10
+
11
+ 当出现以下场景时使用本技能:
12
+
13
+ - 为新增的工具函数、Store 逻辑、数据转换编写**单元测试**
14
+ - 为关键用户交互流程编写**组件测试**或**集成测试**
15
+ - 重构现有模块后需补充或更新测试用例
16
+ - `execute-task` 技能中 TDD 落地编码阶段需要创建测试文件
17
+
18
+ ## 环境依赖
19
+
20
+ - 默认面向本仓库的 `.agents/rules/common/11-测试规范.md`
21
+ - 示例以 Vitest 为主,若项目测试栈不同,需要按项目实际工具调整
22
+
23
+ ## 注意事项
24
+
25
+ - 不要为了“补覆盖率”去 mock 被测模块内部逻辑
26
+ - 测试文件应跟随真实代码落点,不要新造一套平行目录
27
+ - 组件测试只在项目已具备对应测试运行条件时再补
28
+
29
+ ---
30
+
31
+ ## 步骤
32
+
33
+ ### 步骤 1:确认测试目标与类型
34
+
35
+ 1. 明确被测模块:工具函数、Store、组件、业务逻辑。
36
+ 2. 确定测试级别:
37
+
38
+ | 级别 | 适用对象 | 说明 |
39
+ |------|----------|------|
40
+ | 单元测试 | 工具函数、纯逻辑、数据转换 | 隔离测试单个函数/模块的输入输出 |
41
+ | 组件测试 | UI 组件交互 | 使用 `@testing-library/react` 或 `@vue/test-utils` |
42
+ | 集成测试 | 多模块协作流程 | 验证模块间协作的正确性 |
43
+
44
+ ### 步骤 2:创建测试文件
45
+
46
+ 1. 在被测源文件**同目录**下创建测试文件。
47
+ 2. 文件命名:`<源文件名>.test.ts`(逻辑)或 `<源文件名>.test.tsx`(React 组件)。
48
+ 3. 导入 Vitest API 与被测模块。
49
+
50
+ ```text
51
+ src/utils/
52
+ ├── formatDate.ts
53
+ └── formatDate.test.ts # 与源文件同目录
54
+ ```
55
+
56
+ ### 步骤 3:编写测试用例
57
+
58
+ 按 **Arrange-Act-Assert** 模式编写每个测试:
59
+
60
+ 1. **Arrange**:准备测试数据和前置条件。
61
+ 2. **Act**:调用被测函数或触发被测行为。
62
+ 3. **Assert**:断言结果符合预期。
63
+
64
+ ```ts
65
+ import { describe, it, expect } from 'vitest';
66
+ import { formatDate } from './formatDate';
67
+
68
+ describe('formatDate', () => {
69
+ it('应将时间戳转换为 YYYY-MM-DD 格式', () => {
70
+ const timestamp = 1700000000000;
71
+ const result = formatDate(timestamp);
72
+ expect(result).toBe('2023-11-15');
73
+ });
74
+
75
+ it('传入 null 时应返回空字符串', () => {
76
+ expect(formatDate(null)).toBe('');
77
+ });
78
+
79
+ it('传入 undefined 时应返回空字符串', () => {
80
+ expect(formatDate(undefined)).toBe('');
81
+ });
82
+ });
83
+ ```
84
+
85
+ ### 步骤 4:补充边界与异常用例
86
+
87
+ 每个被测函数至少覆盖:
88
+
89
+ - **正常路径**:典型输入的预期输出
90
+ - **边界值**:空值、零值、极大/极小值、空数组/空对象
91
+ - **异常输入**:类型错误、格式异常、非法参数
92
+ - **特殊场景**:并发、超时等(视业务而定)
93
+
94
+ ### 步骤 5:运行测试并确认通过
95
+
96
+ ```bash
97
+ npx vitest run <测试文件路径>
98
+ ```
99
+
100
+ 确认所有用例通过后,再提交代码。
101
+
102
+ ---
103
+
104
+ ## 命名约定
105
+
106
+ ### 文件命名
107
+
108
+ | 类型 | 命名规则 | 示例 |
109
+ |------|----------|------|
110
+ | 逻辑/工具测试 | `<name>.test.ts` | `formatDate.test.ts` |
111
+ | React 组件测试 | `<name>.test.tsx` | `UserCard.test.tsx` |
112
+ | Vue 组件测试 | `<name>.test.ts` | `UserCard.test.ts` |
113
+ | 公共 Mock / 辅助 | 放置于 `tests/` 或 `src/__tests__/helpers/` | `tests/mocks/mockUser.ts` |
114
+
115
+ ### 描述命名
116
+
117
+ - `describe` 块:使用被测模块名称(函数名、组件名、Store 名)
118
+ - `it` / `test` 块:使用**中文**描述预期行为,格式为「应……」或「当……时应……」
119
+ - 描述表达**预期行为**,而非实现步骤
120
+
121
+ ```ts
122
+ describe('useAuthStore', () => {
123
+ it('登录成功后应保存用户信息到 state', () => { /* ... */ });
124
+ it('token 过期时应自动清除登录状态', () => { /* ... */ });
125
+ it('当网络异常时应抛出错误并保持原状态', () => { /* ... */ });
126
+ });
127
+ ```
128
+
129
+ ---
130
+
131
+ ## 测试模式
132
+
133
+ ### 单元测试模式
134
+
135
+ 隔离测试纯函数,不依赖外部环境:
136
+
137
+ ```ts
138
+ describe('calculateTotal', () => {
139
+ it('应正确计算商品总价', () => {
140
+ const items = [
141
+ { price: 10, quantity: 2 },
142
+ { price: 20, quantity: 1 },
143
+ ];
144
+ expect(calculateTotal(items)).toBe(40);
145
+ });
146
+
147
+ it('空数组应返回 0', () => {
148
+ expect(calculateTotal([])).toBe(0);
149
+ });
150
+ });
151
+ ```
152
+
153
+ ### Mock 策略
154
+
155
+ 遵循原则:**Mock 外部依赖,不 Mock 被测模块内部。**
156
+
157
+ #### API 请求 Mock
158
+
159
+ ```ts
160
+ import { vi } from 'vitest';
161
+ import { fetchUser } from './api';
162
+
163
+ vi.mock('./api', () => ({
164
+ fetchUser: vi.fn(),
165
+ }));
166
+
167
+ describe('UserService', () => {
168
+ it('应正确处理用户数据', async () => {
169
+ vi.mocked(fetchUser).mockResolvedValue({ id: 1, name: '张三' });
170
+ const result = await getUserInfo(1);
171
+ expect(result.name).toBe('张三');
172
+ });
173
+
174
+ it('接口异常时应抛出错误', async () => {
175
+ vi.mocked(fetchUser).mockRejectedValue(new Error('网络错误'));
176
+ await expect(getUserInfo(1)).rejects.toThrow('网络错误');
177
+ });
178
+ });
179
+ ```
180
+
181
+ #### 定时器 Mock
182
+
183
+ ```ts
184
+ import { vi, beforeEach, afterEach } from 'vitest';
185
+
186
+ beforeEach(() => {
187
+ vi.useFakeTimers();
188
+ });
189
+
190
+ afterEach(() => {
191
+ vi.useRealTimers();
192
+ });
193
+
194
+ it('防抖函数应在延迟后执行', () => {
195
+ const fn = vi.fn();
196
+ const debounced = debounce(fn, 300);
197
+
198
+ debounced();
199
+ expect(fn).not.toHaveBeenCalled();
200
+
201
+ vi.advanceTimersByTime(300);
202
+ expect(fn).toHaveBeenCalledOnce();
203
+ });
204
+ ```
205
+
206
+ #### 模块 Mock
207
+
208
+ ```ts
209
+ vi.mock('@/utils/storage', () => ({
210
+ getItem: vi.fn(),
211
+ setItem: vi.fn(),
212
+ }));
213
+ ```
214
+
215
+ ### 组件测试模式(React)
216
+
217
+ ```tsx
218
+ import { render, screen, fireEvent } from '@testing-library/react';
219
+
220
+ describe('SearchInput', () => {
221
+ it('输入关键词后应触发搜索回调', async () => {
222
+ const onSearch = vi.fn();
223
+ render(<SearchInput onSearch={onSearch} />);
224
+
225
+ const input = screen.getByTestId('search-input');
226
+ await fireEvent.change(input, { target: { value: '测试' } });
227
+ await fireEvent.click(screen.getByTestId('search-btn'));
228
+
229
+ expect(onSearch).toHaveBeenCalledWith('测试');
230
+ });
231
+ });
232
+ ```
233
+
234
+ ### 组件测试模式(Vue)
235
+
236
+ ```ts
237
+ import { mount } from '@vue/test-utils';
238
+
239
+ describe('SearchInput', () => {
240
+ it('输入关键词后应触发搜索事件', async () => {
241
+ const wrapper = mount(SearchInput);
242
+
243
+ await wrapper.find('[data-testid="search-input"]').setValue('测试');
244
+ await wrapper.find('[data-testid="search-btn"]').trigger('click');
245
+
246
+ expect(wrapper.emitted('search')?.[0]).toEqual(['测试']);
247
+ });
248
+ });
249
+ ```
250
+
251
+ ---
252
+
253
+ ## 禁止模式
254
+
255
+ | 禁止项 | 原因 |
256
+ |--------|------|
257
+ | 测试依赖执行顺序 | 测试应互相独立,可单独运行 |
258
+ | 快照测试滥用 | 仅用于关键 UI 结构,禁止对大段 HTML 做快照 |
259
+ | 硬编码延时(`setTimeout`) | 使用 `vi.useFakeTimers()` 或 `waitFor` |
260
+ | Mock 被测模块内部方法 | 只 Mock 外部依赖 |
261
+ | 断言内部状态或私有变量 | 测试行为而非实现 |
262
+ | `data-testid` 以外的元素定位 | 禁止依赖 CSS class 或 DOM 结构 |
263
+
264
+ ---
265
+
266
+ ## 检查清单
267
+
268
+ 完成测试编写后,逐条确认以下事项:
269
+
270
+ - [ ] **文件位置**:测试文件与源文件在同一目录下
271
+ - [ ] **文件命名**:遵循 `<name>.test.ts` / `<name>.test.tsx` 命名规则
272
+ - [ ] **describe 命名**:使用被测模块名称作为 describe 描述
273
+ - [ ] **it 描述**:使用中文描述预期行为(「应……」「当……时应……」)
274
+ - [ ] **AAA 模式**:每个测试用例遵循 Arrange-Act-Assert 结构
275
+ - [ ] **每个 it 单一职责**:每个 `it` 只验证一个行为点
276
+ - [ ] **正常路径覆盖**:典型输入场景已测试
277
+ - [ ] **边界值覆盖**:空值、零值、极值等已测试
278
+ - [ ] **异常输入覆盖**:非法参数、类型错误等已测试
279
+ - [ ] **Mock 合理性**:仅 Mock 外部依赖,未 Mock 被测模块内部
280
+ - [ ] **元素定位**:组件测试使用 `data-testid` 定位元素
281
+ - [ ] **测试独立性**:每个测试可单独运行,不依赖执行顺序
282
+ - [ ] **测试通过**:所有用例通过 `vitest run`
283
+ - [ ] **类型检查**:`tsc --noEmit` 无报错
284
+
285
+ ---
286
+
287
+ ## 相关规范
288
+
289
+ - `.agents/rules/common/11-测试规范.md` — 测试框架选型、文件约定、编写规范与质量门禁
290
+ - `.agents/rules/common/02-编码规范.md` — 通用编码规范
291
+ - `.agents/rules/common/08-通用约束.md` — 中文描述等通用约束
292
+ - `.agents/skills/common/execute-task/SKILL.md` — TDD 落地编码阶段引用本技能
@@ -0,0 +1,80 @@
1
+ ---
2
+ name: dependency-impact-graph
3
+ description: 分析 monorepo、多包仓库或单仓模块间的依赖关系,判断“改一个包、目录或文件会影响谁”,并给出回归测试范围与潜在消费者提醒。当用户说“改了这个包会影响谁”“依赖影响分析”“回归测试范围”时使用。
4
+ compatibility: Requires a local repository workspace with dependency manifests, package/module boundaries, and source files available for static inspection.
5
+ ---
6
+
7
+ # 依赖影响分析
8
+
9
+ ## 使用时机
10
+
11
+ 当你需要:
12
+
13
+ - 判断某个包、目录、文件改动的下游影响
14
+ - 评估回归测试范围
15
+ - 梳理 monorepo / workspace 的依赖关系
16
+
17
+ ## 核心原则
18
+
19
+ - 先识别仓库结构,再建依赖图
20
+ - 优先用依赖声明,其次用代码引用补边
21
+ - 输出以“直接影响 / 间接影响 / 建议测试范围”为主
22
+ - 不自动安装依赖、不自动改代码
23
+
24
+ ## 步骤 1:识别结构
25
+
26
+ 优先检查:
27
+
28
+ - Node:`package.json`、`pnpm-workspace.yaml`、`lerna.json`
29
+ - Rust:`Cargo.toml`
30
+ - Go:`go.mod`
31
+
32
+ 若不是多包仓库,也可以退化为“单包内模块/目录影响分析”。
33
+
34
+ ## 步骤 2:建立依赖图
35
+
36
+ 依赖来源按优先级:
37
+
38
+ 1. 声明依赖
39
+ 2. 代码 import / require / 相对路径引用
40
+
41
+ 图的语义:
42
+
43
+ - `A -> B` 表示 A 依赖 B
44
+ - 当 B 被修改时,需要沿“谁依赖它”的方向做反向传播
45
+
46
+ ## 步骤 3:输出影响范围
47
+
48
+ 至少输出:
49
+
50
+ - 变更目标
51
+ - 直接依赖方
52
+ - 间接依赖方
53
+ - 建议回归测试范围
54
+ - 潜在 API / SDK / 服务消费者
55
+
56
+ ## 输出模板
57
+
58
+ ```md
59
+ ## 依赖影响分析
60
+
61
+ **变更目标**:`packages/shared-utils`
62
+
63
+ ### 受影响下游
64
+ - 直接:`packages/web-app`、`packages/admin-app`
65
+ - 间接:`packages/e2e-suite`
66
+
67
+ ### 建议回归测试范围
68
+ - 必测:`packages/shared-utils`
69
+ - 建议:`packages/web-app`、`packages/admin-app`
70
+
71
+ ### 消费者提醒
72
+ - 内部消费者:
73
+ - 外部发布面(若存在):
74
+ ```
75
+
76
+ ## 注意事项
77
+
78
+ - 单包仓库下要明确写“当前为单包分析”
79
+ - 尽量区分运行时依赖与仅类型依赖
80
+ - 若项目已有测试命令约定,可附命令示例,但不写死某个工具
@@ -0,0 +1,206 @@
1
+ ---
2
+ name: execute-task
3
+ description: 当用户要求按 `tasks.md`、`/opsx:apply` 或同类任务清单开始实施时,严格按 Superpowers 四步执行具体开发任务并输出审计结果。
4
+ compatibility: Requires tasks.md, local .agents/rules execution policies, and an ai-spec-auto/OpenSpec workspace with write access to task state.
5
+ metadata:
6
+ version: "2.0.0"
7
+ openclaw-user-invocable: "true"
8
+ type: rigid
9
+ ---
10
+
11
+ # Superpowers 任务执行技能 (Task Execution Skill)
12
+
13
+ > 本技能为**刚性技能**:严格遵循,不可简化步骤。每一步都必须产出可见的结构化输出。
14
+
15
+ ## 强制约束(NON-NEGOTIABLE)
16
+
17
+ 1. **四步必须完整执行**:每条任务必须依次经过四个步骤,禁止合并、跳过或简化任何一步。
18
+ 2. **每步必须有可见输出**:每个步骤必须以指定的 Markdown 标题开头输出(`### 第一步:头脑风暴`、`### 第二步:TDD 编码`、`### 第三步:双重审查`、`### 第四步:状态更新`),缺失标题即视为未执行该步骤。
19
+ 3. **步骤 1 的用户确认门禁不可跳过**:除非用户事先明确指示"批量执行"或"跳过确认"。
20
+ 4. **禁止直出代码**:绝对禁止未经步骤 1 思考就直接输出业务代码。
21
+
22
+ ## 触发条件
23
+
24
+ 当用户输入以下类似指令时,**必须**强制调用此技能:
25
+
26
+ - "开始执行任务"
27
+ - "按 tasks 开始写代码"
28
+ - "应用变更 (Apply)"
29
+ - "执行下一个 task"
30
+
31
+ 本技能也会被 `/opsx:apply` / `/opsx-apply` 命令自动触发。
32
+
33
+ ## 环境依赖
34
+
35
+ - 依赖 `tasks.md`、`.agents/rules/12-Superpowers执行规范.md` 和 `.agents/rules/14-审计汇报规范.md`
36
+ - 默认在 ai-spec-auto / OpenSpec 协议驱动仓库中运行
37
+
38
+ ## 注意事项
39
+
40
+ - 未经过第一步确认,不得直接进入编码
41
+ - 没有测试环境时也要明确记录 RED/GREEN/REFACTOR 的替代验证方式
42
+ - 审计报告是强制产物,不能因为任务很小而省略
43
+
44
+ ## 前置要求
45
+
46
+ 1. 当前工作区必须存在 `tasks.md` 文件,且包含未完成的任务 (`- [ ]`)。
47
+ 2. 必须已完整读取对应变更目录下的 `proposal.md` 或 `design.md` 获取上下文。
48
+ 3. 必须已读取 `.agents/rules/12-Superpowers执行规范.md` 确认执行原则。
49
+ 4. 必须已读取 `.agents/rules/14-审计汇报规范.md` 确认审计报告格式。
50
+
51
+ ---
52
+
53
+ ## 四步循环(每条任务必须完整执行)
54
+
55
+ ### 第一步:头脑风暴 (Brainstorm)
56
+
57
+ **强制输出标题**:`### 第一步:头脑风暴`
58
+
59
+ 1. 读取 `tasks.md` 找到第一个未完成的 `- [ ]` 任务。
60
+ 2. 根据任务类型,按需读取对应的项目规范(见「规范按需引用表」)。
61
+ 3. **必须输出**以下内容(限 100 字以内):
62
+ - **思路**:实现该任务的核心方案。
63
+ - **边界**:考虑到的边界情况和潜在风险。
64
+ 4. **用户确认门禁**:输出完成后,必须主动提问:"我的思路是否正确?是否可以开始编写测试和代码?"。**等待用户明确同意后才能进入下一步。**
65
+
66
+ **输出示例**:
67
+
68
+ ```text
69
+ ### 第一步:头脑风暴
70
+
71
+ **任务**:创建 AppButton 全局组件
72
+ **思路**:在 src/components/AppButton/ 下创建组件,使用 NutUI Button 封装,暴露 type/size/disabled 属性。
73
+ **边界**:需处理 loading 状态防重复点击;需兼容 Taro 小程序端。
74
+
75
+ → 我的思路是否正确?是否可以开始编写测试和代码?
76
+ ```
77
+
78
+ ### 第二步:TDD 编码 (Red-Green-Refactor)
79
+
80
+ **强制输出标题**:`### 第二步:TDD 编码`
81
+
82
+ 获得用户同意后,**必须输出** RED / GREEN / REFACTOR 三阶段的操作说明:
83
+
84
+ 1. **RED**:先创建或修改测试文件 / 类型定义,编写验证条件。
85
+ 2. **GREEN**:编写刚好能通过验证的最小必要业务逻辑代码。
86
+ 3. **REFACTOR**:清理冗余代码,确保符合 `.agents/rules/` 下的项目规范。
87
+
88
+ **测试环境分级策略**:
89
+
90
+ | 项目环境 | RED 阶段做什么 | 参考 |
91
+ |----------|---------------|------|
92
+ | 已配置 Vitest/Jest | 创建测试文件,编写失败测试用例 | `.agents/skills/create-test/SKILL.md` |
93
+ | 有 TypeScript 但无测试框架 | 编写严格类型定义(interface/type),确保 tsc 通过 | — |
94
+ | 纯 JavaScript 项目 | 编写 JSDoc 类型注释 + `console.assert` 运行时校验 | — |
95
+
96
+ **输出示例**:
97
+
98
+ ```text
99
+ ### 第二步:TDD 编码
100
+
101
+ **RED**:创建 src/components/AppButton/types.ts,定义 AppButtonProps 接口(type、size、disabled、loading、onClick)。
102
+ **GREEN**:创建 src/components/AppButton/index.tsx,实现组件满足类型约束。
103
+ **REFACTOR**:提取 barrel export 到 src/components/index.ts,对齐 04-组件规范.md。
104
+ ```
105
+
106
+ ### 第三步:双重审查 (Double Review)
107
+
108
+ **强制输出标题**:`### 第三步:双重审查`
109
+
110
+ 代码编写完成后,**必须输出以下审查结论表格**(不可静默跳过、不可省略):
111
+
112
+ | 维度 | 检查项 | 结论 |
113
+ |------|--------|------|
114
+ | 架构对齐 | 实现是否符合 `design.md` / `specs/` | 通过 / 偏差说明 |
115
+ | 代码健壮性 | 异常捕获、类型严谨、边界处理 | 通过 / 待补充项 |
116
+ | 规范合规 | 是否符合步骤 1 加载的规范 | 通过 / 偏差说明 |
117
+
118
+ 如发现偏差,必须在进入步骤 4 前修正代码或说明原因。
119
+
120
+ **输出示例**:
121
+
122
+ ```text
123
+ ### 第三步:双重审查
124
+
125
+ | 维度 | 检查项 | 结论 |
126
+ |------|--------|------|
127
+ | 架构对齐 | 符合 design.md 组件拆分方案 | 通过 |
128
+ | 代码健壮性 | Props 均有默认值,loading 防重复点击 | 通过 |
129
+ | 规范合规 | 目录 PascalCase、barrel export(04-组件规范) | 通过 |
130
+ ```
131
+
132
+ ### 第四步:状态更新与审计汇报 (Update Status & Audit)
133
+
134
+ **强制输出标题**:`### 第四步:状态更新`
135
+
136
+ 1. 修改 `tasks.md`,将完成的任务状态更新为 `- [x]`。
137
+ 2. 按 `.agents/rules/14-审计汇报规范.md` 的模板输出审计报告(五个区块)。
138
+ 3. 主动询问:"是否继续执行下一个任务?"
139
+
140
+ ---
141
+
142
+ ## 批量执行模式
143
+
144
+ 当用户明确指示"批量执行"、"不用逐步确认"或"全部执行"时:
145
+
146
+ - 步骤 1 的用户确认门禁可跳过(但**仍须输出**头脑风暴标题和内容)
147
+ - 步骤 2、3、4 **不可简化**,每步仍须有可见输出
148
+ - 必须在审计报告区块 5 中注明:"用户指示批量执行,跳过逐步确认"
149
+
150
+ ---
151
+
152
+ ## 自我检查:危险信号
153
+
154
+ 当你产生以下想法时,**立即停下** — 你正在合理化跳过步骤:
155
+
156
+ | 你的想法 | 事实 |
157
+ |---------|------|
158
+ | "这个任务很简单,不需要头脑风暴" | 再简单也要输出思路,30 字足够 |
159
+ | "用户着急,我先写代码再补流程" | 流程是质量保证,不是额外负担 |
160
+ | "测试框架没配置,跳过 TDD" | 用类型定义或 assert 兜底,不可跳过 RED 阶段 |
161
+ | "审查没问题,不用写出来" | 必须输出审查表格,不可静默通过 |
162
+ | "这几个任务类似,合并执行更高效" | 除非用户指示批量执行,否则逐条执行 |
163
+ | "输出四个标题太啰嗦了" | 标题是合规证据,缺失即违规 |
164
+ | "我可以把四步内容缩成一段" | 每步必须有独立标题,不可合并 |
165
+
166
+ ---
167
+
168
+ ## 规范按需引用表
169
+
170
+ 在第一步头脑风暴阶段,根据当前 Task 涉及的内容,按需读取对应规范和技能:
171
+
172
+ | 任务类型 | 应读取的规范 | 应读取的技能 |
173
+ |----------|-------------|-------------|
174
+ | 创建/修改组件 | `04-组件规范.md`、`09-样式规范.md` | `create-component`、`theme-variables` |
175
+ | 新增/调整接口 | `05-API规范.md` | `create-api` |
176
+ | 新增页面路由 | `06-路由规范.md`、`03-项目结构.md` | `create-route` / `create-view` |
177
+ | 新增/重构状态 | `07-状态管理.md` | `create-store` |
178
+ | 样式还原 | `09-样式规范.md` | `theme-variables`、`design-analysis` |
179
+ | 编写测试 | `11-测试规范.md` | `create-test` |
180
+ | 通用编码 | `02-编码规范.md`、`08-通用约束.md` | — |
181
+
182
+ 无需一次性全部加载。只读取与当前 Task 直接相关的规范,保持上下文精简。
183
+
184
+ ---
185
+
186
+ ## 合规自检清单
187
+
188
+ 每条任务完成后(步骤 4 输出前),对照以下清单确认合规:
189
+
190
+ - [ ] 输出了 `### 第一步:头脑风暴` 标题和内容
191
+ - [ ] 输出了 `### 第二步:TDD 编码` 标题和 RED/GREEN/REFACTOR 说明
192
+ - [ ] 输出了 `### 第三步:双重审查` 标题和审查结论表格
193
+ - [ ] 输出了 `### 第四步:状态更新` 标题和审计报告
194
+ - [ ] `tasks.md` 中对应任务已标记为 `- [x]`
195
+
196
+ 如有任何一项缺失,必须补充后再进入下一条任务。
197
+
198
+ ---
199
+
200
+ ## 相关规范与技能
201
+
202
+ - `.agents/rules/12-Superpowers执行规范.md` — 执行原则与约束(何时必须启用、何时可跳过)
203
+ - `.agents/rules/14-审计汇报规范.md` — 审计报告格式与约束(第四步必须输出)
204
+ - `.agents/skills/create-test/SKILL.md` — TDD RED 阶段创建测试文件的详细指导
205
+ - `.agents/skills/create-proposal/SKILL.md` — 提案前置分析(OpenSpec 增强层,委托 `/opsx:propose` 产出 tasks.md)
206
+ - `openspec/AGENTS.md` — OpenSpec 三阶段工作流说明
@@ -0,0 +1,16 @@
1
+ {
2
+ "skill_name": "execute-task",
3
+ "evals": [
4
+ {
5
+ "id": "execute-output-1",
6
+ "prompt": "根据 tasks.md 的第一条未完成任务进入执行,要求输出四步结构并在最后给出审计结论。",
7
+ "files": [],
8
+ "expected_output": "输出必须包含头脑风暴、TDD 编码、双重审查、状态更新四个步骤,并保留确认门槛。",
9
+ "assertions": [
10
+ "四步标题完整出现",
11
+ "第一步包含确认门禁",
12
+ "第四步包含审计/状态更新信息"
13
+ ]
14
+ }
15
+ ]
16
+ }