codex skill安装后不显示怎么办

风枫姑娘_4829

风枫姑娘_4829

2026-07-28

610人浏览

原创

Codex自创Skill在UI不显示是因注册失败,主因包括SKILL.md含UTF-8 BOM、frontmatter含未引号包裹的冒号、agents/openai.yaml缺失display_name或short_description字段,或缓存未刷新。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

codex skill安装后不显示怎么办

Codex Skill安装后在UI技能列表里完全找不到,明明文件已放进.codex/skills目录、也重启了程序,但“可用技能”里还是空的——这种情况不是安装失败,而是注册环节被 silently 跳过。

先确认 Skill 文件是否真的被 Codex 读到

打开终端或命令提示符,执行:codex list-skills。如果返回空列表或只显示系统内置 Skill,说明 Codex 根本没加载你放进去的文件。

进入你的用户目录,检查路径是否正确:
Windows:查看 C:\Users\用户名\.codex\skills\
macOS/Linux:查看 ~/.codex/skills/。
【必须确保 SKILL.md 在每个子文件夹最顶层,不能嵌套在 src/ 或 docs/ 里】

用文本编辑器(如 VS Code)右键打开 SKILL.md → “文件编码” → 确认是 UTF-8 without BOM。带 BOM 的文件会导致 frontmatter 解析失败,Codex 直接跳过整个 Skill。

检查 frontmatter 是否合法且位置正确

用任意编辑器打开 SKILL.md,把光标放在第一行最开头,按方向键 ← 缓慢移动。如果能向左越过第一个字符,说明开头有不可见字符(BOM 或空格),删掉它。

frontmatter 必须严格从第一行开始,格式为:

```yaml
---
name: gh-fix-ci
description: Fix GitHub CI configuration files
---
```

Marvis Codex Bridge
Marvis Codex Bridge

将来自 Marvis 或微信的可信远程软件开发请求中继至用户本地的 Codex CLI,等待编码任务完成,并返回经验证的结果。当用户通过 Codex 要求 Marvis 检查、实现、修复、测试、review 或继续在明确指定的本地项目目录中开展工作时,使用此功能。

下载

注意:description 字段若含冒号(如 Triggers: /fix-ci),必须用双引号包裹整段值,否则 YAML 解析器会误判为键值对而崩溃。

验证 agents/openai.yaml 是否缺失关键字段

打开 ~/.agents/openai.yaml(Windows 是 C:\Users\用户名\.agents\openai.yaml),检查是否存在以下两个必填字段:

```yaml
display_name: GitHub CI Fixer
short_description: Auto-corrects .github/workflows/*.yml syntax and best practices
```

这两个字段哪怕缺一个,Skill 就不会出现在 UI 列表中。如果文件不存在,手动创建;如果存在但格式错乱(比如缩进不统一、用了 Tab 混合空格),重写一份纯空格缩进的版本。

强制刷新 Skill 注册缓存

第一步:关闭所有 Codex 进程(包括后台服务)。
第二步:删除 ~/.codex/cache/skills/ 整个文件夹(Windows 同路径)。
第三步:重新启动 Codex Desktop 或运行 codex serve。
第四步:立即在聊天框输入:请问我现在有哪些 skills 可以使用? 观察返回结果。

这一步绕过了内存缓存,强制 Codex 重新扫描磁盘并解析每个 SKILL.md。如果此前因 BOM 或 YAML 错误导致缓存固化,此操作可彻底清零。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Codex AI 编程代理与智能开发工作流
Codex AI 编程代理与智能开发工作流

Codex 是一款超越传统代码生成的 AI 编程代理,致力于构建全生命周期的智能开发工作流。通过持久线程保留上下文,支持多智能体并行协作与后台自动化运维。借助沙箱权限控制、Plan/Steer 任务管理机制,Codex 既能自主拆解并执行复杂工程任务,又能让开发者牢牢掌控项目进程。从需求分析、编码测试到代码审查与部署,Codex 将 AI 深度融入研发全链路,极大提升了软件工程的交付效率与质量标准。

