第九章：Codex Skill 安装及使用

本文主要记录一下 Codex Skill 的基础安装方法，并以几个常用 Skill 为例进行说明，包括：​

•

find-skills：用于查找和推荐合适的 Skill​

•

skill-creator：用于创建和优化自己的 Skill​

•

frontend-design：用于生成更高质量的前端页面和 UI​

•

humanizer：用于润色文字，减少明显的 AI 写作痕迹​

下面就从 Codex 和 Skill 的基本概念开始，一步一步演示安装和使用过程。​

​

​

一、Codex 简介​

二、Codex 基础设置​

​

大家按需选择工作模式，如果是研发人员建议选择编程模式。​

​

​

​

​

​

50%

​

​

​

​

50%

​

​

​

外观没什么好说的，里面有个宠物可以打开，这样的话可以直接在桌面看到任务状态。​

​

​

就像是这样​

​

​

​

​

​

42%

​

​

​

​

58%

​

​

​

沙盒设置最好是：Workspace write（写入模式），默认是：Read only（读取模式）​

​

​

自定义指令就是全局 AGENTS.md 文件，添加之后会优化工作和喜好​

Codex 会在做任何工作前读取文件。通过将全局指导与项目特定的覆盖叠加，无论你打开哪个仓库，都能以一致的期望开始每个任务。​

​

​

​

​

这是我根据卡帕西大佬修改的指令，当然大家也可以按照自己的喜好修改。​

​

​

代码块​

SQL

Tradeoff: These guidelines bias toward correctness, minimal changes, and verification over speed. For trivial tasks, use judgment.​

​

Think Before Coding​

​

Before implementing:​

​

State relevant assumptions explicitly.​

If multiple interpretations exist, briefly present them.​

If a simpler approach exists, prefer it and explain why.​

If ambiguity materially affects correctness, stop and ask.​

For minor ambiguity, state the assumption and proceed with the smallest reversible change.​

Surface important tradeoffs, but keep them concise.​

​

Simplicity First​

​

​

浏览器也要记得打开。​

运行项目并下载源码​

javascript​

运行​

1​

​

​

一般来说 Plus 会员就够了，当然如果很着急的话，可以升级套餐。​

运行项目并下载源码​

javascript​

运行​

1​

​

​

Codex Skill 是什么​

Codex Skill 可以理解成 Codex 的“技能包”。​

​

平时我们让 Codex 做事情，经常需要说很多背景，比如：​

​

帮我写一个前端页面，注意设计感，别太模板化，要有完整交互。​

运行项目并下载源码​

text​

1​

如果安装了 frontend-design 这种 Skill，以后 Codex 遇到前端页面、组件、UI 美化相关任务时，就会按照这个 Skill 里面的工作方式来处理。​

​

简单说：​

​

普通 Codex = 默认能力​

Codex + Skill = 默认能力 + 专项工作流​

运行项目并下载源码​

text​

1​

2​

Skill 一般由一个 SKILL.md 文件组成，里面会写清楚：​

​

什么时候使用这个 Skill​

使用时应该按什么步骤做​

输出格式是什么​

有哪些注意事项​

运行项目并下载源码​

text​

1​

2​

3​

4​

环境准备​

安装 Node.js​

因为 Skills CLI 通常通过 npx 使用，所以电脑上需要先有 Node.js。​

​

打开终端，输入：​

​

node -v​

npx -v​

运行项目并下载源码​

bash​

1​

2​

如果能看到版本号，说明环境正常。​

​

如果提示找不到命令，先去安装 Node.js LTS 版本，安装完成后重新打开终端。​

​

检查 Skills CLI ​

继续执行：​

​

npx skills --help​

运行项目并下载源码​

bash​

1​

能看到帮助信息就可以继续。​

​

常用命令如下：​

​

命令 作用​

npx skills find 关键词 搜索 Skill​

npx skills add 包名 -g -y 安装 Skill​

npx skills check 检查 Skill 更新​

npx skills update 更新已安装 Skill​

查找 Skill​

先搜索再安装，不要看到名字差不多就直接装。​

​

比如想找前端设计相关 Skill：​

​

npx skills find frontend​

运行项目并下载源码​

bash​

1​

想找写作润色相关 Skill：​

​

