前言¶
微信小程序主要面向国内用户，一旦要服务境外访客，常见问题会集中出现：账号体系与登录方式不一致、表单校验与展示习惯不同、搜索与内容触达需要英文能力、界面需要多语言切换，以及机器翻译后文案变长导致的排版溢出。这些点分散在微信开放能力、前端 i18n 与 UI 细节里，单靠通用编程助手容易漏项或给出与小程序约束不符的做法。
下面介绍 SkillHub 上的「小程序国际化适配 Skill」，由腾讯开源发布，面向上述境外体验适配场景，把能力说明收敛进可被 Agent 读取的 SKILL 文档，便于在 Cursor、Claude Code 等环境中按需安装与调用。
这是什么¶
小程序国际化适配 Skill（坐标 @tencent-adm/miniprogram-foreign-user-adaptation，当前版本 1.0.1）定位为：微信小程序境外用户体验适配。来源标注为 enterprise，分类为 dev-programming；SkillHub 页面显示标签 requires_api_key=false，即不依赖额外 API Key 即可使用 Skill 本身。
维护方为 腾讯开源。它解决的是：开发者在小程序里做境外用户相关能力时，让 Agent 按统一、可检索的技能说明推进，而不是每次从零描述「要做登录、表单、搜索、多语言、排版」等需求。
核心功能¶
以下能力均来自 SkillHub 官方简介，未在页面单独展开实现细节时，不臆测具体 API 或代码结构。
- 境外用户账号登录适配：面向境外用户的登录与账号体验相关改造指引。
- 表单国际化：表单字段、校验与展示习惯的国际化处理方向。
- 英文搜索触达：与英文搜索、内容触达相关的适配说明。
- 多语言服务：多语言能力与服务的接入与使用思路。
- 翻译后排版溢出检测：翻译后文案变长时的布局与溢出检查关注点。
Skill 基于通用 SKILL.md 格式，供支持 Skills 的 Agent 在安装目录中加载。
安装与启用¶
方式一：通过 Agent 按官方安装文档执行¶
SkillHub 技能页提供的安装提示为：让 AI 根据 SkillHub 安装与优先源配置 安装坐标 @tencent-adm/miniprogram-foreign-user-adaptation。
方式二：使用 SkillHub CLI¶
先确认本机是否已安装 skillhub：
command -v skillhub && skillhub --version
未安装时，可按官方文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装技能时，必须用 --dir 指向当前 Agent 的 skills 目录；默认装到 ./skills/ 时，部分客户端不会自动识别。
skillhub install @tencent-adm/miniprogram-foreign-user-adaptation --dir <skills 目录>
常用客户端 skills 目录（摘自官方安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装后若客户端要求重启或重新加载 Skills，按各自产品说明操作。Codex CLI、Claude Code 与 Cursor 的差异主要体现在 skills 目录路径 上，安装命令本身一致，均为 skillhub install 加 --dir。
典型用法¶
公开页面未提供独立可复制的小程序代码示例。可复现的用法流程如下：
- 按上一节将
@tencent-adm/miniprogram-foreign-user-adaptation安装到当前 Agent 的 skills 目录。 - 在对话中明确境外场景需求，例如：「需要适配境外用户登录」「表单要做国际化」「要支持英文搜索触达」「接入多语言服务」「翻译后检查排版是否溢出」——与官方简介中的触发场景一致。
- 让 Agent 在已加载该 Skill 的前提下给出分步方案、配置项核对与实现建议，并在你现有小程序工程里落地修改。
若需检索或确认坐标，可在 CLI 中搜索：
skillhub search miniprogram-foreign-user-adaptation
适用场景与注意¶
适合谁：正在开发或改造微信小程序、且目标用户包含境外访客的团队；需要在登录、表单、搜索、多语言与翻译排版等环节系统化适配，并希望 Agent 按固定技能文档回答的开发者。
注意：
- Skill 提供的是 Agent 侧的知识与流程指引，具体仍须符合微信小程序平台规范与你方产品的合规要求。
- SkillHub 列表数据会变动；撰写时页面显示评分为 100000，下载约 1147 次（以 SkillHub 技能页 为准）。
- 未在官方页写明的能力、版本细节或配置字段，不应假设存在；深入实现以安装后的 SKILL.md 及微信官方文档为准。
结尾¶
小程序国际化适配 Skill 把境外用户登录、表单国际化、英文搜索、多语言服务与翻译排版检测等诉求写进可被 Agent 加载的技能包，适合在 SkillHub 安装后，用自然语言驱动分步适配。官方入口：SkillHub - 小程序国际化适配 Skill；API 索引地址：https://api.skillhub.cn/tencent-adm/miniprogram-foreign-user-adaptation。
