@gong-ym/ai-spec-auto 0.2.14 → 0.2.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/commands/README.md +33 -33
- package/.agents/commands/claude/spec-start-review.md +88 -88
- package/.agents/commands/codex/spec-continue.md +74 -74
- package/.agents/commands/codex/spec-orchestrate.md +35 -35
- package/.agents/commands/codex/spec-start-review.md +88 -88
- package/.agents/commands/codex/spec-start.md +67 -67
- package/.agents/commands/codex/spec-status.md +22 -22
- package/.agents/commands/codex/spec-stop.md +29 -29
- package/.agents/commands/codex/spec-update.md +40 -40
- package/.agents/commands/common/branch-review.md +117 -117
- package/.agents/commands/common/project-init.md +25 -25
- package/.agents/commands/common/spec-continue.md +74 -74
- package/.agents/commands/common/spec-orchestrate.md +35 -35
- package/.agents/commands/common/spec-start-review.md +82 -82
- package/.agents/commands/common/spec-start.md +67 -67
- package/.agents/commands/common/spec-status.md +22 -22
- package/.agents/commands/common/spec-stop.md +29 -29
- package/.agents/commands/common/spec-update.md +60 -40
- package/.agents/commands/cursor/opsx-apply.md +55 -55
- package/.agents/commands/cursor/opsx-archive.md +48 -48
- package/.agents/commands/cursor/opsx-explore.md +45 -45
- package/.agents/commands/cursor/opsx-propose.md +59 -59
- package/.agents/commands/cursor/spec-continue.md +63 -63
- package/.agents/commands/cursor/spec-orchestrate.md +53 -53
- package/.agents/commands/cursor/spec-start-review.md +78 -78
- package/.agents/commands/cursor/spec-start.md +59 -59
- package/.agents/commands/cursor/spec-status.md +30 -30
- package/.agents/commands/cursor/spec-stop.md +29 -29
- package/.agents/commands/cursor/spec-update.md +41 -41
- package/.agents/flows/FRONTMATTER.md +263 -263
- package/.agents/flows/RUN_OUTPUT.md +263 -263
- package/.agents/flows/common/README.md +29 -29
- package/.agents/flows/common/bugfix-to-verification.md +95 -95
- package/.agents/flows/common/change-to-architecture-review.md +89 -89
- package/.agents/flows/common/change-to-release.md +94 -94
- package/.agents/flows/common/prd-to-delivery.md +184 -184
- package/.agents/flows/common/requirement-to-observability.md +97 -97
- package/.agents/orchestration/README.md +22 -22
- package/.agents/orchestration/expert-dispatch-spec.md +155 -155
- package/.agents/orchestration/expert-executor-spec.md +84 -84
- package/.agents/orchestration/expert-runtime-action-spec.md +73 -73
- package/.agents/orchestration/runtime-state-handoff-spec.md +264 -264
- package/.agents/orchestration/task-anchor-spec.md +212 -212
- package/.agents/orchestration/task-orchestrator-adapter-payload.md +153 -153
- package/.agents/orchestration/task-orchestrator-bootstrap-payload.md +145 -145
- package/.agents/orchestration/task-orchestrator-output-extractor-spec.md +93 -93
- package/.agents/orchestration/task-orchestrator-run-plan-template.md +312 -312
- package/.agents/orchestration/task-orchestrator-runtime-hooks.md +214 -214
- package/.agents/registry/README.md +63 -63
- package/.agents/registry/flows.json +125 -125
- package/.agents/registry/profiles.json +101 -101
- package/.agents/registry/roles.json +1265 -1265
- package/.agents/registry/rules.json +148 -148
- package/.agents/registry/scenario-packages.json +123 -123
- package/.agents/registry/skills.json +130 -130
- package/.agents/roles/INDEX.md +346 -346
- package/.agents/roles/common/README.md +76 -76
- package/.agents/roles/common/archive-change.md +80 -80
- package/.agents/roles/common/backend-implementer.md +92 -92
- package/.agents/roles/common/code-guardian.md +151 -151
- package/.agents/roles/common/frontend-implementer.md +146 -146
- package/.agents/roles/common/requirement-analyst.md +138 -138
- package/.agents/roles/common/task-orchestrator-routing.md +301 -301
- package/.agents/roles/common/task-orchestrator.md +224 -224
- package/.agents/roles/common/tooling-implementer.md +92 -92
- package/.agents/roles/domains/README.md +35 -35
- package/.agents/roles/domains/delivery/README.md +11 -11
- package/.agents/roles/domains/delivery/container-specialist.md +50 -50
- package/.agents/roles/domains/delivery/deployment-specialist.md +50 -50
- package/.agents/roles/domains/delivery/pipeline-specialist.md +50 -50
- package/.agents/roles/domains/demand-design/README.md +16 -16
- package/.agents/roles/domains/demand-design/api-contract-specialist.md +52 -52
- package/.agents/roles/domains/demand-design/design-collaborator.md +58 -58
- package/.agents/roles/domains/documentation/README.md +11 -11
- package/.agents/roles/domains/documentation/api-doc-specialist.md +50 -50
- package/.agents/roles/domains/documentation/component-doc-specialist.md +49 -49
- package/.agents/roles/domains/documentation/technical-writing-specialist.md +48 -48
- package/.agents/roles/domains/engineering/README.md +17 -17
- package/.agents/roles/domains/engineering/architecture-advisor.md +53 -53
- package/.agents/roles/domains/engineering/build-specialist.md +51 -51
- package/.agents/roles/domains/engineering/dependency-governor.md +52 -52
- package/.agents/roles/domains/governance/README.md +17 -17
- package/.agents/roles/domains/governance/api-governance-specialist.md +51 -51
- package/.agents/roles/domains/governance/lint-policy-specialist.md +49 -49
- package/.agents/roles/domains/governance/route-governance-specialist.md +52 -52
- package/.agents/roles/domains/observability/README.md +11 -11
- package/.agents/roles/domains/observability/error-tracker.md +50 -50
- package/.agents/roles/domains/observability/event-instrumentation-specialist.md +51 -51
- package/.agents/roles/domains/observability/rum-analyst.md +50 -50
- package/.agents/roles/domains/performance/README.md +11 -11
- package/.agents/roles/domains/performance/asset-optimizer.md +50 -50
- package/.agents/roles/domains/performance/performance-auditor.md +56 -56
- package/.agents/roles/domains/performance/vitals-analyst.md +50 -50
- package/.agents/roles/domains/security-a11y/README.md +11 -11
- package/.agents/roles/domains/security-a11y/a11y-auditor.md +50 -50
- package/.agents/roles/domains/security-a11y/aria-specialist.md +51 -51
- package/.agents/roles/domains/security-a11y/security-reviewer.md +49 -49
- package/.agents/roles/domains/testing/README.md +12 -12
- package/.agents/roles/domains/testing/coverage-analyst.md +50 -50
- package/.agents/roles/domains/testing/e2e-test-specialist.md +51 -51
- package/.agents/roles/domains/testing/unit-test-specialist.md +56 -56
- package/.agents/roles/domains/testing/verification-reviewer.md +67 -67
- package/.agents/rules/README.md +87 -87
- package/.agents/rules/common/02-/347/274/226/347/240/201/350/247/204/350/214/203.md +45 -45
- package/.agents/rules/common/08-/351/200/232/347/224/250/347/272/246/346/235/237.md +63 -63
- package/.agents/rules/common/10-/346/226/207/346/241/243/350/247/204/350/214/203.md +101 -101
- package/.agents/rules/common/12-Superpowers/346/211/247/350/241/214/350/247/204/350/214/203.md +46 -46
- package/.agents/rules/common/14-/345/256/241/350/256/241/346/261/207/346/212/245/350/247/204/350/214/203.md +107 -107
- package/.agents/rules/common/15-visual-gate-wait.md +90 -90
- package/.agents/rules/profiles/nestjs/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +27 -27
- package/.agents/rules/profiles/nestjs/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +20 -20
- package/.agents/rules/profiles/nestjs/04-/346/250/241/345/235/227/347/273/223/346/236/204/350/247/204/350/214/203.md +24 -24
- package/.agents/rules/profiles/nestjs/05-/346/216/245/345/217/243/344/270/216/345/245/221/347/272/246/350/247/204/350/214/203.md +24 -24
- package/.agents/rules/profiles/nestjs/06-/346/225/260/346/215/256/350/256/277/351/227/256/350/247/204/350/214/203.md +24 -24
- package/.agents/rules/profiles/nestjs/07-/351/205/215/347/275/256/344/270/216/350/277/220/350/241/214/346/227/266/350/247/204/350/214/203.md +20 -20
- package/.agents/rules/profiles/nestjs/09-/345/274/202/345/270/270/344/270/216/346/227/245/345/277/227/350/247/204/350/214/203.md +20 -20
- package/.agents/rules/profiles/nestjs/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +24 -24
- package/.agents/rules/profiles/nestjs/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +20 -20
- package/.agents/rules/profiles/node-tooling/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +30 -30
- package/.agents/rules/profiles/node-tooling/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +37 -37
- package/.agents/rules/profiles/node-tooling/04-CLI/344/270/216/346/250/241/345/235/227/350/247/204/350/214/203.md +42 -42
- package/.agents/rules/profiles/node-tooling/05-Contract/344/270/216Schema/350/247/204/350/214/203.md +42 -42
- package/.agents/rules/profiles/node-tooling/06-/350/277/220/350/241/214/346/227/266/346/226/207/344/273/266/350/247/204/350/214/203.md +30 -30
- package/.agents/rules/profiles/node-tooling/07-/346/227/245/345/277/227/344/270/216/351/224/231/350/257/257/345/244/204/347/220/206/350/247/204/350/214/203.md +60 -60
- package/.agents/rules/profiles/node-tooling/09-/350/204/232/346/234/254/344/270/216/345/205/245/345/217/243/350/247/204/350/214/203.md +45 -45
- package/.agents/rules/profiles/node-tooling/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +41 -41
- package/.agents/rules/profiles/node-tooling/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +55 -55
- package/.agents/rules/profiles/react/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +29 -29
- package/.agents/rules/profiles/react/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +104 -104
- package/.agents/rules/profiles/react/04-/347/273/204/344/273/266/350/247/204/350/214/203.md +46 -46
- package/.agents/rules/profiles/react/05-API/350/247/204/350/214/203.md +67 -67
- package/.agents/rules/profiles/react/06-/350/267/257/347/224/261/350/247/204/350/214/203.md +54 -54
- package/.agents/rules/profiles/react/07-/347/212/266/346/200/201/347/256/241/347/220/206.md +226 -226
- package/.agents/rules/profiles/react/09-/346/240/267/345/274/217/350/247/204/350/214/203.md +71 -71
- package/.agents/rules/profiles/react/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +80 -80
- package/.agents/rules/profiles/react/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +159 -159
- package/.agents/rules/profiles/springboot/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +31 -31
- package/.agents/rules/profiles/springboot/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +37 -37
- package/.agents/rules/profiles/springboot/04-/345/210/206/345/261/202/350/247/204/350/214/203.md +33 -33
- package/.agents/rules/profiles/springboot/05-/346/216/245/345/217/243/344/270/216/345/245/221/347/272/246/350/247/204/350/214/203.md +51 -51
- package/.agents/rules/profiles/springboot/06-/346/225/260/346/215/256/350/256/277/351/227/256/350/247/204/350/214/203.md +34 -34
- package/.agents/rules/profiles/springboot/07-/351/205/215/347/275/256/344/270/216/350/277/220/350/241/214/346/227/266/350/247/204/350/214/203.md +38 -38
- package/.agents/rules/profiles/springboot/09-/345/274/202/345/270/270/344/270/216/346/227/245/345/277/227/350/247/204/350/214/203.md +48 -48
- package/.agents/rules/profiles/springboot/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +43 -43
- package/.agents/rules/profiles/springboot/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +48 -48
- package/.agents/rules/profiles/vue/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +47 -47
- package/.agents/rules/profiles/vue/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +106 -106
- package/.agents/rules/profiles/vue/04-/347/273/204/344/273/266/350/247/204/350/214/203.md +61 -61
- package/.agents/rules/profiles/vue/05-API/350/247/204/350/214/203.md +67 -67
- package/.agents/rules/profiles/vue/06-/350/267/257/347/224/261/350/247/204/350/214/203.md +69 -69
- package/.agents/rules/profiles/vue/07-/347/212/266/346/200/201/347/256/241/347/220/206.md +93 -93
- package/.agents/rules/profiles/vue/09-/346/240/267/345/274/217/350/247/204/350/214/203.md +67 -67
- package/.agents/rules/profiles/vue/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +80 -80
- package/.agents/rules/profiles/vue/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +159 -159
- package/.agents/skills/README.md +171 -171
- package/.agents/skills/common/archive-change/SKILL.md +180 -180
- package/.agents/skills/common/branch-code-reviewer/SKILL.md +533 -533
- package/.agents/skills/common/branch-code-reviewer/references/business-risk-guide.md +293 -293
- package/.agents/skills/common/branch-code-reviewer/references/html-template-guide.md +121 -121
- package/.agents/skills/common/config-and-secret-scan/SKILL.md +99 -99
- package/.agents/skills/common/create-proposal/SKILL.md +192 -192
- package/.agents/skills/common/create-proposal/evals/evals.json +16 -16
- package/.agents/skills/common/create-proposal/evals/train_queries.json +18 -18
- package/.agents/skills/common/create-proposal/evals/validation_queries.json +18 -18
- package/.agents/skills/common/create-proposal/references/interaction-spec-template.md +42 -42
- package/.agents/skills/common/create-test/SKILL.md +292 -292
- package/.agents/skills/common/dependency-impact-graph/SKILL.md +80 -80
- package/.agents/skills/common/execute-task/SKILL.md +206 -206
- package/.agents/skills/common/execute-task/evals/evals.json +16 -16
- package/.agents/skills/common/execute-task/evals/train_queries.json +18 -18
- package/.agents/skills/common/execute-task/evals/validation_queries.json +18 -18
- package/.agents/skills/common/find-skills/SKILL.md +144 -144
- package/.agents/skills/common/install-ai-spec-auto/SKILL.md +260 -260
- package/.agents/skills/common/install-ai-spec-auto/evals/evals.json +17 -17
- package/.agents/skills/common/install-ai-spec-auto/evals/train_queries.json +18 -18
- package/.agents/skills/common/install-ai-spec-auto/evals/validation_queries.json +18 -18
- package/.agents/skills/common/project-init/SKILL.md +178 -178
- package/.agents/skills/common/project-init/evals/evals.json +16 -16
- package/.agents/skills/common/project-init/evals/train_queries.json +18 -18
- package/.agents/skills/common/project-init/evals/validation_queries.json +18 -18
- package/.agents/skills/common/project-init/references/custom-rule-generation.md +89 -89
- package/.agents/skills/common/project-init/references/deep-scan-rules.md +67 -67
- package/.agents/skills/common/project-init/references/output-contracts.md +71 -71
- package/.agents/skills/common/project-init/references/repo-fact-gathering.md +83 -83
- package/.agents/skills/common/project-init/references/scope-resolution.md +76 -76
- package/.agents/skills/common/project-init/scripts/inspect-project.js +112 -112
- package/.agents/skills/common/skill-creator/LICENSE.txt +201 -201
- package/.agents/skills/common/skill-creator/SKILL.md +370 -370
- package/.agents/skills/common/skill-creator/evals/evals.json +16 -16
- package/.agents/skills/common/skill-creator/evals/train_queries.json +18 -18
- package/.agents/skills/common/skill-creator/evals/validation_queries.json +18 -18
- package/.agents/skills/common/skill-creator/references/output-patterns.md +82 -82
- package/.agents/skills/common/skill-creator/references/workflows.md +27 -27
- package/.agents/skills/common/skill-creator/scripts/init_skill.py +209 -209
- package/.agents/skills/common/skill-creator/scripts/package_skill.py +110 -110
- package/.agents/skills/common/skill-creator/scripts/quick_validate.py +51 -51
- package/.agents/skills/common/skill-optimizer/SKILL.md +102 -102
- package/.agents/skills/common/skill-optimizer/evals/evals.json +16 -16
- package/.agents/skills/common/skill-optimizer/evals/train_queries.json +18 -18
- package/.agents/skills/common/skill-optimizer/evals/validation_queries.json +18 -18
- package/.agents/skills/common/skill-optimizer/references/design-patterns.md +26 -26
- package/.agents/skills/common/skill-optimizer/references/review-checklist.md +22 -22
- package/.agents/skills/common/using-superpowers/SKILL.md +151 -151
- package/.agents/skills/common/wait-for-gate-signal/SKILL.md +85 -85
- package/.agents/skills/domains/README.md +19 -19
- package/.agents/skills/domains/ui-ux-pro-max/SKILL.md +58 -58
- package/.agents/skills/domains/web/design-analysis/SKILL.md +89 -89
- package/.agents/skills/domains/web/design-analysis/rules/analysis-order.md +61 -61
- package/.agents/skills/domains/web/design-analysis/rules/analysis-priorities.md +136 -136
- package/.agents/skills/domains/web/design-analysis/rules/checklist-common-misses.md +107 -107
- package/.agents/skills/domains/web/design-analysis/rules/implementation-common-errors.md +204 -204
- package/.agents/skills/domains/web/design-analysis/rules/implementation-guidelines.md +211 -211
- package/.agents/skills/domains/web/design-analysis/rules/output-analysis-checklist.md +247 -247
- package/.agents/skills/domains/web/design-analysis/rules/tools-design-guidelines.md +108 -108
- package/.agents/skills/domains/web/design-analysis/rules/workflow-element-extraction.md +162 -162
- package/.agents/skills/domains/web/design-analysis/rules/workflow-layout-map.md +131 -131
- package/.agents/skills/domains/web/design-analysis/rules/workflow-output-checklist.md +70 -70
- package/.agents/skills/domains/web/design-analysis/rules/workflow-style-summary.md +91 -91
- package/.agents/skills/domains/web/route-permission-map/SKILL.md +103 -103
- package/.agents/skills/domains/web/ui-verification/SKILL.md +114 -114
- package/.agents/skills/domains/web/ui-verification/evals/evals.json +16 -16
- package/.agents/skills/domains/web/ui-verification/evals/train_queries.json +18 -18
- package/.agents/skills/domains/web/ui-verification/evals/validation_queries.json +18 -18
- package/.agents/skills/domains/web/ui-verification/rules/comparison-content-image.md +34 -34
- package/.agents/skills/domains/web/ui-verification/rules/comparison-content-text.md +30 -30
- package/.agents/skills/domains/web/ui-verification/rules/comparison-hierarchy.md +33 -33
- package/.agents/skills/domains/web/ui-verification/rules/comparison-layout.md +35 -35
- package/.agents/skills/domains/web/ui-verification/rules/errors-alignment.md +42 -42
- package/.agents/skills/domains/web/ui-verification/rules/errors-button-dimensions.md +28 -28
- package/.agents/skills/domains/web/ui-verification/rules/errors-button-position.md +25 -25
- package/.agents/skills/domains/web/ui-verification/rules/errors-css-priority.md +50 -50
- package/.agents/skills/domains/web/ui-verification/rules/errors-flex-column-width.md +46 -46
- package/.agents/skills/domains/web/ui-verification/rules/errors-flex-layout.md +46 -46
- package/.agents/skills/domains/web/ui-verification/rules/errors-grid-container-width.md +44 -44
- package/.agents/skills/domains/web/ui-verification/rules/errors-page-container-width.md +39 -39
- package/.agents/skills/domains/web/ui-verification/rules/tools-browser-navigation.md +53 -53
- package/.agents/skills/domains/web/ui-verification/rules/tools-design-guidelines.md +53 -53
- package/.agents/skills/domains/web/ui-verification/rules/workflow-checklist.md +27 -27
- package/.agents/skills/domains/web/ui-verification/rules/workflow-problem-list.md +56 -56
- package/.agents/skills/domains/web/ui-verification/rules/workflow-reflection.md +44 -44
- package/.agents/skills/domains/web/ui-verification/rules/writing-alignment.md +44 -44
- package/.agents/skills/domains/web/ui-verification/rules/writing-element-completeness.md +63 -63
- package/.agents/skills/domains/web/ui-verification/rules/writing-list-layout.md +75 -75
- package/.agents/skills/domains/web/ui-verification/rules/writing-page-container-width.md +37 -37
- package/.agents/skills/domains/web/web-design-guidelines/SKILL.md +40 -40
- package/.agents/skills/profiles/nestjs/README.md +4 -4
- package/.agents/skills/profiles/node-tooling/README.md +9 -9
- package/.agents/skills/profiles/react/create-api/SKILL.md +145 -145
- package/.agents/skills/profiles/react/create-component/SKILL.md +160 -160
- package/.agents/skills/profiles/react/create-route/SKILL.md +168 -168
- package/.agents/skills/profiles/react/create-store/SKILL.md +262 -262
- package/.agents/skills/profiles/react/theme-variables/SKILL.md +82 -82
- package/.agents/skills/profiles/react/vercel-composition-patterns/AGENTS.md +899 -899
- package/.agents/skills/profiles/react/vercel-composition-patterns/SKILL.md +81 -81
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -100
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/architecture-compound-components.md +112 -112
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -87
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -100
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-context-interface.md +191 -191
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -113
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-lift-state.md +125 -125
- package/.agents/skills/profiles/react/vercel-react-best-practices/AGENTS.md +2934 -2934
- package/.agents/skills/profiles/react/vercel-react-best-practices/SKILL.md +136 -136
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -55
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-init-once.md +42 -42
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-use-latest.md +39 -39
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-api-routes.md +38 -38
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-defer-await.md +80 -80
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-dependencies.md +51 -51
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-parallel.md +28 -28
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -99
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-barrel-imports.md +59 -59
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-conditional.md +31 -31
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -49
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -35
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-preload.md +50 -50
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-event-listeners.md +74 -74
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -71
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -48
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-swr-dedup.md +56 -56
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -107
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-function-results.md +80 -80
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-property-access.md +28 -28
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-storage.md +70 -70
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-combine-iterations.md +32 -32
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-early-exit.md +50 -50
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -45
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-index-maps.md +37 -37
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-length-check-first.md +49 -49
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-min-max-loop.md +82 -82
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -24
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -57
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-activity.md +26 -26
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -47
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -40
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -38
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -46
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -82
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -30
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -28
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -75
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -39
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-dependencies.md +45 -45
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -40
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-derived-state.md +29 -29
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -74
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -58
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -38
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-memo.md +44 -44
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -45
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -35
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-transitions.md +40 -40
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -73
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -73
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-auth-actions.md +96 -96
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-cache-lru.md +41 -41
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-cache-react.md +76 -76
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-dedup-props.md +65 -65
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -83
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-serialization.md +38 -38
- package/.agents/skills/profiles/springboot/README.md +10 -10
- package/.agents/skills/profiles/vue/create-api/SKILL.md +105 -105
- package/.agents/skills/profiles/vue/create-component/SKILL.md +76 -76
- package/.agents/skills/profiles/vue/create-route/SKILL.md +141 -141
- package/.agents/skills/profiles/vue/create-store/SKILL.md +97 -97
- package/.agents/skills/profiles/vue/create-view/SKILL.md +81 -81
- package/.agents/skills/profiles/vue/theme-variables/SKILL.md +73 -73
- package/.agents/skills/profiles/vue/vue-best-practices/SKILL.md +166 -166
- package/.agents/skills/profiles/vue/vue-best-practices/references/animation-class-based-technique.md +254 -254
- package/.agents/skills/profiles/vue/vue-best-practices/references/animation-state-driven-technique.md +291 -291
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-async.md +97 -97
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-data-flow.md +307 -307
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-fallthrough-attrs.md +174 -174
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-keep-alive.md +137 -137
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-slots.md +216 -216
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-suspense.md +228 -228
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-teleport.md +108 -108
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-transition-group.md +128 -128
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-transition.md +125 -125
- package/.agents/skills/profiles/vue/vue-best-practices/references/composables.md +290 -290
- package/.agents/skills/profiles/vue/vue-best-practices/references/directives.md +162 -162
- package/.agents/skills/profiles/vue/vue-best-practices/references/perf-avoid-component-abstraction-in-lists.md +159 -159
- package/.agents/skills/profiles/vue/vue-best-practices/references/perf-v-once-v-memo-directives.md +182 -182
- package/.agents/skills/profiles/vue/vue-best-practices/references/perf-virtualize-large-lists.md +187 -187
- package/.agents/skills/profiles/vue/vue-best-practices/references/plugins.md +166 -166
- package/.agents/skills/profiles/vue/vue-best-practices/references/reactivity.md +344 -344
- package/.agents/skills/profiles/vue/vue-best-practices/references/render-functions.md +201 -201
- package/.agents/skills/profiles/vue/vue-best-practices/references/sfc.md +310 -310
- package/.agents/skills/profiles/vue/vue-best-practices/references/state-management.md +135 -135
- package/.agents/skills/profiles/vue/vue-best-practices/references/updated-hook-performance.md +187 -187
- package/.agents/templates/common/README.md +23 -23
- package/.agents/templates/common/bugfix.md +22 -22
- package/.agents/templates/common/create-expert-package.md +458 -458
- package/.agents/templates/common/mock-page.md +28 -28
- package/.agents/templates/common/new-component.md +25 -25
- package/.agents/templates/common/new-page.md +31 -31
- package/.cursor/mcp.json +35 -35
- package/.qoder/mcp.json +26 -26
- package/bin/archive-change.js +560 -474
- package/bin/check-command.js +62 -62
- package/bin/cli.js +0 -0
- package/bin/command-template-renderer.js +40 -40
- package/bin/context-command.js +102 -102
- package/bin/demo-runtime-smoke.js +760 -760
- package/bin/execution-semantics.js +821 -821
- package/bin/executor-command.js +93 -93
- package/bin/expert-dispatch.js +334 -334
- package/bin/expert-executor.js +1148 -1148
- package/bin/guard-command.js +52 -52
- package/bin/hub-command.js +876 -876
- package/bin/ide-command.js +242 -242
- package/bin/init-command.js +193 -193
- package/bin/install-workflow.js +35 -3
- package/bin/manifest-export.js +34 -34
- package/bin/profile-registry.js +90 -90
- package/bin/protocol-workflow.js +452 -446
- package/bin/repair-command.js +161 -161
- package/bin/repo-map.js +177 -177
- package/bin/report-command.js +236 -236
- package/bin/runtime-bootstrap.js +428 -428
- package/bin/runtime-embedded.js +101 -101
- package/bin/runtime-fallback.js +106 -106
- package/bin/runtime-launcher.js +116 -116
- package/bin/runtime-paths.js +177 -177
- package/bin/runtime-registry.js +289 -289
- package/bin/runtime-state.js +2541 -2541
- package/bin/scan.js +96 -96
- package/bin/self-upgrade.js +206 -206
- package/bin/skill-spec-validator.js +457 -457
- package/bin/spec-command.js +366 -366
- package/bin/superpowers.js +384 -384
- package/bin/sync-command.js +59 -59
- package/bin/sync.js +1904 -1904
- package/bin/task-orchestrator-adapter.js +341 -341
- package/bin/task-orchestrator-extractor.js +274 -274
- package/bin/task-orchestrator-runner.js +1208 -1208
- package/bin/telemetry/README.md +66 -66
- package/bin/telemetry/aspect.js +153 -153
- package/bin/telemetry/collect.js +67 -67
- package/bin/telemetry/config.js +114 -114
- package/bin/telemetry/defaults.json +5 -5
- package/bin/telemetry/healthcheck.js +195 -195
- package/bin/telemetry/identity.js +53 -53
- package/bin/telemetry/index.js +25 -25
- package/bin/telemetry/reporter.js +83 -83
- package/bin/telemetry/safe.js +39 -39
- package/bin/validate-registry.js +740 -740
- package/bin/visual-bridge-config.js +117 -117
- package/bin/visual-bridge.js +287 -287
- package/bin/visual-command.js +432 -432
- package/bin/worktree-command.js +194 -194
- package/configs/common/.editorconfig +15 -15
- package/configs/common/.husky/commit-msg +4 -4
- package/configs/common/.husky/pre-commit +4 -4
- package/configs/common/.lintstagedrc +11 -11
- package/configs/common/.prettierignore +11 -11
- package/configs/common/.prettierrc.json +11 -11
- package/configs/common/.stylelintignore +14 -14
- package/configs/common/.stylelintrc.json +21 -21
- package/configs/common/commitlint.config.js +3 -3
- package/configs/profiles/nestjs/.gitkeep +1 -1
- package/configs/profiles/node-tooling/.gitkeep +1 -1
- package/configs/profiles/react/.eslintignore +6 -6
- package/configs/profiles/react/.eslintrc.js +16 -16
- package/configs/profiles/react/.stylelintrc.json +18 -18
- package/configs/profiles/springboot/.gitkeep +1 -1
- package/configs/profiles/vue/.eslintignore +6 -6
- package/configs/profiles/vue/.eslintrc.cjs +17 -17
- package/contracts/README.md +28 -28
- package/contracts/fixtures/asset-package.fixture.json +26 -26
- package/contracts/fixtures/asset-usage-feedback.fixture.json +14 -14
- package/contracts/fixtures/evidence-report.fixture.json +28 -28
- package/contracts/fixtures/manifest.fixture.json +20 -20
- package/contracts/fixtures/run-event.fixture.json +15 -15
- package/contracts/schemas/asset-package.schema.json +76 -76
- package/contracts/schemas/asset-usage-feedback.schema.json +57 -57
- package/contracts/schemas/evidence-report.schema.json +60 -60
- package/contracts/schemas/manifest.schema.json +63 -63
- package/contracts/schemas/run-event.schema.json +72 -72
- package/install.ps1 +35 -35
- package/install.sh +17 -17
- package/internal/ai-protocol-workflow.js +5824 -5600
- package/internal/hub-client.js +98 -98
- package/internal/hub-sync-selection.js +69 -69
- package/internal/visual-hooks/README.md +481 -481
- package/internal/visual-hooks/config-loader.js +218 -218
- package/internal/visual-hooks/control-puller.js +206 -206
- package/internal/visual-hooks/gate-signal.js +150 -150
- package/internal/visual-hooks/inbox-consumer.js +469 -469
- package/internal/visual-hooks/index.js +197 -197
- package/internal/visual-hooks/push-client.js +189 -189
- package/internal/visual-hooks/receipt-pusher.js +176 -176
- package/internal/visual-hooks/runtime-state-pusher.js +128 -128
- package/openspec/config.yaml.template +52 -52
- package/openspec/schemas/expert-delivery/schema.yaml +68 -68
- package/openspec/schemas/expert-delivery/templates/checklist.md +39 -39
- package/openspec/schemas/expert-delivery/templates/design.md +61 -61
- package/openspec/schemas/expert-delivery/templates/iterations.md +25 -25
- package/openspec/schemas/expert-delivery/templates/proposal.md +45 -45
- package/openspec/schemas/expert-delivery/templates/spec.md +29 -29
- package/openspec/schemas/expert-delivery/templates/tasks.md +24 -24
- package/package.json +1 -1
- package/scripts/acceptance-zero-intrusion.sh +168 -168
- package/scripts/hub-sync-assets.config.example.json +296 -296
- package/scripts/hub-sync-assets.js +2038 -2038
- package/scripts/local-verify.sh +280 -280
- package/scripts/post-publish-auto-fix-check.js +404 -404
- package/scripts/post-publish-verify.sh +175 -175
- package/scripts/setup-cursor-manual-test.sh +107 -107
- package/scripts/setup-cursor-spec-archive-test.sh +111 -111
- package/scripts/setup-visual-integration.sh +225 -225
- package/scripts/test-integration.sh +176 -176
- package/scripts/update-test-project.sh +93 -93
- package/scripts/upload-four-web.sh +57 -57
- package/scripts/verify-install-ps1-bom.js +26 -26
- package/src/agent/agent-context.js +259 -259
- package/src/agent/agent-profile.js +185 -185
- package/src/agent/agent-templates.js +161 -161
- package/src/agent/agent-types.js +108 -108
- package/src/agent/collaboration-protocol.js +333 -333
- package/src/agent/conflict-handler.js +364 -364
- package/src/agent/file-permission.js +121 -121
- package/src/agent/index.js +38 -38
- package/src/agent/permission-audit.js +151 -151
- package/src/agent/review-repair-loop.js +270 -270
- package/src/agent/tool-permission.js +101 -101
- package/src/asset/asset-dependency.js +322 -322
- package/src/asset/asset-feedback.js +350 -350
- package/src/asset/asset-fork.js +300 -300
- package/src/asset/asset-install.js +278 -278
- package/src/asset/asset-installer.js +497 -497
- package/src/asset/asset-lifecycle.js +324 -324
- package/src/asset/asset-manager.js +245 -245
- package/src/asset/asset-package-manager.js +349 -349
- package/src/asset/asset-package.js +186 -186
- package/src/asset/asset-quality.js +262 -262
- package/src/asset/asset-registry.js +387 -387
- package/src/asset/asset-version.js +293 -293
- package/src/asset/index.js +86 -86
- package/src/cache/agent-profile-cache.js +59 -59
- package/src/cache/asset-cache.js +63 -63
- package/src/cache/global-cache.js +61 -61
- package/src/cache/manifest-cache.js +30 -30
- package/src/check/check-service.js +32 -32
- package/src/config/config-layer.js +343 -343
- package/src/config/config-loader.js +60 -60
- package/src/config/defaults.js +49 -49
- package/src/connectors/hub/asset-package.js +72 -72
- package/src/connectors/hub/asset-usage-feedback.js +46 -46
- package/src/connectors/hub/hub-connector.js +44 -44
- package/src/connectors/hub/index.js +21 -21
- package/src/connectors/visual/evidence-report.js +49 -49
- package/src/connectors/visual/index.js +15 -15
- package/src/connectors/visual/queue.js +41 -41
- package/src/connectors/visual/run-event.js +81 -81
- package/src/connectors/visual/visual-connector.js +77 -77
- package/src/context/context-budget.js +59 -59
- package/src/context/context-builder.js +285 -285
- package/src/context/context-loader.js +116 -116
- package/src/context/context-planner.js +158 -158
- package/src/context/types.js +96 -96
- package/src/contracts/index.js +63 -63
- package/src/executor/executor-registry.js +78 -78
- package/src/executor/executor-result-parser.js +44 -44
- package/src/executor/executor-runner.js +141 -141
- package/src/executor/executor-selector.js +139 -139
- package/src/executor/executor-timeout.js +36 -36
- package/src/executor/providers/base-provider-utils.js +189 -189
- package/src/executor/providers/claude-code-executor-provider.js +128 -128
- package/src/executor/providers/codex-executor-provider.js +126 -126
- package/src/executor/providers/cursor-executor-provider.js +99 -99
- package/src/executor/types.js +137 -137
- package/src/git/branch-manager.js +71 -71
- package/src/git/dirty-checker.js +43 -43
- package/src/git/dirty-strategy-handler.js +29 -29
- package/src/git/git-command.js +37 -37
- package/src/git/git-repository-detector.js +45 -45
- package/src/git/multi-repo-worktree-planner.js +88 -88
- package/src/git/policy.js +19 -19
- package/src/git/strategies/block-dirty-strategy.js +34 -34
- package/src/git/strategies/ignore-dirty-strategy.js +33 -33
- package/src/git/strategies/patch-snapshot-strategy.js +53 -53
- package/src/git/strategies/wip-commit-strategy.js +38 -38
- package/src/git/types.js +71 -71
- package/src/git/worktree-manager.js +85 -85
- package/src/governance/asset-review.js +351 -351
- package/src/governance/audit-log.js +368 -368
- package/src/governance/gray-release.js +312 -312
- package/src/governance/index.js +31 -31
- package/src/governance/policy-types.js +56 -56
- package/src/governance/rbac-types.js +171 -171
- package/src/governance/rbac.js +382 -382
- package/src/governance/rollback.js +360 -360
- package/src/governance/security-policy.js +354 -354
- package/src/hook/hook-config-writer.js +125 -125
- package/src/hub/hub-client.js +186 -186
- package/src/hub/hub-config.js +39 -39
- package/src/hub/project-facts.js +31 -31
- package/src/hub/runtime-feedback-reporter.js +55 -55
- package/src/ide/adapters/adapter-protocol.js +385 -385
- package/src/ide/adapters/claude-adapter.js +419 -419
- package/src/ide/adapters/codex-adapter.js +60 -60
- package/src/ide/adapters/cursor-adapter.js +484 -484
- package/src/ide/adapters/index.js +24 -24
- package/src/ide/anchors/markdown-anchor-writer.js +152 -152
- package/src/ide/ide-service.js +270 -270
- package/src/ide/ide-types.js +94 -94
- package/src/ide/links/link-mode-resolver.js +160 -160
- package/src/ide/registry/ide-registry-builder.js +165 -165
- package/src/incident/incident-writer.js +47 -47
- package/src/incident/types.js +22 -22
- package/src/init/ide-linker.js +126 -126
- package/src/init/ide-pointer-injector.js +75 -75
- package/src/init/init-applier.js +197 -197
- package/src/init/init-plan.js +294 -294
- package/src/init/init-service.js +65 -65
- package/src/init/manifest-installer.js +302 -302
- package/src/init/types.js +26 -26
- package/src/project/config-writer.js +83 -83
- package/src/project/context-index-writer.js +82 -82
- package/src/project/json-utils.js +72 -72
- package/src/project/local-state-writer.js +50 -50
- package/src/project/lock-file-writer.js +98 -98
- package/src/project/manifest-writer.js +126 -126
- package/src/project/policy-config-writer.js +91 -91
- package/src/project/project-config-writer.js +74 -74
- package/src/project/project-files.js +39 -39
- package/src/project/registry-index-writer.js +43 -43
- package/src/project/workspace-config-writer.js +63 -63
- package/src/run/index.js +11 -11
- package/src/run/run-id.js +32 -32
- package/src/run/run-service.js +269 -269
- package/src/run/run-store.js +80 -80
- package/src/scanner/aggregator/detection-aggregator.js +23 -23
- package/src/scanner/boundary/boundary-resolver.js +229 -229
- package/src/scanner/detectors/detector-registry.js +44 -44
- package/src/scanner/detectors/fastapi-detector.js +46 -46
- package/src/scanner/detectors/go-detector.js +46 -46
- package/src/scanner/detectors/nestjs-detector.js +57 -57
- package/src/scanner/detectors/nextjs-detector.js +52 -52
- package/src/scanner/detectors/react-vite-detector.js +52 -52
- package/src/scanner/detectors/react-webpack-detector.js +57 -57
- package/src/scanner/detectors/springboot-detector.js +46 -46
- package/src/scanner/detectors/springcloud-detector.js +46 -46
- package/src/scanner/detectors/springmvc-detector.js +46 -46
- package/src/scanner/detectors/vue-vite-detector.js +52 -52
- package/src/scanner/engine.js +72 -72
- package/src/scanner/facts/fact-extractor.js +211 -211
- package/src/scanner/types.js +30 -30
- package/src/security/asset-tamper-checker.js +188 -188
- package/src/security/checksum.js +40 -40
- package/src/spec/spec-writer.js +302 -302
- package/src/state-machine/circuit-breaker.js +112 -112
- package/src/state-machine/escape-hatch.js +49 -49
- package/src/state-machine/stage-runner.js +281 -281
- package/src/state-machine/state-machine.js +24 -24
- package/src/state-machine/transition-guard.js +36 -36
- package/src/state-machine/types.js +37 -37
- package/src/sync/sync-service.js +192 -192
- package/src/visual/agent-visual.js +142 -142
- package/src/visual/event-gateway.js +357 -357
- package/src/visual/event-mapper.js +128 -128
- package/src/visual/hook-dashboard.js +216 -216
- package/src/visual/index.js +27 -27
- package/src/visual/metrics.js +287 -287
- package/src/visual/privacy-filter.js +100 -100
- package/src/visual/risk-board.js +252 -252
- package/src/visual/timeline.js +245 -245
- package/src/visual/visual-client.js +94 -94
- package/src/visual/visual-config.js +40 -40
- package/src/visual/visual-reporter.js +88 -88
|
@@ -1,260 +1,260 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: install-ai-spec-auto
|
|
3
|
-
description: 当用户要求给当前项目接入 ai-spec-auto(安装工具)、自动执行 init(初始化安装) 命令、安装规则/技能/OpenSpec(需求规范流程) 或完成首次安装时,使用本技能自动检查前置条件、推断 profile(技术栈) 与安装目标,并在当前项目执行安装和自检。
|
|
4
|
-
compatibility: 需要当前工作区可执行 Node.js(运行时) 与 npm(包管理工具) 或 pnpm(包管理工具),并且能够访问 @ex 内网 registry(包仓库)。前端项目通常包含 package.json;NestJS/Node 后端项目包含 package.json + @nestjs/core;Spring Boot 后端项目包含 pom.xml 或 build.gradle;Node 工具仓通常包含 package.json + tsconfig.json。同一仓库存在多个技术栈子包时(如 Vue + NestJS),在根目录执行一次安装,写入多 profile manifest。
|
|
5
|
-
metadata:
|
|
6
|
-
version: "1.2.0"
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# ai-spec-auto 安装初始化
|
|
10
|
-
|
|
11
|
-
## 定位
|
|
12
|
-
|
|
13
|
-
本技能负责把 `ai-spec-auto(安装工具)` 安装到当前项目,并执行首次 `init(初始化安装)`。
|
|
14
|
-
|
|
15
|
-
职责边界:
|
|
16
|
-
|
|
17
|
-
- 本技能负责安装前检查、命令执行、安装后自检与结果摘要
|
|
18
|
-
- `project-init(项目规范初始化)` 负责安装完成后的项目规则生成,不负责首次安装
|
|
19
|
-
- `update(更新)`、`check(自检)`、`uninstall(卸载)` 不属于本技能主路径
|
|
20
|
-
|
|
21
|
-
## 触发条件
|
|
22
|
-
|
|
23
|
-
当用户表达以下意思时,调用本技能:
|
|
24
|
-
|
|
25
|
-
- "给当前项目安装 ai-spec-auto"
|
|
26
|
-
- "帮我在这个仓库执行 init"
|
|
27
|
-
- "帮我把这套规范接入当前项目"
|
|
28
|
-
- "自动初始化安装规则和技能"
|
|
29
|
-
- "给别人项目快速装上这套 ai 规范"
|
|
30
|
-
- "在当前项目执行 ai-spec-auto init"
|
|
31
|
-
|
|
32
|
-
以下场景不要触发:
|
|
33
|
-
|
|
34
|
-
- 用户明确要执行 `project-init(项目规范初始化)`
|
|
35
|
-
- 用户只想执行 `update(更新)`、`check(自检)` 或 `uninstall(卸载)`
|
|
36
|
-
- 用户想创建一个新的 `skill(技能)`
|
|
37
|
-
- 用户只是问安装文档位置,没有要求执行安装
|
|
38
|
-
|
|
39
|
-
## 执行原则
|
|
40
|
-
|
|
41
|
-
- 默认直接执行命令,不先输出长篇安装说明
|
|
42
|
-
- 尽量使用显式参数,避免用户卡在交互式选择
|
|
43
|
-
- 能自动推断的内容就自动推断;只有高风险歧义时才确认
|
|
44
|
-
- 默认启用 `--custom-rules(自定义规则)`,让 `init(初始化安装)` 自动勾选当前支持按项目自定义生成的全部规则
|
|
45
|
-
- 已安装项目优先提醒使用 `check(自检)` 或 `update(更新)`,除非用户明确要求重装
|
|
46
|
-
|
|
47
|
-
## 安装前核对清单
|
|
48
|
-
|
|
49
|
-
- [ ] 当前目录或目标目录是要安装的业务项目
|
|
50
|
-
- [ ] 本机可执行 `node(运行时)` 与 `npm(包管理工具)` 或 `pnpm(包管理工具)`
|
|
51
|
-
- [ ] `~/.npmrc` 已配置 `@engineered:registry=https://registry.npmjs.org/`
|
|
52
|
-
- [ ] 已判断当前项目是否已安装,避免误把重复安装当成首次接入
|
|
53
|
-
|
|
54
|
-
## 自动判断规则
|
|
55
|
-
|
|
56
|
-
### 1. 是否已安装
|
|
57
|
-
|
|
58
|
-
以下任一条件成立,都视为项目已经接入过:
|
|
59
|
-
|
|
60
|
-
- 存在 `.ai-spec/install-state.json`
|
|
61
|
-
- 存在 `.agents/`
|
|
62
|
-
- 存在 `openspec/`
|
|
63
|
-
|
|
64
|
-
处理方式:
|
|
65
|
-
|
|
66
|
-
- 已安装且用户没有明确要求重装:优先执行 `check(自检)`,必要时建议 `update(更新)`
|
|
67
|
-
- 已安装且用户明确要求重装:允许继续执行 `init(初始化安装)`,但要先说明会覆盖受管安装产物
|
|
68
|
-
|
|
69
|
-
### 2. 推断 profile(技术栈)
|
|
70
|
-
|
|
71
|
-
按下面顺序判断:
|
|
72
|
-
|
|
73
|
-
1. 已存在 `.ai-spec/manifest.json` 且包含 `profile` / `profiles` 字段 → 直接使用已记录的值
|
|
74
|
-
2. `package.json` 中存在 `vue`、`@vitejs/plugin-vue`、`nuxt` 等依赖 → 命中 `vue`
|
|
75
|
-
3. `package.json` 中存在 `react`、`next`、`@vitejs/plugin-react` 等依赖 → 命中 `react`
|
|
76
|
-
4. `package.json` 中存在 `@nestjs/core`、`@nestjs/common` 等依赖 → 命中 `nestjs`
|
|
77
|
-
5. 存在 `pom.xml` 或 `build.gradle`(且无 `package.json`)→ 命中 `springboot`(待确认)
|
|
78
|
-
6. 存在 `package.json` + 主要依赖为工具链相关(commander、yargs、zod 等),且无 UI/服务端框架 → 命中 `node-tooling`(待确认)
|
|
79
|
-
7. 命中结果处理:
|
|
80
|
-
- 命中 **1 个** profile 且置信度高 → 直接使用,执行前说明推断结果
|
|
81
|
-
- 命中 **多个** profile(如 `vue` + `nestjs`)→ 进入"多 profile 确认"流程(见下方)
|
|
82
|
-
- 命中 **0 个** 或置信度低 → 进入"用户手动选择"流程(见下方)
|
|
83
|
-
|
|
84
|
-
#### 多 profile 确认(自动命中多个时)
|
|
85
|
-
|
|
86
|
-
展示推断结果,让用户确认或补充:
|
|
87
|
-
|
|
88
|
-
```
|
|
89
|
-
检测到以下技术栈:
|
|
90
|
-
[x] vue packages/front/
|
|
91
|
-
[x] nestjs packages/server/
|
|
92
|
-
|
|
93
|
-
请确认或修改,然后继续。
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
#### 用户手动选择(无法自动推断时)
|
|
97
|
-
|
|
98
|
-
展示多选提示,**允许选择多个**:
|
|
99
|
-
|
|
100
|
-
```
|
|
101
|
-
请选择当前项目的技术栈(可多选,空格选中,回车确认):
|
|
102
|
-
|
|
103
|
-
[ ] vue Frontend / Vue
|
|
104
|
-
[ ] react Frontend / React
|
|
105
|
-
[ ] nestjs Backend / NestJS
|
|
106
|
-
[ ] springboot Backend / Spring Boot
|
|
107
|
-
[ ] node-tooling Tooling / Node.js
|
|
108
|
-
|
|
109
|
-
> 选择后按回车继续
|
|
110
|
-
```
|
|
111
|
-
|
|
112
|
-
**不得默认勾选任何项,不得在用户未确认时擅自写入。**
|
|
113
|
-
|
|
114
|
-
### 3. 判断安装目标
|
|
115
|
-
|
|
116
|
-
- 当前目录本身就是单技术栈业务包:直接对 `.(当前目录)` 安装
|
|
117
|
-
- 同一仓库包含多个技术栈子包:在**根目录**安装,写多 profile manifest
|
|
118
|
-
- 单包仓库:直接执行 `init .`
|
|
119
|
-
|
|
120
|
-
### 4. 选择命令入口
|
|
121
|
-
|
|
122
|
-
单 profile 时,优先使用:
|
|
123
|
-
|
|
124
|
-
```bash
|
|
125
|
-
npx @engineered/ai-spec-auto@latest init . --profile <profile> --custom-rules
|
|
126
|
-
```
|
|
127
|
-
|
|
128
|
-
其中 `<profile>` 为 `vue`、`react`、`nestjs`、`springboot` 或 `node-tooling`。
|
|
129
|
-
|
|
130
|
-
多 profile 时,传入逗号分隔的 profiles:
|
|
131
|
-
|
|
132
|
-
```bash
|
|
133
|
-
npx @engineered/ai-spec-auto@latest init . --profiles vue,nestjs --custom-rules
|
|
134
|
-
```
|
|
135
|
-
|
|
136
|
-
仅在"当前工作区就是 `ai-spec-auto(安装工具)` 源码仓库,且用户明确要走本地源码调试安装"时,才改用:
|
|
137
|
-
|
|
138
|
-
```bash
|
|
139
|
-
node ./bin/cli.js init <target> --profile <profile> --custom-rules
|
|
140
|
-
```
|
|
141
|
-
|
|
142
|
-
### 5. 自定义规则选择策略
|
|
143
|
-
|
|
144
|
-
本技能默认把 `--custom-rules(自定义规则)` 作为首次安装命令的一部分。
|
|
145
|
-
|
|
146
|
-
原因:
|
|
147
|
-
|
|
148
|
-
- 底层 `install-workflow(安装主链)` 已支持在非交互模式下把全部可自定义规则自动选中
|
|
149
|
-
- 这样安装完成后,`project-init(项目规范初始化)` 会按项目事实补齐和刷新这些规则,而不是沿用固定模板
|
|
150
|
-
- 这符合"自动初始化安装"的目标,不需要用户再手动进入交互界面逐条勾选
|
|
151
|
-
|
|
152
|
-
各 profile 支持自动全选的规则集由 `profiles.json` 中的 `project_init_rule_ids` 字段决定。
|
|
153
|
-
|
|
154
|
-
如果用户明确要求"沿用标准模板,不要自定义规则",才改用 `--standard-rules(标准规则)`,不要同时传两者。
|
|
155
|
-
|
|
156
|
-
## 标准工作流
|
|
157
|
-
|
|
158
|
-
Progress:
|
|
159
|
-
- [ ] 1. 读取项目标记文件(`package.json` / `pom.xml` / `build.gradle`)、目录结构、`.npmrc`
|
|
160
|
-
- [ ] 2. 判断是否已安装、是否多 profile 场景、确定或推断 `profile(技术栈)`
|
|
161
|
-
- [ ] 3. 组装并实际执行 `init(初始化安装)` 命令
|
|
162
|
-
- [ ] 4. 安装完成后执行 `check(自检)` 或核对关键安装产物
|
|
163
|
-
- [ ] 5. 输出简短安装摘要,并提示下一步执行 `project-init(项目规范初始化)`
|
|
164
|
-
|
|
165
|
-
## 详细步骤
|
|
166
|
-
|
|
167
|
-
### 第一步:环境与仓库检查
|
|
168
|
-
|
|
169
|
-
至少检查以下事实:
|
|
170
|
-
|
|
171
|
-
- 项目标记文件是否存在(`package.json` / `pom.xml` / `build.gradle`)
|
|
172
|
-
- `node -v`、`npm -v` 是否可用
|
|
173
|
-
- `~/.npmrc` 是否包含 `@engineered:registry=https://registry.npmjs.org/`
|
|
174
|
-
- 是否已存在 `.ai-spec/install-state.json`、`.agents/`、`openspec/`
|
|
175
|
-
|
|
176
|
-
如果发现 `registry(包仓库)` 配置缺失:
|
|
177
|
-
|
|
178
|
-
- 明确告诉用户当前阻塞点
|
|
179
|
-
- 给出准确修复命令
|
|
180
|
-
- 不要假装已经安装成功
|
|
181
|
-
|
|
182
|
-
### 第二步:构造非交互命令
|
|
183
|
-
|
|
184
|
-
默认应显式传入 `--profile(技术栈)`,避免安装过程进入交互式选择。
|
|
185
|
-
默认还应显式传入 `--custom-rules(自定义规则)`,让所有支持按项目自定义的规则自动全选。
|
|
186
|
-
|
|
187
|
-
单 profile 安装命令:
|
|
188
|
-
|
|
189
|
-
```bash
|
|
190
|
-
npx @engineered/ai-spec-auto@latest init . --profile <profile> --custom-rules
|
|
191
|
-
```
|
|
192
|
-
|
|
193
|
-
多 profile(同一仓库含多技术栈子包)安装命令:
|
|
194
|
-
|
|
195
|
-
```bash
|
|
196
|
-
npx @engineered/ai-spec-auto@latest init . --profiles vue,nestjs --custom-rules
|
|
197
|
-
```
|
|
198
|
-
|
|
199
|
-
如用户提供 `manifest(安装清单)`,命令改为:
|
|
200
|
-
|
|
201
|
-
```bash
|
|
202
|
-
npx @engineered/ai-spec-auto@latest init . --profile <profile> --custom-rules --manifest <file-or-url>
|
|
203
|
-
```
|
|
204
|
-
|
|
205
|
-
### 第三步:执行安装
|
|
206
|
-
|
|
207
|
-
- 真正执行命令,不要只把命令贴给用户
|
|
208
|
-
- 执行前用一句话说明:安装目标、推断出的 `profile(技术栈)` 或多 profile 列表
|
|
209
|
-
- 若项目已安装且用户没有明确要求重装,不要强行再跑 `init(初始化安装)`
|
|
210
|
-
|
|
211
|
-
### 第四步:安装后验证
|
|
212
|
-
|
|
213
|
-
优先执行:
|
|
214
|
-
|
|
215
|
-
```bash
|
|
216
|
-
npx @engineered/ai-spec-auto@latest check .
|
|
217
|
-
```
|
|
218
|
-
|
|
219
|
-
如果当前环境不适合再次走 `npx(包执行命令)`,至少核对:
|
|
220
|
-
|
|
221
|
-
- `.agents/`
|
|
222
|
-
- `.ai-spec/install-state.json`
|
|
223
|
-
- `openspec/`(完整安装时)
|
|
224
|
-
- `.cursor/`、`.claude/` 等 `IDE(开发工具)` 入口目录
|
|
225
|
-
|
|
226
|
-
### 第五步:结果摘要
|
|
227
|
-
|
|
228
|
-
结果摘要至少包含:
|
|
229
|
-
|
|
230
|
-
- 安装目标目录
|
|
231
|
-
- 实际执行的命令
|
|
232
|
-
- 判定出的 `profile(技术栈)` 或多 profile 列表
|
|
233
|
-
- 是否首次安装 / 已安装改走 `check(自检)`
|
|
234
|
-
- 验证结果
|
|
235
|
-
- 下一步建议:`project-init(项目规范初始化)` 或"初始化项目规范"
|
|
236
|
-
|
|
237
|
-
## Gotchas(易错点)
|
|
238
|
-
|
|
239
|
-
- 不要把 `project-init(项目规范初始化)` 当成首次安装命令
|
|
240
|
-
- 不要忘记追加 `--custom-rules(自定义规则)`,否则非交互模式会回退到标准规则
|
|
241
|
-
- **无法推断 profile 时,不得默认为 `vue`**,必须展示多选提示让用户明确选择
|
|
242
|
-
- 兜底提示必须是**多选**,不能是单选数字列表——用户可能同时需要 vue + nestjs
|
|
243
|
-
- 同一仓库含多技术栈子包时,**在根目录安装**,写多 profile manifest;不要分别进入子包目录各自安装一套 `.agents/`
|
|
244
|
-
- NestJS 项目依据 `@nestjs/core` 依赖识别,**不要把它归为 `node-tooling`**
|
|
245
|
-
- 不要漏掉 `@ex:registry(内网包仓库)` 检查,否则 `npx(包执行命令)` 很可能失败
|
|
246
|
-
- 不要只输出命令,不实际执行
|
|
247
|
-
- 已安装项目如果只需要检查状态,优先走 `check(自检)`,不要机械重复 `init(初始化安装)`
|
|
248
|
-
- Spring Boot 项目不一定存在 `package.json`,不要因为缺少 `package.json` 就直接报错或跳过
|
|
249
|
-
|
|
250
|
-
## 验证标准
|
|
251
|
-
|
|
252
|
-
1. 已成功执行 `init(初始化安装)` 或在已安装场景下正确改走 `check(自检)`
|
|
253
|
-
2. 用户能从摘要里看到安装目标、命令、技术栈和验证结果
|
|
254
|
-
3. 输出明确区分"安装完成"与"下一步执行 `project-init(项目规范初始化)`"
|
|
255
|
-
|
|
256
|
-
## 资源导航
|
|
257
|
-
|
|
258
|
-
- [README.md](/Users/lizhenwei/workspace/vueworkspace/bairong/br-ai-spec/README.md)
|
|
259
|
-
- [docs/install-guide.md](/Users/lizhenwei/workspace/vueworkspace/bairong/br-ai-spec/docs/install-guide.md)
|
|
260
|
-
- [bin/install-workflow.js](/Users/lizhenwei/workspace/vueworkspace/bairong/br-ai-spec/bin/install-workflow.js)
|
|
1
|
+
---
|
|
2
|
+
name: install-ai-spec-auto
|
|
3
|
+
description: 当用户要求给当前项目接入 ai-spec-auto(安装工具)、自动执行 init(初始化安装) 命令、安装规则/技能/OpenSpec(需求规范流程) 或完成首次安装时,使用本技能自动检查前置条件、推断 profile(技术栈) 与安装目标,并在当前项目执行安装和自检。
|
|
4
|
+
compatibility: 需要当前工作区可执行 Node.js(运行时) 与 npm(包管理工具) 或 pnpm(包管理工具),并且能够访问 @ex 内网 registry(包仓库)。前端项目通常包含 package.json;NestJS/Node 后端项目包含 package.json + @nestjs/core;Spring Boot 后端项目包含 pom.xml 或 build.gradle;Node 工具仓通常包含 package.json + tsconfig.json。同一仓库存在多个技术栈子包时(如 Vue + NestJS),在根目录执行一次安装,写入多 profile manifest。
|
|
5
|
+
metadata:
|
|
6
|
+
version: "1.2.0"
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# ai-spec-auto 安装初始化
|
|
10
|
+
|
|
11
|
+
## 定位
|
|
12
|
+
|
|
13
|
+
本技能负责把 `ai-spec-auto(安装工具)` 安装到当前项目,并执行首次 `init(初始化安装)`。
|
|
14
|
+
|
|
15
|
+
职责边界:
|
|
16
|
+
|
|
17
|
+
- 本技能负责安装前检查、命令执行、安装后自检与结果摘要
|
|
18
|
+
- `project-init(项目规范初始化)` 负责安装完成后的项目规则生成,不负责首次安装
|
|
19
|
+
- `update(更新)`、`check(自检)`、`uninstall(卸载)` 不属于本技能主路径
|
|
20
|
+
|
|
21
|
+
## 触发条件
|
|
22
|
+
|
|
23
|
+
当用户表达以下意思时,调用本技能:
|
|
24
|
+
|
|
25
|
+
- "给当前项目安装 ai-spec-auto"
|
|
26
|
+
- "帮我在这个仓库执行 init"
|
|
27
|
+
- "帮我把这套规范接入当前项目"
|
|
28
|
+
- "自动初始化安装规则和技能"
|
|
29
|
+
- "给别人项目快速装上这套 ai 规范"
|
|
30
|
+
- "在当前项目执行 ai-spec-auto init"
|
|
31
|
+
|
|
32
|
+
以下场景不要触发:
|
|
33
|
+
|
|
34
|
+
- 用户明确要执行 `project-init(项目规范初始化)`
|
|
35
|
+
- 用户只想执行 `update(更新)`、`check(自检)` 或 `uninstall(卸载)`
|
|
36
|
+
- 用户想创建一个新的 `skill(技能)`
|
|
37
|
+
- 用户只是问安装文档位置,没有要求执行安装
|
|
38
|
+
|
|
39
|
+
## 执行原则
|
|
40
|
+
|
|
41
|
+
- 默认直接执行命令,不先输出长篇安装说明
|
|
42
|
+
- 尽量使用显式参数,避免用户卡在交互式选择
|
|
43
|
+
- 能自动推断的内容就自动推断;只有高风险歧义时才确认
|
|
44
|
+
- 默认启用 `--custom-rules(自定义规则)`,让 `init(初始化安装)` 自动勾选当前支持按项目自定义生成的全部规则
|
|
45
|
+
- 已安装项目优先提醒使用 `check(自检)` 或 `update(更新)`,除非用户明确要求重装
|
|
46
|
+
|
|
47
|
+
## 安装前核对清单
|
|
48
|
+
|
|
49
|
+
- [ ] 当前目录或目标目录是要安装的业务项目
|
|
50
|
+
- [ ] 本机可执行 `node(运行时)` 与 `npm(包管理工具)` 或 `pnpm(包管理工具)`
|
|
51
|
+
- [ ] `~/.npmrc` 已配置 `@engineered:registry=https://registry.npmjs.org/`
|
|
52
|
+
- [ ] 已判断当前项目是否已安装,避免误把重复安装当成首次接入
|
|
53
|
+
|
|
54
|
+
## 自动判断规则
|
|
55
|
+
|
|
56
|
+
### 1. 是否已安装
|
|
57
|
+
|
|
58
|
+
以下任一条件成立,都视为项目已经接入过:
|
|
59
|
+
|
|
60
|
+
- 存在 `.ai-spec/install-state.json`
|
|
61
|
+
- 存在 `.agents/`
|
|
62
|
+
- 存在 `openspec/`
|
|
63
|
+
|
|
64
|
+
处理方式:
|
|
65
|
+
|
|
66
|
+
- 已安装且用户没有明确要求重装:优先执行 `check(自检)`,必要时建议 `update(更新)`
|
|
67
|
+
- 已安装且用户明确要求重装:允许继续执行 `init(初始化安装)`,但要先说明会覆盖受管安装产物
|
|
68
|
+
|
|
69
|
+
### 2. 推断 profile(技术栈)
|
|
70
|
+
|
|
71
|
+
按下面顺序判断:
|
|
72
|
+
|
|
73
|
+
1. 已存在 `.ai-spec/manifest.json` 且包含 `profile` / `profiles` 字段 → 直接使用已记录的值
|
|
74
|
+
2. `package.json` 中存在 `vue`、`@vitejs/plugin-vue`、`nuxt` 等依赖 → 命中 `vue`
|
|
75
|
+
3. `package.json` 中存在 `react`、`next`、`@vitejs/plugin-react` 等依赖 → 命中 `react`
|
|
76
|
+
4. `package.json` 中存在 `@nestjs/core`、`@nestjs/common` 等依赖 → 命中 `nestjs`
|
|
77
|
+
5. 存在 `pom.xml` 或 `build.gradle`(且无 `package.json`)→ 命中 `springboot`(待确认)
|
|
78
|
+
6. 存在 `package.json` + 主要依赖为工具链相关(commander、yargs、zod 等),且无 UI/服务端框架 → 命中 `node-tooling`(待确认)
|
|
79
|
+
7. 命中结果处理:
|
|
80
|
+
- 命中 **1 个** profile 且置信度高 → 直接使用,执行前说明推断结果
|
|
81
|
+
- 命中 **多个** profile(如 `vue` + `nestjs`)→ 进入"多 profile 确认"流程(见下方)
|
|
82
|
+
- 命中 **0 个** 或置信度低 → 进入"用户手动选择"流程(见下方)
|
|
83
|
+
|
|
84
|
+
#### 多 profile 确认(自动命中多个时)
|
|
85
|
+
|
|
86
|
+
展示推断结果,让用户确认或补充:
|
|
87
|
+
|
|
88
|
+
```
|
|
89
|
+
检测到以下技术栈:
|
|
90
|
+
[x] vue packages/front/
|
|
91
|
+
[x] nestjs packages/server/
|
|
92
|
+
|
|
93
|
+
请确认或修改,然后继续。
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
#### 用户手动选择(无法自动推断时)
|
|
97
|
+
|
|
98
|
+
展示多选提示,**允许选择多个**:
|
|
99
|
+
|
|
100
|
+
```
|
|
101
|
+
请选择当前项目的技术栈(可多选,空格选中,回车确认):
|
|
102
|
+
|
|
103
|
+
[ ] vue Frontend / Vue
|
|
104
|
+
[ ] react Frontend / React
|
|
105
|
+
[ ] nestjs Backend / NestJS
|
|
106
|
+
[ ] springboot Backend / Spring Boot
|
|
107
|
+
[ ] node-tooling Tooling / Node.js
|
|
108
|
+
|
|
109
|
+
> 选择后按回车继续
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
**不得默认勾选任何项,不得在用户未确认时擅自写入。**
|
|
113
|
+
|
|
114
|
+
### 3. 判断安装目标
|
|
115
|
+
|
|
116
|
+
- 当前目录本身就是单技术栈业务包:直接对 `.(当前目录)` 安装
|
|
117
|
+
- 同一仓库包含多个技术栈子包:在**根目录**安装,写多 profile manifest
|
|
118
|
+
- 单包仓库:直接执行 `init .`
|
|
119
|
+
|
|
120
|
+
### 4. 选择命令入口
|
|
121
|
+
|
|
122
|
+
单 profile 时,优先使用:
|
|
123
|
+
|
|
124
|
+
```bash
|
|
125
|
+
npx @engineered/ai-spec-auto@latest init . --profile <profile> --custom-rules
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
其中 `<profile>` 为 `vue`、`react`、`nestjs`、`springboot` 或 `node-tooling`。
|
|
129
|
+
|
|
130
|
+
多 profile 时,传入逗号分隔的 profiles:
|
|
131
|
+
|
|
132
|
+
```bash
|
|
133
|
+
npx @engineered/ai-spec-auto@latest init . --profiles vue,nestjs --custom-rules
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
仅在"当前工作区就是 `ai-spec-auto(安装工具)` 源码仓库,且用户明确要走本地源码调试安装"时,才改用:
|
|
137
|
+
|
|
138
|
+
```bash
|
|
139
|
+
node ./bin/cli.js init <target> --profile <profile> --custom-rules
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
### 5. 自定义规则选择策略
|
|
143
|
+
|
|
144
|
+
本技能默认把 `--custom-rules(自定义规则)` 作为首次安装命令的一部分。
|
|
145
|
+
|
|
146
|
+
原因:
|
|
147
|
+
|
|
148
|
+
- 底层 `install-workflow(安装主链)` 已支持在非交互模式下把全部可自定义规则自动选中
|
|
149
|
+
- 这样安装完成后,`project-init(项目规范初始化)` 会按项目事实补齐和刷新这些规则,而不是沿用固定模板
|
|
150
|
+
- 这符合"自动初始化安装"的目标,不需要用户再手动进入交互界面逐条勾选
|
|
151
|
+
|
|
152
|
+
各 profile 支持自动全选的规则集由 `profiles.json` 中的 `project_init_rule_ids` 字段决定。
|
|
153
|
+
|
|
154
|
+
如果用户明确要求"沿用标准模板,不要自定义规则",才改用 `--standard-rules(标准规则)`,不要同时传两者。
|
|
155
|
+
|
|
156
|
+
## 标准工作流
|
|
157
|
+
|
|
158
|
+
Progress:
|
|
159
|
+
- [ ] 1. 读取项目标记文件(`package.json` / `pom.xml` / `build.gradle`)、目录结构、`.npmrc`
|
|
160
|
+
- [ ] 2. 判断是否已安装、是否多 profile 场景、确定或推断 `profile(技术栈)`
|
|
161
|
+
- [ ] 3. 组装并实际执行 `init(初始化安装)` 命令
|
|
162
|
+
- [ ] 4. 安装完成后执行 `check(自检)` 或核对关键安装产物
|
|
163
|
+
- [ ] 5. 输出简短安装摘要,并提示下一步执行 `project-init(项目规范初始化)`
|
|
164
|
+
|
|
165
|
+
## 详细步骤
|
|
166
|
+
|
|
167
|
+
### 第一步:环境与仓库检查
|
|
168
|
+
|
|
169
|
+
至少检查以下事实:
|
|
170
|
+
|
|
171
|
+
- 项目标记文件是否存在(`package.json` / `pom.xml` / `build.gradle`)
|
|
172
|
+
- `node -v`、`npm -v` 是否可用
|
|
173
|
+
- `~/.npmrc` 是否包含 `@engineered:registry=https://registry.npmjs.org/`
|
|
174
|
+
- 是否已存在 `.ai-spec/install-state.json`、`.agents/`、`openspec/`
|
|
175
|
+
|
|
176
|
+
如果发现 `registry(包仓库)` 配置缺失:
|
|
177
|
+
|
|
178
|
+
- 明确告诉用户当前阻塞点
|
|
179
|
+
- 给出准确修复命令
|
|
180
|
+
- 不要假装已经安装成功
|
|
181
|
+
|
|
182
|
+
### 第二步:构造非交互命令
|
|
183
|
+
|
|
184
|
+
默认应显式传入 `--profile(技术栈)`,避免安装过程进入交互式选择。
|
|
185
|
+
默认还应显式传入 `--custom-rules(自定义规则)`,让所有支持按项目自定义的规则自动全选。
|
|
186
|
+
|
|
187
|
+
单 profile 安装命令:
|
|
188
|
+
|
|
189
|
+
```bash
|
|
190
|
+
npx @engineered/ai-spec-auto@latest init . --profile <profile> --custom-rules
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
多 profile(同一仓库含多技术栈子包)安装命令:
|
|
194
|
+
|
|
195
|
+
```bash
|
|
196
|
+
npx @engineered/ai-spec-auto@latest init . --profiles vue,nestjs --custom-rules
|
|
197
|
+
```
|
|
198
|
+
|
|
199
|
+
如用户提供 `manifest(安装清单)`,命令改为:
|
|
200
|
+
|
|
201
|
+
```bash
|
|
202
|
+
npx @engineered/ai-spec-auto@latest init . --profile <profile> --custom-rules --manifest <file-or-url>
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
### 第三步:执行安装
|
|
206
|
+
|
|
207
|
+
- 真正执行命令,不要只把命令贴给用户
|
|
208
|
+
- 执行前用一句话说明:安装目标、推断出的 `profile(技术栈)` 或多 profile 列表
|
|
209
|
+
- 若项目已安装且用户没有明确要求重装,不要强行再跑 `init(初始化安装)`
|
|
210
|
+
|
|
211
|
+
### 第四步:安装后验证
|
|
212
|
+
|
|
213
|
+
优先执行:
|
|
214
|
+
|
|
215
|
+
```bash
|
|
216
|
+
npx @engineered/ai-spec-auto@latest check .
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
如果当前环境不适合再次走 `npx(包执行命令)`,至少核对:
|
|
220
|
+
|
|
221
|
+
- `.agents/`
|
|
222
|
+
- `.ai-spec/install-state.json`
|
|
223
|
+
- `openspec/`(完整安装时)
|
|
224
|
+
- `.cursor/`、`.claude/` 等 `IDE(开发工具)` 入口目录
|
|
225
|
+
|
|
226
|
+
### 第五步:结果摘要
|
|
227
|
+
|
|
228
|
+
结果摘要至少包含:
|
|
229
|
+
|
|
230
|
+
- 安装目标目录
|
|
231
|
+
- 实际执行的命令
|
|
232
|
+
- 判定出的 `profile(技术栈)` 或多 profile 列表
|
|
233
|
+
- 是否首次安装 / 已安装改走 `check(自检)`
|
|
234
|
+
- 验证结果
|
|
235
|
+
- 下一步建议:`project-init(项目规范初始化)` 或"初始化项目规范"
|
|
236
|
+
|
|
237
|
+
## Gotchas(易错点)
|
|
238
|
+
|
|
239
|
+
- 不要把 `project-init(项目规范初始化)` 当成首次安装命令
|
|
240
|
+
- 不要忘记追加 `--custom-rules(自定义规则)`,否则非交互模式会回退到标准规则
|
|
241
|
+
- **无法推断 profile 时,不得默认为 `vue`**,必须展示多选提示让用户明确选择
|
|
242
|
+
- 兜底提示必须是**多选**,不能是单选数字列表——用户可能同时需要 vue + nestjs
|
|
243
|
+
- 同一仓库含多技术栈子包时,**在根目录安装**,写多 profile manifest;不要分别进入子包目录各自安装一套 `.agents/`
|
|
244
|
+
- NestJS 项目依据 `@nestjs/core` 依赖识别,**不要把它归为 `node-tooling`**
|
|
245
|
+
- 不要漏掉 `@ex:registry(内网包仓库)` 检查,否则 `npx(包执行命令)` 很可能失败
|
|
246
|
+
- 不要只输出命令,不实际执行
|
|
247
|
+
- 已安装项目如果只需要检查状态,优先走 `check(自检)`,不要机械重复 `init(初始化安装)`
|
|
248
|
+
- Spring Boot 项目不一定存在 `package.json`,不要因为缺少 `package.json` 就直接报错或跳过
|
|
249
|
+
|
|
250
|
+
## 验证标准
|
|
251
|
+
|
|
252
|
+
1. 已成功执行 `init(初始化安装)` 或在已安装场景下正确改走 `check(自检)`
|
|
253
|
+
2. 用户能从摘要里看到安装目标、命令、技术栈和验证结果
|
|
254
|
+
3. 输出明确区分"安装完成"与"下一步执行 `project-init(项目规范初始化)`"
|
|
255
|
+
|
|
256
|
+
## 资源导航
|
|
257
|
+
|
|
258
|
+
- [README.md](/Users/lizhenwei/workspace/vueworkspace/bairong/br-ai-spec/README.md)
|
|
259
|
+
- [docs/install-guide.md](/Users/lizhenwei/workspace/vueworkspace/bairong/br-ai-spec/docs/install-guide.md)
|
|
260
|
+
- [bin/install-workflow.js](/Users/lizhenwei/workspace/vueworkspace/bairong/br-ai-spec/bin/install-workflow.js)
|
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
{
|
|
2
|
-
"skill_name": "install-ai-spec-auto",
|
|
3
|
-
"evals": [
|
|
4
|
-
{
|
|
5
|
-
"id": "install-ai-spec-auto-output-1",
|
|
6
|
-
"prompt": "在一个尚未接入规范库的 Vue 项目中,自动检查前置条件并执行 ai-spec-auto init 安装,安装完成后给出验证结果和下一步。",
|
|
7
|
-
"files": [],
|
|
8
|
-
"expected_output": "输出应覆盖环境检查、registry 配置检查、profile 推断、实际执行 init 命令、安装后验证,以及 project-init 作为下一步建议。",
|
|
9
|
-
"assertions": [
|
|
10
|
-
"明确检查 @ex registry 配置",
|
|
11
|
-
"执行 init 而不是只贴命令",
|
|
12
|
-
"区分 install 与 project-init",
|
|
13
|
-
"包含 check 或关键安装产物验证"
|
|
14
|
-
]
|
|
15
|
-
}
|
|
16
|
-
]
|
|
17
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"skill_name": "install-ai-spec-auto",
|
|
3
|
+
"evals": [
|
|
4
|
+
{
|
|
5
|
+
"id": "install-ai-spec-auto-output-1",
|
|
6
|
+
"prompt": "在一个尚未接入规范库的 Vue 项目中,自动检查前置条件并执行 ai-spec-auto init 安装,安装完成后给出验证结果和下一步。",
|
|
7
|
+
"files": [],
|
|
8
|
+
"expected_output": "输出应覆盖环境检查、registry 配置检查、profile 推断、实际执行 init 命令、安装后验证,以及 project-init 作为下一步建议。",
|
|
9
|
+
"assertions": [
|
|
10
|
+
"明确检查 @ex registry 配置",
|
|
11
|
+
"执行 init 而不是只贴命令",
|
|
12
|
+
"区分 install 与 project-init",
|
|
13
|
+
"包含 check 或关键安装产物验证"
|
|
14
|
+
]
|
|
15
|
+
}
|
|
16
|
+
]
|
|
17
|
+
}
|
|
@@ -1,18 +1,18 @@
|
|
|
1
|
-
[
|
|
2
|
-
{
|
|
3
|
-
"query": "给当前项目安装 ai-spec-auto,并直接执行 init",
|
|
4
|
-
"should_trigger": true
|
|
5
|
-
},
|
|
6
|
-
{
|
|
7
|
-
"query": "帮我把这套规范接入当前 Vue 项目,自动跑安装命令",
|
|
8
|
-
"should_trigger": true
|
|
9
|
-
},
|
|
10
|
-
{
|
|
11
|
-
"query": "当前项目已经装过了,帮我跑 check 看状态",
|
|
12
|
-
"should_trigger": false
|
|
13
|
-
},
|
|
14
|
-
{
|
|
15
|
-
"query": "执行 project-init,补 01 和 03",
|
|
16
|
-
"should_trigger": false
|
|
17
|
-
}
|
|
18
|
-
]
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"query": "给当前项目安装 ai-spec-auto,并直接执行 init",
|
|
4
|
+
"should_trigger": true
|
|
5
|
+
},
|
|
6
|
+
{
|
|
7
|
+
"query": "帮我把这套规范接入当前 Vue 项目,自动跑安装命令",
|
|
8
|
+
"should_trigger": true
|
|
9
|
+
},
|
|
10
|
+
{
|
|
11
|
+
"query": "当前项目已经装过了,帮我跑 check 看状态",
|
|
12
|
+
"should_trigger": false
|
|
13
|
+
},
|
|
14
|
+
{
|
|
15
|
+
"query": "执行 project-init,补 01 和 03",
|
|
16
|
+
"should_trigger": false
|
|
17
|
+
}
|
|
18
|
+
]
|
|
@@ -1,18 +1,18 @@
|
|
|
1
|
-
[
|
|
2
|
-
{
|
|
3
|
-
"query": "在这个仓库里自动初始化安装 ai-spec-auto,别只给命令,直接执行",
|
|
4
|
-
"should_trigger": true
|
|
5
|
-
},
|
|
6
|
-
{
|
|
7
|
-
"query": "给别人项目快速装上 rules 和 skills,自动跑 init",
|
|
8
|
-
"should_trigger": true
|
|
9
|
-
},
|
|
10
|
-
{
|
|
11
|
-
"query": "帮我更新已经安装过的规范库",
|
|
12
|
-
"should_trigger": false
|
|
13
|
-
},
|
|
14
|
-
{
|
|
15
|
-
"query": "给我新建一个 skill,用来安装项目",
|
|
16
|
-
"should_trigger": false
|
|
17
|
-
}
|
|
18
|
-
]
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"query": "在这个仓库里自动初始化安装 ai-spec-auto,别只给命令,直接执行",
|
|
4
|
+
"should_trigger": true
|
|
5
|
+
},
|
|
6
|
+
{
|
|
7
|
+
"query": "给别人项目快速装上 rules 和 skills,自动跑 init",
|
|
8
|
+
"should_trigger": true
|
|
9
|
+
},
|
|
10
|
+
{
|
|
11
|
+
"query": "帮我更新已经安装过的规范库",
|
|
12
|
+
"should_trigger": false
|
|
13
|
+
},
|
|
14
|
+
{
|
|
15
|
+
"query": "给我新建一个 skill,用来安装项目",
|
|
16
|
+
"should_trigger": false
|
|
17
|
+
}
|
|
18
|
+
]
|