安装skill后必须重启codex客户端才能加载激活,否则指令无效;重启后输入“你现在可以使用hatch-pet吗?”验证,成功则回复“已就绪”,失败需检查路径、skill.md及文件夹名;调用时须在项目上下文中,支持自然语言、$前缀显式调用或mcp路由;验证需执行典型任务并观察输出与状态栏提示。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在 Codex 中安装 Skill 后,必须完成加载和激活才能调用其功能,否则输入指令会被忽略或返回“未识别该技能”;很多用户卡在这一步,以为装完就能用,其实还差关键一环。
确认 Skill 已成功加载
重启 Codex 客户端。这是【强制步骤】,不重启则新 Skill 不会被扫描注册,所有后续操作都无效。
重启后,在对话区直接输入:你现在可以使用 hatch-pet 吗?(将 hatch-pet 替换为你实际安装的 Skill 名)
若 Codex 明确回复“可以,hatch-pet 已就绪”或列出其能力说明,说明加载成功;若回复“未找到该技能”或沉默,则需检查安装路径是否正确、SKILL.md 是否存在、文件夹名是否与调用名一致。
在项目中调用 Skill
点击左侧“项目(Projects)”→新建或打开一个已有项目文件夹→进入该项目下的任意对话线程。
确保当前对话处于项目上下文中,而非纯聊天(Chats)模式,因为 Skill 的部分功能(如读取本地文件、执行脚本)依赖项目工作区权限。
直接输入自然语言指令,例如:“用 tiktok-shop-operator 查美国区近7天销量增长最快的日用品,价格30–50美元,评分4.5以上”,Codex 会自动匹配并调用对应 Skill。
手动触发 Skill 的两种方式
方法一:使用 $ 前缀显式调用
在对话中输入:$tiktok-shop-operator 国家=美国 类目=日用品 价格=30-50 评分=4.5+。这种方式绕过意图识别,强制指定 Skill,适合调试或避免歧义。
方法二:通过 MCP 服务器间接调用
先运行 /mcp 查看已注册的 MCP 列表,确认世舶或达人精灵等 MCP 服务已在线;再输入“查招投标数据”,Codex 将自动路由至对应 MCP 并返回结构化结果。
注意:MCP 调用依赖 Skill 内部是否声明了 mcp_server 字段,未声明则无法走此路径。
验证 Skill 是否真正生效
第一步:输入该 Skill 典型任务的最小可行指令,例如对 hatch-pet 输入“生成一只蓝色小猫桌宠”。
第二步:观察输出——若返回图像 URL 或本地渲染预览,说明 Skill 执行链完整;若只返回文字描述或报错,检查 scripts/ 下的可执行文件是否存在、是否有运行权限。
第三步:查看 Codex 底部状态栏是否出现“正在运行 hatch-pet…”提示,这是 Skill 实际被调起的视觉信号。