npx skills find writing​

运行项目并下载源码​

bash​

1​

想找创建 Skill 相关工具：​

​

npx skills find skill creator​

运行项目并下载源码​

bash​

1​

这里重点看几个信息：​

​

Skill 名称​

Skill 描述​

来源是否可信​

是否适合自己的任务​

运行项目并下载源码​

text​

1​

2​

3​

4​

如果已经安装了 find-skills，也可以直接在 Codex 里面问：​

​

帮我找一个适合做前端界面设计的 Skill，并告诉我安装命令。​

运行项目并下载源码​

text​

1​

find-skills 的作用就是帮我们发现合适的 Skill，并且提醒我们检查来源、安装量和适用场景。​

​

​

​

安装 Skill​

安装命令格式一般是：​

​

npx skills add <owner/repo@skill-name> -g -y​

运行项目并下载源码​

bash​

1​

注意：这里的 <owner/repo@skill-name> 是占位符，需要替换成你搜索到的真实 Skill 包名。​

​

例如搜索结果里面给出的安装命令可能类似：​

​

npx skills add xxx/xxx@frontend-design -g -y​

运行项目并下载源码​

bash​

1​

不要直接复制我这里的 xxx/xxx，以你自己终端搜索结果为准。​

当然如果是比较出名的也直接对话让 Codex 直接帮你安装。​

​

​

​

参数说明​

参数 说明​

add 添加并安装 Skill​

-g 全局安装，所有 Codex 会话都可以用​

-y 自动确认安装​

安装完成后，可以检查一下：​

​

npx skills check​

运行项目并下载源码​

bash​

1​

​

​

如果本地 Skill 目录中出现了对应文件夹，基本就说明安装成功了。​

​

常见目录类似：​

​

C:\Users\你的用户名\.agents\skills​

运行项目并下载源码​

text​

1​

或者：​

​

C:\Users\你的用户名\.codex\skills​

运行项目并下载源码​

text​

1​

具体位置和你使用的 Codex 环境有关。​

​

检查是否安装成功​

最简单的方法就是直接让 Codex 使用它。​

​

例如测试 frontend-design：​

​

使用 frontend-design 帮我做一个 SaaS 数据看板首页，要求信息密度高一些，不要做成宣传页。​

运行项目并下载源码​

text​

1​

测试 humanizer：​

​

使用 humanizer，把下面这段文章改得更自然一些，不要改变原意。​

运行项目并下载源码​

text​

1​

​

​

如果 Codex 回复时开始按照这个 Skill 的规则工作，就说明可以正常使用。​

​

常用 Skill 说明​

下面是这次推荐的 4 个 Skill。​

​

​

​

find-skills​

作用：​

​

发现、搜索、筛选和安装 Skill。​

运行项目并下载源码​

text​

1​

适合场景：​

​

不知道有没有现成 Skill​

想让 Codex 增加某个领域能力​

想找设计、测试、部署、写作等专项技能​

运行项目并下载源码​

text​

1​

2​

3​

使用示例：​

​

帮我找一个适合做 SEO 文章优化的 Skill。​

运行项目并下载源码​

text​

1​

它会帮你找候选 Skill，并说明适合什么场景、怎么安装。​

​

skill-creator​

作用：​

​

创建新的 Skill，修改已有 Skill，优化 Skill 触发效果。​

运行项目并下载源码​

text​

1​

适合场景：​

​

你有一套固定工作流​

经常重复让 Codex 做同一件事​

想把经验沉淀成一个可复用 Skill​

运行项目并下载源码​

text​

1​

2​

3​

使用示例：​

​

我想创建一个 Skill，用来把会议记录整理成行动项、负责人和截止时间。​

运行项目并下载源码​

text​

1​

Codex 会帮你梳理触发条件、输出格式、处理步骤，然后生成 SKILL.md。​

​

frontend-design​

作用：​

​

让 Codex 更擅长做前端界面、网页、组件和 UI 美化。​

运行项目并下载源码​

text​

1​

适合场景：​

​

写 HTML/CSS 页面​

做 React 组件​

做后台管理系统​

做数据看板​

做落地页​

优化页面视觉效果​

运行项目并下载源码​

text​

1​

2​

3​

4​

5​

6​

使用示例：​

​

