AgentSkillsCN

es-plugins-validation

针对 Elasticsearch 插件(Lance Vector 与 Cloud IAM)进行端到端回归验证。适用于在修改插件代码后、提交或创建 PR 前,或当用户要求对插件进行测试或回归测试时使用;亦可在提及 Lance Vector 或 Cloud IAM 验证时启用此技能。该技能提供涵盖 P0/P1/P2 优先级的 75 个测试用例的自动化测试脚本,包括 kNN 搜索、OSS 集成、内存泄漏、身份验证、角色映射,以及各类边缘场景。

SKILL.md
--- frontmatter
name: es-plugins-validation
description: End-to-end regression validation for Elasticsearch plugins (Lance Vector and Cloud IAM). Use when validating changes to prevent regressions, after modifying plugin code, before committing or creating PR, when user asks to validate test or regression test the plugins, or any mention of lance-vector or cloud-iam validation. Provides automated test scripts covering 75 test cases across P0/P1/P2 priorities including kNN search, OSS integration, memory leaks, authentication, role mapping, and edge cases.

ES Plugins Regression Validation

Quick Start

Run P0 critical tests:

bash
./project_starter.sh -d && bash .claude/skills/es-plugins-validation/scripts/run_p0.sh

Environment

ComponentValue
ES Distributionbuild/distribution/local/elasticsearch-9.2.4-SNAPSHOT
OSS Bucketdenny-test-lance
OSS Credentials~/.oss/credentials.json
Startup Script./project_starter.sh
Basic Authelastic / Summer11

Critical Regressions (P0)

IDDescriptionMethod
R1Zero-score bugAll hits._score > 0
R2Memory leaksHeap growth < 30%
R3OSS env varsSet before ES starts
R4Arrow typespa.string() for _id

Test Scripts

run_p0.sh - Critical Tests

Runs 21 P0 tests (blocking regressions). Use after any code change.

run_p1.sh - High Priority Tests

Runs 38 P1 tests (major functionality). Run daily or per PR.

run_all.sh - Full Regression

Runs all 75 tests. Run weekly or pre-release.

test_memory.sh - Memory Leak Detection

Monitors heap during 1000 searches.

create_test_data.py - Generate Lance Datasets

Creates test data in OSS bucket.

Test Coverage Summary

CategoryTestsP0P1P2
Lance Vector (LV)3210148
Cloud IAM (CI)266146
Integration (INT)7331
Configuration (CFG)5122
Error Handling (ERR)5131

Total: 75 tests (21 P0, 38 P1, 16 P2)

Sync with Validation Guide

This skill is generated from reg_validation_guide.md (OFFICIAL guide). To update:

  1. Edit reg_validation_guide.md
  2. Run python3 .claude/skills/es-plugins-validation/scripts/sync_from_plan.py

Detailed Test References