跳到正文← Codex 零基础Skill 工坊 · Codex 本地技能
把做顺的任务,
留成可复用的方法
从三份纯指令模板开始,写清什么时候使用、按什么步骤做、怎样检查结果。技能本身不会增加文件生成、屏幕访问或外部账号权限。
这里制作的是 SKILL.md 文件。页面不会替你安装技能、运行命令或调用模型;示例由本站编写,适用于支持本地技能的 Codex 入口。
正在读取本机草稿… 草稿仅在本机当前浏览器保存,不上传服务器;清理浏览器数据会删除草稿,请勿写入密钥或私人资料。
改成自己的方法
更换模板会保留各自草稿。先改触发范围、操作步骤和验收要求,再检查并下载。
本地练习目录中的技能文件夹与 SKILL.md 文件名;文件内容需在编辑器中另行核对。 把文件放对,再确认被发现
下载文件只完成第一步。接下来在你实际运行 Codex 的环境中放置文件;本机、WSL 和远程工作区要分别核对。
当前内容尚未在本轮下载,或下载后又有修改。安装前请下载最新文件。
tutorial-writing 的目标文件路径
你的项目目录\.agents\skills\tutorial-writing\SKILL.md
- 先阅读下载文件。若你加入了脚本、外链或依赖,请另行核对来源、用途与权限。
- 把“你的项目目录”换成在 Codex 中打开的项目文件夹,逐层新建
.agents/skills/tutorial-writing。已有同名目录时先备份,不要直接覆盖。 - 在资源管理器中打开项目文件夹;安装个人技能时,可按 Win + R 输入
%USERPROFILE% 打开用户主目录。开启“查看 → 显示 → 文件扩展名”,再检查文件名。 - 将下载文件放入目标目录,最终名称应是
SKILL.md。注意浏览器可能下载成 SKILL (1).md,Windows 也可能隐藏 .txt 后缀。 - 打开对应项目并确认技能被发现。CLI / IDE 扩展可用
/skills 或输入 $ 查找;桌面入口按当前版本的技能界面检查,未出现时重启后再查。 - 在新对话里复制下面的调用请求。检查实际回复是否使用了该方法,再进入“检查结果”做三个小测试。
第一次调用
$tutorial-writing
读者第一次使用 Codex。已确认:左侧显示项目,中间是对话区,右侧可查看文件。请写一节“找到练习文件”。
用“教程口吻”跑三个小例子
下面的请求和验收标准跟随所选模板。修改了方法后,也要调整测试材料;分别新开对话更容易发现是否依赖上一轮内容。
正常材料
$tutorial-writing
读者第一次使用 Codex。已确认:左侧显示项目,中间是对话区,右侧可查看文件。请写一节“找到练习文件”。
检查什么先说明目标,再给短步骤;只使用已提供的界面信息,并说明如何检查找到的文件。
缺少依据
$tutorial-writing
帮我写一篇这个新软件的安装教程,但我还没有提供软件名、系统和安装资料。
检查什么先指出缺少的软件、系统和资料,不编造下载地址、按钮或安装命令。
不适用任务
$tutorial-writing
这次只要一个关于月亮的故事,不需要教程。
检查什么不强行套用操作步骤;说明当前请求不属于教程写作流程。
记下真实结果
记录 Codex 入口与版本、输入材料、实际输出、通过或失败的原因。文件已下载、技能出现在列表、输出符合方法,是三件需要分别检查的事。页面不会替你执行这些测试,也不会自动标记通过。
没被发现时检查目录、文件名和前置信息;发现了却没按方法执行时,收窄描述中的触发范围,补充步骤,再用新材料重试。
目录与调用方式依据 OpenAI 官方 Build skills 文档(2026-10-04 核对)。Windows 路径按默认用户主目录展开;具体入口以当前版本为准。