2026.05.26

734

10

Codex API集成与AI编程生态开发
Codex API集成与AI编程生态开发

Codex API 集成是构建下一代 AI 编程生态的核心基石,能通过 API 将强大的代码生成与推理能力无缝接入 VS Code、JetBrains 等主流 IDE 插件,还能将其深度嵌入 CI/CD 流水线,实现自动化的代码审查、单元测试生成与 Bug 修复。结合 Amazon Bedrock 等云平台的托管服务,企业可以灵活打造符合内部安全规范的专属 AI 编程助手。

2026.05.26

264

10

Codex 模型原理与AI软件工程进阶
Codex 模型原理与AI软件工程进阶

Codex 是基于通用大模型底座,通过海量代码语料与真实 Pull Request 进行专项微调的代码专用模型,能深度理解代码语法树与跨文件依赖,实现从自然语言到高质量工程代码的精准转化。在 AI 软件工程进阶中,Codex 推动了从提示词工程向“驾驭工程(Harness Engineering)”的范式跃迁。

2026.05.26

197

10

Codex AI编程工具新手指南
Codex AI编程工具新手指南

全面解析Codex AI编程工具的核心原理、功能特点与实际用途,提供适合新手的Codex入门教程、环境配置方法、代码生成演示与常见问题解答,帮助开发者快速掌握AI自动写代码能力,提升编程学习与开发效率。

2026.05.27

430

10

Codex Agent编程与自主开发能力调优专题
Codex Agent编程与自主开发能力调优专题

PHP中文网为您提供Codex Agent编程与自主开发能力调优专题。针对AI Agent全权委托开发模式,我们为您系统梳理了Harness Engineering(驾驭工程)核心理念,以及涵盖AGENTS.md规范编写、Skills技能配置、Worktree沙盒隔离与多Agent协作架构的实战指南。

2026.06.10

248

7

MiMo Code AI 编程助手入门与智能开发实战专题
MiMo Code AI 编程助手入门与智能开发实战专题

PHP中文网为您提供MiMo Code AI编程助手入门与智能开发实战专题。作为小米MiMo团队推出的新一代终端原生AI编码代理,我们为您整理了通过官方脚本一键部署(支持Mac/Linux/Windows)及零配置接入MiMo-V2.5免费大模型的核心指南。同时,详细梳理了MiMo Code的三大核心工作模式(Build构建、Plan只读分析、Compose全流程编排)与独创的持久化记忆系统,深度解析其动态上下文压缩与双Agent协同架

2026.06.25

216

7

MiMo Code Agent开发与AI编程工作流专题
MiMo Code Agent开发与AI编程工作流专题

PHP中文网为您提供MiMo Code Agent开发与AI编程工作流专题。作为小米MiMo团队基于OpenCode二次开发并采用MIT协议开源的终端AI编程助手,我们为您深度拆解了MiMo Code的核心架构与实战工作流。专题详细梳理了其独创的“项目记忆、会话检查点、任务进度”三重持久化记忆系统,以及通过独立子Agent自动保存状态与动态上下文压缩技术,彻底解决长程任务“失忆”痛点。

2026.06.25

137

7

MiMo Code 模型能力优化与高级开发应用专题
MiMo Code 模型能力优化与高级开发应用专题

PHP中文网为您提供MiMo Code模型能力优化与高级开发应用专题。作为小米MiMo团队重磅推出的终端原生AI编程助手,我们为您深度拆解了其在底层计算与模型协同上的硬核优化。专题详细梳理了Max Mode(并行采样选优)机制,通过独立裁判模型在SWE-Bench Pro上提升10-20%的复杂任务完成率,以及基于SGLang HiCache技术的KVCache成本优化,实现百万级Token上下文的高效处理。

2026.06.25

129

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Codex 应用程序简介
Codex 应用程序简介

共0课时 | 192人学习

Codex官方文档
Codex官方文档

共0课时 | 0人学习