使用 frontend-design 做一个后台管理系统首页，包含数据卡片、趋势图和任务列表。​

运行项目并下载源码​

text​

1​

这个 Skill 的重点不是只生成页面结构，而是会考虑设计感、布局、交互、响应式和视觉层次。​

​

humanizer​

作用：​

​

把 AI 味比较重的文字改得更自然。​

运行项目并下载源码​

text​

1​

适合场景：​

​

博客文章润色​

说明文档优化​

邮件改写​

产品介绍优化​

减少明显的 AI 套话​

运行项目并下载源码​

text​

1​

2​

3​

4​

5​

使用示例：​

​

使用 humanizer 润色这段话，让它更像真人写的，但是不要改变意思。​

运行项目并下载源码​

text​

1​

它会重点处理这些问题：​

​

句子太工整​

套话太多​

表达太空​

过度总结​

明显 AI 语气​

运行项目并下载源码​

text​

1​

2​

3​

4​

5​

创建自己的 Skill​

如果你经常让 Codex 做同一类事情，就可以考虑自己写一个 Skill。​

​

最小目录结构如下：​

​

my-skill/​

SKILL.md​

运行项目并下载源码​

text​

1​

2​

如果复杂一点，可以这样：​

​

my-skill/​

SKILL.md​

references/​

scripts/​

../assets/​

运行项目并下载源码​

text​

1​

2​

3​

4​

5​

其中 SKILL.md 是必须的。​

​

一个简单示例：​

​

​

​

名称：会议事项清单​

描述：当用户希望将会议记录转化为行动事项、负责人、截止日期和后续问题时，请使用此功能。​

​

​

会议事项清单​

当收到会议纪要时：​

提取具体的行动事项。​

如果有相关信息，需明确列出所有者、截止日期以及依赖关系。​

将未找到的业主或逾期未完成的任务标记为“待确认”。​

生成一个 Markdown 表格。​

如果存在重要信息缺失的情况，以 3 个后续问题作为结尾。​

运行项目并下载源码​

markdown​

​

1​

2​

3​

4​

5​

6​

7​

8​

9​

10​

11​

这个文件写好后，Codex 就知道遇到会议纪要整理任务时应该怎么处理。​

​

如果不会写，可以直接让 skill-creator 帮你生成：​

​

使用 skill-creator 帮我创建一个会议纪要整理 Skill。​

运行项目并下载源码​

text​

1​

常见问题​

提示找不到 npx​

一般是 Node.js 没安装，或者安装后终端没有重启。​

​

解决办法：​

​

安装 Node.js LTS​

关闭终端​

重新打开终端​

再次执行 node -v 和 npx -v​

运行项目并下载源码​

text​

1​

2​

3​

4​

安装后 Codex 没有自动触发 Skill​

可以在提示词里面明确写出来：​

​

使用 humanizer ...​

使用 frontend-design ...​

使用 skill-creator ...​

运行项目并下载源码​

text​

1​

2​

3​

如果还是不触发，检查 Skill 的 description 是否写得太弱。Skill 的触发主要依赖描述。​

​

能不能一次安装很多 Skill​

可以，但是不建议一上来装太多。​

​

建议先安装自己高频用到的 3 到 5 个。比如：​

​

find-skills​

skill-creator​

frontend-design​

humanizer​

运行项目并下载源码​

text​

1​

2​

3​

4​

后面需要什么再补。​

​

Skill 有没有安全风险​

有可能。​

​

安装前建议看一下来源和内容，尤其是带 scripts、联网、读写文件、执行命令的 Skill。​

​

不熟悉来源的 Skill，不建议直接全局安装。​

​

总结​

整体流程其实就这几步：​

​

准备 Node.js 和 npx​

用 npx skills find 搜索 Skill​

检查 Skill 来源和描述​

用 npx skills add 安装​

用真实任务测试是否生效​

常用流程可以用 skill-creator 做成自己的 Skill​

运行项目并下载源码​

text​

1​

2​

3​

4​

5​

6​

这几个 Skill 里面，我个人建议先从 find-skills 和 frontend-design 开始用。​

如果你经常写文章，再加一个 humanizer。​

如果你已经有自己的固定工作流，就可以继续用 skill-creator 做自己的 Skill。​

​