装完就失灵?AI 助手不认技能包的四个典型症状,排查顺序千万别搞反
装完就失灵?AI 助手不认技能包的四个典型症状,排查顺序千万别搞反
你有没有过这种经历:
花了三分钟,兴致勃勃装好一套官方技能包,转头让 AI 帮你加个页面跳转。结果它胸有成竹地写出一套你项目里根本不存在的旧写法,还自带一个你早就删掉的容器组件。
你盯着屏幕愣了三秒,第一反应是:这技能包是不是坏的?
先别急着重装。绝大多数“装完就失灵”,不是包坏了,而是它压根没被 AI 看见,或者看见了却没被叫醒。今天拿 Expo 官方那套技能包当样本,把四个典型症状和排查顺序一次讲透——这套思路,换成任何技能包都通用。
一、先搞明白:技能包到底是个啥?
打个比方。AI 是个聪明但刚入职的实习生,写代码的基本功没问题,可它没在你公司上过班。
技能包就是那本“老员工留下的工作手册”。它不教 AI 写代码,它只告诉 AI:我们这套框架有这些规矩,这个功能该这么接,那个坑别踩。
Expo 是干什么的?简单说,它是一套做手机 App 的工具链,用网页技术写一次,iPhone 和安卓都能跑。问题就在这儿——AI 的训练数据里,通用 React Native 的内容远多于 Expo 的内容。它一开口,就自动走回“最熟的那条路”。
于是官方出手,把团队积累的经验拆成二十多份小册子:16 份免费的开源框架技能,管导航、动画、原生界面、数据请求、老项目升级;7 份 EAS 云服务技能,管打包上架、热更新、云端模拟器;外加 1 份实验性技能。MIT 协议开源,版本已经迭代到 1.14.x。

