Fix version list: keep only locally verified versions, document incompatibilities

Locally verified PASSED:
- OkHttp: 4.10.0, 4.11.0, 4.12.0 (all 24 versions passed)
- Dubbo 3.x: 3.1.11, 3.2.19 (3.3.6 dropped: dubbo-dependencies-zookeeper not published for 3.3+)

Reverted (need code fixes, not just test extensions):
- PostgreSQL 42.x: execute() delegates to executeWithFlags() in 42.x, plugin
  intercepts both causing double spans. Needs plugin code fix.
- HttpClient 5.2+: async execution path changed, different span structure.
  Needs investigation of 5.2+ async behavior.

Also add "verify locally before pushing PR" rule to plugin development skill.

Author: wu-sheng

.claude/skills/new-plugin/SKILL.md

@@ -1094,6 +1094,24 @@ This is useful when different framework versions need different dependency versi
 
 **This step is mandatory.** Documentation updates are part of the PR requirements.
 
+## Step 11 - Verify Locally Before Pushing PR
+
+**ALWAYS run E2E tests locally before pushing a PR.** Do not rely on CI to catch issues — CI failures waste review cycles and block other PRs.
+
+For test-only version extensions:
+1. Pre-warm Maven dependencies for all new versions
+2. Run the test scenario locally with `bash ./test/plugin/run.sh --debug {scenario}`
+3. Verify all versions pass
+4. Only then commit, push, and create PR
+
+For new plugins or code changes:
+1. Build the plugin module: `./mvnw clean package -pl {module} -am -Dmaven.test.skip=true`
+2. Run unit tests: `./mvnw test -pl {module}`
+3. Run E2E tests locally
+4. Only then push
+
+This catches issues like wrong version numbers, assertion mismatches, missing classes, and dependency conflicts before they reach CI.
+
 ## Quick Reference - Plugin Type Decision Tree
 
 ```

CHANGES.md

@@ -17,10 +17,8 @@ Release Notes.
 * Extend GraphQL plugin to support graphql-java 18 -> 24 (20+ requires JDK 17).
 * Extend Spring Kafka plugin to support Spring Kafka 2.4 -> 2.9 and 3.0 -> 3.3.
 * Enhance test/plugin/run.sh to support extra Maven properties per version in support-version.list (format: version,key=value).
-* Extend PostgreSQL plugin to support PostgreSQL JDBC 42.2 -> 42.7.
 * Extend OkHttp plugin to support OkHttp 4.10 -> 4.12.
-* Extend Dubbo 3.x plugin to support Dubbo 3.1 -> 3.3.
-* Extend HttpClient 5.x plugin to support HttpClient 5.2 -> 5.4.
+* Extend Dubbo 3.x plugin to support Dubbo 3.1 -> 3.2.
 
 All issues and pull requests are [here](https://github.com/apache/skywalking/milestone/249?closed=1)
 

docs/en/setup/service-agent/java-agent/Supported-list.md

@@ -31,7 +31,7 @@ metrics based on the tracing data.
   * [Feign](https://github.com/OpenFeign/feign) 9.x -> 12.1
   * [Netflix Spring Cloud Feign](https://github.com/spring-cloud/spring-cloud-openfeign) 1.1.x -> 2.x
   * [Okhttp](https://github.com/square/okhttp) 2.x -> 3.x -> 4.12.x
-  * [Apache httpcomponent HttpClient](http://hc.apache.org/) 2.0 -> 3.1, 4.2, 4.3, 5.0 -> 5.4.x
+  * [Apache httpcomponent HttpClient](http://hc.apache.org/) 2.0 -> 3.1, 4.2, 4.3, 5.0, 5.1
   * [Spring RestTemplate](https://github.com/spring-projects/spring-framework) 4.x
   * [Spring RestTemplate](https://github.com/spring-projects/spring-framework) 6.x (Optional²)
   * [Jetty Client](http://www.eclipse.org/jetty/) 9.x -> 11.x
@@ -49,7 +49,7 @@ metrics based on the tracing data.
   * Oracle Driver (Optional¹), See [SkySPM Plugin Repository](https://github.com/SkyAPM/java-plugin-extensions)
   * H2 Driver 1.3.x -> 1.4.x
   * [ShardingSphere](https://github.com/apache/shardingsphere) 3.0.0, 4.0.0, 4.0.1, 4.1.0, 4.1.1, 5.0.0
-  * PostgreSQL Driver 8.x, 9.x, 42.x (42.2 -> 42.7)
+  * PostgreSQL Driver 8.x, 9.x, 42.x
   * Mariadb Driver 1.8, 2.x (2.0 -> 2.7)
   * [InfluxDB](https://github.com/influxdata/influxdb-java) 2.5 -> 2.17
   * [Mssql-Jtds](https://github.com/milesibastos/jTDS) 1.x
@@ -60,7 +60,7 @@ metrics based on the tracing data.
 * RPC Frameworks
   * [Dubbo](https://github.com/alibaba/dubbo) 2.5.4 -> 2.6.0
   * [Dubbox](https://github.com/dangdangdotcom/dubbox) 2.8.4
-  * [Apache Dubbo](https://github.com/apache/dubbo) 2.7.x -> 3.3.x
+  * [Apache Dubbo](https://github.com/apache/dubbo) 2.7.x -> 3.2.x
   * [Motan](https://github.com/weibocom/motan) 0.2.x -> 1.1.0
   * [gRPC](https://github.com/grpc/grpc-java) 1.x
   * [Apache ServiceComb Java Chassis](https://github.com/apache/servicecomb-java-chassis) 1.x, 2.x

test/plugin/scenarios/dubbo-3.x-scenario/support-version.list

@@ -14,7 +14,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# dubbo-dependencies-zookeeper module not published for 3.3+, needs pom change
 3.0.4
 3.1.11
 3.2.19
-3.3.6

test/plugin/scenarios/httpclient-5.x-scenario/support-version.list

@@ -14,8 +14,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# HttpClient 5.2+ changes async behavior, producing different spans.
+# Needs investigation of the async execution path changes.
 5.0
 5.1
-5.2.3
-5.3.1
-5.4.4

test/plugin/scenarios/postgresql-scenario/support-version.list

@@ -14,12 +14,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# PostgreSQL 42.x changes internal method dispatch: execute() delegates to
+# executeWithFlags(), producing different span names. Needs expectedData update
+# or investigation of which method to intercept for 42.x.
 9.2-1004-jdbc41
 9.3-1104-jdbc41
 9.4-1206-jdbc42
-42.2.29
-42.3.10
-42.4.5
-42.5.6
-42.6.2
-42.7.10