leniu-dev 2.0.0
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/.claude/agents/auto-test-generator.md +315 -0
- package/.claude/agents/bug-analyzer.md +103 -0
- package/.claude/agents/code-reviewer.md +122 -0
- package/.claude/agents/code-scanner.md +145 -0
- package/.claude/agents/image-reader.md +154 -0
- package/.claude/agents/loki-runner.md +80 -0
- package/.claude/agents/mysql-runner.md +81 -0
- package/.claude/agents/project-manager.md +159 -0
- package/.claude/agents/requirements-analyzer.md +175 -0
- package/.claude/agents/task-fetcher.md +75 -0
- package/.claude/audio/completed.wav +0 -0
- package/.claude/commands/add-todo.md +255 -0
- package/.claude/commands/auto-test.md +252 -0
- package/.claude/commands/check.md +210 -0
- package/.claude/commands/crud.md +454 -0
- package/.claude/commands/dev.md +532 -0
- package/.claude/commands/init-config.md +154 -0
- package/.claude/commands/init-docs.md +681 -0
- package/.claude/commands/next.md +281 -0
- package/.claude/commands/opsx-apply.md +147 -0
- package/.claude/commands/opsx-archive.md +105 -0
- package/.claude/commands/opsx-bulk-archive.md +237 -0
- package/.claude/commands/opsx-continue.md +109 -0
- package/.claude/commands/opsx-explore.md +281 -0
- package/.claude/commands/opsx-ff.md +92 -0
- package/.claude/commands/opsx-new.md +65 -0
- package/.claude/commands/opsx-onboard.md +397 -0
- package/.claude/commands/opsx-sync.md +129 -0
- package/.claude/commands/opsx-verify.md +159 -0
- package/.claude/commands/progress.md +264 -0
- package/.claude/commands/release.md +109 -0
- package/.claude/commands/start.md +199 -0
- package/.claude/commands/sync.md +307 -0
- package/.claude/commands/update-status.md +428 -0
- package/.claude/docs/Mixin/344/275/277/347/224/250/346/214/207/345/215/227.md +299 -0
- package/.claude/docs/README.md +167 -0
- package/.claude/docs//345/211/215/347/253/257/345/274/200/345/217/221/346/214/207/345/215/227.md +599 -0
- package/.claude/docs//345/220/216/347/253/257/345/274/200/345/217/221/346/214/207/345/215/227.md +726 -0
- package/.claude/docs//345/267/245/344/275/234/346/265/201/345/274/200/345/217/221/346/214/207/345/215/227.md +714 -0
- package/.claude/docs//345/267/245/345/205/267/347/261/273/344/275/277/347/224/250/346/214/207/345/215/227.md +463 -0
- package/.claude/docs//346/225/260/346/215/256/345/272/223/350/256/276/350/256/241/350/247/204/350/214/203.md +390 -0
- package/.claude/docs//346/226/260/345/212/237/350/203/275/345/274/200/345/217/221/346/265/201/347/250/213/350/247/204/350/214/203.md +688 -0
- package/.claude/docs//346/226/260/351/241/271/347/233/256/345/274/200/345/217/221/346/265/201/347/250/213.md +365 -0
- package/.claude/docs//346/241/206/346/236/266/350/257/264/346/230/216.md +393 -0
- package/.claude/docs//350/267/257/347/224/261/351/205/215/347/275/256/346/214/207/345/215/227.md +246 -0
- package/.claude/framework-config.json +73 -0
- package/.claude/hooks/lib/notify.js +310 -0
- package/.claude/hooks/pre-tool-use.js +117 -0
- package/.claude/hooks/skill-forced-eval.js +161 -0
- package/.claude/hooks/stop.js +55 -0
- package/.claude/notify-config.json +9 -0
- package/.claude/settings.json +57 -0
- package/.claude/skills/add-skill/SKILL.md +488 -0
- package/.claude/skills/analyze-requirements/SKILL.md +112 -0
- package/.claude/skills/api-development/SKILL.md +315 -0
- package/.claude/skills/architecture-design/SKILL.md +152 -0
- package/.claude/skills/auto-test/SKILL.md +625 -0
- package/.claude/skills/auto-test/references/api-conventions.md +260 -0
- package/.claude/skills/backend-annotations/SKILL.md +248 -0
- package/.claude/skills/banana-image/CHANGELOG.md +37 -0
- package/.claude/skills/banana-image/README.md +146 -0
- package/.claude/skills/banana-image/SKILL.md +171 -0
- package/.claude/skills/banana-image/assets/logo.png +0 -0
- package/.claude/skills/banana-image/references/advanced-usage.md +189 -0
- package/.claude/skills/banana-image/scripts/apply_template.py +125 -0
- package/.claude/skills/banana-image/scripts/banana_image_exec.ts +412 -0
- package/.claude/skills/banana-image/scripts/batch_prep.py +82 -0
- package/.claude/skills/banana-image/scripts/package-lock.json +1437 -0
- package/.claude/skills/banana-image/scripts/package.json +18 -0
- package/.claude/skills/banana-image/scripts/requirements.txt +10 -0
- package/.claude/skills/banana-image/templates/poster.json +22 -0
- package/.claude/skills/banana-image/templates/product.json +17 -0
- package/.claude/skills/banana-image/templates/social.json +22 -0
- package/.claude/skills/banana-image/templates/thumbnail.json +17 -0
- package/.claude/skills/brainstorm/SKILL.md +216 -0
- package/.claude/skills/bug-detective/SKILL.md +295 -0
- package/.claude/skills/bug-detective/references/error-patterns.md +242 -0
- package/.claude/skills/chrome-cdp/SKILL.md +81 -0
- package/.claude/skills/chrome-cdp/scripts/cdp.mjs +838 -0
- package/.claude/skills/chrome-cdp/scripts/run-cdp.sh +7 -0
- package/.claude/skills/code-patterns/SKILL.md +163 -0
- package/.claude/skills/code-patterns/references/leniu-code-patterns.md +87 -0
- package/.claude/skills/codex-code-review/SKILL.md +327 -0
- package/.claude/skills/collaborating-with-codex/SKILL.md +180 -0
- package/.claude/skills/collaborating-with-codex/scripts/codex_bridge.py +275 -0
- package/.claude/skills/collaborating-with-gemini/SKILL.md +194 -0
- package/.claude/skills/collaborating-with-gemini/scripts/gemini_bridge.py +275 -0
- package/.claude/skills/crud-development/SKILL.md +328 -0
- package/.claude/skills/data-permission/SKILL.md +221 -0
- package/.claude/skills/data-permission/references/custom-data-scope.md +90 -0
- package/.claude/skills/database-ops/SKILL.md +210 -0
- package/.claude/skills/error-handler/SKILL.md +310 -0
- package/.claude/skills/file-oss-management/SKILL.md +260 -0
- package/.claude/skills/file-oss-management/references/entities.md +105 -0
- package/.claude/skills/file-oss-management/references/service-impl.md +104 -0
- package/.claude/skills/fix-bug/SKILL.md +269 -0
- package/.claude/skills/git-workflow/SKILL.md +179 -0
- package/.claude/skills/jenkins-deploy/SKILL.md +134 -0
- package/.claude/skills/jenkins-deploy/assets/env_param.template.json +51 -0
- package/.claude/skills/jenkins-deploy/assets/jk_build.py +400 -0
- package/.claude/skills/json-serialization/SKILL.md +341 -0
- package/.claude/skills/lanhu-design/SKILL.md +99 -0
- package/.claude/skills/leniu-api-development/SKILL.md +319 -0
- package/.claude/skills/leniu-api-development/references/real-examples.md +273 -0
- package/.claude/skills/leniu-architecture-design/SKILL.md +383 -0
- package/.claude/skills/leniu-backend-annotations/SKILL.md +277 -0
- package/.claude/skills/leniu-brainstorm/SKILL.md +242 -0
- package/.claude/skills/leniu-brainstorm/references/business-scenarios.md +162 -0
- package/.claude/skills/leniu-code-patterns/SKILL.md +411 -0
- package/.claude/skills/leniu-crud-development/SKILL.md +404 -0
- package/.claude/skills/leniu-crud-development/references/templates.md +597 -0
- package/.claude/skills/leniu-customization-location/SKILL.md +410 -0
- package/.claude/skills/leniu-data-permission/SKILL.md +341 -0
- package/.claude/skills/leniu-database-ops/SKILL.md +426 -0
- package/.claude/skills/leniu-error-handler/SKILL.md +462 -0
- package/.claude/skills/leniu-java-concurrent/SKILL.md +400 -0
- package/.claude/skills/leniu-java-entity/SKILL.md +237 -0
- package/.claude/skills/leniu-java-entity/references/templates.md +237 -0
- package/.claude/skills/leniu-java-logging/SKILL.md +229 -0
- package/.claude/skills/leniu-java-logging/references/data-mask.md +46 -0
- package/.claude/skills/leniu-java-logging/references/logging-scenarios.md +113 -0
- package/.claude/skills/leniu-java-mq/SKILL.md +338 -0
- package/.claude/skills/leniu-java-mybatis/SKILL.md +267 -0
- package/.claude/skills/leniu-java-mybatis/references/report-mapper.md +88 -0
- package/.claude/skills/leniu-java-task/SKILL.md +367 -0
- package/.claude/skills/leniu-marketing-scenario/SKILL.md +448 -0
- package/.claude/skills/leniu-marketing-scenario/references/pay-meal-rules.md +197 -0
- package/.claude/skills/leniu-marketing-scenario/references/price-rules.md +286 -0
- package/.claude/skills/leniu-marketing-scenario/references/recharge-rules.md +188 -0
- package/.claude/skills/leniu-redis-cache/SKILL.md +331 -0
- package/.claude/skills/leniu-report-scenario/SKILL.md +508 -0
- package/.claude/skills/leniu-report-scenario/references/amount-handling.md +448 -0
- package/.claude/skills/leniu-report-scenario/references/analysis-module.md +64 -0
- package/.claude/skills/leniu-report-scenario/references/customization-table-fields.md +93 -0
- package/.claude/skills/leniu-report-scenario/references/customization.md +356 -0
- package/.claude/skills/leniu-report-scenario/references/data-permission.md +182 -0
- package/.claude/skills/leniu-report-scenario/references/export.md +553 -0
- package/.claude/skills/leniu-report-scenario/references/mealtime.md +197 -0
- package/.claude/skills/leniu-report-scenario/references/query-param.md +274 -0
- package/.claude/skills/leniu-report-scenario/references/report-tables.md +162 -0
- package/.claude/skills/leniu-report-scenario/references/standard-customization.md +112 -0
- package/.claude/skills/leniu-report-scenario/references/standard-table-fields.md +113 -0
- package/.claude/skills/leniu-report-scenario/references/total-line.md +179 -0
- package/.claude/skills/leniu-security-guard/SKILL.md +306 -0
- package/.claude/skills/leniu-utils-toolkit/SKILL.md +380 -0
- package/.claude/skills/loki-log-query/SKILL.md +430 -0
- package/.claude/skills/mysql-debug/SKILL.md +406 -0
- package/.claude/skills/performance-doctor/SKILL.md +297 -0
- package/.claude/skills/project-navigator/SKILL.md +211 -0
- package/.claude/skills/redis-cache/SKILL.md +282 -0
- package/.claude/skills/redis-cache/references/listeners.md +23 -0
- package/.claude/skills/scheduled-jobs/SKILL.md +277 -0
- package/.claude/skills/security-guard/SKILL.md +245 -0
- package/.claude/skills/security-guard/references/encrypt-config.md +103 -0
- package/.claude/skills/security-guard/references/sensitive-strategies.md +42 -0
- package/.claude/skills/sms-mail/SKILL.md +346 -0
- package/.claude/skills/sms-mail/references/mail-config.md +88 -0
- package/.claude/skills/sms-mail/references/sms-config.md +74 -0
- package/.claude/skills/social-login/SKILL.md +328 -0
- package/.claude/skills/social-login/references/provider-configs.md +118 -0
- package/.claude/skills/store-pc/SKILL.md +366 -0
- package/.claude/skills/sync-back-merge/SKILL.md +66 -0
- package/.claude/skills/task-tracker/SKILL.md +307 -0
- package/.claude/skills/tech-decision/SKILL.md +393 -0
- package/.claude/skills/tenant-management/SKILL.md +272 -0
- package/.claude/skills/tenant-management/references/tenant-scenarios.md +91 -0
- package/.claude/skills/test-development/SKILL.md +301 -0
- package/.claude/skills/test-development/references/parameterized-examples.md +119 -0
- package/.claude/skills/ui-pc/SKILL.md +438 -0
- package/.claude/skills/utils-toolkit/SKILL.md +354 -0
- package/.claude/skills/utils-toolkit/references/redis-utils-api.md +56 -0
- package/.claude/skills/websocket-sse/SKILL.md +350 -0
- package/.claude/skills/workflow-engine/SKILL.md +249 -0
- package/.claude/skills/yunxiao-task-management/SKILL.md +401 -0
- package/.claude/skills/yunxiao-task-management/templates//346/217/220/346/265/213/345/215/225/346/250/241/346/235/277.html +17 -0
- package/.claude/templates/env-config.md +27 -0
- package/.claude/templates//345/276/205/345/212/236/346/270/205/345/215/225/346/250/241/346/235/277.md +56 -0
- package/.claude/templates//351/234/200/346/261/202/346/226/207/346/241/243/346/250/241/346/235/277.md +85 -0
- package/.claude/templates//351/241/271/347/233/256/347/212/266/346/200/201/346/250/241/346/235/277.md +43 -0
- package/.codex/skills/add-skill/SKILL.md +488 -0
- package/.codex/skills/add-todo/SKILL.md +269 -0
- package/.codex/skills/analyze-requirements/SKILL.md +112 -0
- package/.codex/skills/api-development/SKILL.md +315 -0
- package/.codex/skills/architecture-design/SKILL.md +152 -0
- package/.codex/skills/auto-test/SKILL.md +453 -0
- package/.codex/skills/auto-test/references/api-conventions.md +260 -0
- package/.codex/skills/backend-annotations/SKILL.md +248 -0
- package/.codex/skills/banana-image/CHANGELOG.md +37 -0
- package/.codex/skills/banana-image/README.md +146 -0
- package/.codex/skills/banana-image/SKILL.md +171 -0
- package/.codex/skills/banana-image/assets/logo.png +0 -0
- package/.codex/skills/banana-image/references/advanced-usage.md +189 -0
- package/.codex/skills/banana-image/scripts/apply_template.py +125 -0
- package/.codex/skills/banana-image/scripts/banana_image_exec.ts +412 -0
- package/.codex/skills/banana-image/scripts/batch_prep.py +82 -0
- package/.codex/skills/banana-image/scripts/package-lock.json +1437 -0
- package/.codex/skills/banana-image/scripts/package.json +18 -0
- package/.codex/skills/banana-image/scripts/requirements.txt +10 -0
- package/.codex/skills/banana-image/templates/poster.json +22 -0
- package/.codex/skills/banana-image/templates/product.json +17 -0
- package/.codex/skills/banana-image/templates/social.json +22 -0
- package/.codex/skills/banana-image/templates/thumbnail.json +17 -0
- package/.codex/skills/brainstorm/SKILL.md +216 -0
- package/.codex/skills/bug-detective/SKILL.md +295 -0
- package/.codex/skills/bug-detective/references/error-patterns.md +242 -0
- package/.codex/skills/check/SKILL.md +367 -0
- package/.codex/skills/code-patterns/SKILL.md +163 -0
- package/.codex/skills/code-patterns/references/leniu-code-patterns.md +87 -0
- package/.codex/skills/collaborating-with-codex/SKILL.md +180 -0
- package/.codex/skills/collaborating-with-codex/scripts/codex_bridge.py +275 -0
- package/.codex/skills/collaborating-with-gemini/SKILL.md +194 -0
- package/.codex/skills/collaborating-with-gemini/scripts/gemini_bridge.py +275 -0
- package/.codex/skills/crud/SKILL.md +265 -0
- package/.codex/skills/crud-development/SKILL.md +328 -0
- package/.codex/skills/data-permission/SKILL.md +221 -0
- package/.codex/skills/data-permission/references/custom-data-scope.md +90 -0
- package/.codex/skills/database-ops/SKILL.md +210 -0
- package/.codex/skills/dev/SKILL.md +187 -0
- package/.codex/skills/error-handler/SKILL.md +310 -0
- package/.codex/skills/file-oss-management/SKILL.md +260 -0
- package/.codex/skills/file-oss-management/references/entities.md +105 -0
- package/.codex/skills/file-oss-management/references/service-impl.md +104 -0
- package/.codex/skills/fix-bug/SKILL.md +269 -0
- package/.codex/skills/git-workflow/SKILL.md +179 -0
- package/.codex/skills/init-docs/SKILL.md +194 -0
- package/.codex/skills/jenkins-deploy/SKILL.md +134 -0
- package/.codex/skills/json-serialization/SKILL.md +341 -0
- package/.codex/skills/lanhu-design/SKILL.md +99 -0
- package/.codex/skills/leniu-api-development/SKILL.md +319 -0
- package/.codex/skills/leniu-api-development/references/real-examples.md +273 -0
- package/.codex/skills/leniu-architecture-design/SKILL.md +383 -0
- package/.codex/skills/leniu-backend-annotations/SKILL.md +277 -0
- package/.codex/skills/leniu-brainstorm/SKILL.md +242 -0
- package/.codex/skills/leniu-brainstorm/references/business-scenarios.md +162 -0
- package/.codex/skills/leniu-code-patterns/SKILL.md +411 -0
- package/.codex/skills/leniu-crud-development/SKILL.md +404 -0
- package/.codex/skills/leniu-crud-development/references/templates.md +597 -0
- package/.codex/skills/leniu-customization-location/SKILL.md +410 -0
- package/.codex/skills/leniu-data-permission/SKILL.md +341 -0
- package/.codex/skills/leniu-database-ops/SKILL.md +426 -0
- package/.codex/skills/leniu-error-handler/SKILL.md +462 -0
- package/.codex/skills/leniu-java-amount-handling/SKILL.md +461 -0
- package/.codex/skills/leniu-java-code-style/SKILL.md +510 -0
- package/.codex/skills/leniu-java-concurrent/SKILL.md +400 -0
- package/.codex/skills/leniu-java-entity/SKILL.md +237 -0
- package/.codex/skills/leniu-java-entity/references/templates.md +237 -0
- package/.codex/skills/leniu-java-logging/SKILL.md +229 -0
- package/.codex/skills/leniu-java-logging/references/data-mask.md +46 -0
- package/.codex/skills/leniu-java-logging/references/logging-scenarios.md +113 -0
- package/.codex/skills/leniu-java-mq/SKILL.md +338 -0
- package/.codex/skills/leniu-java-mybatis/SKILL.md +267 -0
- package/.codex/skills/leniu-java-mybatis/references/report-mapper.md +88 -0
- package/.codex/skills/leniu-java-task/SKILL.md +367 -0
- package/.codex/skills/leniu-marketing-scenario/SKILL.md +448 -0
- package/.codex/skills/leniu-marketing-scenario/references/pay-meal-rules.md +197 -0
- package/.codex/skills/leniu-marketing-scenario/references/price-rules.md +286 -0
- package/.codex/skills/leniu-marketing-scenario/references/recharge-rules.md +188 -0
- package/.codex/skills/leniu-redis-cache/SKILL.md +331 -0
- package/.codex/skills/leniu-report-scenario/SKILL.md +508 -0
- package/.codex/skills/leniu-report-scenario/references/amount-handling.md +448 -0
- package/.codex/skills/leniu-report-scenario/references/analysis-module.md +64 -0
- package/.codex/skills/leniu-report-scenario/references/customization-table-fields.md +93 -0
- package/.codex/skills/leniu-report-scenario/references/customization.md +356 -0
- package/.codex/skills/leniu-report-scenario/references/data-permission.md +182 -0
- package/.codex/skills/leniu-report-scenario/references/export.md +553 -0
- package/.codex/skills/leniu-report-scenario/references/mealtime.md +197 -0
- package/.codex/skills/leniu-report-scenario/references/query-param.md +274 -0
- package/.codex/skills/leniu-report-scenario/references/report-tables.md +162 -0
- package/.codex/skills/leniu-report-scenario/references/standard-customization.md +112 -0
- package/.codex/skills/leniu-report-scenario/references/standard-table-fields.md +113 -0
- package/.codex/skills/leniu-report-scenario/references/total-line.md +179 -0
- package/.codex/skills/leniu-security-guard/SKILL.md +306 -0
- package/.codex/skills/leniu-utils-toolkit/SKILL.md +380 -0
- package/.codex/skills/loki-log-query/SKILL.md +430 -0
- package/.codex/skills/loki-log-query/environments.json +45 -0
- package/.codex/skills/mysql-debug/SKILL.md +406 -0
- package/.codex/skills/next/SKILL.md +137 -0
- package/.codex/skills/openspec-apply-change/SKILL.md +165 -0
- package/.codex/skills/openspec-archive-change/SKILL.md +122 -0
- package/.codex/skills/openspec-bulk-archive-change/SKILL.md +254 -0
- package/.codex/skills/openspec-continue-change/SKILL.md +126 -0
- package/.codex/skills/openspec-explore/SKILL.md +299 -0
- package/.codex/skills/openspec-ff-change/SKILL.md +109 -0
- package/.codex/skills/openspec-new-change/SKILL.md +82 -0
- package/.codex/skills/openspec-onboard/SKILL.md +414 -0
- package/.codex/skills/openspec-sync-specs/SKILL.md +146 -0
- package/.codex/skills/openspec-verify-change/SKILL.md +176 -0
- package/.codex/skills/performance-doctor/SKILL.md +297 -0
- package/.codex/skills/progress/SKILL.md +193 -0
- package/.codex/skills/project-navigator/SKILL.md +211 -0
- package/.codex/skills/redis-cache/SKILL.md +282 -0
- package/.codex/skills/redis-cache/references/listeners.md +23 -0
- package/.codex/skills/scheduled-jobs/SKILL.md +277 -0
- package/.codex/skills/security-guard/SKILL.md +245 -0
- package/.codex/skills/security-guard/references/encrypt-config.md +103 -0
- package/.codex/skills/security-guard/references/sensitive-strategies.md +42 -0
- package/.codex/skills/skill-creator/LICENSE.txt +202 -0
- package/.codex/skills/skill-creator/SKILL.md +479 -0
- package/.codex/skills/skill-creator/agents/analyzer.md +274 -0
- package/.codex/skills/skill-creator/agents/comparator.md +202 -0
- package/.codex/skills/skill-creator/agents/grader.md +223 -0
- package/.codex/skills/skill-creator/assets/eval_review.html +146 -0
- package/.codex/skills/skill-creator/eval-viewer/generate_review.py +471 -0
- package/.codex/skills/skill-creator/eval-viewer/viewer.html +1325 -0
- package/.codex/skills/skill-creator/references/schemas.md +430 -0
- package/.codex/skills/skill-creator/scripts/__init__.py +0 -0
- package/.codex/skills/skill-creator/scripts/aggregate_benchmark.py +401 -0
- package/.codex/skills/skill-creator/scripts/generate_report.py +326 -0
- package/.codex/skills/skill-creator/scripts/improve_description.py +248 -0
- package/.codex/skills/skill-creator/scripts/package_skill.py +136 -0
- package/.codex/skills/skill-creator/scripts/quick_validate.py +103 -0
- package/.codex/skills/skill-creator/scripts/run_eval.py +310 -0
- package/.codex/skills/skill-creator/scripts/run_loop.py +332 -0
- package/.codex/skills/skill-creator/scripts/utils.py +47 -0
- package/.codex/skills/sms-mail/SKILL.md +346 -0
- package/.codex/skills/sms-mail/references/mail-config.md +88 -0
- package/.codex/skills/sms-mail/references/sms-config.md +74 -0
- package/.codex/skills/social-login/SKILL.md +328 -0
- package/.codex/skills/social-login/references/provider-configs.md +118 -0
- package/.codex/skills/start/SKILL.md +154 -0
- package/.codex/skills/store-pc/SKILL.md +366 -0
- package/.codex/skills/sync/SKILL.md +149 -0
- package/.codex/skills/sync-back-merge/SKILL.md +66 -0
- package/.codex/skills/task-tracker/SKILL.md +307 -0
- package/.codex/skills/tech-decision/SKILL.md +393 -0
- package/.codex/skills/tenant-management/SKILL.md +272 -0
- package/.codex/skills/tenant-management/references/tenant-scenarios.md +91 -0
- package/.codex/skills/test-development/SKILL.md +301 -0
- package/.codex/skills/test-development/references/parameterized-examples.md +119 -0
- package/.codex/skills/ui-pc/SKILL.md +438 -0
- package/.codex/skills/update-status/SKILL.md +159 -0
- package/.codex/skills/utils-toolkit/SKILL.md +354 -0
- package/.codex/skills/utils-toolkit/references/redis-utils-api.md +56 -0
- package/.codex/skills/websocket-sse/SKILL.md +350 -0
- package/.codex/skills/workflow-engine/SKILL.md +249 -0
- package/.codex/skills/yunxiao-task-management/SKILL.md +401 -0
- package/.codex/skills/yunxiao-task-management/templates//346/217/220/346/265/213/345/215/225/346/250/241/346/235/277.html +17 -0
- package/.cursor/agents/bug-analyzer.md +102 -0
- package/.cursor/agents/code-reviewer.md +122 -0
- package/.cursor/agents/code-scanner.md +145 -0
- package/.cursor/agents/image-reader.md +154 -0
- package/.cursor/agents/loki-runner.md +80 -0
- package/.cursor/agents/mysql-runner.md +81 -0
- package/.cursor/agents/project-manager.md +159 -0
- package/.cursor/agents/requirements-analyzer.md +141 -0
- package/.cursor/agents/task-fetcher.md +75 -0
- package/.cursor/audio/completed.wav +0 -0
- package/.cursor/commands/opsx-apply.md +152 -0
- package/.cursor/commands/opsx-archive.md +157 -0
- package/.cursor/commands/opsx-bulk-archive.md +242 -0
- package/.cursor/commands/opsx-continue.md +114 -0
- package/.cursor/commands/opsx-explore.md +174 -0
- package/.cursor/commands/opsx-ff.md +94 -0
- package/.cursor/commands/opsx-new.md +69 -0
- package/.cursor/commands/opsx-onboard.md +525 -0
- package/.cursor/commands/opsx-sync.md +134 -0
- package/.cursor/commands/opsx-verify.md +164 -0
- package/.cursor/hooks/cursor-pre-tool-use.js +122 -0
- package/.cursor/hooks/cursor-skill-eval.js +466 -0
- package/.cursor/hooks/lib/notify.js +310 -0
- package/.cursor/hooks/stop.js +55 -0
- package/.cursor/hooks.json +23 -0
- package/.cursor/mcp.json +22 -0
- package/.cursor/rules/skill-activation.mdc +99 -0
- package/.cursor/skills/add-skill/SKILL.md +488 -0
- package/.cursor/skills/analyze-requirements/SKILL.md +112 -0
- package/.cursor/skills/api-development/SKILL.md +315 -0
- package/.cursor/skills/architecture-design/SKILL.md +152 -0
- package/.cursor/skills/auto-test/SKILL.md +453 -0
- package/.cursor/skills/auto-test/references/api-conventions.md +260 -0
- package/.cursor/skills/backend-annotations/SKILL.md +248 -0
- package/.cursor/skills/banana-image/CHANGELOG.md +37 -0
- package/.cursor/skills/banana-image/README.md +146 -0
- package/.cursor/skills/banana-image/SKILL.md +171 -0
- package/.cursor/skills/banana-image/assets/logo.png +0 -0
- package/.cursor/skills/banana-image/references/advanced-usage.md +189 -0
- package/.cursor/skills/banana-image/scripts/apply_template.py +125 -0
- package/.cursor/skills/banana-image/scripts/banana_image_exec.ts +412 -0
- package/.cursor/skills/banana-image/scripts/batch_prep.py +82 -0
- package/.cursor/skills/banana-image/scripts/package-lock.json +1437 -0
- package/.cursor/skills/banana-image/scripts/package.json +18 -0
- package/.cursor/skills/banana-image/scripts/requirements.txt +10 -0
- package/.cursor/skills/banana-image/templates/poster.json +22 -0
- package/.cursor/skills/banana-image/templates/product.json +17 -0
- package/.cursor/skills/banana-image/templates/social.json +22 -0
- package/.cursor/skills/banana-image/templates/thumbnail.json +17 -0
- package/.cursor/skills/brainstorm/SKILL.md +216 -0
- package/.cursor/skills/bug-detective/SKILL.md +295 -0
- package/.cursor/skills/bug-detective/references/error-patterns.md +242 -0
- package/.cursor/skills/code-patterns/SKILL.md +163 -0
- package/.cursor/skills/code-patterns/references/leniu-code-patterns.md +87 -0
- package/.cursor/skills/collaborating-with-codex/SKILL.md +180 -0
- package/.cursor/skills/collaborating-with-codex/scripts/codex_bridge.py +275 -0
- package/.cursor/skills/collaborating-with-gemini/SKILL.md +194 -0
- package/.cursor/skills/collaborating-with-gemini/scripts/gemini_bridge.py +275 -0
- package/.cursor/skills/crud-development/SKILL.md +328 -0
- package/.cursor/skills/data-permission/SKILL.md +221 -0
- package/.cursor/skills/data-permission/references/custom-data-scope.md +90 -0
- package/.cursor/skills/database-ops/SKILL.md +210 -0
- package/.cursor/skills/error-handler/SKILL.md +310 -0
- package/.cursor/skills/file-oss-management/SKILL.md +260 -0
- package/.cursor/skills/file-oss-management/references/entities.md +105 -0
- package/.cursor/skills/file-oss-management/references/service-impl.md +104 -0
- package/.cursor/skills/fix-bug/SKILL.md +269 -0
- package/.cursor/skills/git-workflow/SKILL.md +179 -0
- package/.cursor/skills/jenkins-deploy/SKILL.md +134 -0
- package/.cursor/skills/json-serialization/SKILL.md +341 -0
- package/.cursor/skills/lanhu-design/SKILL.md +99 -0
- package/.cursor/skills/leniu-api-development/SKILL.md +319 -0
- package/.cursor/skills/leniu-api-development/references/real-examples.md +273 -0
- package/.cursor/skills/leniu-architecture-design/SKILL.md +383 -0
- package/.cursor/skills/leniu-backend-annotations/SKILL.md +277 -0
- package/.cursor/skills/leniu-brainstorm/SKILL.md +242 -0
- package/.cursor/skills/leniu-brainstorm/references/business-scenarios.md +162 -0
- package/.cursor/skills/leniu-code-patterns/SKILL.md +411 -0
- package/.cursor/skills/leniu-crud-development/SKILL.md +404 -0
- package/.cursor/skills/leniu-crud-development/references/templates.md +597 -0
- package/.cursor/skills/leniu-customization-location/SKILL.md +410 -0
- package/.cursor/skills/leniu-data-permission/SKILL.md +341 -0
- package/.cursor/skills/leniu-database-ops/SKILL.md +426 -0
- package/.cursor/skills/leniu-error-handler/SKILL.md +462 -0
- package/.cursor/skills/leniu-java-amount-handling/SKILL.md +461 -0
- package/.cursor/skills/leniu-java-code-style/SKILL.md +510 -0
- package/.cursor/skills/leniu-java-concurrent/SKILL.md +400 -0
- package/.cursor/skills/leniu-java-entity/SKILL.md +237 -0
- package/.cursor/skills/leniu-java-entity/references/templates.md +237 -0
- package/.cursor/skills/leniu-java-logging/SKILL.md +229 -0
- package/.cursor/skills/leniu-java-logging/references/data-mask.md +46 -0
- package/.cursor/skills/leniu-java-logging/references/logging-scenarios.md +113 -0
- package/.cursor/skills/leniu-java-mq/SKILL.md +338 -0
- package/.cursor/skills/leniu-java-mybatis/SKILL.md +267 -0
- package/.cursor/skills/leniu-java-mybatis/references/report-mapper.md +88 -0
- package/.cursor/skills/leniu-java-task/SKILL.md +367 -0
- package/.cursor/skills/leniu-marketing-scenario/SKILL.md +448 -0
- package/.cursor/skills/leniu-marketing-scenario/references/pay-meal-rules.md +197 -0
- package/.cursor/skills/leniu-marketing-scenario/references/price-rules.md +286 -0
- package/.cursor/skills/leniu-marketing-scenario/references/recharge-rules.md +188 -0
- package/.cursor/skills/leniu-redis-cache/SKILL.md +331 -0
- package/.cursor/skills/leniu-report-scenario/SKILL.md +508 -0
- package/.cursor/skills/leniu-report-scenario/references/amount-handling.md +448 -0
- package/.cursor/skills/leniu-report-scenario/references/analysis-module.md +64 -0
- package/.cursor/skills/leniu-report-scenario/references/customization-table-fields.md +93 -0
- package/.cursor/skills/leniu-report-scenario/references/customization.md +356 -0
- package/.cursor/skills/leniu-report-scenario/references/data-permission.md +182 -0
- package/.cursor/skills/leniu-report-scenario/references/export.md +553 -0
- package/.cursor/skills/leniu-report-scenario/references/mealtime.md +197 -0
- package/.cursor/skills/leniu-report-scenario/references/query-param.md +274 -0
- package/.cursor/skills/leniu-report-scenario/references/report-tables.md +162 -0
- package/.cursor/skills/leniu-report-scenario/references/standard-customization.md +112 -0
- package/.cursor/skills/leniu-report-scenario/references/standard-table-fields.md +113 -0
- package/.cursor/skills/leniu-report-scenario/references/total-line.md +179 -0
- package/.cursor/skills/leniu-security-guard/SKILL.md +306 -0
- package/.cursor/skills/leniu-utils-toolkit/SKILL.md +380 -0
- package/.cursor/skills/loki-log-query/SKILL.md +430 -0
- package/.cursor/skills/loki-log-query/environments.json +45 -0
- package/.cursor/skills/mysql-debug/SKILL.md +406 -0
- package/.cursor/skills/openspec-apply-change/SKILL.md +165 -0
- package/.cursor/skills/openspec-archive-change/SKILL.md +122 -0
- package/.cursor/skills/openspec-bulk-archive-change/SKILL.md +254 -0
- package/.cursor/skills/openspec-continue-change/SKILL.md +126 -0
- package/.cursor/skills/openspec-explore/SKILL.md +299 -0
- package/.cursor/skills/openspec-ff-change/SKILL.md +109 -0
- package/.cursor/skills/openspec-new-change/SKILL.md +82 -0
- package/.cursor/skills/openspec-onboard/SKILL.md +414 -0
- package/.cursor/skills/openspec-sync-specs/SKILL.md +146 -0
- package/.cursor/skills/openspec-verify-change/SKILL.md +176 -0
- package/.cursor/skills/performance-doctor/SKILL.md +297 -0
- package/.cursor/skills/project-navigator/SKILL.md +211 -0
- package/.cursor/skills/redis-cache/SKILL.md +282 -0
- package/.cursor/skills/redis-cache/references/listeners.md +23 -0
- package/.cursor/skills/scheduled-jobs/SKILL.md +277 -0
- package/.cursor/skills/security-guard/SKILL.md +245 -0
- package/.cursor/skills/security-guard/references/encrypt-config.md +103 -0
- package/.cursor/skills/security-guard/references/sensitive-strategies.md +42 -0
- package/.cursor/skills/skill-creator/LICENSE.txt +202 -0
- package/.cursor/skills/skill-creator/SKILL.md +479 -0
- package/.cursor/skills/skill-creator/agents/analyzer.md +274 -0
- package/.cursor/skills/skill-creator/agents/comparator.md +202 -0
- package/.cursor/skills/skill-creator/agents/grader.md +223 -0
- package/.cursor/skills/skill-creator/assets/eval_review.html +146 -0
- package/.cursor/skills/skill-creator/eval-viewer/generate_review.py +471 -0
- package/.cursor/skills/skill-creator/eval-viewer/viewer.html +1325 -0
- package/.cursor/skills/skill-creator/references/schemas.md +430 -0
- package/.cursor/skills/skill-creator/scripts/__init__.py +0 -0
- package/.cursor/skills/skill-creator/scripts/aggregate_benchmark.py +401 -0
- package/.cursor/skills/skill-creator/scripts/generate_report.py +326 -0
- package/.cursor/skills/skill-creator/scripts/improve_description.py +248 -0
- package/.cursor/skills/skill-creator/scripts/package_skill.py +136 -0
- package/.cursor/skills/skill-creator/scripts/quick_validate.py +103 -0
- package/.cursor/skills/skill-creator/scripts/run_eval.py +310 -0
- package/.cursor/skills/skill-creator/scripts/run_loop.py +332 -0
- package/.cursor/skills/skill-creator/scripts/utils.py +47 -0
- package/.cursor/skills/sms-mail/SKILL.md +346 -0
- package/.cursor/skills/sms-mail/references/mail-config.md +88 -0
- package/.cursor/skills/sms-mail/references/sms-config.md +74 -0
- package/.cursor/skills/social-login/SKILL.md +328 -0
- package/.cursor/skills/social-login/references/provider-configs.md +118 -0
- package/.cursor/skills/store-pc/SKILL.md +366 -0
- package/.cursor/skills/sync-back-merge/SKILL.md +66 -0
- package/.cursor/skills/task-tracker/SKILL.md +307 -0
- package/.cursor/skills/tech-decision/SKILL.md +393 -0
- package/.cursor/skills/tenant-management/SKILL.md +272 -0
- package/.cursor/skills/tenant-management/references/tenant-scenarios.md +91 -0
- package/.cursor/skills/test-development/SKILL.md +301 -0
- package/.cursor/skills/test-development/references/parameterized-examples.md +119 -0
- package/.cursor/skills/ui-pc/SKILL.md +438 -0
- package/.cursor/skills/utils-toolkit/SKILL.md +354 -0
- package/.cursor/skills/utils-toolkit/references/redis-utils-api.md +56 -0
- package/.cursor/skills/websocket-sse/SKILL.md +350 -0
- package/.cursor/skills/workflow-engine/SKILL.md +249 -0
- package/.cursor/skills/yunxiao-task-management/SKILL.md +401 -0
- package/.cursor/skills/yunxiao-task-management/templates//346/217/220/346/265/213/345/215/225/346/250/241/346/235/277.html +17 -0
- package/.cursor/templates/env-config.md +27 -0
- package/AGENTS.md +275 -0
- package/CLAUDE.md +285 -0
- package/README.md +104 -0
- package/bin/index.js +3069 -0
- package/init.sh +178 -0
- package/package.json +40 -0
- package/scripts/build-skills.js +180 -0
- package/src/platform-map.json +100 -0
- package/src/skills/add-skill/SKILL.md +488 -0
- package/src/skills/add-todo/SKILL.md +269 -0
- package/src/skills/analyze-requirements/SKILL.md +112 -0
- package/src/skills/api-development/SKILL.md +315 -0
- package/src/skills/architecture-design/SKILL.md +152 -0
- package/src/skills/backend-annotations/SKILL.md +248 -0
- package/src/skills/banana-image/CHANGELOG.md +37 -0
- package/src/skills/banana-image/README.md +146 -0
- package/src/skills/banana-image/SKILL.md +171 -0
- package/src/skills/banana-image/assets/logo.png +0 -0
- package/src/skills/banana-image/references/advanced-usage.md +189 -0
- package/src/skills/banana-image/scripts/apply_template.py +125 -0
- package/src/skills/banana-image/scripts/banana_image_exec.ts +412 -0
- package/src/skills/banana-image/scripts/batch_prep.py +82 -0
- package/src/skills/banana-image/scripts/package-lock.json +1437 -0
- package/src/skills/banana-image/scripts/package.json +18 -0
- package/src/skills/banana-image/scripts/requirements.txt +10 -0
- package/src/skills/banana-image/templates/poster.json +22 -0
- package/src/skills/banana-image/templates/product.json +17 -0
- package/src/skills/banana-image/templates/social.json +22 -0
- package/src/skills/banana-image/templates/thumbnail.json +17 -0
- package/src/skills/brainstorm/SKILL.md +216 -0
- package/src/skills/bug-detective/SKILL.md +295 -0
- package/src/skills/bug-detective/references/error-patterns.md +242 -0
- package/src/skills/check/SKILL.md +367 -0
- package/src/skills/code-patterns/SKILL.md +163 -0
- package/src/skills/code-patterns/references/leniu-code-patterns.md +87 -0
- package/src/skills/codex-code-review/SKILL.md +327 -0
- package/src/skills/collaborating-with-codex/SKILL.md +180 -0
- package/src/skills/collaborating-with-codex/scripts/codex_bridge.py +275 -0
- package/src/skills/collaborating-with-gemini/SKILL.md +194 -0
- package/src/skills/collaborating-with-gemini/scripts/gemini_bridge.py +275 -0
- package/src/skills/crud/SKILL.md +265 -0
- package/src/skills/crud-development/SKILL.md +328 -0
- package/src/skills/data-permission/SKILL.md +221 -0
- package/src/skills/data-permission/references/custom-data-scope.md +90 -0
- package/src/skills/database-ops/SKILL.md +210 -0
- package/src/skills/dev/SKILL.md +187 -0
- package/src/skills/error-handler/SKILL.md +310 -0
- package/src/skills/file-oss-management/SKILL.md +260 -0
- package/src/skills/file-oss-management/references/entities.md +105 -0
- package/src/skills/file-oss-management/references/service-impl.md +104 -0
- package/src/skills/fix-bug/SKILL.md +269 -0
- package/src/skills/git-workflow/SKILL.md +179 -0
- package/src/skills/init-docs/SKILL.md +194 -0
- package/src/skills/json-serialization/SKILL.md +341 -0
- package/src/skills/leniu-api-development/SKILL.md +319 -0
- package/src/skills/leniu-api-development/references/real-examples.md +273 -0
- package/src/skills/leniu-architecture-design/SKILL.md +383 -0
- package/src/skills/leniu-backend-annotations/SKILL.md +277 -0
- package/src/skills/leniu-brainstorm/SKILL.md +242 -0
- package/src/skills/leniu-brainstorm/references/business-scenarios.md +162 -0
- package/src/skills/leniu-code-patterns/SKILL.md +411 -0
- package/src/skills/leniu-crud-development/SKILL.md +404 -0
- package/src/skills/leniu-crud-development/references/templates.md +597 -0
- package/src/skills/leniu-customization-location/SKILL.md +410 -0
- package/src/skills/leniu-data-permission/SKILL.md +341 -0
- package/src/skills/leniu-database-ops/SKILL.md +426 -0
- package/src/skills/leniu-error-handler/SKILL.md +462 -0
- package/src/skills/leniu-java-amount-handling/SKILL.md +461 -0
- package/src/skills/leniu-java-code-style/SKILL.md +510 -0
- package/src/skills/leniu-java-concurrent/SKILL.md +400 -0
- package/src/skills/leniu-java-entity/SKILL.md +237 -0
- package/src/skills/leniu-java-entity/references/templates.md +237 -0
- package/src/skills/leniu-java-export/SKILL.md +570 -0
- package/src/skills/leniu-java-logging/SKILL.md +229 -0
- package/src/skills/leniu-java-logging/references/data-mask.md +46 -0
- package/src/skills/leniu-java-logging/references/logging-scenarios.md +113 -0
- package/src/skills/leniu-java-mq/SKILL.md +338 -0
- package/src/skills/leniu-java-mybatis/SKILL.md +267 -0
- package/src/skills/leniu-java-mybatis/references/report-mapper.md +88 -0
- package/src/skills/leniu-java-report-query-param/SKILL.md +291 -0
- package/src/skills/leniu-java-task/SKILL.md +367 -0
- package/src/skills/leniu-java-total-line/SKILL.md +196 -0
- package/src/skills/leniu-marketing-price-rule-customizer/SKILL.md +301 -0
- package/src/skills/leniu-marketing-recharge-rule-customizer/SKILL.md +285 -0
- package/src/skills/leniu-mealtime/SKILL.md +215 -0
- package/src/skills/leniu-redis-cache/SKILL.md +331 -0
- package/src/skills/leniu-report-customization/SKILL.md +415 -0
- package/src/skills/leniu-report-customization/references/table-fields.md +93 -0
- package/src/skills/leniu-report-standard-customization/SKILL.md +391 -0
- package/src/skills/leniu-report-standard-customization/references/analysis-module.md +64 -0
- package/src/skills/leniu-report-standard-customization/references/table-fields.md +113 -0
- package/src/skills/leniu-security-guard/SKILL.md +306 -0
- package/src/skills/leniu-utils-toolkit/SKILL.md +380 -0
- package/src/skills/loki-log-query/SKILL.md +400 -0
- package/src/skills/loki-log-query/environments.json +45 -0
- package/src/skills/mysql-debug/SKILL.md +400 -0
- package/src/skills/next/SKILL.md +137 -0
- package/src/skills/openspec-apply-change/SKILL.md +165 -0
- package/src/skills/openspec-archive-change/SKILL.md +122 -0
- package/src/skills/openspec-bulk-archive-change/SKILL.md +254 -0
- package/src/skills/openspec-continue-change/SKILL.md +126 -0
- package/src/skills/openspec-explore/SKILL.md +299 -0
- package/src/skills/openspec-ff-change/SKILL.md +109 -0
- package/src/skills/openspec-new-change/SKILL.md +82 -0
- package/src/skills/openspec-onboard/SKILL.md +414 -0
- package/src/skills/openspec-sync-specs/SKILL.md +146 -0
- package/src/skills/openspec-verify-change/SKILL.md +176 -0
- package/src/skills/performance-doctor/SKILL.md +297 -0
- package/src/skills/progress/SKILL.md +193 -0
- package/src/skills/project-navigator/SKILL.md +211 -0
- package/src/skills/redis-cache/SKILL.md +282 -0
- package/src/skills/redis-cache/references/listeners.md +23 -0
- package/src/skills/scheduled-jobs/SKILL.md +277 -0
- package/src/skills/security-guard/SKILL.md +245 -0
- package/src/skills/security-guard/references/encrypt-config.md +103 -0
- package/src/skills/security-guard/references/sensitive-strategies.md +42 -0
- package/src/skills/skill-creator/LICENSE.txt +202 -0
- package/src/skills/skill-creator/SKILL.md +479 -0
- package/src/skills/skill-creator/agents/analyzer.md +274 -0
- package/src/skills/skill-creator/agents/comparator.md +202 -0
- package/src/skills/skill-creator/agents/grader.md +223 -0
- package/src/skills/skill-creator/assets/eval_review.html +146 -0
- package/src/skills/skill-creator/eval-viewer/generate_review.py +471 -0
- package/src/skills/skill-creator/eval-viewer/viewer.html +1325 -0
- package/src/skills/skill-creator/references/schemas.md +430 -0
- package/src/skills/skill-creator/scripts/__init__.py +0 -0
- package/src/skills/skill-creator/scripts/aggregate_benchmark.py +401 -0
- package/src/skills/skill-creator/scripts/generate_report.py +326 -0
- package/src/skills/skill-creator/scripts/improve_description.py +248 -0
- package/src/skills/skill-creator/scripts/package_skill.py +136 -0
- package/src/skills/skill-creator/scripts/quick_validate.py +103 -0
- package/src/skills/skill-creator/scripts/run_eval.py +310 -0
- package/src/skills/skill-creator/scripts/run_loop.py +332 -0
- package/src/skills/skill-creator/scripts/utils.py +47 -0
- package/src/skills/sms-mail/SKILL.md +346 -0
- package/src/skills/sms-mail/references/mail-config.md +88 -0
- package/src/skills/sms-mail/references/sms-config.md +74 -0
- package/src/skills/social-login/SKILL.md +328 -0
- package/src/skills/social-login/references/provider-configs.md +118 -0
- package/src/skills/start/SKILL.md +154 -0
- package/src/skills/store-pc/SKILL.md +366 -0
- package/src/skills/sync/SKILL.md +149 -0
- package/src/skills/sync-back-merge/SKILL.md +66 -0
- package/src/skills/task-tracker/SKILL.md +307 -0
- package/src/skills/tech-decision/SKILL.md +393 -0
- package/src/skills/tenant-management/SKILL.md +272 -0
- package/src/skills/tenant-management/references/tenant-scenarios.md +91 -0
- package/src/skills/test-development/SKILL.md +301 -0
- package/src/skills/test-development/references/parameterized-examples.md +119 -0
- package/src/skills/ui-pc/SKILL.md +438 -0
- package/src/skills/update-status/SKILL.md +159 -0
- package/src/skills/utils-toolkit/SKILL.md +354 -0
- package/src/skills/utils-toolkit/references/redis-utils-api.md +56 -0
- package/src/skills/websocket-sse/SKILL.md +350 -0
- package/src/skills/workflow-engine/SKILL.md +249 -0
- package/src/skills/yunxiao-task-management/SKILL.md +401 -0
- package/src/skills/yunxiao-task-management/templates//346/217/220/346/265/213/345/215/225/346/250/241/346/235/277.html +17 -0
|
@@ -0,0 +1,406 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: mysql-debug
|
|
3
|
+
description: |
|
|
4
|
+
MySQL 数据库查询调试技能。通过 mysql CLI 直接查询本地 MySQL 数据库,配合日志进行 Bug 排查。
|
|
5
|
+
Bug 修复时自动评估是否需要查库,从日志中提取数据库名(租户ID),支持手动指定数据库。
|
|
6
|
+
|
|
7
|
+
触发场景:
|
|
8
|
+
- 结合日志排查 Bug 时需要查询数据库验证数据
|
|
9
|
+
- 检查数据库中某条记录的实际值
|
|
10
|
+
- 验证 SQL 执行结果是否符合预期
|
|
11
|
+
- 排查数据不一致、数据丢失、数据异常问题
|
|
12
|
+
- 需要查看表结构、索引、数据分布
|
|
13
|
+
|
|
14
|
+
触发词:查数据库、查表、执行SQL、查记录、mysql查询、数据库排查、验证数据、查数据、db查询、数据库调试
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# MySQL 数据库查询调试技能
|
|
18
|
+
|
|
19
|
+
## 概述
|
|
20
|
+
|
|
21
|
+
本技能用于在 Bug 排查过程中直接查询 MySQL 数据库,验证数据状态。配合日志分析定位问题根因。
|
|
22
|
+
|
|
23
|
+
**核心能力**:
|
|
24
|
+
1. 智能判断 Bug 是否需要查库(明显代码错误跳过)
|
|
25
|
+
2. 从日志自动提取数据库名(租户 ID = 数据库名)
|
|
26
|
+
3. 只读查询,安全排查
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## 连接信息获取(四级降级,自动查找)
|
|
31
|
+
|
|
32
|
+
当本技能被激活时,**按以下优先级获取数据库连接信息**:
|
|
33
|
+
|
|
34
|
+
### 优先级 1:用户对话中指定(最高优先级)
|
|
35
|
+
|
|
36
|
+
用户直接给出连接信息,或指定环境名:
|
|
37
|
+
- "连 dev 环境查一下" → 使用配置中 dev 环境
|
|
38
|
+
- "去 dev10 查" → **范围匹配** dev 环境(range: "1~15")
|
|
39
|
+
- 直接给出 host/port/user/password → 直接使用
|
|
40
|
+
|
|
41
|
+
### 优先级 2:本地项目 `.claude/mysql-config.json`
|
|
42
|
+
|
|
43
|
+
项目目录下的配置文件,优先于全局配置。
|
|
44
|
+
|
|
45
|
+
### 优先级 3:全局配置(所有项目共享)
|
|
46
|
+
|
|
47
|
+
全局配置文件(通过 `npx ai-engineering-init config --scope global` 创建)。
|
|
48
|
+
查找路径:`~/.claude/mysql-config.json` 或 `~/.cursor/mysql-config.json`(取决于使用的工具)。
|
|
49
|
+
**推荐**:公司统一的数据库连接信息放全局,项目特定的覆盖放本地。
|
|
50
|
+
|
|
51
|
+
### 优先级 4:工程配置文件(零配置,本地开发默认)
|
|
52
|
+
|
|
53
|
+
从项目的 `bootstrap-dev.yml` 中自动提取连接信息:
|
|
54
|
+
|
|
55
|
+
**搜索路径**:
|
|
56
|
+
```
|
|
57
|
+
**/bootstrap-dev.yml
|
|
58
|
+
**/bootstrap*.yml(降级)
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
**解析位置**:`spring.dataset.system.master` 节点
|
|
62
|
+
|
|
63
|
+
**解析规则**:
|
|
64
|
+
```yaml
|
|
65
|
+
# 从以下字段提取:
|
|
66
|
+
jdbcUrl: jdbc:mysql://127.0.0.1:3306/system_xxx
|
|
67
|
+
username: root
|
|
68
|
+
password: xxx
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
**提取结果**:
|
|
72
|
+
- host = `127.0.0.1`(从 jdbcUrl 解析)
|
|
73
|
+
- port = `3306`(从 jdbcUrl 解析)
|
|
74
|
+
- user = `root`(username 字段)
|
|
75
|
+
- password = `xxx`(password 字段)
|
|
76
|
+
- 注意:jdbcUrl 中的数据库名(`system_xxx`)为系统库,**不作为查询目标数据库**。查询目标数据库 = 租户ID(从日志提取或用户指定)
|
|
77
|
+
|
|
78
|
+
### mysql CLI 查找(多路径)
|
|
79
|
+
|
|
80
|
+
按顺序查找 mysql 客户端:
|
|
81
|
+
|
|
82
|
+
```bash
|
|
83
|
+
which mysql \
|
|
84
|
+
|| ls /usr/local/mysql/bin/mysql \
|
|
85
|
+
|| ls /opt/homebrew/bin/mysql \
|
|
86
|
+
|| ls /opt/homebrew/opt/mysql-client/bin/mysql
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
找到任一即可使用。如果全部不存在,输出安装提示:
|
|
90
|
+
```
|
|
91
|
+
brew install mysql-client
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
### 引导提示(仅当连接信息和 mysql CLI 都无法获取时)
|
|
95
|
+
|
|
96
|
+
```
|
|
97
|
+
⚠️ 数据库查询功能需要先完成配置:
|
|
98
|
+
|
|
99
|
+
1. 连接信息获取失败:
|
|
100
|
+
- 未找到 bootstrap-dev.yml 工程配置文件
|
|
101
|
+
- 未找到 .claude/mysql-config.json 配置文件
|
|
102
|
+
→ 请创建 .claude/mysql-config.json 或确保项目中存在 bootstrap-dev.yml
|
|
103
|
+
|
|
104
|
+
2. 安装 MySQL 客户端:
|
|
105
|
+
brew install mysql-client
|
|
106
|
+
|
|
107
|
+
完成后重新触发即可使用数据库查询辅助排查。
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
> 引导提示输出后,Bug 排查仍可继续(走 bug-detective 纯代码分析路径),只是跳过数据库查询环节。
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
## 多环境支持
|
|
115
|
+
|
|
116
|
+
### 配置文件结构
|
|
117
|
+
|
|
118
|
+
`.claude/mysql-config.json` 支持多环境配置:
|
|
119
|
+
|
|
120
|
+
```json
|
|
121
|
+
{
|
|
122
|
+
"environments": {
|
|
123
|
+
"local": { "host": "127.0.0.1", "port": 3306, "user": "root", "password": "xxx" },
|
|
124
|
+
"dev": { "host": "dev-db.example.com", "port": 3306, "user": "dev_user", "password": "xxx" },
|
|
125
|
+
"prod": { "host": "prod-db.example.com", "port": 3306, "user": "readonly", "password": "xxx" }
|
|
126
|
+
},
|
|
127
|
+
"default": "local"
|
|
128
|
+
}
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
### 环境选择规则
|
|
132
|
+
|
|
133
|
+
| 优先级 | 来源 | 示例 |
|
|
134
|
+
|--------|------|------|
|
|
135
|
+
| 1(最高) | 用户对话中指定 | "连 dev 环境查一下"、"用生产库看看" |
|
|
136
|
+
| 2 | 配置文件 `default` 字段 | `"default": "local"` |
|
|
137
|
+
|
|
138
|
+
### 环境关键词映射
|
|
139
|
+
|
|
140
|
+
用户说的话 → 对应环境名:
|
|
141
|
+
|
|
142
|
+
| 用户说法 | 环境 |
|
|
143
|
+
|---------|------|
|
|
144
|
+
| "本地"、"local"、"本地环境" | `local` |
|
|
145
|
+
| "开发"、"dev"、"测试环境"、"开发环境" | `dev` |
|
|
146
|
+
| "生产"、"prod"、"线上"、"正式环境" | `prod` |
|
|
147
|
+
|
|
148
|
+
### 连接示例
|
|
149
|
+
|
|
150
|
+
```bash
|
|
151
|
+
# 用户说"连 dev 环境查一下 order_info"
|
|
152
|
+
# → 读取 environments.dev 的连接信息 + 日志提取的数据库名
|
|
153
|
+
mysql -h dev-db.example.com -P 3306 -u dev_user -p'xxx' 546198574447230976 -e "SELECT ..."
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
---
|
|
157
|
+
|
|
158
|
+
## 核心流程:是否需要查库?
|
|
159
|
+
|
|
160
|
+
### 决策树(Bug 修复时必须先评估)
|
|
161
|
+
|
|
162
|
+
```
|
|
163
|
+
用户报告 Bug / 提供日志
|
|
164
|
+
│
|
|
165
|
+
├─ 明显的代码错误? ──→ ✅ 不需要查库,直接修复
|
|
166
|
+
│ - NPE 且代码中未做空判断
|
|
167
|
+
│ - 语法错误、拼写错误
|
|
168
|
+
│ - 类型转换错误(ClassCastException)
|
|
169
|
+
│ - 缺少 import、注解遗漏
|
|
170
|
+
│ - 方法签名不匹配
|
|
171
|
+
│
|
|
172
|
+
├─ 数据相关的问题? ──→ 🔍 需要查库
|
|
173
|
+
│ - "查不到数据"、"数据为空"
|
|
174
|
+
│ - "数量不对"、"金额不对"
|
|
175
|
+
│ - SQL 相关异常(DataIntegrityViolation、DuplicateKey)
|
|
176
|
+
│ - 关联查询结果异常
|
|
177
|
+
│ - 状态流转异常(订单状态不对等)
|
|
178
|
+
│
|
|
179
|
+
├─ 不确定是代码还是数据? ──→ 🔍 需要查库确认
|
|
180
|
+
│ - 逻辑正确但结果错误
|
|
181
|
+
│ - 特定租户/特定数据才出现的 Bug
|
|
182
|
+
│ - 生产有问题但本地无法复现
|
|
183
|
+
│
|
|
184
|
+
└─ 配置/环境问题? ──→ ✅ 不需要查库
|
|
185
|
+
- 启动失败、Bean 创建异常
|
|
186
|
+
- 配置文件错误
|
|
187
|
+
- 依赖版本冲突
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
### 评估输出格式
|
|
191
|
+
|
|
192
|
+
在 Bug 修复响应中,先输出评估结论:
|
|
193
|
+
|
|
194
|
+
```
|
|
195
|
+
📊 数据库查询评估:需要查库
|
|
196
|
+
理由:日志显示 order_info 查询返回空,需要确认数据是否存在
|
|
197
|
+
数据库:546198574447230976(从日志提取)
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
或:
|
|
201
|
+
|
|
202
|
+
```
|
|
203
|
+
📊 数据库查询评估:不需要查库
|
|
204
|
+
理由:明显的 NPE,代码中 getUserInfo() 返回值未做空判断
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
---
|
|
208
|
+
|
|
209
|
+
## 从日志提取数据库名
|
|
210
|
+
|
|
211
|
+
### 日志格式说明
|
|
212
|
+
|
|
213
|
+
本项目的日志格式:
|
|
214
|
+
|
|
215
|
+
```
|
|
216
|
+
2026-03-04 10:21:40.902,-,546198574447230976,, DEBUG 94396 --- [ XNIO-1 task-3] n.x.f.c.request.RequestLoggingFilter : 47 : >>> GET /api/v2/web/xxx
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
各字段含义:
|
|
220
|
+
|
|
221
|
+
```
|
|
222
|
+
时间戳 ,-,租户ID(=数据库名),, 日志级别 PID --- [线程名] 类名 : 行号 : 日志内容
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
### 提取规则
|
|
226
|
+
|
|
227
|
+
1. **自动提取**:从日志行中匹配 `,-,(\d{15,19}),,` 模式,提取的数字即为数据库名
|
|
228
|
+
2. **手动指定**:用户直接说"查 546198574447230976 库"或"数据库名是 xxx"
|
|
229
|
+
3. **优先级**:手动指定 > 日志提取 > 配置文件 default
|
|
230
|
+
|
|
231
|
+
### 提取示例
|
|
232
|
+
|
|
233
|
+
```
|
|
234
|
+
日志:2026-03-04 10:21:40.902,-,546198574447230976,, DEBUG ...
|
|
235
|
+
↑
|
|
236
|
+
数据库名 = 546198574447230976
|
|
237
|
+
```
|
|
238
|
+
|
|
239
|
+
连接时使用:
|
|
240
|
+
```bash
|
|
241
|
+
mysql -h 127.0.0.1 -P 3306 -u root -p'password' 546198574447230976 -e "SELECT ..."
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
---
|
|
245
|
+
|
|
246
|
+
## 查询执行
|
|
247
|
+
|
|
248
|
+
### 连接方式
|
|
249
|
+
|
|
250
|
+
按"连接信息获取"章节的优先级获取 host/port/user/password,数据库名从日志提取或用户指定:
|
|
251
|
+
|
|
252
|
+
```bash
|
|
253
|
+
# 连接信息来源:用户指定 > mysql-config.json > bootstrap-dev.yml 自动提取
|
|
254
|
+
# 数据库名来源:用户指定 > 日志提取的租户ID
|
|
255
|
+
mysql -h {host} -P {port} -u {user} -p'{password}' {database_from_log_or_user} -e "{SQL}"
|
|
256
|
+
|
|
257
|
+
# mysql 路径:如果 which mysql 失败,尝试绝对路径
|
|
258
|
+
/opt/homebrew/opt/mysql-client/bin/mysql -h {host} ...
|
|
259
|
+
```
|
|
260
|
+
|
|
261
|
+
### 常用排查查询模板
|
|
262
|
+
|
|
263
|
+
#### 查看表结构
|
|
264
|
+
```sql
|
|
265
|
+
DESCRIBE table_name;
|
|
266
|
+
SHOW CREATE TABLE table_name;
|
|
267
|
+
```
|
|
268
|
+
|
|
269
|
+
#### 按 ID 查记录
|
|
270
|
+
```sql
|
|
271
|
+
SELECT * FROM table_name WHERE id = {id} AND del_flag = 2;
|
|
272
|
+
```
|
|
273
|
+
|
|
274
|
+
#### 查看最近修改的数据
|
|
275
|
+
```sql
|
|
276
|
+
SELECT * FROM table_name
|
|
277
|
+
WHERE uptime >= '{log_timestamp}'
|
|
278
|
+
ORDER BY uptime DESC
|
|
279
|
+
LIMIT 20;
|
|
280
|
+
```
|
|
281
|
+
|
|
282
|
+
#### 检查关联数据一致性
|
|
283
|
+
```sql
|
|
284
|
+
SELECT a.id, b.id AS related_id
|
|
285
|
+
FROM table_a a
|
|
286
|
+
LEFT JOIN table_b b ON a.related_id = b.id
|
|
287
|
+
WHERE a.id = {id} AND b.id IS NULL;
|
|
288
|
+
```
|
|
289
|
+
|
|
290
|
+
#### 统计数据分布
|
|
291
|
+
```sql
|
|
292
|
+
SELECT status, COUNT(*) as cnt
|
|
293
|
+
FROM table_name
|
|
294
|
+
WHERE del_flag = 2
|
|
295
|
+
GROUP BY status;
|
|
296
|
+
```
|
|
297
|
+
|
|
298
|
+
#### 查看某时间段的操作记录
|
|
299
|
+
```sql
|
|
300
|
+
SELECT * FROM table_name
|
|
301
|
+
WHERE crtime BETWEEN '{start}' AND '{end}'
|
|
302
|
+
ORDER BY crtime DESC
|
|
303
|
+
LIMIT 50;
|
|
304
|
+
```
|
|
305
|
+
|
|
306
|
+
---
|
|
307
|
+
|
|
308
|
+
## 安全规范(强制执行,违反即终止)
|
|
309
|
+
|
|
310
|
+
### 允许执行的 SQL(白名单)
|
|
311
|
+
|
|
312
|
+
**只允许以下语句类型**:
|
|
313
|
+
- `SELECT` — 查询数据
|
|
314
|
+
- `DESCRIBE` / `DESC` — 查看表结构
|
|
315
|
+
- `SHOW` — 查看建表语句、索引、状态等
|
|
316
|
+
- `EXPLAIN` — 分析执行计划
|
|
317
|
+
|
|
318
|
+
### 禁止执行的 SQL(黑名单)
|
|
319
|
+
|
|
320
|
+
**DDL 操作 — 全部禁止**:
|
|
321
|
+
- `CREATE TABLE / VIEW / INDEX / DATABASE`
|
|
322
|
+
- `ALTER TABLE / COLUMN`
|
|
323
|
+
- `DROP TABLE / VIEW / INDEX / DATABASE`
|
|
324
|
+
- `TRUNCATE TABLE`
|
|
325
|
+
- `RENAME TABLE`
|
|
326
|
+
|
|
327
|
+
**DML 写操作 — 全部禁止**:
|
|
328
|
+
- `INSERT` — 禁止插入数据
|
|
329
|
+
- `UPDATE` — 禁止更新数据
|
|
330
|
+
- `DELETE` — 禁止删除数据
|
|
331
|
+
- `REPLACE` — 禁止替换数据
|
|
332
|
+
|
|
333
|
+
**权限/管理操作 — 全部禁止**:
|
|
334
|
+
- `GRANT / REVOKE`
|
|
335
|
+
- `SET GLOBAL`
|
|
336
|
+
- `FLUSH`
|
|
337
|
+
|
|
338
|
+
### 敏感 SQL 拦截(执行前必须分析)
|
|
339
|
+
|
|
340
|
+
在执行任何 SQL 之前,必须进行安全分析。遇到以下情况时,**不执行 SQL,改为输出分析结果并询问用户**:
|
|
341
|
+
|
|
342
|
+
| 风险类型 | 检测规则 | 处理方式 |
|
|
343
|
+
|---------|---------|---------|
|
|
344
|
+
| 无 WHERE 全表扫描 | `SELECT * FROM xxx` 无 WHERE 子句 | 提醒用户加条件,或自动加 `LIMIT 10` |
|
|
345
|
+
| 大范围查询 | WHERE 条件覆盖范围过大(如 `del_flag = 2`) | 提醒加更精确条件,强制 `LIMIT 50` |
|
|
346
|
+
| 多表 JOIN 无条件 | JOIN 无 ON 条件(笛卡尔积) | 拒绝执行,提示补充 JOIN 条件 |
|
|
347
|
+
| 子查询嵌套过深 | 超过 3 层嵌套子查询 | 输出 SQL 让用户确认后再执行 |
|
|
348
|
+
| 敏感表查询 | 涉及用户密码表、密钥表 | 输出脱敏后的 SQL 分析,不直接查询 |
|
|
349
|
+
|
|
350
|
+
### 执行前检查流程
|
|
351
|
+
|
|
352
|
+
```
|
|
353
|
+
收到/构造 SQL
|
|
354
|
+
│
|
|
355
|
+
├─ 是否在白名单内? ──→ 否 → 拒绝执行,输出原因
|
|
356
|
+
│
|
|
357
|
+
├─ 是否命中敏感规则? ──→ 是 → 输出风险分析,询问用户
|
|
358
|
+
│
|
|
359
|
+
├─ 是否包含 LIMIT? ──→ 否 → 自动追加 LIMIT 50
|
|
360
|
+
│
|
|
361
|
+
└─ 通过所有检查 → 执行 SQL
|
|
362
|
+
```
|
|
363
|
+
|
|
364
|
+
### 查询结果安全
|
|
365
|
+
|
|
366
|
+
- 查询必须加 `LIMIT`(默认 LIMIT 50)防止返回过多数据
|
|
367
|
+
- 不在输出中暴露密码、手机号(phone)、身份证(id_card)等敏感字段
|
|
368
|
+
- 查询结果中的敏感字段用 `***` 脱敏展示
|
|
369
|
+
- 如需修改数据,**只输出 SQL 语句让用户手动执行**,不代为执行
|
|
370
|
+
|
|
371
|
+
### 配置文件安全
|
|
372
|
+
|
|
373
|
+
- `.claude/mysql-config.json` 已加入 `.gitignore`,禁止提交到版本库
|
|
374
|
+
|
|
375
|
+
---
|
|
376
|
+
|
|
377
|
+
## 与 bug-detective 配合
|
|
378
|
+
|
|
379
|
+
本技能是 `bug-detective` 的数据层扩展。当 bug-detective 被触发时,会自动评估是否需要同时激活 mysql-debug:
|
|
380
|
+
|
|
381
|
+
| 步骤 | bug-detective | mysql-debug |
|
|
382
|
+
|------|--------------|-------------|
|
|
383
|
+
| 1 | 分析日志、定位异常层 | 评估是否需要查库 |
|
|
384
|
+
| 2 | 识别涉及的表和查询 | 从日志提取数据库名 |
|
|
385
|
+
| 3 | 推断可能原因 | 执行 SQL 验证数据 |
|
|
386
|
+
| 4 | 给出修复方案 | 用数据证实/排除假设 |
|
|
387
|
+
|
|
388
|
+
典型联合使用:
|
|
389
|
+
```
|
|
390
|
+
用户:"订单查询接口返回空数据,日志如下..."
|
|
391
|
+
日志:2026-03-04 10:21:40.902,-,546198574447230976,, ERROR ...
|
|
392
|
+
|
|
393
|
+
→ 评估:需要查库(数据返回空,需确认数据是否存在)
|
|
394
|
+
→ 提取数据库:546198574447230976
|
|
395
|
+
→ 执行:SELECT * FROM order_info WHERE id = xxx AND del_flag = 2
|
|
396
|
+
→ 发现:del_flag = 1(已删除),用户操作了删除但不知情
|
|
397
|
+
→ 修复方案:恢复数据 / 检查前端删除按钮权限
|
|
398
|
+
```
|
|
399
|
+
|
|
400
|
+
---
|
|
401
|
+
|
|
402
|
+
## 注意
|
|
403
|
+
|
|
404
|
+
- 本技能专注于**查询数据库辅助排查**,不涉及建表、迁移等操作(请使用 `database-ops`)
|
|
405
|
+
- 如果是纯代码错误(NPE、语法错误等)不需要查库,请使用 `bug-detective`
|
|
406
|
+
- 如果是 SQL 性能问题(慢查询),请使用 `performance-doctor`
|
|
@@ -0,0 +1,297 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: performance-doctor
|
|
3
|
+
description: |
|
|
4
|
+
后端性能问题诊断与优化。包含 SQL 优化、缓存策略、批量操作优化、接口优化、日志分析。
|
|
5
|
+
|
|
6
|
+
触发场景:
|
|
7
|
+
- 接口响应慢
|
|
8
|
+
- SQL 慢查询优化
|
|
9
|
+
- 缓存策略设计
|
|
10
|
+
- 分页查询优化
|
|
11
|
+
- N+1 查询问题
|
|
12
|
+
- 批量操作超时
|
|
13
|
+
|
|
14
|
+
触发词:性能优化、慢查询、SQL优化、索引优化、缓存、Redis缓存、N+1、分页优化、EXPLAIN、响应慢、批量操作
|
|
15
|
+
|
|
16
|
+
注意:如果是排查功能性 Bug(代码报错、逻辑错误),请使用 bug-detective。
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
# 后端性能优化指南
|
|
20
|
+
|
|
21
|
+
## 诊断流程
|
|
22
|
+
|
|
23
|
+
```
|
|
24
|
+
1. 定位 -> 接口层面(响应时间) / SQL层面(慢查询) / 缓存层面(命中率)
|
|
25
|
+
2. 分析 -> SQL 日志 / Arthas JVM 诊断 / 日志分析
|
|
26
|
+
3. 优化 -> 索引 / 缓存 / 批量处理
|
|
27
|
+
4. 验证 -> 对比优化前后指标
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
### 性能指标
|
|
31
|
+
|
|
32
|
+
| 指标 | 良好 | 需优化 | 工具 |
|
|
33
|
+
|------|------|--------|------|
|
|
34
|
+
| 接口响应 | < 200ms | > 500ms | p6spy/SkyWalking |
|
|
35
|
+
| 数据库查询 | < 50ms | > 200ms | SQL 日志 |
|
|
36
|
+
| 内存使用 | < 70% | > 85% | Arthas/JVM 监控 |
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## 1. MyBatis-Plus 查询优化
|
|
41
|
+
|
|
42
|
+
### 查询构建规范
|
|
43
|
+
|
|
44
|
+
```java
|
|
45
|
+
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
|
|
46
|
+
import com.baomidou.mybatisplus.core.toolkit.Wrappers;
|
|
47
|
+
|
|
48
|
+
private LambdaQueryWrapper<XxxEntity> buildQueryWrapper(XxxQueryDTO query) {
|
|
49
|
+
LambdaQueryWrapper<XxxEntity> lqw = Wrappers.lambdaQuery();
|
|
50
|
+
lqw.eq(query.getDeptId() != null, XxxEntity::getDeptId, query.getDeptId());
|
|
51
|
+
lqw.like(StrUtil.isNotBlank(query.getKeyword()), XxxEntity::getName, query.getKeyword());
|
|
52
|
+
lqw.between(query.getStartTime() != null && query.getEndTime() != null,
|
|
53
|
+
XxxEntity::getCreateTime, query.getStartTime(), query.getEndTime());
|
|
54
|
+
return lqw;
|
|
55
|
+
}
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### 更新构建规范
|
|
59
|
+
|
|
60
|
+
```java
|
|
61
|
+
import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
|
|
62
|
+
|
|
63
|
+
// 精确更新
|
|
64
|
+
baseMapper.update(null,
|
|
65
|
+
new LambdaUpdateWrapper<XxxEntity>()
|
|
66
|
+
.set(XxxEntity::getStatus, status)
|
|
67
|
+
.eq(XxxEntity::getId, id));
|
|
68
|
+
|
|
69
|
+
// 条件更新(非null才设置)
|
|
70
|
+
baseMapper.update(null,
|
|
71
|
+
new LambdaUpdateWrapper<XxxEntity>()
|
|
72
|
+
.set(ObjectUtil.isNotNull(entity.getName()), XxxEntity::getName, entity.getName())
|
|
73
|
+
.set(XxxEntity::getPhone, entity.getPhone())
|
|
74
|
+
.eq(XxxEntity::getId, entity.getId()));
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
### 批量更新
|
|
78
|
+
|
|
79
|
+
```java
|
|
80
|
+
import com.baomidou.mybatisplus.extension.toolkit.Db;
|
|
81
|
+
|
|
82
|
+
// 推荐:Db 工具类批量更新
|
|
83
|
+
Db.updateBatchById(entityList);
|
|
84
|
+
|
|
85
|
+
// 避免:循环单个更新(N次数据库访问)
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
### N+1 查询修复
|
|
89
|
+
|
|
90
|
+
```java
|
|
91
|
+
// ❌ 错误:循环查询
|
|
92
|
+
for (Order order : orders) {
|
|
93
|
+
User user = userMapper.selectById(order.getUserId());
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
// ✅ 正确:批量查询 + Map 映射
|
|
97
|
+
List<Long> userIds = orders.stream().map(Order::getUserId).distinct().toList();
|
|
98
|
+
Map<Long, User> userMap = userMapper.selectBatchIds(userIds).stream()
|
|
99
|
+
.collect(Collectors.toMap(User::getId, Function.identity()));
|
|
100
|
+
for (Order order : orders) {
|
|
101
|
+
User user = userMap.get(order.getUserId());
|
|
102
|
+
}
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
---
|
|
106
|
+
|
|
107
|
+
## 2. 缓存优化
|
|
108
|
+
|
|
109
|
+
### Redisson 缓存操作
|
|
110
|
+
|
|
111
|
+
```java
|
|
112
|
+
import org.redisson.api.RedissonClient;
|
|
113
|
+
import org.redisson.api.RBucket;
|
|
114
|
+
|
|
115
|
+
// 设置缓存
|
|
116
|
+
RBucket<UserVo> bucket = redissonClient.getBucket("user:" + id);
|
|
117
|
+
bucket.set(userVo, Duration.ofMinutes(30));
|
|
118
|
+
|
|
119
|
+
// 获取缓存
|
|
120
|
+
UserVo cached = redissonClient.<UserVo>getBucket("user:" + id).get();
|
|
121
|
+
|
|
122
|
+
// 删除缓存
|
|
123
|
+
redissonClient.getBucket("user:" + id).delete();
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
### Spring Cache 注解
|
|
127
|
+
|
|
128
|
+
```java
|
|
129
|
+
@Cacheable(value = "user", key = "#id")
|
|
130
|
+
public UserVo getById(Long id) { ... }
|
|
131
|
+
|
|
132
|
+
@CacheEvict(value = "user", key = "#bo.id")
|
|
133
|
+
public int update(UserBo bo) { ... }
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
> **@Cacheable 禁止返回不可变集合**(`List.of()`、`Set.of()`),Redis 反序列化会失败。必须用 `new ArrayList<>(List.of(...))`。
|
|
137
|
+
|
|
138
|
+
### 分布式锁
|
|
139
|
+
|
|
140
|
+
```java
|
|
141
|
+
import org.redisson.api.RLock;
|
|
142
|
+
|
|
143
|
+
// 注入 RedissonClient
|
|
144
|
+
RLock lock = redissonClient.getLock("lock:order:" + orderId);
|
|
145
|
+
try {
|
|
146
|
+
if (lock.tryLock(3, 10, TimeUnit.SECONDS)) {
|
|
147
|
+
try {
|
|
148
|
+
// 业务逻辑
|
|
149
|
+
} finally {
|
|
150
|
+
if (lock.isLocked() && lock.isHeldByCurrentThread()) {
|
|
151
|
+
lock.unlock();
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
} else {
|
|
155
|
+
throw new [你的异常类]("业务处理中,请稍后再试");
|
|
156
|
+
}
|
|
157
|
+
} catch (InterruptedException e) {
|
|
158
|
+
Thread.currentThread().interrupt();
|
|
159
|
+
throw new [你的异常类]("操作被中断");
|
|
160
|
+
}
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
### 限流
|
|
164
|
+
|
|
165
|
+
```java
|
|
166
|
+
import org.redisson.api.RRateLimiter;
|
|
167
|
+
import org.redisson.api.RateType;
|
|
168
|
+
import org.redisson.api.RateIntervalUnit;
|
|
169
|
+
|
|
170
|
+
RRateLimiter limiter = redissonClient.getRateLimiter("api:rate:" + userId);
|
|
171
|
+
limiter.trySetRate(RateType.OVERALL, 100, 60, RateIntervalUnit.SECONDS);
|
|
172
|
+
if (!limiter.tryAcquire()) {
|
|
173
|
+
throw new [你的异常类]("请求过于频繁");
|
|
174
|
+
}
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
### 本地缓存(Caffeine)
|
|
178
|
+
|
|
179
|
+
```java
|
|
180
|
+
import com.github.benmanes.caffeine.cache.Cache;
|
|
181
|
+
import com.github.benmanes.caffeine.cache.Caffeine;
|
|
182
|
+
|
|
183
|
+
private final Cache<Long, UserVo> localCache = Caffeine.newBuilder()
|
|
184
|
+
.maximumSize(1000)
|
|
185
|
+
.expireAfterWrite(5, TimeUnit.MINUTES)
|
|
186
|
+
.build();
|
|
187
|
+
|
|
188
|
+
public UserVo getUser(Long id) {
|
|
189
|
+
return localCache.get(id, key -> {
|
|
190
|
+
RBucket<UserVo> bucket = redissonClient.getBucket("user:" + id);
|
|
191
|
+
UserVo cached = bucket.get();
|
|
192
|
+
return cached != null ? cached : baseMapper.selectById(id);
|
|
193
|
+
});
|
|
194
|
+
}
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
---
|
|
198
|
+
|
|
199
|
+
## 3. 索引优化
|
|
200
|
+
|
|
201
|
+
```sql
|
|
202
|
+
-- 为高频查询字段添加索引
|
|
203
|
+
CREATE INDEX idx_status ON xxx_table(status);
|
|
204
|
+
|
|
205
|
+
-- 复合索引:遵循最左前缀原则
|
|
206
|
+
CREATE INDEX idx_status_create_time ON xxx_table(status, create_time);
|
|
207
|
+
|
|
208
|
+
-- 使用 EXPLAIN 分析查询
|
|
209
|
+
EXPLAIN SELECT * FROM xxx_table WHERE status = 1 AND create_time > '2026-01-01';
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
---
|
|
213
|
+
|
|
214
|
+
## 4. 批量操作优化
|
|
215
|
+
|
|
216
|
+
```java
|
|
217
|
+
// 推荐:分批处理(每批500条)
|
|
218
|
+
public void batchInsert(List<XxxEntity> list) {
|
|
219
|
+
int batchSize = 500;
|
|
220
|
+
for (int i = 0; i < list.size(); i += batchSize) {
|
|
221
|
+
int end = Math.min(i + batchSize, list.size());
|
|
222
|
+
baseMapper.insertBatch(list.subList(i, end));
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
// 批量更新同理
|
|
227
|
+
@Transactional(rollbackFor = Exception.class)
|
|
228
|
+
public void batchUpdate(List<XxxDTO> list) {
|
|
229
|
+
int batchSize = 500;
|
|
230
|
+
for (int i = 0; i < list.size(); i += batchSize) {
|
|
231
|
+
int end = Math.min(i + batchSize, list.size());
|
|
232
|
+
List<XxxEntity> batch = list.subList(i, end).stream()
|
|
233
|
+
.map(dto -> BeanUtil.copyProperties(dto, XxxEntity.class))
|
|
234
|
+
.toList();
|
|
235
|
+
Db.updateBatchById(batch);
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
---
|
|
241
|
+
|
|
242
|
+
## 5. 性能日志分析
|
|
243
|
+
|
|
244
|
+
### SQL 监控
|
|
245
|
+
|
|
246
|
+
开发环境 p6spy 默认开启:`spring.datasource.dynamic.p6spy: true`
|
|
247
|
+
|
|
248
|
+
日志格式:
|
|
249
|
+
```
|
|
250
|
+
2026-01-08 22:12:10 [req-123] [...] INFO p6spy - Consume Time:245 ms
|
|
251
|
+
Execute SQL:SELECT * FROM user WHERE status = 1
|
|
252
|
+
```
|
|
253
|
+
|
|
254
|
+
### 分析命令
|
|
255
|
+
|
|
256
|
+
```bash
|
|
257
|
+
# 慢 SQL(>200ms)
|
|
258
|
+
grep "Consume Time" ./logs/console.log | grep -E "Consume Time:[2-9][0-9]{2,}|[0-9]{4,}"
|
|
259
|
+
|
|
260
|
+
# N+1 检测(同一 SQL 重复多次)
|
|
261
|
+
grep "Execute SQL" ./logs/console.log | sed 's/WHERE.*/WHERE .../' | sort | uniq -c | sort -rn | head -20
|
|
262
|
+
|
|
263
|
+
# 错误日志
|
|
264
|
+
grep "ERROR" ./logs/console.log | tail -50
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
### AI 主动读日志的触发条件
|
|
268
|
+
|
|
269
|
+
| 场景 | 关键词 | 分析重点 |
|
|
270
|
+
|------|--------|---------|
|
|
271
|
+
| 接口慢 | "接口慢"、"超时" | SQL 执行时间、N+1 查询 |
|
|
272
|
+
| SQL 慢 | "SQL慢"、"查询慢" | p6spy Consume Time |
|
|
273
|
+
| 内存/CPU | "内存高"、"卡顿" | OOM、GC、线程池满 |
|
|
274
|
+
| 频繁报错 | "一直报错" | ERROR 日志、异常频率 |
|
|
275
|
+
|
|
276
|
+
---
|
|
277
|
+
|
|
278
|
+
## 常见问题速查
|
|
279
|
+
|
|
280
|
+
| 问题 | 原因 | 方案 |
|
|
281
|
+
|------|------|------|
|
|
282
|
+
| 接口响应慢 | SQL 无索引 | 添加索引,EXPLAIN 分析 |
|
|
283
|
+
| 接口响应慢 | N+1 查询 | 批量查询 + Map 映射 |
|
|
284
|
+
| 接口响应慢 | 未缓存 | Redisson 或 @Cacheable |
|
|
285
|
+
| 分页查询慢 | 深分页 | 游标分页或限制页码 |
|
|
286
|
+
| 批量操作超时 | 数据量太大 | 分批500条处理 |
|
|
287
|
+
| 内存溢出 | 大数据量一次加载 | 分批/流式处理 |
|
|
288
|
+
|
|
289
|
+
---
|
|
290
|
+
|
|
291
|
+
## 监控工具
|
|
292
|
+
|
|
293
|
+
| 工具 | 用途 | 使用方式 |
|
|
294
|
+
|------|------|---------|
|
|
295
|
+
| **p6spy** | SQL 监控、执行时间 | 开发环境默认开启 |
|
|
296
|
+
| **Arthas** | JVM 诊断、火焰图 | `java -jar arthas-boot.jar` |
|
|
297
|
+
| **SkyWalking** | 分布式链路追踪 | 需单独部署 |
|