详情

首页手游攻略 Codex 如何安装 Claude Skills?openskills 使用方法详解

Codex 如何安装 Claude Skills?openskills 使用方法详解

佚名 2026-07-22 16:30:02

很多人搜「Codex 怎么安装 Claude Skills」,其实装没装好不能只看命令有没有跑完,得同时满足三个结果才算数:技能文件已写入、AGENTS.md 里有对应索引、read 命令能正常返回指令。

先给 Codex 准备个能验收的项目

项目根目录得先装好 Node.js 20.6 以上版本和 Git。官方来源是 numman-ali/openskills;源码可用 git clone https://github.com/numman-ali/openskills.git 核对。OpenSkills 不需要 API Key,私有仓库得另外配 Git 凭据。

npx openskills install anthropics/skills --universal
npx openskills sync

--universal 参数会把技能写到 ./.agent/skills 目录,sync 命令用来创建或者更新 AGENTS.md。如果只是单个项目用,没必要装到全局。

命令跑完后,哪三个产物最关键?

技能实体:先看 SKILL.md

目标目录下应该会出现 .agent/skills/<name>/SKILL.md。文件头部的 namedescription 字段说明技能身份和触发场景,正文和配套资源里存着具体执行内容。

任务入口:再看 AGENTS.md

AGENTS.md 里得有 <available_skills> 清单和目标技能名称。它只存索引,技能正文会按需读取。

怎样让 Codex 真正读到 Claude Skill?

npx openskills list
npx openskills read <skill-name>

list 命令得能列出技能名称、简介,还有是装在项目级还是全局;read 的有效输出要同时包含 ReadingBase directory、具体指令和 Skill read。你可以再建个符合技能描述的小任务验收;要是旧任务没重读规则,直接开新任务就行。

调用失败时,别急着重复安装

  1. 找不到技能:先核对当前工作目录、输入的技能名和实际目录名对不对得上。
  2. list 能查到但触发不了:重跑 sync,核对索引并刷新任务。
  3. read 输出正常但执行报错:补齐依赖;密钥放到环境变量或者宿主配置里。
  4. 私有源拉取失败:检查 Git 登录状态或者仓库权限有没有问题。

FAQ:update 和 sync 要不要每次都跑?

update 用来刷新技能文件,sync 用来刷新索引。如果是缺少来源元数据的旧安装,得重装一次才能更新。

Codex 端完成清单

  • ./.agent/skills 下存在目标 SKILL.md 文件。
  • AGENTS.md 收录了正确的技能名称。
  • list 能明确标明安装位置。
  • read 能正常返回指令和资源目录。
  • 新任务能触发技能,依赖与密钥已单独配置好。

这套方案适合在 Codex 项目里复用技能;如果是一次性提示词,就没必要多装这一层了。

相关资讯
点击查看更多
游戏推荐
推荐专题
热门阅读
推荐下载