@gong-ym/ai-spec-auto 0.2.13 → 0.2.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/commands/README.md +33 -33
- package/.agents/commands/claude/spec-start-review.md +88 -88
- package/.agents/commands/codex/spec-continue.md +74 -74
- package/.agents/commands/codex/spec-orchestrate.md +35 -35
- package/.agents/commands/codex/spec-start-review.md +88 -88
- package/.agents/commands/codex/spec-start.md +67 -67
- package/.agents/commands/codex/spec-status.md +22 -22
- package/.agents/commands/codex/spec-stop.md +29 -29
- package/.agents/commands/codex/spec-update.md +40 -40
- package/.agents/commands/common/branch-review.md +117 -117
- package/.agents/commands/common/project-init.md +25 -25
- package/.agents/commands/common/spec-continue.md +74 -74
- package/.agents/commands/common/spec-orchestrate.md +35 -35
- package/.agents/commands/common/spec-start-review.md +82 -82
- package/.agents/commands/common/spec-start.md +67 -67
- package/.agents/commands/common/spec-status.md +22 -22
- package/.agents/commands/common/spec-stop.md +29 -29
- package/.agents/commands/common/spec-update.md +60 -40
- package/.agents/commands/cursor/opsx-apply.md +55 -55
- package/.agents/commands/cursor/opsx-archive.md +48 -48
- package/.agents/commands/cursor/opsx-explore.md +45 -45
- package/.agents/commands/cursor/opsx-propose.md +59 -59
- package/.agents/commands/cursor/spec-continue.md +63 -63
- package/.agents/commands/cursor/spec-orchestrate.md +53 -53
- package/.agents/commands/cursor/spec-start-review.md +78 -78
- package/.agents/commands/cursor/spec-start.md +59 -59
- package/.agents/commands/cursor/spec-status.md +30 -30
- package/.agents/commands/cursor/spec-stop.md +29 -29
- package/.agents/commands/cursor/spec-update.md +41 -41
- package/.agents/flows/FRONTMATTER.md +263 -263
- package/.agents/flows/RUN_OUTPUT.md +263 -263
- package/.agents/flows/common/README.md +29 -29
- package/.agents/flows/common/bugfix-to-verification.md +95 -95
- package/.agents/flows/common/change-to-architecture-review.md +89 -89
- package/.agents/flows/common/change-to-release.md +94 -94
- package/.agents/flows/common/prd-to-delivery.md +184 -184
- package/.agents/flows/common/requirement-to-observability.md +97 -97
- package/.agents/orchestration/README.md +22 -22
- package/.agents/orchestration/expert-dispatch-spec.md +155 -155
- package/.agents/orchestration/expert-executor-spec.md +84 -84
- package/.agents/orchestration/expert-runtime-action-spec.md +73 -73
- package/.agents/orchestration/runtime-state-handoff-spec.md +264 -264
- package/.agents/orchestration/task-anchor-spec.md +212 -212
- package/.agents/orchestration/task-orchestrator-adapter-payload.md +153 -153
- package/.agents/orchestration/task-orchestrator-bootstrap-payload.md +145 -145
- package/.agents/orchestration/task-orchestrator-output-extractor-spec.md +93 -93
- package/.agents/orchestration/task-orchestrator-run-plan-template.md +312 -312
- package/.agents/orchestration/task-orchestrator-runtime-hooks.md +214 -214
- package/.agents/registry/README.md +63 -63
- package/.agents/registry/flows.json +125 -125
- package/.agents/registry/profiles.json +101 -101
- package/.agents/registry/roles.json +1265 -1265
- package/.agents/registry/rules.json +148 -148
- package/.agents/registry/scenario-packages.json +123 -123
- package/.agents/registry/skills.json +130 -130
- package/.agents/roles/INDEX.md +346 -346
- package/.agents/roles/common/README.md +76 -76
- package/.agents/roles/common/archive-change.md +80 -80
- package/.agents/roles/common/backend-implementer.md +92 -92
- package/.agents/roles/common/code-guardian.md +151 -151
- package/.agents/roles/common/frontend-implementer.md +146 -146
- package/.agents/roles/common/requirement-analyst.md +138 -138
- package/.agents/roles/common/task-orchestrator-routing.md +301 -301
- package/.agents/roles/common/task-orchestrator.md +224 -224
- package/.agents/roles/common/tooling-implementer.md +92 -92
- package/.agents/roles/domains/README.md +35 -35
- package/.agents/roles/domains/delivery/README.md +11 -11
- package/.agents/roles/domains/delivery/container-specialist.md +50 -50
- package/.agents/roles/domains/delivery/deployment-specialist.md +50 -50
- package/.agents/roles/domains/delivery/pipeline-specialist.md +50 -50
- package/.agents/roles/domains/demand-design/README.md +16 -16
- package/.agents/roles/domains/demand-design/api-contract-specialist.md +52 -52
- package/.agents/roles/domains/demand-design/design-collaborator.md +58 -58
- package/.agents/roles/domains/documentation/README.md +11 -11
- package/.agents/roles/domains/documentation/api-doc-specialist.md +50 -50
- package/.agents/roles/domains/documentation/component-doc-specialist.md +49 -49
- package/.agents/roles/domains/documentation/technical-writing-specialist.md +48 -48
- package/.agents/roles/domains/engineering/README.md +17 -17
- package/.agents/roles/domains/engineering/architecture-advisor.md +53 -53
- package/.agents/roles/domains/engineering/build-specialist.md +51 -51
- package/.agents/roles/domains/engineering/dependency-governor.md +52 -52
- package/.agents/roles/domains/governance/README.md +17 -17
- package/.agents/roles/domains/governance/api-governance-specialist.md +51 -51
- package/.agents/roles/domains/governance/lint-policy-specialist.md +49 -49
- package/.agents/roles/domains/governance/route-governance-specialist.md +52 -52
- package/.agents/roles/domains/observability/README.md +11 -11
- package/.agents/roles/domains/observability/error-tracker.md +50 -50
- package/.agents/roles/domains/observability/event-instrumentation-specialist.md +51 -51
- package/.agents/roles/domains/observability/rum-analyst.md +50 -50
- package/.agents/roles/domains/performance/README.md +11 -11
- package/.agents/roles/domains/performance/asset-optimizer.md +50 -50
- package/.agents/roles/domains/performance/performance-auditor.md +56 -56
- package/.agents/roles/domains/performance/vitals-analyst.md +50 -50
- package/.agents/roles/domains/security-a11y/README.md +11 -11
- package/.agents/roles/domains/security-a11y/a11y-auditor.md +50 -50
- package/.agents/roles/domains/security-a11y/aria-specialist.md +51 -51
- package/.agents/roles/domains/security-a11y/security-reviewer.md +49 -49
- package/.agents/roles/domains/testing/README.md +12 -12
- package/.agents/roles/domains/testing/coverage-analyst.md +50 -50
- package/.agents/roles/domains/testing/e2e-test-specialist.md +51 -51
- package/.agents/roles/domains/testing/unit-test-specialist.md +56 -56
- package/.agents/roles/domains/testing/verification-reviewer.md +67 -67
- package/.agents/rules/README.md +87 -87
- package/.agents/rules/common/02-/347/274/226/347/240/201/350/247/204/350/214/203.md +45 -45
- package/.agents/rules/common/08-/351/200/232/347/224/250/347/272/246/346/235/237.md +63 -63
- package/.agents/rules/common/10-/346/226/207/346/241/243/350/247/204/350/214/203.md +101 -101
- package/.agents/rules/common/12-Superpowers/346/211/247/350/241/214/350/247/204/350/214/203.md +46 -46
- package/.agents/rules/common/14-/345/256/241/350/256/241/346/261/207/346/212/245/350/247/204/350/214/203.md +107 -107
- package/.agents/rules/common/15-visual-gate-wait.md +90 -90
- package/.agents/rules/profiles/nestjs/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +27 -27
- package/.agents/rules/profiles/nestjs/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +20 -20
- package/.agents/rules/profiles/nestjs/04-/346/250/241/345/235/227/347/273/223/346/236/204/350/247/204/350/214/203.md +24 -24
- package/.agents/rules/profiles/nestjs/05-/346/216/245/345/217/243/344/270/216/345/245/221/347/272/246/350/247/204/350/214/203.md +24 -24
- package/.agents/rules/profiles/nestjs/06-/346/225/260/346/215/256/350/256/277/351/227/256/350/247/204/350/214/203.md +24 -24
- package/.agents/rules/profiles/nestjs/07-/351/205/215/347/275/256/344/270/216/350/277/220/350/241/214/346/227/266/350/247/204/350/214/203.md +20 -20
- package/.agents/rules/profiles/nestjs/09-/345/274/202/345/270/270/344/270/216/346/227/245/345/277/227/350/247/204/350/214/203.md +20 -20
- package/.agents/rules/profiles/nestjs/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +24 -24
- package/.agents/rules/profiles/nestjs/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +20 -20
- package/.agents/rules/profiles/node-tooling/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +30 -30
- package/.agents/rules/profiles/node-tooling/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +37 -37
- package/.agents/rules/profiles/node-tooling/04-CLI/344/270/216/346/250/241/345/235/227/350/247/204/350/214/203.md +42 -42
- package/.agents/rules/profiles/node-tooling/05-Contract/344/270/216Schema/350/247/204/350/214/203.md +42 -42
- package/.agents/rules/profiles/node-tooling/06-/350/277/220/350/241/214/346/227/266/346/226/207/344/273/266/350/247/204/350/214/203.md +30 -30
- package/.agents/rules/profiles/node-tooling/07-/346/227/245/345/277/227/344/270/216/351/224/231/350/257/257/345/244/204/347/220/206/350/247/204/350/214/203.md +60 -60
- package/.agents/rules/profiles/node-tooling/09-/350/204/232/346/234/254/344/270/216/345/205/245/345/217/243/350/247/204/350/214/203.md +45 -45
- package/.agents/rules/profiles/node-tooling/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +41 -41
- package/.agents/rules/profiles/node-tooling/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +55 -55
- package/.agents/rules/profiles/react/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +29 -29
- package/.agents/rules/profiles/react/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +104 -104
- package/.agents/rules/profiles/react/04-/347/273/204/344/273/266/350/247/204/350/214/203.md +46 -46
- package/.agents/rules/profiles/react/05-API/350/247/204/350/214/203.md +67 -67
- package/.agents/rules/profiles/react/06-/350/267/257/347/224/261/350/247/204/350/214/203.md +54 -54
- package/.agents/rules/profiles/react/07-/347/212/266/346/200/201/347/256/241/347/220/206.md +226 -226
- package/.agents/rules/profiles/react/09-/346/240/267/345/274/217/350/247/204/350/214/203.md +71 -71
- package/.agents/rules/profiles/react/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +80 -80
- package/.agents/rules/profiles/react/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +159 -159
- package/.agents/rules/profiles/springboot/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +31 -31
- package/.agents/rules/profiles/springboot/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +37 -37
- package/.agents/rules/profiles/springboot/04-/345/210/206/345/261/202/350/247/204/350/214/203.md +33 -33
- package/.agents/rules/profiles/springboot/05-/346/216/245/345/217/243/344/270/216/345/245/221/347/272/246/350/247/204/350/214/203.md +51 -51
- package/.agents/rules/profiles/springboot/06-/346/225/260/346/215/256/350/256/277/351/227/256/350/247/204/350/214/203.md +34 -34
- package/.agents/rules/profiles/springboot/07-/351/205/215/347/275/256/344/270/216/350/277/220/350/241/214/346/227/266/350/247/204/350/214/203.md +38 -38
- package/.agents/rules/profiles/springboot/09-/345/274/202/345/270/270/344/270/216/346/227/245/345/277/227/350/247/204/350/214/203.md +48 -48
- package/.agents/rules/profiles/springboot/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +43 -43
- package/.agents/rules/profiles/springboot/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +48 -48
- package/.agents/rules/profiles/vue/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +47 -47
- package/.agents/rules/profiles/vue/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +106 -106
- package/.agents/rules/profiles/vue/04-/347/273/204/344/273/266/350/247/204/350/214/203.md +61 -61
- package/.agents/rules/profiles/vue/05-API/350/247/204/350/214/203.md +67 -67
- package/.agents/rules/profiles/vue/06-/350/267/257/347/224/261/350/247/204/350/214/203.md +69 -69
- package/.agents/rules/profiles/vue/07-/347/212/266/346/200/201/347/256/241/347/220/206.md +93 -93
- package/.agents/rules/profiles/vue/09-/346/240/267/345/274/217/350/247/204/350/214/203.md +67 -67
- package/.agents/rules/profiles/vue/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +80 -80
- package/.agents/rules/profiles/vue/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +159 -159
- package/.agents/skills/README.md +171 -171
- package/.agents/skills/common/archive-change/SKILL.md +180 -180
- package/.agents/skills/common/branch-code-reviewer/SKILL.md +533 -459
- package/.agents/skills/common/branch-code-reviewer/references/business-risk-guide.md +293 -293
- package/.agents/skills/common/branch-code-reviewer/references/html-template-guide.md +121 -121
- package/.agents/skills/common/config-and-secret-scan/SKILL.md +99 -99
- package/.agents/skills/common/create-proposal/SKILL.md +192 -192
- package/.agents/skills/common/create-proposal/evals/evals.json +16 -16
- package/.agents/skills/common/create-proposal/evals/train_queries.json +18 -18
- package/.agents/skills/common/create-proposal/evals/validation_queries.json +18 -18
- package/.agents/skills/common/create-proposal/references/interaction-spec-template.md +42 -42
- package/.agents/skills/common/create-test/SKILL.md +292 -292
- package/.agents/skills/common/dependency-impact-graph/SKILL.md +80 -80
- package/.agents/skills/common/execute-task/SKILL.md +206 -206
- package/.agents/skills/common/execute-task/evals/evals.json +16 -16
- package/.agents/skills/common/execute-task/evals/train_queries.json +18 -18
- package/.agents/skills/common/execute-task/evals/validation_queries.json +18 -18
- package/.agents/skills/common/find-skills/SKILL.md +144 -144
- package/.agents/skills/common/install-ai-spec-auto/SKILL.md +260 -260
- package/.agents/skills/common/install-ai-spec-auto/evals/evals.json +17 -17
- package/.agents/skills/common/install-ai-spec-auto/evals/train_queries.json +18 -18
- package/.agents/skills/common/install-ai-spec-auto/evals/validation_queries.json +18 -18
- package/.agents/skills/common/project-init/SKILL.md +178 -178
- package/.agents/skills/common/project-init/evals/evals.json +16 -16
- package/.agents/skills/common/project-init/evals/train_queries.json +18 -18
- package/.agents/skills/common/project-init/evals/validation_queries.json +18 -18
- package/.agents/skills/common/project-init/references/custom-rule-generation.md +89 -89
- package/.agents/skills/common/project-init/references/deep-scan-rules.md +67 -67
- package/.agents/skills/common/project-init/references/output-contracts.md +71 -71
- package/.agents/skills/common/project-init/references/repo-fact-gathering.md +83 -83
- package/.agents/skills/common/project-init/references/scope-resolution.md +76 -76
- package/.agents/skills/common/project-init/scripts/inspect-project.js +112 -112
- package/.agents/skills/common/skill-creator/LICENSE.txt +201 -201
- package/.agents/skills/common/skill-creator/SKILL.md +370 -370
- package/.agents/skills/common/skill-creator/evals/evals.json +16 -16
- package/.agents/skills/common/skill-creator/evals/train_queries.json +18 -18
- package/.agents/skills/common/skill-creator/evals/validation_queries.json +18 -18
- package/.agents/skills/common/skill-creator/references/output-patterns.md +82 -82
- package/.agents/skills/common/skill-creator/references/workflows.md +27 -27
- package/.agents/skills/common/skill-creator/scripts/init_skill.py +209 -209
- package/.agents/skills/common/skill-creator/scripts/package_skill.py +110 -110
- package/.agents/skills/common/skill-creator/scripts/quick_validate.py +51 -51
- package/.agents/skills/common/skill-optimizer/SKILL.md +102 -102
- package/.agents/skills/common/skill-optimizer/evals/evals.json +16 -16
- package/.agents/skills/common/skill-optimizer/evals/train_queries.json +18 -18
- package/.agents/skills/common/skill-optimizer/evals/validation_queries.json +18 -18
- package/.agents/skills/common/skill-optimizer/references/design-patterns.md +26 -26
- package/.agents/skills/common/skill-optimizer/references/review-checklist.md +22 -22
- package/.agents/skills/common/using-superpowers/SKILL.md +151 -151
- package/.agents/skills/common/wait-for-gate-signal/SKILL.md +85 -85
- package/.agents/skills/domains/README.md +19 -19
- package/.agents/skills/domains/ui-ux-pro-max/SKILL.md +58 -58
- package/.agents/skills/domains/web/design-analysis/SKILL.md +89 -89
- package/.agents/skills/domains/web/design-analysis/rules/analysis-order.md +61 -61
- package/.agents/skills/domains/web/design-analysis/rules/analysis-priorities.md +136 -136
- package/.agents/skills/domains/web/design-analysis/rules/checklist-common-misses.md +107 -107
- package/.agents/skills/domains/web/design-analysis/rules/implementation-common-errors.md +204 -204
- package/.agents/skills/domains/web/design-analysis/rules/implementation-guidelines.md +211 -211
- package/.agents/skills/domains/web/design-analysis/rules/output-analysis-checklist.md +247 -247
- package/.agents/skills/domains/web/design-analysis/rules/tools-design-guidelines.md +108 -108
- package/.agents/skills/domains/web/design-analysis/rules/workflow-element-extraction.md +162 -162
- package/.agents/skills/domains/web/design-analysis/rules/workflow-layout-map.md +131 -131
- package/.agents/skills/domains/web/design-analysis/rules/workflow-output-checklist.md +70 -70
- package/.agents/skills/domains/web/design-analysis/rules/workflow-style-summary.md +91 -91
- package/.agents/skills/domains/web/route-permission-map/SKILL.md +103 -103
- package/.agents/skills/domains/web/ui-verification/SKILL.md +114 -114
- package/.agents/skills/domains/web/ui-verification/evals/evals.json +16 -16
- package/.agents/skills/domains/web/ui-verification/evals/train_queries.json +18 -18
- package/.agents/skills/domains/web/ui-verification/evals/validation_queries.json +18 -18
- package/.agents/skills/domains/web/ui-verification/rules/comparison-content-image.md +34 -34
- package/.agents/skills/domains/web/ui-verification/rules/comparison-content-text.md +30 -30
- package/.agents/skills/domains/web/ui-verification/rules/comparison-hierarchy.md +33 -33
- package/.agents/skills/domains/web/ui-verification/rules/comparison-layout.md +35 -35
- package/.agents/skills/domains/web/ui-verification/rules/errors-alignment.md +42 -42
- package/.agents/skills/domains/web/ui-verification/rules/errors-button-dimensions.md +28 -28
- package/.agents/skills/domains/web/ui-verification/rules/errors-button-position.md +25 -25
- package/.agents/skills/domains/web/ui-verification/rules/errors-css-priority.md +50 -50
- package/.agents/skills/domains/web/ui-verification/rules/errors-flex-column-width.md +46 -46
- package/.agents/skills/domains/web/ui-verification/rules/errors-flex-layout.md +46 -46
- package/.agents/skills/domains/web/ui-verification/rules/errors-grid-container-width.md +44 -44
- package/.agents/skills/domains/web/ui-verification/rules/errors-page-container-width.md +39 -39
- package/.agents/skills/domains/web/ui-verification/rules/tools-browser-navigation.md +53 -53
- package/.agents/skills/domains/web/ui-verification/rules/tools-design-guidelines.md +53 -53
- package/.agents/skills/domains/web/ui-verification/rules/workflow-checklist.md +27 -27
- package/.agents/skills/domains/web/ui-verification/rules/workflow-problem-list.md +56 -56
- package/.agents/skills/domains/web/ui-verification/rules/workflow-reflection.md +44 -44
- package/.agents/skills/domains/web/ui-verification/rules/writing-alignment.md +44 -44
- package/.agents/skills/domains/web/ui-verification/rules/writing-element-completeness.md +63 -63
- package/.agents/skills/domains/web/ui-verification/rules/writing-list-layout.md +75 -75
- package/.agents/skills/domains/web/ui-verification/rules/writing-page-container-width.md +37 -37
- package/.agents/skills/domains/web/web-design-guidelines/SKILL.md +40 -40
- package/.agents/skills/profiles/nestjs/README.md +4 -4
- package/.agents/skills/profiles/node-tooling/README.md +9 -9
- package/.agents/skills/profiles/react/create-api/SKILL.md +145 -145
- package/.agents/skills/profiles/react/create-component/SKILL.md +160 -160
- package/.agents/skills/profiles/react/create-route/SKILL.md +168 -168
- package/.agents/skills/profiles/react/create-store/SKILL.md +262 -262
- package/.agents/skills/profiles/react/theme-variables/SKILL.md +82 -82
- package/.agents/skills/profiles/react/vercel-composition-patterns/AGENTS.md +899 -899
- package/.agents/skills/profiles/react/vercel-composition-patterns/SKILL.md +81 -81
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -100
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/architecture-compound-components.md +112 -112
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -87
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -100
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-context-interface.md +191 -191
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -113
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-lift-state.md +125 -125
- package/.agents/skills/profiles/react/vercel-react-best-practices/AGENTS.md +2934 -2934
- package/.agents/skills/profiles/react/vercel-react-best-practices/SKILL.md +136 -136
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -55
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-init-once.md +42 -42
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-use-latest.md +39 -39
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-api-routes.md +38 -38
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-defer-await.md +80 -80
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-dependencies.md +51 -51
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-parallel.md +28 -28
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -99
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-barrel-imports.md +59 -59
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-conditional.md +31 -31
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -49
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -35
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-preload.md +50 -50
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-event-listeners.md +74 -74
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -71
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -48
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-swr-dedup.md +56 -56
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -107
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-function-results.md +80 -80
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-property-access.md +28 -28
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-storage.md +70 -70
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-combine-iterations.md +32 -32
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-early-exit.md +50 -50
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -45
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-index-maps.md +37 -37
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-length-check-first.md +49 -49
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-min-max-loop.md +82 -82
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -24
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -57
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-activity.md +26 -26
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -47
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -40
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -38
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -46
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -82
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -30
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -28
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -75
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -39
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-dependencies.md +45 -45
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -40
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-derived-state.md +29 -29
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -74
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -58
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -38
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-memo.md +44 -44
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -45
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -35
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-transitions.md +40 -40
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -73
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -73
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-auth-actions.md +96 -96
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-cache-lru.md +41 -41
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-cache-react.md +76 -76
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-dedup-props.md +65 -65
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -83
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-serialization.md +38 -38
- package/.agents/skills/profiles/springboot/README.md +10 -10
- package/.agents/skills/profiles/vue/create-api/SKILL.md +105 -105
- package/.agents/skills/profiles/vue/create-component/SKILL.md +76 -76
- package/.agents/skills/profiles/vue/create-route/SKILL.md +141 -141
- package/.agents/skills/profiles/vue/create-store/SKILL.md +97 -97
- package/.agents/skills/profiles/vue/create-view/SKILL.md +81 -81
- package/.agents/skills/profiles/vue/theme-variables/SKILL.md +73 -73
- package/.agents/skills/profiles/vue/vue-best-practices/SKILL.md +166 -166
- package/.agents/skills/profiles/vue/vue-best-practices/references/animation-class-based-technique.md +254 -254
- package/.agents/skills/profiles/vue/vue-best-practices/references/animation-state-driven-technique.md +291 -291
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-async.md +97 -97
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-data-flow.md +307 -307
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-fallthrough-attrs.md +174 -174
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-keep-alive.md +137 -137
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-slots.md +216 -216
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-suspense.md +228 -228
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-teleport.md +108 -108
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-transition-group.md +128 -128
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-transition.md +125 -125
- package/.agents/skills/profiles/vue/vue-best-practices/references/composables.md +290 -290
- package/.agents/skills/profiles/vue/vue-best-practices/references/directives.md +162 -162
- package/.agents/skills/profiles/vue/vue-best-practices/references/perf-avoid-component-abstraction-in-lists.md +159 -159
- package/.agents/skills/profiles/vue/vue-best-practices/references/perf-v-once-v-memo-directives.md +182 -182
- package/.agents/skills/profiles/vue/vue-best-practices/references/perf-virtualize-large-lists.md +187 -187
- package/.agents/skills/profiles/vue/vue-best-practices/references/plugins.md +166 -166
- package/.agents/skills/profiles/vue/vue-best-practices/references/reactivity.md +344 -344
- package/.agents/skills/profiles/vue/vue-best-practices/references/render-functions.md +201 -201
- package/.agents/skills/profiles/vue/vue-best-practices/references/sfc.md +310 -310
- package/.agents/skills/profiles/vue/vue-best-practices/references/state-management.md +135 -135
- package/.agents/skills/profiles/vue/vue-best-practices/references/updated-hook-performance.md +187 -187
- package/.agents/templates/common/README.md +23 -23
- package/.agents/templates/common/bugfix.md +22 -22
- package/.agents/templates/common/create-expert-package.md +458 -458
- package/.agents/templates/common/mock-page.md +28 -28
- package/.agents/templates/common/new-component.md +25 -25
- package/.agents/templates/common/new-page.md +31 -31
- package/.cursor/mcp.json +35 -35
- package/.qoder/mcp.json +26 -26
- package/bin/archive-change.js +560 -474
- package/bin/check-command.js +62 -62
- package/bin/cli.js +0 -0
- package/bin/command-template-renderer.js +40 -40
- package/bin/context-command.js +102 -102
- package/bin/demo-runtime-smoke.js +760 -760
- package/bin/execution-semantics.js +821 -821
- package/bin/executor-command.js +93 -93
- package/bin/expert-dispatch.js +334 -334
- package/bin/expert-executor.js +1148 -1148
- package/bin/guard-command.js +52 -52
- package/bin/hub-command.js +876 -876
- package/bin/ide-command.js +242 -242
- package/bin/init-command.js +193 -193
- package/bin/install-workflow.js +35 -3
- package/bin/manifest-export.js +34 -34
- package/bin/profile-registry.js +90 -90
- package/bin/protocol-workflow.js +452 -446
- package/bin/repair-command.js +161 -161
- package/bin/repo-map.js +177 -177
- package/bin/report-command.js +236 -236
- package/bin/runtime-bootstrap.js +428 -428
- package/bin/runtime-embedded.js +101 -101
- package/bin/runtime-fallback.js +106 -106
- package/bin/runtime-launcher.js +116 -116
- package/bin/runtime-paths.js +177 -177
- package/bin/runtime-registry.js +289 -289
- package/bin/runtime-state.js +2541 -2541
- package/bin/scan.js +96 -96
- package/bin/self-upgrade.js +206 -206
- package/bin/skill-spec-validator.js +457 -457
- package/bin/spec-command.js +366 -366
- package/bin/superpowers.js +384 -384
- package/bin/sync-command.js +59 -59
- package/bin/sync.js +1904 -1904
- package/bin/task-orchestrator-adapter.js +341 -341
- package/bin/task-orchestrator-extractor.js +274 -274
- package/bin/task-orchestrator-runner.js +1208 -1208
- package/bin/telemetry/README.md +66 -66
- package/bin/telemetry/aspect.js +153 -153
- package/bin/telemetry/collect.js +67 -67
- package/bin/telemetry/config.js +114 -114
- package/bin/telemetry/defaults.json +5 -5
- package/bin/telemetry/healthcheck.js +195 -195
- package/bin/telemetry/identity.js +53 -53
- package/bin/telemetry/index.js +25 -25
- package/bin/telemetry/reporter.js +83 -83
- package/bin/telemetry/safe.js +39 -39
- package/bin/validate-registry.js +740 -740
- package/bin/visual-bridge-config.js +117 -117
- package/bin/visual-bridge.js +287 -287
- package/bin/visual-command.js +432 -432
- package/bin/worktree-command.js +194 -194
- package/configs/common/.editorconfig +15 -15
- package/configs/common/.husky/commit-msg +4 -4
- package/configs/common/.husky/pre-commit +4 -4
- package/configs/common/.lintstagedrc +11 -11
- package/configs/common/.prettierignore +11 -11
- package/configs/common/.prettierrc.json +11 -11
- package/configs/common/.stylelintignore +14 -14
- package/configs/common/.stylelintrc.json +21 -21
- package/configs/common/commitlint.config.js +3 -3
- package/configs/profiles/nestjs/.gitkeep +1 -1
- package/configs/profiles/node-tooling/.gitkeep +1 -1
- package/configs/profiles/react/.eslintignore +6 -6
- package/configs/profiles/react/.eslintrc.js +16 -16
- package/configs/profiles/react/.stylelintrc.json +18 -18
- package/configs/profiles/springboot/.gitkeep +1 -1
- package/configs/profiles/vue/.eslintignore +6 -6
- package/configs/profiles/vue/.eslintrc.cjs +17 -17
- package/contracts/README.md +28 -28
- package/contracts/fixtures/asset-package.fixture.json +26 -26
- package/contracts/fixtures/asset-usage-feedback.fixture.json +14 -14
- package/contracts/fixtures/evidence-report.fixture.json +28 -28
- package/contracts/fixtures/manifest.fixture.json +20 -20
- package/contracts/fixtures/run-event.fixture.json +15 -15
- package/contracts/schemas/asset-package.schema.json +76 -76
- package/contracts/schemas/asset-usage-feedback.schema.json +57 -57
- package/contracts/schemas/evidence-report.schema.json +60 -60
- package/contracts/schemas/manifest.schema.json +63 -63
- package/contracts/schemas/run-event.schema.json +72 -72
- package/install.ps1 +35 -35
- package/install.sh +17 -17
- package/internal/ai-protocol-workflow.js +5824 -5600
- package/internal/hub-client.js +98 -98
- package/internal/hub-sync-selection.js +69 -69
- package/internal/visual-hooks/README.md +481 -481
- package/internal/visual-hooks/config-loader.js +218 -218
- package/internal/visual-hooks/control-puller.js +206 -206
- package/internal/visual-hooks/gate-signal.js +150 -150
- package/internal/visual-hooks/inbox-consumer.js +469 -469
- package/internal/visual-hooks/index.js +197 -197
- package/internal/visual-hooks/push-client.js +189 -189
- package/internal/visual-hooks/receipt-pusher.js +176 -176
- package/internal/visual-hooks/runtime-state-pusher.js +128 -128
- package/openspec/config.yaml.template +52 -52
- package/openspec/schemas/expert-delivery/schema.yaml +68 -68
- package/openspec/schemas/expert-delivery/templates/checklist.md +39 -39
- package/openspec/schemas/expert-delivery/templates/design.md +61 -61
- package/openspec/schemas/expert-delivery/templates/iterations.md +25 -25
- package/openspec/schemas/expert-delivery/templates/proposal.md +45 -45
- package/openspec/schemas/expert-delivery/templates/spec.md +29 -29
- package/openspec/schemas/expert-delivery/templates/tasks.md +24 -24
- package/package.json +1 -1
- package/scripts/acceptance-zero-intrusion.sh +168 -168
- package/scripts/hub-sync-assets.config.example.json +296 -296
- package/scripts/hub-sync-assets.js +2038 -2038
- package/scripts/local-verify.sh +280 -280
- package/scripts/post-publish-auto-fix-check.js +404 -404
- package/scripts/post-publish-verify.sh +175 -175
- package/scripts/setup-cursor-manual-test.sh +107 -107
- package/scripts/setup-cursor-spec-archive-test.sh +111 -111
- package/scripts/setup-visual-integration.sh +225 -225
- package/scripts/test-integration.sh +176 -176
- package/scripts/update-test-project.sh +93 -93
- package/scripts/upload-four-web.sh +57 -57
- package/scripts/verify-install-ps1-bom.js +26 -26
- package/src/agent/agent-context.js +259 -259
- package/src/agent/agent-profile.js +185 -185
- package/src/agent/agent-templates.js +161 -161
- package/src/agent/agent-types.js +108 -108
- package/src/agent/collaboration-protocol.js +333 -333
- package/src/agent/conflict-handler.js +364 -364
- package/src/agent/file-permission.js +121 -121
- package/src/agent/index.js +38 -38
- package/src/agent/permission-audit.js +151 -151
- package/src/agent/review-repair-loop.js +270 -270
- package/src/agent/tool-permission.js +101 -101
- package/src/asset/asset-dependency.js +322 -322
- package/src/asset/asset-feedback.js +350 -350
- package/src/asset/asset-fork.js +300 -300
- package/src/asset/asset-install.js +278 -278
- package/src/asset/asset-installer.js +497 -497
- package/src/asset/asset-lifecycle.js +324 -324
- package/src/asset/asset-manager.js +245 -245
- package/src/asset/asset-package-manager.js +349 -349
- package/src/asset/asset-package.js +186 -186
- package/src/asset/asset-quality.js +262 -262
- package/src/asset/asset-registry.js +387 -387
- package/src/asset/asset-version.js +293 -293
- package/src/asset/index.js +86 -86
- package/src/cache/agent-profile-cache.js +59 -59
- package/src/cache/asset-cache.js +63 -63
- package/src/cache/global-cache.js +61 -61
- package/src/cache/manifest-cache.js +30 -30
- package/src/check/check-service.js +32 -32
- package/src/config/config-layer.js +343 -343
- package/src/config/config-loader.js +60 -60
- package/src/config/defaults.js +49 -49
- package/src/connectors/hub/asset-package.js +72 -72
- package/src/connectors/hub/asset-usage-feedback.js +46 -46
- package/src/connectors/hub/hub-connector.js +44 -44
- package/src/connectors/hub/index.js +21 -21
- package/src/connectors/visual/evidence-report.js +49 -49
- package/src/connectors/visual/index.js +15 -15
- package/src/connectors/visual/queue.js +41 -41
- package/src/connectors/visual/run-event.js +81 -81
- package/src/connectors/visual/visual-connector.js +77 -77
- package/src/context/context-budget.js +59 -59
- package/src/context/context-builder.js +285 -285
- package/src/context/context-loader.js +116 -116
- package/src/context/context-planner.js +158 -158
- package/src/context/types.js +96 -96
- package/src/contracts/index.js +63 -63
- package/src/executor/executor-registry.js +78 -78
- package/src/executor/executor-result-parser.js +44 -44
- package/src/executor/executor-runner.js +141 -141
- package/src/executor/executor-selector.js +139 -139
- package/src/executor/executor-timeout.js +36 -36
- package/src/executor/providers/base-provider-utils.js +189 -189
- package/src/executor/providers/claude-code-executor-provider.js +128 -128
- package/src/executor/providers/codex-executor-provider.js +126 -126
- package/src/executor/providers/cursor-executor-provider.js +99 -99
- package/src/executor/types.js +137 -137
- package/src/git/branch-manager.js +71 -71
- package/src/git/dirty-checker.js +43 -43
- package/src/git/dirty-strategy-handler.js +29 -29
- package/src/git/git-command.js +37 -37
- package/src/git/git-repository-detector.js +45 -45
- package/src/git/multi-repo-worktree-planner.js +88 -88
- package/src/git/policy.js +19 -19
- package/src/git/strategies/block-dirty-strategy.js +34 -34
- package/src/git/strategies/ignore-dirty-strategy.js +33 -33
- package/src/git/strategies/patch-snapshot-strategy.js +53 -53
- package/src/git/strategies/wip-commit-strategy.js +38 -38
- package/src/git/types.js +71 -71
- package/src/git/worktree-manager.js +85 -85
- package/src/governance/asset-review.js +351 -351
- package/src/governance/audit-log.js +368 -368
- package/src/governance/gray-release.js +312 -312
- package/src/governance/index.js +31 -31
- package/src/governance/policy-types.js +56 -56
- package/src/governance/rbac-types.js +171 -171
- package/src/governance/rbac.js +382 -382
- package/src/governance/rollback.js +360 -360
- package/src/governance/security-policy.js +354 -354
- package/src/hook/hook-config-writer.js +125 -125
- package/src/hub/hub-client.js +186 -186
- package/src/hub/hub-config.js +39 -39
- package/src/hub/project-facts.js +31 -31
- package/src/hub/runtime-feedback-reporter.js +55 -55
- package/src/ide/adapters/adapter-protocol.js +385 -385
- package/src/ide/adapters/claude-adapter.js +419 -419
- package/src/ide/adapters/codex-adapter.js +60 -60
- package/src/ide/adapters/cursor-adapter.js +484 -484
- package/src/ide/adapters/index.js +24 -24
- package/src/ide/anchors/markdown-anchor-writer.js +152 -152
- package/src/ide/ide-service.js +270 -270
- package/src/ide/ide-types.js +94 -94
- package/src/ide/links/link-mode-resolver.js +160 -160
- package/src/ide/registry/ide-registry-builder.js +165 -165
- package/src/incident/incident-writer.js +47 -47
- package/src/incident/types.js +22 -22
- package/src/init/ide-linker.js +126 -126
- package/src/init/ide-pointer-injector.js +75 -75
- package/src/init/init-applier.js +197 -197
- package/src/init/init-plan.js +294 -294
- package/src/init/init-service.js +65 -65
- package/src/init/manifest-installer.js +302 -302
- package/src/init/types.js +26 -26
- package/src/project/config-writer.js +83 -83
- package/src/project/context-index-writer.js +82 -82
- package/src/project/json-utils.js +72 -72
- package/src/project/local-state-writer.js +50 -50
- package/src/project/lock-file-writer.js +98 -98
- package/src/project/manifest-writer.js +126 -126
- package/src/project/policy-config-writer.js +91 -91
- package/src/project/project-config-writer.js +74 -74
- package/src/project/project-files.js +39 -39
- package/src/project/registry-index-writer.js +43 -43
- package/src/project/workspace-config-writer.js +63 -63
- package/src/run/index.js +11 -11
- package/src/run/run-id.js +32 -32
- package/src/run/run-service.js +269 -269
- package/src/run/run-store.js +80 -80
- package/src/scanner/aggregator/detection-aggregator.js +23 -23
- package/src/scanner/boundary/boundary-resolver.js +229 -229
- package/src/scanner/detectors/detector-registry.js +44 -44
- package/src/scanner/detectors/fastapi-detector.js +46 -46
- package/src/scanner/detectors/go-detector.js +46 -46
- package/src/scanner/detectors/nestjs-detector.js +57 -57
- package/src/scanner/detectors/nextjs-detector.js +52 -52
- package/src/scanner/detectors/react-vite-detector.js +52 -52
- package/src/scanner/detectors/react-webpack-detector.js +57 -57
- package/src/scanner/detectors/springboot-detector.js +46 -46
- package/src/scanner/detectors/springcloud-detector.js +46 -46
- package/src/scanner/detectors/springmvc-detector.js +46 -46
- package/src/scanner/detectors/vue-vite-detector.js +52 -52
- package/src/scanner/engine.js +72 -72
- package/src/scanner/facts/fact-extractor.js +211 -211
- package/src/scanner/types.js +30 -30
- package/src/security/asset-tamper-checker.js +188 -188
- package/src/security/checksum.js +40 -40
- package/src/spec/spec-writer.js +302 -302
- package/src/state-machine/circuit-breaker.js +112 -112
- package/src/state-machine/escape-hatch.js +49 -49
- package/src/state-machine/stage-runner.js +281 -281
- package/src/state-machine/state-machine.js +24 -24
- package/src/state-machine/transition-guard.js +36 -36
- package/src/state-machine/types.js +37 -37
- package/src/sync/sync-service.js +192 -192
- package/src/visual/agent-visual.js +142 -142
- package/src/visual/event-gateway.js +357 -357
- package/src/visual/event-mapper.js +128 -128
- package/src/visual/hook-dashboard.js +216 -216
- package/src/visual/index.js +27 -27
- package/src/visual/metrics.js +287 -287
- package/src/visual/privacy-filter.js +100 -100
- package/src/visual/risk-board.js +252 -252
- package/src/visual/timeline.js +245 -245
- package/src/visual/visual-client.js +94 -94
- package/src/visual/visual-config.js +40 -40
- package/src/visual/visual-reporter.js +88 -88
|
@@ -1,80 +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
|
-
- 若项目已有测试命令约定,可附命令示例,但不写死某个工具
|
|
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
|
+
- 若项目已有测试命令约定,可附命令示例,但不写死某个工具
|
|
@@ -1,206 +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 三阶段工作流说明
|
|
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 三阶段工作流说明
|
|
@@ -1,16 +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
|
-
}
|
|
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
|
+
}
|
|
@@ -1,18 +1,18 @@
|
|
|
1
|
-
[
|
|
2
|
-
{
|
|
3
|
-
"query": "按 tasks.md 开始执行第一个任务",
|
|
4
|
-
"should_trigger": true
|
|
5
|
-
},
|
|
6
|
-
{
|
|
7
|
-
"query": "帮我应用这个 OpenSpec 变更",
|
|
8
|
-
"should_trigger": true
|
|
9
|
-
},
|
|
10
|
-
{
|
|
11
|
-
"query": "先生成一个提案",
|
|
12
|
-
"should_trigger": false
|
|
13
|
-
},
|
|
14
|
-
{
|
|
15
|
-
"query": "归档这个 change",
|
|
16
|
-
"should_trigger": false
|
|
17
|
-
}
|
|
18
|
-
]
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"query": "按 tasks.md 开始执行第一个任务",
|
|
4
|
+
"should_trigger": true
|
|
5
|
+
},
|
|
6
|
+
{
|
|
7
|
+
"query": "帮我应用这个 OpenSpec 变更",
|
|
8
|
+
"should_trigger": true
|
|
9
|
+
},
|
|
10
|
+
{
|
|
11
|
+
"query": "先生成一个提案",
|
|
12
|
+
"should_trigger": false
|
|
13
|
+
},
|
|
14
|
+
{
|
|
15
|
+
"query": "归档这个 change",
|
|
16
|
+
"should_trigger": false
|
|
17
|
+
}
|
|
18
|
+
]
|