这套东西最聪明的地方,是“克制”:每份主说明不超过 500 行,描述不超过 1024 个字符,超了自动检查直接拦下。
道理很简单——给小抄塞一整本书,实习生反而不看。
二、症状一:AI 从头到尾不提技能名
先查挂载位置,别查模型。
技能不是“装上就全局生效”的,它靠目录结构被发现:每个技能文件夹里必须有一份主说明文件,而且只认“下面一层”,多套一层文件夹就等于把书锁进了抽屉。
最常见的三种装错法:
第一种,装在了项目外面。 你在整个代码仓库的上一层执行安装,AI 打开项目根目录,视野里啥也没有。
第二种,装给了别人。 Claude Code 和 Codex 走各自的官方插件市场,Cursor、Copilot、Windsurf、Gemini、Cline 这些走命令行安装。你在 A 工具里装得热火朝天,人在 B 工具里干活——快递送到了隔壁。
第三种,装完没刷新。 技能是在会话开始或刷新时被扫描的。装完立刻提问,AI 脑子里还是上一轮的旧记忆。
有个一秒自查法:直接问它“你现在能看到哪些 Expo 技能?”
它要是一个都报不出来,先别聊业务,回去查位置。
三、症状二:路由补全失效,技能像“失联”了
查工程规则有没有生效。
这套包里有个特殊角色,叫 expo-overview。它不写一行代码,专门当“总调度员”:判断你到底想干嘛,再把活派给具体技能。它要是不在岗,后面二十多个技能基本就是摆设。
但这位调度员是有门槛的——只有当你的话里提到 Expo、EAS,或者项目里确实有 expo 依赖时,它才出面。
所以有一种“失灵”其实是设计如此:一个纯 React Native、根本没接 Expo 的项目,它按规矩就是不出声。这不是坏了,是它知道自己不该管。
第二个高频坑是问题问得太泛。“帮我加个页面”这种话,任何框架都能接;你得说清“用 Expo Router 加一个带参数跳转的详情页”。触发词到位,技能才会被拉出来干活。
第三个坑是规则打架。项目里如果同时挂了远程规则和本地规则文件,两套说法可能互相盖住。留一套就好,别双开。
顺带说个让人安心的事:官方自己的流水线在盯这张“技能地图”,新技能必须登记进调度员的名单,漏登记直接构建失败。所以路由表本身是可靠的,出问题多半在你这一侧的规则层。
四、症状三:一屏英文报错,先分清是“通道”还是“技能”
这是最容易走弯路的一条。
AI 答得不对,你以为是技能没生效;实际上模型请求压根没通。技能只是给 AI 看的说明书,它不负责发网络请求。通道一抖,什么技能都救不了。
三个高频报错,认脸就行:
401——钥匙不对或没生效,多半是密钥少复制一位、多了个空格,或者改完配置没重启。
local proxy failed——本地代理残留,地址栏里还躺着 localhost 或者系统里有个失效的代理变量。
reading 'choices' of undefined——请求地址拼错了。典型场景:你自己多写了一段路径,工具又自动补了一段,变成双份,返回的结构自然对不上。
还有一层更隐蔽的“通道错配”,特别值得说。
这套包为了照顾不同工具,同一份云端服务配置准备了两套写法:一处标 http,一处标 streamable-http。不是官方乱写,是不同客户端认的协议名不一样。
结果就是:你把给 A 用的配置整段复制给 B,界面上看着装好了,实际连不上,也不弹大红报错。表现只是——AI 查不到最新文档、调不动云端构建、截图截不出来。
典型的“看着装好了,其实没接上”。
所以排查顺序一定要分开走:先确认模型能正常回一句话,再确认技能清单里有它,最后才怀疑触发。 三步一起查,只会越查越乱。
五、症状四:时好时坏,偶尔冒出旧写法
查版本,两头的版本都要查。
技能包是活的。官方每次改内容,都会同时顶两个清单文件的版本号,两个不一致,流水线直接打回。这说明迭代很快,而你手里那份旧说明书,可能在教 AI 用已经变了的接口。
更新很简单:命令行装的,一条更新命令刷新全部;插件市场装的,走市场自己的更新入口。装完记得重启会话。
更隐蔽的一层在项目这边——SDK 版本。
这套技能有条共享铁律:先读项目里的 Expo 版本,再去看对应版本的文档。同样是写一个界面,不同 SDK 版本的写法可能完全不一样。
你项目停在旧版本,AI 却拿着最新文档写新版本的代码,一跑就崩。而这一条,恰恰是技能生效之后才会做的事。
所以有时候“报错”反而是它在认真干活,只是你和它的版本没对上。
顺便提一句,技能里还明确写了不少“规矩”,比如装依赖必须用 Expo 自己的安装方式,不要用普通的包管理器硬装,否则版本对不上。这类规矩没人告诉 AI,它就会按习惯来。
六、照着这张顺序表走,别跳步
- 位置对不对:装到当前项目能看见的地方了吗?
- 会话刷没刷:装完重启或刷新了吗?
- 工具对不对:装给的和你用的是同一个吗?
- 通道通不通:模型能正常回你一句话吗?
- 触发到不到位:问题里有没有明确的 Expo 关键词?
- 版本新不新:技能和项目 SDK 对得上吗?
一句话记住顺序:先确认“看得见”,再确认“叫得应”,最后才确认“答得对”。
七、普通人要不要凑这个热闹?
先说实话:这不是给普通用户下载的 App,而是给“已经在用 AI 写代码的人”配的一份外挂手册。
它不吃显卡,普通笔记本就够,门槛只有一个——你本来就在用 Cursor、Claude Code 这类工具做项目。
适合谁?做独立 App 的、接外包的、团队里要统一代码风格的,还有那些自己动手做原型的产品经理。
有个细节挺厚道:免费和付费的边界划得很清楚,16 个框架技能完全开源,7 个云服务技能会消耗付费额度,而每一份付费技能的开头,第一句话就把成本写明白,不玩“用着用着突然扣费”那套。
官方还留了一条反馈通道:AI 用错了、信息过时了,可以直接把问题报回去。相当于你踩过的坑,能变成下一版手册里的一行字。
结语
AI 编程这两年最大的变化,其实不是模型变多聪明,而是我们开始学会“给 AI 配资料”。
模型是通才,技能包是专科教材。装上了不等于生效,生效了不等于用对。搞清这条链路,比反复重装有用得多。
最后问一句:你装技能包时踩过最离谱的坑是啥?装错目录、忘了重启,还是查了半天发现是密钥少复制了一位?评论区聊聊,说不定你的一句话,就能救下一个正在抓头发的人。