@gong-ym/ai-spec-auto 0.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/commands/README.md +33 -0
- package/.agents/commands/claude/spec-start-review.md +88 -0
- package/.agents/commands/codex/spec-continue.md +74 -0
- package/.agents/commands/codex/spec-orchestrate.md +35 -0
- package/.agents/commands/codex/spec-start-review.md +88 -0
- package/.agents/commands/codex/spec-start.md +67 -0
- package/.agents/commands/codex/spec-status.md +22 -0
- package/.agents/commands/codex/spec-stop.md +29 -0
- package/.agents/commands/codex/spec-update.md +40 -0
- package/.agents/commands/common/branch-review.md +117 -0
- package/.agents/commands/common/project-init.md +25 -0
- package/.agents/commands/common/spec-continue.md +74 -0
- package/.agents/commands/common/spec-orchestrate.md +35 -0
- package/.agents/commands/common/spec-start-review.md +82 -0
- package/.agents/commands/common/spec-start.md +67 -0
- package/.agents/commands/common/spec-status.md +22 -0
- package/.agents/commands/common/spec-stop.md +29 -0
- package/.agents/commands/common/spec-update.md +40 -0
- package/.agents/commands/cursor/opsx-apply.md +55 -0
- package/.agents/commands/cursor/opsx-archive.md +48 -0
- package/.agents/commands/cursor/opsx-explore.md +45 -0
- package/.agents/commands/cursor/opsx-propose.md +59 -0
- package/.agents/commands/cursor/spec-continue.md +63 -0
- package/.agents/commands/cursor/spec-orchestrate.md +53 -0
- package/.agents/commands/cursor/spec-start-review.md +78 -0
- package/.agents/commands/cursor/spec-start.md +59 -0
- package/.agents/commands/cursor/spec-status.md +30 -0
- package/.agents/commands/cursor/spec-stop.md +29 -0
- package/.agents/commands/cursor/spec-update.md +41 -0
- package/.agents/flows/FRONTMATTER.md +263 -0
- package/.agents/flows/RUN_OUTPUT.md +263 -0
- package/.agents/flows/common/README.md +29 -0
- package/.agents/flows/common/bugfix-to-verification.md +95 -0
- package/.agents/flows/common/change-to-architecture-review.md +89 -0
- package/.agents/flows/common/change-to-release.md +94 -0
- package/.agents/flows/common/prd-to-delivery.md +184 -0
- package/.agents/flows/common/requirement-to-observability.md +97 -0
- package/.agents/orchestration/README.md +22 -0
- package/.agents/orchestration/expert-dispatch-spec.md +155 -0
- package/.agents/orchestration/expert-executor-spec.md +84 -0
- package/.agents/orchestration/expert-runtime-action-spec.md +73 -0
- package/.agents/orchestration/runtime-state-handoff-spec.md +264 -0
- package/.agents/orchestration/task-anchor-spec.md +212 -0
- package/.agents/orchestration/task-orchestrator-adapter-payload.md +153 -0
- package/.agents/orchestration/task-orchestrator-bootstrap-payload.md +145 -0
- package/.agents/orchestration/task-orchestrator-output-extractor-spec.md +93 -0
- package/.agents/orchestration/task-orchestrator-run-plan-template.md +312 -0
- package/.agents/orchestration/task-orchestrator-runtime-hooks.md +214 -0
- package/.agents/registry/README.md +63 -0
- package/.agents/registry/flows.json +125 -0
- package/.agents/registry/profiles.json +101 -0
- package/.agents/registry/roles.json +1266 -0
- package/.agents/registry/rules.json +148 -0
- package/.agents/registry/scenario-packages.json +123 -0
- package/.agents/registry/skills.json +130 -0
- package/.agents/roles/INDEX.md +346 -0
- package/.agents/roles/common/README.md +76 -0
- package/.agents/roles/common/archive-change.md +80 -0
- package/.agents/roles/common/backend-implementer.md +92 -0
- package/.agents/roles/common/code-guardian.md +151 -0
- package/.agents/roles/common/frontend-implementer.md +146 -0
- package/.agents/roles/common/requirement-analyst.md +138 -0
- package/.agents/roles/common/task-orchestrator-routing.md +301 -0
- package/.agents/roles/common/task-orchestrator.md +224 -0
- package/.agents/roles/common/tooling-implementer.md +92 -0
- package/.agents/roles/domains/README.md +35 -0
- package/.agents/roles/domains/delivery/README.md +11 -0
- package/.agents/roles/domains/delivery/container-specialist.md +50 -0
- package/.agents/roles/domains/delivery/deployment-specialist.md +50 -0
- package/.agents/roles/domains/delivery/pipeline-specialist.md +50 -0
- package/.agents/roles/domains/demand-design/README.md +16 -0
- package/.agents/roles/domains/demand-design/api-contract-specialist.md +52 -0
- package/.agents/roles/domains/demand-design/design-collaborator.md +58 -0
- package/.agents/roles/domains/documentation/README.md +11 -0
- package/.agents/roles/domains/documentation/api-doc-specialist.md +50 -0
- package/.agents/roles/domains/documentation/component-doc-specialist.md +49 -0
- package/.agents/roles/domains/documentation/technical-writing-specialist.md +48 -0
- package/.agents/roles/domains/engineering/README.md +17 -0
- package/.agents/roles/domains/engineering/architecture-advisor.md +53 -0
- package/.agents/roles/domains/engineering/build-specialist.md +51 -0
- package/.agents/roles/domains/engineering/dependency-governor.md +52 -0
- package/.agents/roles/domains/governance/README.md +17 -0
- package/.agents/roles/domains/governance/api-governance-specialist.md +51 -0
- package/.agents/roles/domains/governance/lint-policy-specialist.md +49 -0
- package/.agents/roles/domains/governance/route-governance-specialist.md +52 -0
- package/.agents/roles/domains/observability/README.md +11 -0
- package/.agents/roles/domains/observability/error-tracker.md +50 -0
- package/.agents/roles/domains/observability/event-instrumentation-specialist.md +51 -0
- package/.agents/roles/domains/observability/rum-analyst.md +50 -0
- package/.agents/roles/domains/performance/README.md +11 -0
- package/.agents/roles/domains/performance/asset-optimizer.md +50 -0
- package/.agents/roles/domains/performance/performance-auditor.md +56 -0
- package/.agents/roles/domains/performance/vitals-analyst.md +50 -0
- package/.agents/roles/domains/security-a11y/README.md +11 -0
- package/.agents/roles/domains/security-a11y/a11y-auditor.md +50 -0
- package/.agents/roles/domains/security-a11y/aria-specialist.md +51 -0
- package/.agents/roles/domains/security-a11y/security-reviewer.md +49 -0
- package/.agents/roles/domains/testing/README.md +12 -0
- package/.agents/roles/domains/testing/coverage-analyst.md +50 -0
- package/.agents/roles/domains/testing/e2e-test-specialist.md +51 -0
- package/.agents/roles/domains/testing/unit-test-specialist.md +56 -0
- package/.agents/roles/domains/testing/verification-reviewer.md +67 -0
- package/.agents/rules/README.md +87 -0
- package/.agents/rules/common/02-/347/274/226/347/240/201/350/247/204/350/214/203.md +45 -0
- package/.agents/rules/common/08-/351/200/232/347/224/250/347/272/246/346/235/237.md +63 -0
- package/.agents/rules/common/10-/346/226/207/346/241/243/350/247/204/350/214/203.md +101 -0
- package/.agents/rules/common/12-Superpowers/346/211/247/350/241/214/350/247/204/350/214/203.md +46 -0
- package/.agents/rules/common/14-/345/256/241/350/256/241/346/261/207/346/212/245/350/247/204/350/214/203.md +107 -0
- package/.agents/rules/common/15-visual-gate-wait.md +90 -0
- package/.agents/rules/profiles/nestjs/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +27 -0
- package/.agents/rules/profiles/nestjs/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +20 -0
- package/.agents/rules/profiles/nestjs/04-/346/250/241/345/235/227/347/273/223/346/236/204/350/247/204/350/214/203.md +24 -0
- package/.agents/rules/profiles/nestjs/05-/346/216/245/345/217/243/344/270/216/345/245/221/347/272/246/350/247/204/350/214/203.md +24 -0
- package/.agents/rules/profiles/nestjs/06-/346/225/260/346/215/256/350/256/277/351/227/256/350/247/204/350/214/203.md +24 -0
- package/.agents/rules/profiles/nestjs/07-/351/205/215/347/275/256/344/270/216/350/277/220/350/241/214/346/227/266/350/247/204/350/214/203.md +20 -0
- package/.agents/rules/profiles/nestjs/09-/345/274/202/345/270/270/344/270/216/346/227/245/345/277/227/350/247/204/350/214/203.md +20 -0
- package/.agents/rules/profiles/nestjs/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +24 -0
- package/.agents/rules/profiles/nestjs/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +20 -0
- package/.agents/rules/profiles/node-tooling/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +30 -0
- package/.agents/rules/profiles/node-tooling/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +37 -0
- package/.agents/rules/profiles/node-tooling/04-CLI/344/270/216/346/250/241/345/235/227/350/247/204/350/214/203.md +42 -0
- package/.agents/rules/profiles/node-tooling/05-Contract/344/270/216Schema/350/247/204/350/214/203.md +42 -0
- package/.agents/rules/profiles/node-tooling/06-/350/277/220/350/241/214/346/227/266/346/226/207/344/273/266/350/247/204/350/214/203.md +30 -0
- package/.agents/rules/profiles/node-tooling/07-/346/227/245/345/277/227/344/270/216/351/224/231/350/257/257/345/244/204/347/220/206/350/247/204/350/214/203.md +60 -0
- package/.agents/rules/profiles/node-tooling/09-/350/204/232/346/234/254/344/270/216/345/205/245/345/217/243/350/247/204/350/214/203.md +45 -0
- package/.agents/rules/profiles/node-tooling/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +41 -0
- package/.agents/rules/profiles/node-tooling/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +55 -0
- package/.agents/rules/profiles/react/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +29 -0
- package/.agents/rules/profiles/react/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +104 -0
- package/.agents/rules/profiles/react/04-/347/273/204/344/273/266/350/247/204/350/214/203.md +46 -0
- package/.agents/rules/profiles/react/05-API/350/247/204/350/214/203.md +67 -0
- package/.agents/rules/profiles/react/06-/350/267/257/347/224/261/350/247/204/350/214/203.md +54 -0
- package/.agents/rules/profiles/react/07-/347/212/266/346/200/201/347/256/241/347/220/206.md +226 -0
- package/.agents/rules/profiles/react/09-/346/240/267/345/274/217/350/247/204/350/214/203.md +71 -0
- package/.agents/rules/profiles/react/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +80 -0
- package/.agents/rules/profiles/react/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +159 -0
- package/.agents/rules/profiles/springboot/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +31 -0
- package/.agents/rules/profiles/springboot/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +37 -0
- package/.agents/rules/profiles/springboot/04-/345/210/206/345/261/202/350/247/204/350/214/203.md +33 -0
- package/.agents/rules/profiles/springboot/05-/346/216/245/345/217/243/344/270/216/345/245/221/347/272/246/350/247/204/350/214/203.md +51 -0
- package/.agents/rules/profiles/springboot/06-/346/225/260/346/215/256/350/256/277/351/227/256/350/247/204/350/214/203.md +34 -0
- package/.agents/rules/profiles/springboot/07-/351/205/215/347/275/256/344/270/216/350/277/220/350/241/214/346/227/266/350/247/204/350/214/203.md +38 -0
- package/.agents/rules/profiles/springboot/09-/345/274/202/345/270/270/344/270/216/346/227/245/345/277/227/350/247/204/350/214/203.md +48 -0
- package/.agents/rules/profiles/springboot/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +43 -0
- package/.agents/rules/profiles/springboot/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +48 -0
- package/.agents/rules/profiles/vue/01-/351/241/271/347/233/256/346/246/202/350/277/260.md +47 -0
- package/.agents/rules/profiles/vue/03-/351/241/271/347/233/256/347/273/223/346/236/204.md +106 -0
- package/.agents/rules/profiles/vue/04-/347/273/204/344/273/266/350/247/204/350/214/203.md +61 -0
- package/.agents/rules/profiles/vue/05-API/350/247/204/350/214/203.md +67 -0
- package/.agents/rules/profiles/vue/06-/350/267/257/347/224/261/350/247/204/350/214/203.md +69 -0
- package/.agents/rules/profiles/vue/07-/347/212/266/346/200/201/347/256/241/347/220/206.md +93 -0
- package/.agents/rules/profiles/vue/09-/346/240/267/345/274/217/350/247/204/350/214/203.md +67 -0
- package/.agents/rules/profiles/vue/11-/346/265/213/350/257/225/350/247/204/350/214/203.md +80 -0
- package/.agents/rules/profiles/vue/13-/344/273/243/347/240/201/346/240/274/345/274/217/345/214/226/344/270/216/346/243/200/346/237/245.md +159 -0
- package/.agents/skills/README.md +171 -0
- package/.agents/skills/common/archive-change/SKILL.md +180 -0
- package/.agents/skills/common/branch-code-reviewer/SKILL.md +459 -0
- package/.agents/skills/common/branch-code-reviewer/references/business-risk-guide.md +293 -0
- package/.agents/skills/common/branch-code-reviewer/references/html-template-guide.md +121 -0
- package/.agents/skills/common/config-and-secret-scan/SKILL.md +99 -0
- package/.agents/skills/common/create-proposal/SKILL.md +192 -0
- package/.agents/skills/common/create-proposal/evals/evals.json +16 -0
- package/.agents/skills/common/create-proposal/evals/train_queries.json +18 -0
- package/.agents/skills/common/create-proposal/evals/validation_queries.json +18 -0
- package/.agents/skills/common/create-proposal/references/interaction-spec-template.md +42 -0
- package/.agents/skills/common/create-test/SKILL.md +292 -0
- package/.agents/skills/common/dependency-impact-graph/SKILL.md +80 -0
- package/.agents/skills/common/execute-task/SKILL.md +206 -0
- package/.agents/skills/common/execute-task/evals/evals.json +16 -0
- package/.agents/skills/common/execute-task/evals/train_queries.json +18 -0
- package/.agents/skills/common/execute-task/evals/validation_queries.json +18 -0
- package/.agents/skills/common/find-skills/SKILL.md +144 -0
- package/.agents/skills/common/install-ai-spec-auto/SKILL.md +260 -0
- package/.agents/skills/common/install-ai-spec-auto/evals/evals.json +17 -0
- package/.agents/skills/common/install-ai-spec-auto/evals/train_queries.json +18 -0
- package/.agents/skills/common/install-ai-spec-auto/evals/validation_queries.json +18 -0
- package/.agents/skills/common/project-init/SKILL.md +178 -0
- package/.agents/skills/common/project-init/evals/evals.json +16 -0
- package/.agents/skills/common/project-init/evals/train_queries.json +18 -0
- package/.agents/skills/common/project-init/evals/validation_queries.json +18 -0
- package/.agents/skills/common/project-init/references/custom-rule-generation.md +89 -0
- package/.agents/skills/common/project-init/references/deep-scan-rules.md +67 -0
- package/.agents/skills/common/project-init/references/output-contracts.md +71 -0
- package/.agents/skills/common/project-init/references/repo-fact-gathering.md +83 -0
- package/.agents/skills/common/project-init/references/scope-resolution.md +76 -0
- package/.agents/skills/common/project-init/scripts/inspect-project.js +112 -0
- package/.agents/skills/common/skill-creator/LICENSE.txt +202 -0
- package/.agents/skills/common/skill-creator/SKILL.md +370 -0
- package/.agents/skills/common/skill-creator/evals/evals.json +16 -0
- package/.agents/skills/common/skill-creator/evals/train_queries.json +18 -0
- package/.agents/skills/common/skill-creator/evals/validation_queries.json +18 -0
- package/.agents/skills/common/skill-creator/references/output-patterns.md +82 -0
- package/.agents/skills/common/skill-creator/references/workflows.md +28 -0
- package/.agents/skills/common/skill-creator/scripts/init_skill.py +209 -0
- package/.agents/skills/common/skill-creator/scripts/package_skill.py +110 -0
- package/.agents/skills/common/skill-creator/scripts/quick_validate.py +51 -0
- package/.agents/skills/common/skill-optimizer/SKILL.md +102 -0
- package/.agents/skills/common/skill-optimizer/evals/evals.json +16 -0
- package/.agents/skills/common/skill-optimizer/evals/train_queries.json +18 -0
- package/.agents/skills/common/skill-optimizer/evals/validation_queries.json +18 -0
- package/.agents/skills/common/skill-optimizer/references/design-patterns.md +26 -0
- package/.agents/skills/common/skill-optimizer/references/review-checklist.md +22 -0
- package/.agents/skills/common/using-superpowers/SKILL.md +151 -0
- package/.agents/skills/common/wait-for-gate-signal/SKILL.md +85 -0
- package/.agents/skills/domains/README.md +19 -0
- package/.agents/skills/domains/ui-ux-pro-max/SKILL.md +58 -0
- package/.agents/skills/domains/web/design-analysis/SKILL.md +89 -0
- package/.agents/skills/domains/web/design-analysis/rules/analysis-order.md +61 -0
- package/.agents/skills/domains/web/design-analysis/rules/analysis-priorities.md +136 -0
- package/.agents/skills/domains/web/design-analysis/rules/checklist-common-misses.md +107 -0
- package/.agents/skills/domains/web/design-analysis/rules/implementation-common-errors.md +204 -0
- package/.agents/skills/domains/web/design-analysis/rules/implementation-guidelines.md +211 -0
- package/.agents/skills/domains/web/design-analysis/rules/output-analysis-checklist.md +247 -0
- package/.agents/skills/domains/web/design-analysis/rules/tools-design-guidelines.md +108 -0
- package/.agents/skills/domains/web/design-analysis/rules/workflow-element-extraction.md +162 -0
- package/.agents/skills/domains/web/design-analysis/rules/workflow-layout-map.md +131 -0
- package/.agents/skills/domains/web/design-analysis/rules/workflow-output-checklist.md +70 -0
- package/.agents/skills/domains/web/design-analysis/rules/workflow-style-summary.md +91 -0
- package/.agents/skills/domains/web/route-permission-map/SKILL.md +103 -0
- package/.agents/skills/domains/web/ui-verification/SKILL.md +114 -0
- package/.agents/skills/domains/web/ui-verification/evals/evals.json +16 -0
- package/.agents/skills/domains/web/ui-verification/evals/train_queries.json +18 -0
- package/.agents/skills/domains/web/ui-verification/evals/validation_queries.json +18 -0
- package/.agents/skills/domains/web/ui-verification/rules/comparison-content-image.md +34 -0
- package/.agents/skills/domains/web/ui-verification/rules/comparison-content-text.md +30 -0
- package/.agents/skills/domains/web/ui-verification/rules/comparison-hierarchy.md +33 -0
- package/.agents/skills/domains/web/ui-verification/rules/comparison-layout.md +35 -0
- package/.agents/skills/domains/web/ui-verification/rules/errors-alignment.md +42 -0
- package/.agents/skills/domains/web/ui-verification/rules/errors-button-dimensions.md +28 -0
- package/.agents/skills/domains/web/ui-verification/rules/errors-button-position.md +25 -0
- package/.agents/skills/domains/web/ui-verification/rules/errors-css-priority.md +50 -0
- package/.agents/skills/domains/web/ui-verification/rules/errors-flex-column-width.md +46 -0
- package/.agents/skills/domains/web/ui-verification/rules/errors-flex-layout.md +46 -0
- package/.agents/skills/domains/web/ui-verification/rules/errors-grid-container-width.md +44 -0
- package/.agents/skills/domains/web/ui-verification/rules/errors-page-container-width.md +39 -0
- package/.agents/skills/domains/web/ui-verification/rules/tools-browser-navigation.md +53 -0
- package/.agents/skills/domains/web/ui-verification/rules/tools-design-guidelines.md +53 -0
- package/.agents/skills/domains/web/ui-verification/rules/workflow-checklist.md +27 -0
- package/.agents/skills/domains/web/ui-verification/rules/workflow-problem-list.md +56 -0
- package/.agents/skills/domains/web/ui-verification/rules/workflow-reflection.md +44 -0
- package/.agents/skills/domains/web/ui-verification/rules/writing-alignment.md +44 -0
- package/.agents/skills/domains/web/ui-verification/rules/writing-element-completeness.md +63 -0
- package/.agents/skills/domains/web/ui-verification/rules/writing-list-layout.md +75 -0
- package/.agents/skills/domains/web/ui-verification/rules/writing-page-container-width.md +37 -0
- package/.agents/skills/domains/web/web-design-guidelines/SKILL.md +40 -0
- package/.agents/skills/profiles/nestjs/README.md +4 -0
- package/.agents/skills/profiles/node-tooling/README.md +9 -0
- package/.agents/skills/profiles/react/create-api/SKILL.md +145 -0
- package/.agents/skills/profiles/react/create-component/SKILL.md +160 -0
- package/.agents/skills/profiles/react/create-route/SKILL.md +168 -0
- package/.agents/skills/profiles/react/create-store/SKILL.md +262 -0
- package/.agents/skills/profiles/react/theme-variables/SKILL.md +82 -0
- package/.agents/skills/profiles/react/vercel-composition-patterns/AGENTS.md +899 -0
- package/.agents/skills/profiles/react/vercel-composition-patterns/SKILL.md +81 -0
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -0
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/architecture-compound-components.md +112 -0
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -0
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -0
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-context-interface.md +191 -0
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -0
- package/.agents/skills/profiles/react/vercel-composition-patterns/rules/state-lift-state.md +125 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/AGENTS.md +2934 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/SKILL.md +136 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-api-routes.md +38 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-defer-await.md +80 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-dependencies.md +51 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-parallel.md +28 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-barrel-imports.md +59 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/bundle-preload.md +50 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-early-exit.md +50 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-index-maps.md +37 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-activity.md +26 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-memo.md +44 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-cache-react.md +76 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
- package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-serialization.md +38 -0
- package/.agents/skills/profiles/springboot/README.md +10 -0
- package/.agents/skills/profiles/vue/create-api/SKILL.md +105 -0
- package/.agents/skills/profiles/vue/create-component/SKILL.md +76 -0
- package/.agents/skills/profiles/vue/create-route/SKILL.md +141 -0
- package/.agents/skills/profiles/vue/create-store/SKILL.md +97 -0
- package/.agents/skills/profiles/vue/create-view/SKILL.md +81 -0
- package/.agents/skills/profiles/vue/theme-variables/SKILL.md +73 -0
- package/.agents/skills/profiles/vue/vue-best-practices/SKILL.md +166 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/animation-class-based-technique.md +254 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/animation-state-driven-technique.md +291 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-async.md +97 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-data-flow.md +307 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-fallthrough-attrs.md +174 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-keep-alive.md +137 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-slots.md +216 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-suspense.md +228 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-teleport.md +108 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-transition-group.md +128 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/component-transition.md +125 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/composables.md +290 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/directives.md +162 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/perf-avoid-component-abstraction-in-lists.md +159 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/perf-v-once-v-memo-directives.md +182 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/perf-virtualize-large-lists.md +187 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/plugins.md +166 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/reactivity.md +344 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/render-functions.md +201 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/sfc.md +310 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/state-management.md +135 -0
- package/.agents/skills/profiles/vue/vue-best-practices/references/updated-hook-performance.md +187 -0
- package/.agents/templates/common/README.md +23 -0
- package/.agents/templates/common/bugfix.md +22 -0
- package/.agents/templates/common/create-expert-package.md +458 -0
- package/.agents/templates/common/mock-page.md +28 -0
- package/.agents/templates/common/new-component.md +25 -0
- package/.agents/templates/common/new-page.md +31 -0
- package/.cursor/mcp.json +36 -0
- package/.qoder/README.md +114 -0
- package/.qoder/commands +1 -0
- package/.qoder/mcp.json +26 -0
- package/.qoder/rules +1 -0
- package/.qoder/skills +1 -0
- package/LICENSE +21 -0
- package/README.md +433 -0
- package/bin/archive-change.js +474 -0
- package/bin/check-command.js +62 -0
- package/bin/cli.js +295 -0
- package/bin/command-template-renderer.js +40 -0
- package/bin/context-command.js +102 -0
- package/bin/demo-runtime-smoke.js +760 -0
- package/bin/execution-semantics.js +821 -0
- package/bin/executor-command.js +93 -0
- package/bin/expert-dispatch.js +334 -0
- package/bin/expert-executor.js +1148 -0
- package/bin/guard-command.js +52 -0
- package/bin/hub-command.js +876 -0
- package/bin/ide-command.js +242 -0
- package/bin/init-command.js +193 -0
- package/bin/install-workflow.js +2983 -0
- package/bin/manifest-export.js +34 -0
- package/bin/profile-registry.js +90 -0
- package/bin/protocol-workflow.js +446 -0
- package/bin/repair-command.js +161 -0
- package/bin/repo-map.js +177 -0
- package/bin/report-command.js +236 -0
- package/bin/runtime-bootstrap.js +428 -0
- package/bin/runtime-embedded.js +101 -0
- package/bin/runtime-fallback.js +106 -0
- package/bin/runtime-launcher.js +116 -0
- package/bin/runtime-paths.js +177 -0
- package/bin/runtime-registry.js +289 -0
- package/bin/runtime-state.js +2541 -0
- package/bin/scan.js +96 -0
- package/bin/self-upgrade.js +206 -0
- package/bin/skill-spec-validator.js +457 -0
- package/bin/spec-command.js +366 -0
- package/bin/superpowers.js +384 -0
- package/bin/sync-command.js +59 -0
- package/bin/sync.js +1904 -0
- package/bin/task-orchestrator-adapter.js +341 -0
- package/bin/task-orchestrator-extractor.js +274 -0
- package/bin/task-orchestrator-runner.js +1208 -0
- package/bin/telemetry/README.md +66 -0
- package/bin/telemetry/aspect.js +153 -0
- package/bin/telemetry/collect.js +67 -0
- package/bin/telemetry/config.js +114 -0
- package/bin/telemetry/defaults.json +5 -0
- package/bin/telemetry/healthcheck.js +195 -0
- package/bin/telemetry/identity.js +53 -0
- package/bin/telemetry/index.js +25 -0
- package/bin/telemetry/reporter.js +83 -0
- package/bin/telemetry/safe.js +39 -0
- package/bin/validate-registry.js +740 -0
- package/bin/visual-bridge-config.js +117 -0
- package/bin/visual-bridge.js +287 -0
- package/bin/visual-command.js +432 -0
- package/bin/worktree-command.js +194 -0
- package/configs/common/.editorconfig +15 -0
- package/configs/common/.husky/commit-msg +4 -0
- package/configs/common/.husky/pre-commit +4 -0
- package/configs/common/.lintstagedrc +11 -0
- package/configs/common/.prettierignore +11 -0
- package/configs/common/.prettierrc.json +11 -0
- package/configs/common/.stylelintignore +14 -0
- package/configs/common/.stylelintrc.json +21 -0
- package/configs/common/commitlint.config.js +3 -0
- package/configs/profiles/nestjs/.gitkeep +1 -0
- package/configs/profiles/node-tooling/.gitkeep +1 -0
- package/configs/profiles/react/.eslintignore +6 -0
- package/configs/profiles/react/.eslintrc.js +16 -0
- package/configs/profiles/react/.stylelintrc.json +18 -0
- package/configs/profiles/springboot/.gitkeep +1 -0
- package/configs/profiles/vue/.eslintignore +7 -0
- package/configs/profiles/vue/.eslintrc.cjs +17 -0
- package/contracts/README.md +28 -0
- package/contracts/fixtures/asset-package.fixture.json +26 -0
- package/contracts/fixtures/asset-usage-feedback.fixture.json +14 -0
- package/contracts/fixtures/evidence-report.fixture.json +28 -0
- package/contracts/fixtures/manifest.fixture.json +20 -0
- package/contracts/fixtures/run-event.fixture.json +15 -0
- package/contracts/schemas/asset-package.schema.json +76 -0
- package/contracts/schemas/asset-usage-feedback.schema.json +57 -0
- package/contracts/schemas/evidence-report.schema.json +60 -0
- package/contracts/schemas/manifest.schema.json +63 -0
- package/contracts/schemas/run-event.schema.json +72 -0
- package/install.ps1 +35 -0
- package/install.sh +17 -0
- package/internal/ai-protocol-workflow.js +5600 -0
- package/internal/hub-client.js +98 -0
- package/internal/hub-sync-selection.js +69 -0
- package/internal/visual-hooks/README.md +481 -0
- package/internal/visual-hooks/config-loader.js +218 -0
- package/internal/visual-hooks/control-puller.js +206 -0
- package/internal/visual-hooks/gate-signal.js +150 -0
- package/internal/visual-hooks/inbox-consumer.js +469 -0
- package/internal/visual-hooks/index.js +197 -0
- package/internal/visual-hooks/push-client.js +189 -0
- package/internal/visual-hooks/receipt-pusher.js +176 -0
- package/internal/visual-hooks/runtime-state-pusher.js +128 -0
- package/openspec/changes/.gitkeep +0 -0
- package/openspec/changes/archive/.gitkeep +0 -0
- package/openspec/config.yaml.template +52 -0
- package/openspec/schemas/expert-delivery/schema.yaml +68 -0
- package/openspec/schemas/expert-delivery/templates/checklist.md +39 -0
- package/openspec/schemas/expert-delivery/templates/design.md +61 -0
- package/openspec/schemas/expert-delivery/templates/iterations.md +25 -0
- package/openspec/schemas/expert-delivery/templates/proposal.md +45 -0
- package/openspec/schemas/expert-delivery/templates/spec.md +29 -0
- package/openspec/schemas/expert-delivery/templates/tasks.md +24 -0
- package/openspec/specs/.gitkeep +0 -0
- package/package.json +73 -0
- package/scripts/acceptance-zero-intrusion.sh +168 -0
- package/scripts/hub-sync-assets.config.example.json +296 -0
- package/scripts/hub-sync-assets.js +2038 -0
- package/scripts/local-verify.sh +280 -0
- package/scripts/post-publish-auto-fix-check.js +404 -0
- package/scripts/post-publish-verify.sh +175 -0
- package/scripts/setup-cursor-manual-test.sh +107 -0
- package/scripts/setup-cursor-spec-archive-test.sh +111 -0
- package/scripts/setup-visual-integration.sh +225 -0
- package/scripts/test-integration.sh +176 -0
- package/scripts/update-test-project.sh +93 -0
- package/scripts/upload-four-web.sh +57 -0
- package/scripts/verify-install-ps1-bom.js +26 -0
- package/src/agent/agent-context.js +259 -0
- package/src/agent/agent-profile.js +185 -0
- package/src/agent/agent-templates.js +161 -0
- package/src/agent/agent-types.js +108 -0
- package/src/agent/collaboration-protocol.js +333 -0
- package/src/agent/conflict-handler.js +364 -0
- package/src/agent/file-permission.js +121 -0
- package/src/agent/index.js +38 -0
- package/src/agent/permission-audit.js +151 -0
- package/src/agent/review-repair-loop.js +270 -0
- package/src/agent/tool-permission.js +101 -0
- package/src/asset/asset-dependency.js +322 -0
- package/src/asset/asset-feedback.js +350 -0
- package/src/asset/asset-fork.js +300 -0
- package/src/asset/asset-install.js +278 -0
- package/src/asset/asset-installer.js +497 -0
- package/src/asset/asset-lifecycle.js +324 -0
- package/src/asset/asset-manager.js +245 -0
- package/src/asset/asset-package-manager.js +349 -0
- package/src/asset/asset-package.js +186 -0
- package/src/asset/asset-quality.js +262 -0
- package/src/asset/asset-registry.js +387 -0
- package/src/asset/asset-version.js +293 -0
- package/src/asset/index.js +86 -0
- package/src/cache/agent-profile-cache.js +59 -0
- package/src/cache/asset-cache.js +63 -0
- package/src/cache/global-cache.js +61 -0
- package/src/cache/manifest-cache.js +30 -0
- package/src/check/check-service.js +32 -0
- package/src/config/config-layer.js +343 -0
- package/src/config/config-loader.js +60 -0
- package/src/config/defaults.js +49 -0
- package/src/connectors/hub/asset-package.js +72 -0
- package/src/connectors/hub/asset-usage-feedback.js +46 -0
- package/src/connectors/hub/hub-connector.js +44 -0
- package/src/connectors/hub/index.js +21 -0
- package/src/connectors/visual/evidence-report.js +49 -0
- package/src/connectors/visual/index.js +15 -0
- package/src/connectors/visual/queue.js +41 -0
- package/src/connectors/visual/run-event.js +81 -0
- package/src/connectors/visual/visual-connector.js +77 -0
- package/src/context/context-budget.js +59 -0
- package/src/context/context-builder.js +285 -0
- package/src/context/context-loader.js +116 -0
- package/src/context/context-planner.js +158 -0
- package/src/context/types.js +96 -0
- package/src/contracts/index.js +63 -0
- package/src/executor/executor-registry.js +78 -0
- package/src/executor/executor-result-parser.js +44 -0
- package/src/executor/executor-runner.js +141 -0
- package/src/executor/executor-selector.js +139 -0
- package/src/executor/executor-timeout.js +36 -0
- package/src/executor/providers/base-provider-utils.js +189 -0
- package/src/executor/providers/claude-code-executor-provider.js +128 -0
- package/src/executor/providers/codex-executor-provider.js +126 -0
- package/src/executor/providers/cursor-executor-provider.js +99 -0
- package/src/executor/types.js +137 -0
- package/src/git/branch-manager.js +71 -0
- package/src/git/dirty-checker.js +43 -0
- package/src/git/dirty-strategy-handler.js +29 -0
- package/src/git/git-command.js +37 -0
- package/src/git/git-repository-detector.js +45 -0
- package/src/git/multi-repo-worktree-planner.js +88 -0
- package/src/git/policy.js +19 -0
- package/src/git/strategies/block-dirty-strategy.js +34 -0
- package/src/git/strategies/ignore-dirty-strategy.js +33 -0
- package/src/git/strategies/patch-snapshot-strategy.js +53 -0
- package/src/git/strategies/wip-commit-strategy.js +38 -0
- package/src/git/types.js +71 -0
- package/src/git/worktree-manager.js +85 -0
- package/src/governance/asset-review.js +351 -0
- package/src/governance/audit-log.js +368 -0
- package/src/governance/gray-release.js +312 -0
- package/src/governance/index.js +31 -0
- package/src/governance/policy-types.js +56 -0
- package/src/governance/rbac-types.js +171 -0
- package/src/governance/rbac.js +382 -0
- package/src/governance/rollback.js +360 -0
- package/src/governance/security-policy.js +354 -0
- package/src/hook/hook-config-writer.js +125 -0
- package/src/hub/hub-client.js +186 -0
- package/src/hub/hub-config.js +39 -0
- package/src/hub/project-facts.js +31 -0
- package/src/hub/runtime-feedback-reporter.js +55 -0
- package/src/ide/adapters/adapter-protocol.js +385 -0
- package/src/ide/adapters/claude-adapter.js +419 -0
- package/src/ide/adapters/codex-adapter.js +60 -0
- package/src/ide/adapters/cursor-adapter.js +484 -0
- package/src/ide/adapters/index.js +24 -0
- package/src/ide/anchors/markdown-anchor-writer.js +152 -0
- package/src/ide/ide-service.js +270 -0
- package/src/ide/ide-types.js +94 -0
- package/src/ide/links/link-mode-resolver.js +160 -0
- package/src/ide/registry/ide-registry-builder.js +165 -0
- package/src/incident/incident-writer.js +47 -0
- package/src/incident/types.js +22 -0
- package/src/init/ide-linker.js +126 -0
- package/src/init/ide-pointer-injector.js +75 -0
- package/src/init/init-applier.js +197 -0
- package/src/init/init-plan.js +294 -0
- package/src/init/init-service.js +65 -0
- package/src/init/manifest-installer.js +302 -0
- package/src/init/types.js +26 -0
- package/src/project/config-writer.js +83 -0
- package/src/project/context-index-writer.js +82 -0
- package/src/project/json-utils.js +72 -0
- package/src/project/local-state-writer.js +50 -0
- package/src/project/lock-file-writer.js +98 -0
- package/src/project/manifest-writer.js +126 -0
- package/src/project/policy-config-writer.js +91 -0
- package/src/project/project-config-writer.js +74 -0
- package/src/project/project-files.js +39 -0
- package/src/project/registry-index-writer.js +43 -0
- package/src/project/workspace-config-writer.js +63 -0
- package/src/run/index.js +11 -0
- package/src/run/run-id.js +32 -0
- package/src/run/run-service.js +269 -0
- package/src/run/run-store.js +80 -0
- package/src/scanner/aggregator/detection-aggregator.js +23 -0
- package/src/scanner/boundary/boundary-resolver.js +229 -0
- package/src/scanner/detectors/detector-registry.js +44 -0
- package/src/scanner/detectors/fastapi-detector.js +46 -0
- package/src/scanner/detectors/go-detector.js +46 -0
- package/src/scanner/detectors/nestjs-detector.js +57 -0
- package/src/scanner/detectors/nextjs-detector.js +52 -0
- package/src/scanner/detectors/react-vite-detector.js +52 -0
- package/src/scanner/detectors/react-webpack-detector.js +57 -0
- package/src/scanner/detectors/springboot-detector.js +46 -0
- package/src/scanner/detectors/springcloud-detector.js +46 -0
- package/src/scanner/detectors/springmvc-detector.js +46 -0
- package/src/scanner/detectors/vue-vite-detector.js +52 -0
- package/src/scanner/engine.js +72 -0
- package/src/scanner/facts/fact-extractor.js +211 -0
- package/src/scanner/types.js +30 -0
- package/src/security/asset-tamper-checker.js +188 -0
- package/src/security/checksum.js +40 -0
- package/src/spec/spec-writer.js +302 -0
- package/src/state-machine/circuit-breaker.js +112 -0
- package/src/state-machine/escape-hatch.js +49 -0
- package/src/state-machine/stage-runner.js +281 -0
- package/src/state-machine/state-machine.js +24 -0
- package/src/state-machine/transition-guard.js +36 -0
- package/src/state-machine/types.js +37 -0
- package/src/sync/sync-service.js +192 -0
- package/src/visual/agent-visual.js +142 -0
- package/src/visual/event-gateway.js +357 -0
- package/src/visual/event-mapper.js +128 -0
- package/src/visual/hook-dashboard.js +216 -0
- package/src/visual/index.js +27 -0
- package/src/visual/metrics.js +287 -0
- package/src/visual/privacy-filter.js +100 -0
- package/src/visual/risk-board.js +252 -0
- package/src/visual/timeline.js +245 -0
- package/src/visual/visual-client.js +94 -0
- package/src/visual/visual-config.js +40 -0
- package/src/visual/visual-reporter.js +88 -0
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"skill_name": "create-proposal",
|
|
3
|
+
"evals": [
|
|
4
|
+
{
|
|
5
|
+
"id": "proposal-output-1",
|
|
6
|
+
"prompt": "用户要发起一个带设计稿和未就绪接口的新页面需求,请给出提案前置分析、上下文注入重点和后置检查项。",
|
|
7
|
+
"files": [],
|
|
8
|
+
"expected_output": "输出应覆盖设计稿、接口状态、交付形态、复杂交互、后置检查和下一步 apply/execute-task 提示。",
|
|
9
|
+
"assertions": [
|
|
10
|
+
"说明何时触发 design-analysis",
|
|
11
|
+
"明确 mock 与真实接口边界",
|
|
12
|
+
"包含后置检查与下一步建议"
|
|
13
|
+
]
|
|
14
|
+
}
|
|
15
|
+
]
|
|
16
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"query": "帮我给这个新页面需求起一个 OpenSpec 提案",
|
|
4
|
+
"should_trigger": true
|
|
5
|
+
},
|
|
6
|
+
{
|
|
7
|
+
"query": "我要发起一个包含 UI 和接口的需求 proposal",
|
|
8
|
+
"should_trigger": true
|
|
9
|
+
},
|
|
10
|
+
{
|
|
11
|
+
"query": "开始按 tasks.md 写代码",
|
|
12
|
+
"should_trigger": false
|
|
13
|
+
},
|
|
14
|
+
{
|
|
15
|
+
"query": "把这个变更归档",
|
|
16
|
+
"should_trigger": false
|
|
17
|
+
}
|
|
18
|
+
]
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"query": "在 /opsx:propose 之前先帮我梳理需求和设计稿输入",
|
|
4
|
+
"should_trigger": true
|
|
5
|
+
},
|
|
6
|
+
{
|
|
7
|
+
"query": "我要新增一个带 mock 数据的页面提案",
|
|
8
|
+
"should_trigger": true
|
|
9
|
+
},
|
|
10
|
+
{
|
|
11
|
+
"query": "执行下一个开发任务",
|
|
12
|
+
"should_trigger": false
|
|
13
|
+
},
|
|
14
|
+
{
|
|
15
|
+
"query": "检查页面和设计稿差异",
|
|
16
|
+
"should_trigger": false
|
|
17
|
+
}
|
|
18
|
+
]
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# 交互说明模板
|
|
2
|
+
|
|
3
|
+
当需求包含搜索、表单、弹窗、批量操作、复杂状态切换等交互时,可先按这份模板收口,再写入 `proposal / design / tasks`。
|
|
4
|
+
|
|
5
|
+
```md
|
|
6
|
+
## 交互说明
|
|
7
|
+
|
|
8
|
+
### 页面概述
|
|
9
|
+
- 目标:
|
|
10
|
+
- 入口:
|
|
11
|
+
- 关键用户路径:
|
|
12
|
+
|
|
13
|
+
### 布局与区域
|
|
14
|
+
- 主区域:
|
|
15
|
+
- 次区域:
|
|
16
|
+
- 响应式注意点:
|
|
17
|
+
|
|
18
|
+
### 关键交互
|
|
19
|
+
#### 搜索 / 筛选
|
|
20
|
+
- 字段:
|
|
21
|
+
- 查询时机:
|
|
22
|
+
- 重置行为:
|
|
23
|
+
|
|
24
|
+
#### 表单 / 弹窗
|
|
25
|
+
- 打开条件:
|
|
26
|
+
- 校验规则:
|
|
27
|
+
- 提交成功 / 失败反馈:
|
|
28
|
+
|
|
29
|
+
#### 列表 / 批量操作
|
|
30
|
+
- 批量选择:
|
|
31
|
+
- 空态 / 加载态 / 错误态:
|
|
32
|
+
- 分页与筛选联动:
|
|
33
|
+
|
|
34
|
+
### 数据与状态
|
|
35
|
+
- 数据来源:
|
|
36
|
+
- mock / 真实接口边界:
|
|
37
|
+
- 本地状态与全局状态分工:
|
|
38
|
+
|
|
39
|
+
### 验收关注点
|
|
40
|
+
- 用户是否能完成关键路径:
|
|
41
|
+
- 是否存在易错或易漏状态:
|
|
42
|
+
```
|
|
@@ -0,0 +1,292 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: create-test
|
|
3
|
+
description: 当需要为功能模块编写单元测试或集成测试时使用本技能。指导按团队规范创建 Vitest 测试文件,涵盖命名约定、断言模式、Mock 策略与覆盖率要求。
|
|
4
|
+
compatibility: Assumes a local TypeScript/JavaScript repository with Vitest-compatible tooling and .agents/rules/common testing conventions.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# 创建测试
|
|
8
|
+
|
|
9
|
+
## 使用时机
|
|
10
|
+
|
|
11
|
+
当出现以下场景时使用本技能:
|
|
12
|
+
|
|
13
|
+
- 为新增的工具函数、Store 逻辑、数据转换编写**单元测试**
|
|
14
|
+
- 为关键用户交互流程编写**组件测试**或**集成测试**
|
|
15
|
+
- 重构现有模块后需补充或更新测试用例
|
|
16
|
+
- `execute-task` 技能中 TDD 落地编码阶段需要创建测试文件
|
|
17
|
+
|
|
18
|
+
## 环境依赖
|
|
19
|
+
|
|
20
|
+
- 默认面向本仓库的 `.agents/rules/common/11-测试规范.md`
|
|
21
|
+
- 示例以 Vitest 为主,若项目测试栈不同,需要按项目实际工具调整
|
|
22
|
+
|
|
23
|
+
## 注意事项
|
|
24
|
+
|
|
25
|
+
- 不要为了“补覆盖率”去 mock 被测模块内部逻辑
|
|
26
|
+
- 测试文件应跟随真实代码落点,不要新造一套平行目录
|
|
27
|
+
- 组件测试只在项目已具备对应测试运行条件时再补
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## 步骤
|
|
32
|
+
|
|
33
|
+
### 步骤 1:确认测试目标与类型
|
|
34
|
+
|
|
35
|
+
1. 明确被测模块:工具函数、Store、组件、业务逻辑。
|
|
36
|
+
2. 确定测试级别:
|
|
37
|
+
|
|
38
|
+
| 级别 | 适用对象 | 说明 |
|
|
39
|
+
|------|----------|------|
|
|
40
|
+
| 单元测试 | 工具函数、纯逻辑、数据转换 | 隔离测试单个函数/模块的输入输出 |
|
|
41
|
+
| 组件测试 | UI 组件交互 | 使用 `@testing-library/react` 或 `@vue/test-utils` |
|
|
42
|
+
| 集成测试 | 多模块协作流程 | 验证模块间协作的正确性 |
|
|
43
|
+
|
|
44
|
+
### 步骤 2:创建测试文件
|
|
45
|
+
|
|
46
|
+
1. 在被测源文件**同目录**下创建测试文件。
|
|
47
|
+
2. 文件命名:`<源文件名>.test.ts`(逻辑)或 `<源文件名>.test.tsx`(React 组件)。
|
|
48
|
+
3. 导入 Vitest API 与被测模块。
|
|
49
|
+
|
|
50
|
+
```text
|
|
51
|
+
src/utils/
|
|
52
|
+
├── formatDate.ts
|
|
53
|
+
└── formatDate.test.ts # 与源文件同目录
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
### 步骤 3:编写测试用例
|
|
57
|
+
|
|
58
|
+
按 **Arrange-Act-Assert** 模式编写每个测试:
|
|
59
|
+
|
|
60
|
+
1. **Arrange**:准备测试数据和前置条件。
|
|
61
|
+
2. **Act**:调用被测函数或触发被测行为。
|
|
62
|
+
3. **Assert**:断言结果符合预期。
|
|
63
|
+
|
|
64
|
+
```ts
|
|
65
|
+
import { describe, it, expect } from 'vitest';
|
|
66
|
+
import { formatDate } from './formatDate';
|
|
67
|
+
|
|
68
|
+
describe('formatDate', () => {
|
|
69
|
+
it('应将时间戳转换为 YYYY-MM-DD 格式', () => {
|
|
70
|
+
const timestamp = 1700000000000;
|
|
71
|
+
const result = formatDate(timestamp);
|
|
72
|
+
expect(result).toBe('2023-11-15');
|
|
73
|
+
});
|
|
74
|
+
|
|
75
|
+
it('传入 null 时应返回空字符串', () => {
|
|
76
|
+
expect(formatDate(null)).toBe('');
|
|
77
|
+
});
|
|
78
|
+
|
|
79
|
+
it('传入 undefined 时应返回空字符串', () => {
|
|
80
|
+
expect(formatDate(undefined)).toBe('');
|
|
81
|
+
});
|
|
82
|
+
});
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
### 步骤 4:补充边界与异常用例
|
|
86
|
+
|
|
87
|
+
每个被测函数至少覆盖:
|
|
88
|
+
|
|
89
|
+
- **正常路径**:典型输入的预期输出
|
|
90
|
+
- **边界值**:空值、零值、极大/极小值、空数组/空对象
|
|
91
|
+
- **异常输入**:类型错误、格式异常、非法参数
|
|
92
|
+
- **特殊场景**:并发、超时等(视业务而定)
|
|
93
|
+
|
|
94
|
+
### 步骤 5:运行测试并确认通过
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
npx vitest run <测试文件路径>
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
确认所有用例通过后,再提交代码。
|
|
101
|
+
|
|
102
|
+
---
|
|
103
|
+
|
|
104
|
+
## 命名约定
|
|
105
|
+
|
|
106
|
+
### 文件命名
|
|
107
|
+
|
|
108
|
+
| 类型 | 命名规则 | 示例 |
|
|
109
|
+
|------|----------|------|
|
|
110
|
+
| 逻辑/工具测试 | `<name>.test.ts` | `formatDate.test.ts` |
|
|
111
|
+
| React 组件测试 | `<name>.test.tsx` | `UserCard.test.tsx` |
|
|
112
|
+
| Vue 组件测试 | `<name>.test.ts` | `UserCard.test.ts` |
|
|
113
|
+
| 公共 Mock / 辅助 | 放置于 `tests/` 或 `src/__tests__/helpers/` | `tests/mocks/mockUser.ts` |
|
|
114
|
+
|
|
115
|
+
### 描述命名
|
|
116
|
+
|
|
117
|
+
- `describe` 块:使用被测模块名称(函数名、组件名、Store 名)
|
|
118
|
+
- `it` / `test` 块:使用**中文**描述预期行为,格式为「应……」或「当……时应……」
|
|
119
|
+
- 描述表达**预期行为**,而非实现步骤
|
|
120
|
+
|
|
121
|
+
```ts
|
|
122
|
+
describe('useAuthStore', () => {
|
|
123
|
+
it('登录成功后应保存用户信息到 state', () => { /* ... */ });
|
|
124
|
+
it('token 过期时应自动清除登录状态', () => { /* ... */ });
|
|
125
|
+
it('当网络异常时应抛出错误并保持原状态', () => { /* ... */ });
|
|
126
|
+
});
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
---
|
|
130
|
+
|
|
131
|
+
## 测试模式
|
|
132
|
+
|
|
133
|
+
### 单元测试模式
|
|
134
|
+
|
|
135
|
+
隔离测试纯函数,不依赖外部环境:
|
|
136
|
+
|
|
137
|
+
```ts
|
|
138
|
+
describe('calculateTotal', () => {
|
|
139
|
+
it('应正确计算商品总价', () => {
|
|
140
|
+
const items = [
|
|
141
|
+
{ price: 10, quantity: 2 },
|
|
142
|
+
{ price: 20, quantity: 1 },
|
|
143
|
+
];
|
|
144
|
+
expect(calculateTotal(items)).toBe(40);
|
|
145
|
+
});
|
|
146
|
+
|
|
147
|
+
it('空数组应返回 0', () => {
|
|
148
|
+
expect(calculateTotal([])).toBe(0);
|
|
149
|
+
});
|
|
150
|
+
});
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
### Mock 策略
|
|
154
|
+
|
|
155
|
+
遵循原则:**Mock 外部依赖,不 Mock 被测模块内部。**
|
|
156
|
+
|
|
157
|
+
#### API 请求 Mock
|
|
158
|
+
|
|
159
|
+
```ts
|
|
160
|
+
import { vi } from 'vitest';
|
|
161
|
+
import { fetchUser } from './api';
|
|
162
|
+
|
|
163
|
+
vi.mock('./api', () => ({
|
|
164
|
+
fetchUser: vi.fn(),
|
|
165
|
+
}));
|
|
166
|
+
|
|
167
|
+
describe('UserService', () => {
|
|
168
|
+
it('应正确处理用户数据', async () => {
|
|
169
|
+
vi.mocked(fetchUser).mockResolvedValue({ id: 1, name: '张三' });
|
|
170
|
+
const result = await getUserInfo(1);
|
|
171
|
+
expect(result.name).toBe('张三');
|
|
172
|
+
});
|
|
173
|
+
|
|
174
|
+
it('接口异常时应抛出错误', async () => {
|
|
175
|
+
vi.mocked(fetchUser).mockRejectedValue(new Error('网络错误'));
|
|
176
|
+
await expect(getUserInfo(1)).rejects.toThrow('网络错误');
|
|
177
|
+
});
|
|
178
|
+
});
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
#### 定时器 Mock
|
|
182
|
+
|
|
183
|
+
```ts
|
|
184
|
+
import { vi, beforeEach, afterEach } from 'vitest';
|
|
185
|
+
|
|
186
|
+
beforeEach(() => {
|
|
187
|
+
vi.useFakeTimers();
|
|
188
|
+
});
|
|
189
|
+
|
|
190
|
+
afterEach(() => {
|
|
191
|
+
vi.useRealTimers();
|
|
192
|
+
});
|
|
193
|
+
|
|
194
|
+
it('防抖函数应在延迟后执行', () => {
|
|
195
|
+
const fn = vi.fn();
|
|
196
|
+
const debounced = debounce(fn, 300);
|
|
197
|
+
|
|
198
|
+
debounced();
|
|
199
|
+
expect(fn).not.toHaveBeenCalled();
|
|
200
|
+
|
|
201
|
+
vi.advanceTimersByTime(300);
|
|
202
|
+
expect(fn).toHaveBeenCalledOnce();
|
|
203
|
+
});
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
#### 模块 Mock
|
|
207
|
+
|
|
208
|
+
```ts
|
|
209
|
+
vi.mock('@/utils/storage', () => ({
|
|
210
|
+
getItem: vi.fn(),
|
|
211
|
+
setItem: vi.fn(),
|
|
212
|
+
}));
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
### 组件测试模式(React)
|
|
216
|
+
|
|
217
|
+
```tsx
|
|
218
|
+
import { render, screen, fireEvent } from '@testing-library/react';
|
|
219
|
+
|
|
220
|
+
describe('SearchInput', () => {
|
|
221
|
+
it('输入关键词后应触发搜索回调', async () => {
|
|
222
|
+
const onSearch = vi.fn();
|
|
223
|
+
render(<SearchInput onSearch={onSearch} />);
|
|
224
|
+
|
|
225
|
+
const input = screen.getByTestId('search-input');
|
|
226
|
+
await fireEvent.change(input, { target: { value: '测试' } });
|
|
227
|
+
await fireEvent.click(screen.getByTestId('search-btn'));
|
|
228
|
+
|
|
229
|
+
expect(onSearch).toHaveBeenCalledWith('测试');
|
|
230
|
+
});
|
|
231
|
+
});
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
### 组件测试模式(Vue)
|
|
235
|
+
|
|
236
|
+
```ts
|
|
237
|
+
import { mount } from '@vue/test-utils';
|
|
238
|
+
|
|
239
|
+
describe('SearchInput', () => {
|
|
240
|
+
it('输入关键词后应触发搜索事件', async () => {
|
|
241
|
+
const wrapper = mount(SearchInput);
|
|
242
|
+
|
|
243
|
+
await wrapper.find('[data-testid="search-input"]').setValue('测试');
|
|
244
|
+
await wrapper.find('[data-testid="search-btn"]').trigger('click');
|
|
245
|
+
|
|
246
|
+
expect(wrapper.emitted('search')?.[0]).toEqual(['测试']);
|
|
247
|
+
});
|
|
248
|
+
});
|
|
249
|
+
```
|
|
250
|
+
|
|
251
|
+
---
|
|
252
|
+
|
|
253
|
+
## 禁止模式
|
|
254
|
+
|
|
255
|
+
| 禁止项 | 原因 |
|
|
256
|
+
|--------|------|
|
|
257
|
+
| 测试依赖执行顺序 | 测试应互相独立,可单独运行 |
|
|
258
|
+
| 快照测试滥用 | 仅用于关键 UI 结构,禁止对大段 HTML 做快照 |
|
|
259
|
+
| 硬编码延时(`setTimeout`) | 使用 `vi.useFakeTimers()` 或 `waitFor` |
|
|
260
|
+
| Mock 被测模块内部方法 | 只 Mock 外部依赖 |
|
|
261
|
+
| 断言内部状态或私有变量 | 测试行为而非实现 |
|
|
262
|
+
| `data-testid` 以外的元素定位 | 禁止依赖 CSS class 或 DOM 结构 |
|
|
263
|
+
|
|
264
|
+
---
|
|
265
|
+
|
|
266
|
+
## 检查清单
|
|
267
|
+
|
|
268
|
+
完成测试编写后,逐条确认以下事项:
|
|
269
|
+
|
|
270
|
+
- [ ] **文件位置**:测试文件与源文件在同一目录下
|
|
271
|
+
- [ ] **文件命名**:遵循 `<name>.test.ts` / `<name>.test.tsx` 命名规则
|
|
272
|
+
- [ ] **describe 命名**:使用被测模块名称作为 describe 描述
|
|
273
|
+
- [ ] **it 描述**:使用中文描述预期行为(「应……」「当……时应……」)
|
|
274
|
+
- [ ] **AAA 模式**:每个测试用例遵循 Arrange-Act-Assert 结构
|
|
275
|
+
- [ ] **每个 it 单一职责**:每个 `it` 只验证一个行为点
|
|
276
|
+
- [ ] **正常路径覆盖**:典型输入场景已测试
|
|
277
|
+
- [ ] **边界值覆盖**:空值、零值、极值等已测试
|
|
278
|
+
- [ ] **异常输入覆盖**:非法参数、类型错误等已测试
|
|
279
|
+
- [ ] **Mock 合理性**:仅 Mock 外部依赖,未 Mock 被测模块内部
|
|
280
|
+
- [ ] **元素定位**:组件测试使用 `data-testid` 定位元素
|
|
281
|
+
- [ ] **测试独立性**:每个测试可单独运行,不依赖执行顺序
|
|
282
|
+
- [ ] **测试通过**:所有用例通过 `vitest run`
|
|
283
|
+
- [ ] **类型检查**:`tsc --noEmit` 无报错
|
|
284
|
+
|
|
285
|
+
---
|
|
286
|
+
|
|
287
|
+
## 相关规范
|
|
288
|
+
|
|
289
|
+
- `.agents/rules/common/11-测试规范.md` — 测试框架选型、文件约定、编写规范与质量门禁
|
|
290
|
+
- `.agents/rules/common/02-编码规范.md` — 通用编码规范
|
|
291
|
+
- `.agents/rules/common/08-通用约束.md` — 中文描述等通用约束
|
|
292
|
+
- `.agents/skills/common/execute-task/SKILL.md` — TDD 落地编码阶段引用本技能
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: dependency-impact-graph
|
|
3
|
+
description: 分析 monorepo、多包仓库或单仓模块间的依赖关系,判断“改一个包、目录或文件会影响谁”,并给出回归测试范围与潜在消费者提醒。当用户说“改了这个包会影响谁”“依赖影响分析”“回归测试范围”时使用。
|
|
4
|
+
compatibility: Requires a local repository workspace with dependency manifests, package/module boundaries, and source files available for static inspection.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# 依赖影响分析
|
|
8
|
+
|
|
9
|
+
## 使用时机
|
|
10
|
+
|
|
11
|
+
当你需要:
|
|
12
|
+
|
|
13
|
+
- 判断某个包、目录、文件改动的下游影响
|
|
14
|
+
- 评估回归测试范围
|
|
15
|
+
- 梳理 monorepo / workspace 的依赖关系
|
|
16
|
+
|
|
17
|
+
## 核心原则
|
|
18
|
+
|
|
19
|
+
- 先识别仓库结构,再建依赖图
|
|
20
|
+
- 优先用依赖声明,其次用代码引用补边
|
|
21
|
+
- 输出以“直接影响 / 间接影响 / 建议测试范围”为主
|
|
22
|
+
- 不自动安装依赖、不自动改代码
|
|
23
|
+
|
|
24
|
+
## 步骤 1:识别结构
|
|
25
|
+
|
|
26
|
+
优先检查:
|
|
27
|
+
|
|
28
|
+
- Node:`package.json`、`pnpm-workspace.yaml`、`lerna.json`
|
|
29
|
+
- Rust:`Cargo.toml`
|
|
30
|
+
- Go:`go.mod`
|
|
31
|
+
|
|
32
|
+
若不是多包仓库,也可以退化为“单包内模块/目录影响分析”。
|
|
33
|
+
|
|
34
|
+
## 步骤 2:建立依赖图
|
|
35
|
+
|
|
36
|
+
依赖来源按优先级:
|
|
37
|
+
|
|
38
|
+
1. 声明依赖
|
|
39
|
+
2. 代码 import / require / 相对路径引用
|
|
40
|
+
|
|
41
|
+
图的语义:
|
|
42
|
+
|
|
43
|
+
- `A -> B` 表示 A 依赖 B
|
|
44
|
+
- 当 B 被修改时,需要沿“谁依赖它”的方向做反向传播
|
|
45
|
+
|
|
46
|
+
## 步骤 3:输出影响范围
|
|
47
|
+
|
|
48
|
+
至少输出:
|
|
49
|
+
|
|
50
|
+
- 变更目标
|
|
51
|
+
- 直接依赖方
|
|
52
|
+
- 间接依赖方
|
|
53
|
+
- 建议回归测试范围
|
|
54
|
+
- 潜在 API / SDK / 服务消费者
|
|
55
|
+
|
|
56
|
+
## 输出模板
|
|
57
|
+
|
|
58
|
+
```md
|
|
59
|
+
## 依赖影响分析
|
|
60
|
+
|
|
61
|
+
**变更目标**:`packages/shared-utils`
|
|
62
|
+
|
|
63
|
+
### 受影响下游
|
|
64
|
+
- 直接:`packages/web-app`、`packages/admin-app`
|
|
65
|
+
- 间接:`packages/e2e-suite`
|
|
66
|
+
|
|
67
|
+
### 建议回归测试范围
|
|
68
|
+
- 必测:`packages/shared-utils`
|
|
69
|
+
- 建议:`packages/web-app`、`packages/admin-app`
|
|
70
|
+
|
|
71
|
+
### 消费者提醒
|
|
72
|
+
- 内部消费者:
|
|
73
|
+
- 外部发布面(若存在):
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
## 注意事项
|
|
77
|
+
|
|
78
|
+
- 单包仓库下要明确写“当前为单包分析”
|
|
79
|
+
- 尽量区分运行时依赖与仅类型依赖
|
|
80
|
+
- 若项目已有测试命令约定,可附命令示例,但不写死某个工具
|
|
@@ -0,0 +1,206 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: execute-task
|
|
3
|
+
description: 当用户要求按 `tasks.md`、`/opsx:apply` 或同类任务清单开始实施时,严格按 Superpowers 四步执行具体开发任务并输出审计结果。
|
|
4
|
+
compatibility: Requires tasks.md, local .agents/rules execution policies, and an ai-spec-auto/OpenSpec workspace with write access to task state.
|
|
5
|
+
metadata:
|
|
6
|
+
version: "2.0.0"
|
|
7
|
+
openclaw-user-invocable: "true"
|
|
8
|
+
type: rigid
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Superpowers 任务执行技能 (Task Execution Skill)
|
|
12
|
+
|
|
13
|
+
> 本技能为**刚性技能**:严格遵循,不可简化步骤。每一步都必须产出可见的结构化输出。
|
|
14
|
+
|
|
15
|
+
## 强制约束(NON-NEGOTIABLE)
|
|
16
|
+
|
|
17
|
+
1. **四步必须完整执行**:每条任务必须依次经过四个步骤,禁止合并、跳过或简化任何一步。
|
|
18
|
+
2. **每步必须有可见输出**:每个步骤必须以指定的 Markdown 标题开头输出(`### 第一步:头脑风暴`、`### 第二步:TDD 编码`、`### 第三步:双重审查`、`### 第四步:状态更新`),缺失标题即视为未执行该步骤。
|
|
19
|
+
3. **步骤 1 的用户确认门禁不可跳过**:除非用户事先明确指示"批量执行"或"跳过确认"。
|
|
20
|
+
4. **禁止直出代码**:绝对禁止未经步骤 1 思考就直接输出业务代码。
|
|
21
|
+
|
|
22
|
+
## 触发条件
|
|
23
|
+
|
|
24
|
+
当用户输入以下类似指令时,**必须**强制调用此技能:
|
|
25
|
+
|
|
26
|
+
- "开始执行任务"
|
|
27
|
+
- "按 tasks 开始写代码"
|
|
28
|
+
- "应用变更 (Apply)"
|
|
29
|
+
- "执行下一个 task"
|
|
30
|
+
|
|
31
|
+
本技能也会被 `/opsx:apply` / `/opsx-apply` 命令自动触发。
|
|
32
|
+
|
|
33
|
+
## 环境依赖
|
|
34
|
+
|
|
35
|
+
- 依赖 `tasks.md`、`.agents/rules/12-Superpowers执行规范.md` 和 `.agents/rules/14-审计汇报规范.md`
|
|
36
|
+
- 默认在 ai-spec-auto / OpenSpec 协议驱动仓库中运行
|
|
37
|
+
|
|
38
|
+
## 注意事项
|
|
39
|
+
|
|
40
|
+
- 未经过第一步确认,不得直接进入编码
|
|
41
|
+
- 没有测试环境时也要明确记录 RED/GREEN/REFACTOR 的替代验证方式
|
|
42
|
+
- 审计报告是强制产物,不能因为任务很小而省略
|
|
43
|
+
|
|
44
|
+
## 前置要求
|
|
45
|
+
|
|
46
|
+
1. 当前工作区必须存在 `tasks.md` 文件,且包含未完成的任务 (`- [ ]`)。
|
|
47
|
+
2. 必须已完整读取对应变更目录下的 `proposal.md` 或 `design.md` 获取上下文。
|
|
48
|
+
3. 必须已读取 `.agents/rules/12-Superpowers执行规范.md` 确认执行原则。
|
|
49
|
+
4. 必须已读取 `.agents/rules/14-审计汇报规范.md` 确认审计报告格式。
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## 四步循环(每条任务必须完整执行)
|
|
54
|
+
|
|
55
|
+
### 第一步:头脑风暴 (Brainstorm)
|
|
56
|
+
|
|
57
|
+
**强制输出标题**:`### 第一步:头脑风暴`
|
|
58
|
+
|
|
59
|
+
1. 读取 `tasks.md` 找到第一个未完成的 `- [ ]` 任务。
|
|
60
|
+
2. 根据任务类型,按需读取对应的项目规范(见「规范按需引用表」)。
|
|
61
|
+
3. **必须输出**以下内容(限 100 字以内):
|
|
62
|
+
- **思路**:实现该任务的核心方案。
|
|
63
|
+
- **边界**:考虑到的边界情况和潜在风险。
|
|
64
|
+
4. **用户确认门禁**:输出完成后,必须主动提问:"我的思路是否正确?是否可以开始编写测试和代码?"。**等待用户明确同意后才能进入下一步。**
|
|
65
|
+
|
|
66
|
+
**输出示例**:
|
|
67
|
+
|
|
68
|
+
```text
|
|
69
|
+
### 第一步:头脑风暴
|
|
70
|
+
|
|
71
|
+
**任务**:创建 AppButton 全局组件
|
|
72
|
+
**思路**:在 src/components/AppButton/ 下创建组件,使用 NutUI Button 封装,暴露 type/size/disabled 属性。
|
|
73
|
+
**边界**:需处理 loading 状态防重复点击;需兼容 Taro 小程序端。
|
|
74
|
+
|
|
75
|
+
→ 我的思路是否正确?是否可以开始编写测试和代码?
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### 第二步:TDD 编码 (Red-Green-Refactor)
|
|
79
|
+
|
|
80
|
+
**强制输出标题**:`### 第二步:TDD 编码`
|
|
81
|
+
|
|
82
|
+
获得用户同意后,**必须输出** RED / GREEN / REFACTOR 三阶段的操作说明:
|
|
83
|
+
|
|
84
|
+
1. **RED**:先创建或修改测试文件 / 类型定义,编写验证条件。
|
|
85
|
+
2. **GREEN**:编写刚好能通过验证的最小必要业务逻辑代码。
|
|
86
|
+
3. **REFACTOR**:清理冗余代码,确保符合 `.agents/rules/` 下的项目规范。
|
|
87
|
+
|
|
88
|
+
**测试环境分级策略**:
|
|
89
|
+
|
|
90
|
+
| 项目环境 | RED 阶段做什么 | 参考 |
|
|
91
|
+
|----------|---------------|------|
|
|
92
|
+
| 已配置 Vitest/Jest | 创建测试文件,编写失败测试用例 | `.agents/skills/create-test/SKILL.md` |
|
|
93
|
+
| 有 TypeScript 但无测试框架 | 编写严格类型定义(interface/type),确保 tsc 通过 | — |
|
|
94
|
+
| 纯 JavaScript 项目 | 编写 JSDoc 类型注释 + `console.assert` 运行时校验 | — |
|
|
95
|
+
|
|
96
|
+
**输出示例**:
|
|
97
|
+
|
|
98
|
+
```text
|
|
99
|
+
### 第二步:TDD 编码
|
|
100
|
+
|
|
101
|
+
**RED**:创建 src/components/AppButton/types.ts,定义 AppButtonProps 接口(type、size、disabled、loading、onClick)。
|
|
102
|
+
**GREEN**:创建 src/components/AppButton/index.tsx,实现组件满足类型约束。
|
|
103
|
+
**REFACTOR**:提取 barrel export 到 src/components/index.ts,对齐 04-组件规范.md。
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
### 第三步:双重审查 (Double Review)
|
|
107
|
+
|
|
108
|
+
**强制输出标题**:`### 第三步:双重审查`
|
|
109
|
+
|
|
110
|
+
代码编写完成后,**必须输出以下审查结论表格**(不可静默跳过、不可省略):
|
|
111
|
+
|
|
112
|
+
| 维度 | 检查项 | 结论 |
|
|
113
|
+
|------|--------|------|
|
|
114
|
+
| 架构对齐 | 实现是否符合 `design.md` / `specs/` | 通过 / 偏差说明 |
|
|
115
|
+
| 代码健壮性 | 异常捕获、类型严谨、边界处理 | 通过 / 待补充项 |
|
|
116
|
+
| 规范合规 | 是否符合步骤 1 加载的规范 | 通过 / 偏差说明 |
|
|
117
|
+
|
|
118
|
+
如发现偏差,必须在进入步骤 4 前修正代码或说明原因。
|
|
119
|
+
|
|
120
|
+
**输出示例**:
|
|
121
|
+
|
|
122
|
+
```text
|
|
123
|
+
### 第三步:双重审查
|
|
124
|
+
|
|
125
|
+
| 维度 | 检查项 | 结论 |
|
|
126
|
+
|------|--------|------|
|
|
127
|
+
| 架构对齐 | 符合 design.md 组件拆分方案 | 通过 |
|
|
128
|
+
| 代码健壮性 | Props 均有默认值,loading 防重复点击 | 通过 |
|
|
129
|
+
| 规范合规 | 目录 PascalCase、barrel export(04-组件规范) | 通过 |
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
### 第四步:状态更新与审计汇报 (Update Status & Audit)
|
|
133
|
+
|
|
134
|
+
**强制输出标题**:`### 第四步:状态更新`
|
|
135
|
+
|
|
136
|
+
1. 修改 `tasks.md`,将完成的任务状态更新为 `- [x]`。
|
|
137
|
+
2. 按 `.agents/rules/14-审计汇报规范.md` 的模板输出审计报告(五个区块)。
|
|
138
|
+
3. 主动询问:"是否继续执行下一个任务?"
|
|
139
|
+
|
|
140
|
+
---
|
|
141
|
+
|
|
142
|
+
## 批量执行模式
|
|
143
|
+
|
|
144
|
+
当用户明确指示"批量执行"、"不用逐步确认"或"全部执行"时:
|
|
145
|
+
|
|
146
|
+
- 步骤 1 的用户确认门禁可跳过(但**仍须输出**头脑风暴标题和内容)
|
|
147
|
+
- 步骤 2、3、4 **不可简化**,每步仍须有可见输出
|
|
148
|
+
- 必须在审计报告区块 5 中注明:"用户指示批量执行,跳过逐步确认"
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## 自我检查:危险信号
|
|
153
|
+
|
|
154
|
+
当你产生以下想法时,**立即停下** — 你正在合理化跳过步骤:
|
|
155
|
+
|
|
156
|
+
| 你的想法 | 事实 |
|
|
157
|
+
|---------|------|
|
|
158
|
+
| "这个任务很简单,不需要头脑风暴" | 再简单也要输出思路,30 字足够 |
|
|
159
|
+
| "用户着急,我先写代码再补流程" | 流程是质量保证,不是额外负担 |
|
|
160
|
+
| "测试框架没配置,跳过 TDD" | 用类型定义或 assert 兜底,不可跳过 RED 阶段 |
|
|
161
|
+
| "审查没问题,不用写出来" | 必须输出审查表格,不可静默通过 |
|
|
162
|
+
| "这几个任务类似,合并执行更高效" | 除非用户指示批量执行,否则逐条执行 |
|
|
163
|
+
| "输出四个标题太啰嗦了" | 标题是合规证据,缺失即违规 |
|
|
164
|
+
| "我可以把四步内容缩成一段" | 每步必须有独立标题,不可合并 |
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
## 规范按需引用表
|
|
169
|
+
|
|
170
|
+
在第一步头脑风暴阶段,根据当前 Task 涉及的内容,按需读取对应规范和技能:
|
|
171
|
+
|
|
172
|
+
| 任务类型 | 应读取的规范 | 应读取的技能 |
|
|
173
|
+
|----------|-------------|-------------|
|
|
174
|
+
| 创建/修改组件 | `04-组件规范.md`、`09-样式规范.md` | `create-component`、`theme-variables` |
|
|
175
|
+
| 新增/调整接口 | `05-API规范.md` | `create-api` |
|
|
176
|
+
| 新增页面路由 | `06-路由规范.md`、`03-项目结构.md` | `create-route` / `create-view` |
|
|
177
|
+
| 新增/重构状态 | `07-状态管理.md` | `create-store` |
|
|
178
|
+
| 样式还原 | `09-样式规范.md` | `theme-variables`、`design-analysis` |
|
|
179
|
+
| 编写测试 | `11-测试规范.md` | `create-test` |
|
|
180
|
+
| 通用编码 | `02-编码规范.md`、`08-通用约束.md` | — |
|
|
181
|
+
|
|
182
|
+
无需一次性全部加载。只读取与当前 Task 直接相关的规范,保持上下文精简。
|
|
183
|
+
|
|
184
|
+
---
|
|
185
|
+
|
|
186
|
+
## 合规自检清单
|
|
187
|
+
|
|
188
|
+
每条任务完成后(步骤 4 输出前),对照以下清单确认合规:
|
|
189
|
+
|
|
190
|
+
- [ ] 输出了 `### 第一步:头脑风暴` 标题和内容
|
|
191
|
+
- [ ] 输出了 `### 第二步:TDD 编码` 标题和 RED/GREEN/REFACTOR 说明
|
|
192
|
+
- [ ] 输出了 `### 第三步:双重审查` 标题和审查结论表格
|
|
193
|
+
- [ ] 输出了 `### 第四步:状态更新` 标题和审计报告
|
|
194
|
+
- [ ] `tasks.md` 中对应任务已标记为 `- [x]`
|
|
195
|
+
|
|
196
|
+
如有任何一项缺失,必须补充后再进入下一条任务。
|
|
197
|
+
|
|
198
|
+
---
|
|
199
|
+
|
|
200
|
+
## 相关规范与技能
|
|
201
|
+
|
|
202
|
+
- `.agents/rules/12-Superpowers执行规范.md` — 执行原则与约束(何时必须启用、何时可跳过)
|
|
203
|
+
- `.agents/rules/14-审计汇报规范.md` — 审计报告格式与约束(第四步必须输出)
|
|
204
|
+
- `.agents/skills/create-test/SKILL.md` — TDD RED 阶段创建测试文件的详细指导
|
|
205
|
+
- `.agents/skills/create-proposal/SKILL.md` — 提案前置分析(OpenSpec 增强层,委托 `/opsx:propose` 产出 tasks.md)
|
|
206
|
+
- `openspec/AGENTS.md` — OpenSpec 三阶段工作流说明
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"skill_name": "execute-task",
|
|
3
|
+
"evals": [
|
|
4
|
+
{
|
|
5
|
+
"id": "execute-output-1",
|
|
6
|
+
"prompt": "根据 tasks.md 的第一条未完成任务进入执行,要求输出四步结构并在最后给出审计结论。",
|
|
7
|
+
"files": [],
|
|
8
|
+
"expected_output": "输出必须包含头脑风暴、TDD 编码、双重审查、状态更新四个步骤,并保留确认门槛。",
|
|
9
|
+
"assertions": [
|
|
10
|
+
"四步标题完整出现",
|
|
11
|
+
"第一步包含确认门禁",
|
|
12
|
+
"第四步包含审计/状态更新信息"
|
|
13
|
+
]
|
|
14
|
+
}
|
|
15
|
+
]
|
|
16
|
+
}
|