Codex Skill 安装基础以及常用 Skill 使用Codex Skill 安装基础以及常用 Skill 使用前言Codex 简介Codex 基础设置Codex Skill 是什么环境准备1. 安装 Node.js2. 检查 Skills CLI查找 Skill安装 Skill参数说明检查是否安装成功常用 Skill 说明1. find-skills2. skill-creator3. frontend-design4. humanizer创建自己的 Skill常见问题1. 提示找不到 npx2. 安装后 Codex 没有自动触发 Skill3. 能不能一次安装很多 Skill4. Skill 有没有安全风险总结Codex Skill 安装基础以及常用 Skill 使用前言最近在使用 Codex 的过程中发现它不只是一个“帮你写代码的 AI 工具”更像是一个可以不断扩展能力的开发助手。默认情况下Codex 已经可以完成代码编写、问题排查、文档整理、项目分析等工作。但是如果我们经常让它处理某一类固定任务比如前端页面设计、文章润色、查找工具、创建标准化工作流每次都重新描述要求就会比较麻烦。这时候就可以使用 Codex Skill。Codex Skill 可以理解成 Codex 的“技能包”或者“工作流插件”。安装对应 Skill 后Codex 在遇到特定任务时会自动参考 Skill 中定义的规则、步骤和注意事项来处理问题。这样不仅能减少重复提示词也能让输出结果更加稳定。本文主要记录一下 Codex Skill 的基础安装方法并以几个常用 Skill 为例进行说明包括find-skills用于查找和推荐合适的 Skillskill-creator用于创建和优化自己的 Skillfrontend-design用于生成更高质量的前端页面和 UIhumanizer用于润色文字减少明显的 AI 写作痕迹下面就从 Codex 和 Skill 的基本概念开始一步一步演示安装和使用过程。Codex 简介Codex 是 OpenAI 面向开发场景推出的 AI 编程助手可以帮助开发者完成代码编写、项目理解、Bug 修复、命令执行、文件修改、文档生成等任务。和普通聊天式 AI 不同Codex 更偏向真实开发环境中的协作。它可以读取项目文件、理解代码结构、根据需求修改代码并在需要时运行终端命令进行验证。简单理解Codex 可以做这些事情1. 阅读和分析项目代码 2. 根据需求新增或修改功能 3. 修复报错和 Bug 4. 编写 README、教程、接口文档 5. 生成前端页面和组件 6. 执行测试、检查运行结果 7. 根据固定流程完成重复性任务Codex 基础设置大家按需选择工作模式如果是研发人员建议选择编程模式。外观没什么好说的里面有个宠物可以打开这样的话可以直接在桌面看到任务状态。就象是这样沙盒设置最好是Workspace write写入模式默认是Read only读取模式 写入模式可以节省一些审批。自定义指令就是全局AGENTS.md 文件添加之后会优化工作和喜好 Codex 会在做任何工作前读取文件。通过将全局指导与项目特定的覆盖叠加无论你打开哪个仓库都能以一致的期望开始每个任务。这是我根据卡帕西大佬修改的指令当然大家也可以按照自己的喜好修改。Tradeoff:These guidelines bias toward correctness,minimal changes,and verification over speed.For trivial tasks,use judgment.1.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 proceedwiththe smallest reversible change.-Surface important tradeoffs,but keep them concise.2.Simplicity First Write the minimum code that solves the requested problem.-Do not add features beyond what was asked.-Do not introduce abstractionsforsingle-use code.-Do not add flexibility,configuration,or extension points unless required.-Do not add broad defensive error handling unless the failure mode is realistic or already observed.-If the solution becomes large,reassess and simplify before continuing.Ask:“Would a senior engineer considerthisovercomplicated?” If yes,simplify.3.Surgical Changes Touch only what is necessary.When editing existing code:-Do not improve adjacent code,comments,formatting,or architecture unless required.-Do not refactor unrelated code.-Match the existing project style,evenifanother style would be preferable.-If unrelated dead code or issues are noticed,mention them separately insteadofchanging them.-Remove imports,variables,functions,or comments that become unused becauseofyour own changes.-Do not remove pre-existing dead code unless explicitly asked.Every changed line should trace directly to the user’s request.4.Goal-Driven Execution Turn the task into verifiable success criteria before coding.Examples:-“Fix the bug” → reproduce the issue,apply the smallest fix,verify it no longer happens.-“Add validation” → verify invalid inputs are rejected and valid inputs still work.-“RefactorX” → verify behavior is unchanged before and after.-“Improve performance” → define the measured metric and compare before/after when possible.For multi-step tasks,use a brief plan:1.Inspect relevant files → verify:identify exact change points.2.Make the smallest necessary change → verify:compile or run focused checks.3.Validate behavior → verify:tests,lint,build,focused command,or documented manual check.When tests exist,prefer a failing test before the fix.If no test framework exists,use the smallest available verification:compile,lint,run a focused command,or describe the manual verification.5.Safety Boundaries Do not run destructive or high-risk actions unless explicitly requested.Avoid:-deleting files or directories;-resetting git history;-force pushing;-modifying secrets orAPIkeys;-changing production configuration;-installing global packages;-broad dependency upgrades;-formatting the whole repository;-large rewrites unrelated to the task.If a risky action seems necessary,explain why and ask first.6.Response Style-Leadwiththe answer,conclusion,or next action.-Use numbered stepsformulti-step operations;make each step a clear,bounded action.-Keep replies concise.Avoid unnecessary preambles,pleasantries,repetition,and tangents.-When work is complete,state the result and how it was verified;mention material limitations when relevant.-When detailed explanation is requested or neededforcorrectness,include the necessary reasoning and context.Do not omit important detailsforbrevity.浏览器也要记得打开。一般来说 Plus 会员就够了当然如果很着急的话可以升级套餐。Codex Skill 是什么Codex Skill 可以理解成 Codex 的“技能包”。平时我们让 Codex 做事情经常需要说很多背景比如帮我写一个前端页面注意设计感别太模板化要有完整交互。如果安装了frontend-design这种 Skill以后 Codex 遇到前端页面、组件、UI 美化相关任务时就会按照这个 Skill 里面的工作方式来处理。简单说普通 Codex 默认能力 Codex Skill 默认能力 专项工作流Skill 一般由一个SKILL.md文件组成里面会写清楚什么时候使用这个 Skill 使用时应该按什么步骤做 输出格式是什么 有哪些注意事项环境准备1. 安装 Node.js因为 Skills CLI 通常通过npx使用所以电脑上需要先有 Node.js。打开终端输入node-vnpx-v如果能看到版本号说明环境正常。如果提示找不到命令先去安装 Node.js LTS 版本安装完成后重新打开终端。2. 检查 Skills CLI继续执行npx skills--help能看到帮助信息就可以继续。常用命令如下命令作用npx skills find 关键词搜索 Skillnpx skills add 包名 -g -y安装 Skillnpx skills check检查 Skill 更新npx skills update更新已安装 Skill查找 Skill先搜索再安装不要看到名字差不多就直接装。比如想找前端设计相关 Skillnpx skillsfindfrontend想找写作润色相关 Skillnpx skillsfindwriting想找创建 Skill 相关工具npx skillsfindskill creator这里重点看几个信息1. Skill 名称 2. Skill 描述 3. 来源是否可信 4. 是否适合自己的任务如果已经安装了find-skills也可以直接在 Codex 里面问帮我找一个适合做前端界面设计的 Skill并告诉我安装命令。find-skills的作用就是帮我们发现合适的 Skill并且提醒我们检查来源、安装量和适用场景。安装 Skill安装命令格式一般是npx skillsaddowner/reposkill-name-g-y注意这里的owner/reposkill-name是占位符需要替换成你搜索到的真实 Skill 包名。例如搜索结果里面给出的安装命令可能类似npx skillsaddxxx/xxxfrontend-design-g-y不要直接复制我这里的xxx/xxx以你自己终端搜索结果为准。当然如果是比较出名的也直接对话让 Codex 直接帮你安装。参数说明参数说明add添加并安装 Skill-g全局安装所有 Codex 会话都可以用-y自动确认安装安装完成后可以检查一下npx skills check如果本地 Skill 目录中出现了对应文件夹基本就说明安装成功了。常见目录类似C:\Users\你的用户名\.agents\skills或者C:\Users\你的用户名\.codex\skills具体位置和你使用的 Codex 环境有关。检查是否安装成功最简单的方法就是直接让 Codex 使用它。例如测试frontend-design使用 frontend-design 帮我做一个 SaaS 数据看板首页要求信息密度高一些不要做成宣传页。测试humanizer使用 humanizer把下面这段文章改得更自然一些不要改变原意。如果 Codex 回复时开始按照这个 Skill 的规则工作就说明可以正常使用。常用 Skill 说明下面是这次推荐的 4 个 Skill。1. find-skills作用发现、搜索、筛选和安装 Skill。适合场景不知道有没有现成 Skill 想让 Codex 增加某个领域能力 想找设计、测试、部署、写作等专项技能使用示例帮我找一个适合做 SEO 文章优化的 Skill。它会帮你找候选 Skill并说明适合什么场景、怎么安装。2. skill-creator作用创建新的 Skill修改已有 Skill优化 Skill 触发效果。适合场景你有一套固定工作流 经常重复让 Codex 做同一件事 想把经验沉淀成一个可复用 Skill使用示例我想创建一个 Skill用来把会议记录整理成行动项、负责人和截止时间。Codex 会帮你梳理触发条件、输出格式、处理步骤然后生成SKILL.md。3. frontend-design作用让 Codex 更擅长做前端界面、网页、组件和 UI 美化。适合场景写 HTML/CSS 页面 做 React 组件 做后台管理系统 做数据看板 做落地页 优化页面视觉效果使用示例使用 frontend-design 做一个后台管理系统首页包含数据卡片、趋势图和任务列表。这个 Skill 的重点不是只生成页面结构而是会考虑设计感、布局、交互、响应式和视觉层次。4. humanizer作用把 AI 味比较重的文字改得更自然。适合场景博客文章润色 说明文档优化 邮件改写 产品介绍优化 减少明显的 AI 套话使用示例使用 humanizer 润色这段话让它更像真人写的但是不要改变意思。它会重点处理这些问题句子太工整 套话太多 表达太空 过度总结 明显 AI 语气创建自己的 Skill如果你经常让 Codex 做同一类事情就可以考虑自己写一个 Skill。最小目录结构如下my-skill/ SKILL.md如果复杂一点可以这样my-skill/ SKILL.md references/ scripts/ assets/其中SKILL.md是必须的。一个简单示例--- 名称会议事项清单 描述当用户希望将会议记录转化为行动事项、负责人、截止日期和后续问题时请使用此功能。 --- # 会议事项清单 当收到会议纪要时 1. 提取具体的行动事项。 2. 如果有相关信息需明确列出所有者、截止日期以及依赖关系。 3. 将未找到的业主或逾期未完成的任务标记为“待确认”。 4. 生成一个 Markdown 表格。 5. 如果存在重要信息缺失的情况以 3 个后续问题作为结尾。这个文件写好后Codex 就知道遇到会议纪要整理任务时应该怎么处理。如果不会写可以直接让skill-creator帮你生成使用 skill-creator 帮我创建一个会议纪要整理 Skill。常见问题1. 提示找不到 npx一般是 Node.js 没安装或者安装后终端没有重启。解决办法安装 Node.js LTS 关闭终端 重新打开终端 再次执行 node -v 和 npx -v2. 安装后 Codex 没有自动触发 Skill可以在提示词里面明确写出来使用 humanizer ... 使用 frontend-design ... 使用 skill-creator ...如果还是不触发检查 Skill 的description是否写得太弱。Skill 的触发主要依赖描述。3. 能不能一次安装很多 Skill可以但是不建议一上来装太多。建议先安装自己高频用到的 3 到 5 个。比如find-skills skill-creator frontend-design humanizer后面需要什么再补。4. Skill 有没有安全风险有可能。安装前建议看一下来源和内容尤其是带scripts、联网、读写文件、执行命令的 Skill。不熟悉来源的 Skill不建议直接全局安装。总结整体流程其实就这几步1. 准备 Node.js 和 npx 2. 用 npx skills find 搜索 Skill 3. 检查 Skill 来源和描述 4. 用 npx skills add 安装 5. 用真实任务测试是否生效 6. 常用流程可以用 skill-creator 做成自己的 Skill这几个 Skill 里面我个人建议先从find-skills和frontend-design开始用。如果你经常写文章再加一个humanizer。如果你已经有自己的固定工作流就可以继续用skill-creator做自己的 Skill。暂时先这样吧如果实在看不明白就留言看到我会回复的。希望这个教程对您有帮助路漫漫其修远与君共勉。