新增 WxJava 用户技能指南#4071
Merged
Merged
Conversation
binarywang
marked this pull request as ready for review
July 20, 2026 02:20
Owner
Author
|
auggie review |
🤖 Augment PR SummarySummary: 本 PR 为 WxJava 仓库补充面向用户/贡献者的 AI 编程智能体 SKILL 指南集合，便于按场景获取模块选择、接入与维护建议。 Changes:
Technical Notes: 这些变更均为文档与元数据新增，不涉及 SDK 代码与依赖调整；引用了仓库内既有 🤖 Was this summary useful? React with 👍 or 👎 |
![augmentcode[bot]](https://avatars.githubusercontent.com/in/1027498?s=60&v=4){kind=small}
Owner
Author
|
@codex review |
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 25e96b7cc0
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
There was a problem hiding this comment.
Pull request overview
Note
Copilot couldn't run its full agentic review because it didn't start before the timeout. Make sure your repository has a runner available, or add a copilot-code-review.yml file specifying one with the runs-on attribute. See the docs for more details.
该 PR 新增面向 WxJava 用户的 5 个 AI SKILL（模块选择、接入指南、故障排查、接口贡献、升级迁移），并为每个 SKILL 补齐入口文档、UI 元数据与参考资料，方便按场景获取指引。
Changes:
- 新增 5 个 SKILL 的
SKILL.md入口文件与agents/openai.yaml界面元数据 - 为各 SKILL 增加按需加载的参考文档（模块映射 / 接入约束 / 诊断清单 / 贡献约定 / 迁移检查表）
- 更新根目录 README，加入 SKILL 安装与使用说明入口
Reviewed changes
Copilot reviewed 16 out of 16 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| skills/wxjava-upgrade-guide/references/migration.md | 提供升级迁移检查表与分支指引参考 |
| skills/wxjava-upgrade-guide/agents/openai.yaml | 定义“升级迁移”SKILL 的界面元数据与默认提示词 |
| skills/wxjava-upgrade-guide/SKILL.md | 定义“升级迁移”SKILL 的入口与执行步骤 |
| skills/wxjava-troubleshooter/references/diagnostics.md | 提供故障排查诊断清单与高频场景表格 |
| skills/wxjava-troubleshooter/agents/openai.yaml | 定义“故障排查”SKILL 的界面元数据与默认提示词 |
| skills/wxjava-troubleshooter/SKILL.md | 定义“故障排查”SKILL 的入口与执行步骤 |
| skills/wxjava-module-selector/references/modules.md | 提供业务场景到模块的映射与选择检查点 |
| skills/wxjava-module-selector/agents/openai.yaml | 定义“模块选择”SKILL 的界面元数据与默认提示词 |
| skills/wxjava-module-selector/SKILL.md | 定义“模块选择”SKILL 的入口与执行步骤 |
| skills/wxjava-integration-guide/references/integration.md | 提供接入约束与实施检查表参考 |
| skills/wxjava-integration-guide/agents/openai.yaml | 定义“接入指南”SKILL 的界面元数据与默认提示词 |
| skills/wxjava-integration-guide/SKILL.md | 定义“接入指南”SKILL 的入口与执行步骤 |
| skills/wxjava-api-contributor/references/contribution.md | 提供接口贡献约定与增量检查表参考 |
| skills/wxjava-api-contributor/agents/openai.yaml | 定义“接口贡献”SKILL 的界面元数据与默认提示词 |
| skills/wxjava-api-contributor/SKILL.md | 定义“接口贡献”SKILL 的入口与执行步骤 |
| README.md | 增加 SKILL 安装/复制指引与可用 SKILL 列表 |
Comment on lines
+13
to
+20
| | 症状 | 优先检查 | 依据 | | ||
| | --- | --- | --- | | ||
| | 多节点间歇性 token 失效 | 是否共享 token/config storage，是否让各节点并发刷新 | Wiki 的 MP/CP 配置存储说明与集群案例 | | ||
| | `NoClassDefFoundError`、`NoSuchMethodError` | `mvn dependency:tree`、HttpClient/commons-lang/xstream 冲突及 BOM 是否统一版本 | Wiki 的异常排查页与 HTTP 客户端升级指南 | | ||
| | 回调验签或重复处理 | 原始请求体、时间戳/nonce/签名、回调 URL、业务幂等键 | MP 合法性校验与支付回调说明 | | ||
| | HTTP 连接、超时或代理问题 | 连接/读取超时、代理、TLS、正反向代理是否混用 | Wiki 的 HttpClient 参数与代理文档 | | ||
| | 企业微信会话存档崩溃 | 是否仍手动销毁旧 SDK 实例，是否已迁移安全 API | [会话存档安全使用指南](../../../docs/CP_MSG_AUDIT_SDK_SAFE_USAGE.md) | | ||
| | 视频号/小店接口 404 或字段不匹配 | 当前官方路径与请求字段、目标 SDK 版本、历史 Issue 是否已修复 | 关闭的 bug Issue，如 [#3982](https://github.com/binarywang/WxJava/issues/3982) | |
Comment on lines
+3
to
+12
| | 场景 | 核心模块 | | ||
| | --- | --- | | ||
| | 微信公众号 | `weixin-java-mp` | | ||
| | 微信小程序 | `weixin-java-miniapp` | | ||
| | 微信支付 | `weixin-java-pay` | | ||
| | 企业微信 | `weixin-java-cp` | | ||
| | 微信开放平台／第三方平台 | `weixin-java-open` | | ||
| | 视频号／微信小店 | `weixin-java-channel` | | ||
|
|
||
| 多个模块并用时优先使用 `com.github.binarywang:wx-java-bom`。Spring Boot 集成从 `spring-boot-starters` 选择；Solon 集成从 `solon-plugins` 选择。只有多个独立微信应用配置时才选择名称含 `multi` 的 Starter 或插件。 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
变更内容
用户影响
用户可按微信业务场景获得更准确的模块选择、接入和维护指引。
验证
quick_validate.py校验五个 SKILL 均通过git diff --check通过