Skip to content

本页由 AI 根据韩语原文翻译,可能存在错误。

第5章 搬运技能——用一行 $weekly-review 做每周回顾 ​

必读 想跟着这个阶段学下去,一定要读这一章。

一句话总结:Codex 的技能和 Claude Code 是同一种格式(SKILL.md),只是存放的位置和调用的符号不同。文件夹是 .agents/skills,调用时用 $名称。 把整理工具里的 3 个技能搬过来,用一行 $weekly-review 做出每周回顾,再和原件对一对。

这一章依据 2026年11月1日确认的 Codex 官方文档,以及本指南的实际操作(在 Codex 终端里运行)写成。技能是什么、为什么要用,在 Claude Code 第7章里讲过了。

同样的格式,不同的位置 ​

Codex 的技能,也是一个装着 SKILL.md 文件的文件夹,SKILL.md 里必须有名称(name)和说明(description)。[1] 技能遵循多种工具共同使用的公开标准。[2] 所以,在 Claude Code 里做的 SKILL.md,不用修改,原样就搬过来了。

不同的是存放的位置和调用的方法。

Claude CodeCodex
只用于这个文件夹.claude/skills/.agents/skills/
用于我所有的文件夹~/.claude/skills/~/.agents/skills/
调用/名称$名称

来源:Codex 官方文档[3][4]

搬之前先试了一下。技能还放在 .claude/skills 里的时候调用 $weekly-review,Codex 没能直接在技能列表里找到,而是通过文件搜索翻找 SKILL.md,才找出来的。这次找到了,但放在规定的位置更保险。

理解检查

在 Codex 里,“整理工具”文件夹专用技能的存放位置和调用方法,哪项是对的?

搬运技能 ​

我这样拜托了 Codex。

把 .claude/skills 文件夹里的 3 个技能,复制到 Codex 读取的位置 .agents/skills 里。原来的文件夹保持不动。

被拦住了。 原因是第4章看到过的受保护文件夹。工作文件夹里的 .agents,默认状态下只能读取。[5] Codex 告诉我复制被阻止了,并告诉我可以改为输入的命令。

bash
mkdir -p .agents/skills
cp -R .claude/skills/meeting-notes .claude/skills/study-notes .claude/skills/weekly-review .agents/skills/

这两行的意思是这样的。

  • mkdir -p .agents/skills:创建 .agents/skills 文件夹。mkdir 是“创建文件夹”,-p 是“把中间的文件夹也一次建好,已经有了就直接跳过”。
  • cp -R 原件1 原件2 原件3 .agents/skills/:把三个技能文件夹复制到 .agents/skills/ 里面。cp 是“复制”,-R 是“连文件夹里的文件一起整个复制”。原来的文件夹会原样保留。

本指南的练习不是在应用里,而是在终端里运行的。这是预先定好许可方式、让它不来询问的运行方式,所以 Codex 没法询问,就那样停住了(这种方式在第7章里讲)。在应用里这一步看起来是什么样,本指南没能亲自确认。如果出现征求许可的画面,请读清楚要往哪里写什么,再做判断。

本指南是把 Codex 告诉我的命令亲自执行,才完成复制的。打开 macOS 终端,用 cd ~/hello-ai-practice/organizer 进入文件夹,然后输入上面的两行。如果是第一次用终端,请先看 Claude Code 第10章。

搬完之后,.agents/skills 下面有 meeting-notes、study-notes、weekly-review 三个文件夹就行了。

理解检查

你请 Codex 把技能复制到 .agents/skills,它回答说“因为是只读,被拦下了”。合适的应对是什么?

用 $ 来调用 ​

在输入框里输入 $,就可以挑选并调用技能。[6] 这次只发送了一个技能名称。

$weekly-review

复制完成之后,它直接打开了 .agents/skills/weekly-review/SKILL.md,没有用文件搜索。然后汇总 3 份回顾备忘,做出了每周回顾。

结果:用技能做的每周回顾

我把数字和事实,和原始备忘对了一遍。

原始备忘每周回顾对吗
点赞 12 个12 个对
价格错写成 6,000韩元6,000韩元 错误对
套餐今天 4 个4 个对
套餐本周合计 11 个11 个对
Instagram 3 次都发了3 次对
热红酒成本 1,800韩元没有漏了
买灯泡并换上没有漏了
写文案花了 2 小时没有漏了

来源:本指南的实践结果(2026-11-01)

没有错的项目,但有三个漏掉了。看起来是因为不太符合回顾模板的三栏(做得好的、可惜的、下周要做的),就被省掉了。像这样,不只要看错的,也要看漏的。 如果有不该漏掉的内容,就在技能里加一行,比如"像热红酒成本这种会成为下次会议议题的数字,要放进下周要做的里"。

即使不调用,只要请求和技能说明相符,Codex 也可能自己挑选技能。[7] 所以最好在说明的开头,把什么时候用写清楚。[8]

理解检查

用 $weekly-review 做出来的每周回顾,数字全都对,但漏掉了热红酒成本 1,800 韩元。这份指南建议接下来怎么做?

创建新技能与插件 ​

从头创建新技能时,调用默认自带的 $skill-creator,然后说明目标、步骤、格式。[9] 官方文档推荐的好的第一个技能,是每周汇报或会议后续整理这样的步骤和格式总是相同的事。[10] 整理工具的三个技能正是这样的例子。

这次练习不需要插件。只要记住名字和要注意的地方就行。插件是把技能和外部工具连接打包在一起安装的套装。[11][12] 对于插件里带的钩子(自动运行的脚本),文档要求在运行之前先审查,判断它是否可信。[13] 第一次见到的插件,就像在 Claude Code 第7章里学的那样,先确认是谁做的、有什么权限。

理解检查

打算安装一个没见过的插件。官方文档强调的是什么?

动手试试 ​

  1. 请 Codex 把 .claude/skills 里的 3 个技能复制到 .agents/skills。如果它征求许可,读过内容后判断;如果被拦住,就在终端里(应用菜单「View → Open Terminal」也行)亲自输入正文里的两行命令。
  2. 打开一个新对话,在输入框里输入 $,确认三个技能是否出现。
  3. 发送 $weekly-review,把结果和原始备忘对一对。把错的和漏的分开数一数。
  4. 有漏掉的,就在技能里加一行,再运行一次。

连续任务:第6章里,我们会看每周五让每周回顾自动运行的预约,以及云端和手机。

总结 ​

  • 技能格式(SKILL.md)和 Claude Code 相同。位置是 .agents/skills,调用用 $名称。
  • .agents 是受保护文件夹,搬运时可能被拦住,或者需要许可(本指南只确认了在终端里被拦住)。
  • 一行 $weekly-review 就出了每周回顾。5 个项目是对的,漏了 3 个。
  • 不只确认错的,也要确认漏的。反复出现的话,就修改技能。

术语整理 ​

术语中文名称一句话解释
$ 提及美元符提及在 Codex 里按名称调用技能的方法
.agents/skillsagents 技能文件夹Codex 在这个文件夹里查找技能
skill-creator技能创建器帮助创建新技能的默认技能

这一章读完了吗?

学习记录只保存在这个浏览器中。整体进度可以在 全部目录中查看。

下一章:第6章. 预约、云端、手机

参考资料(13 条)
  1. Codex 官方文档,「Build skills」。 "A skill is a directory with a SKILL.md file plus optional scripts and references. The SKILL.md file must include name and description." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  2. Codex 官方文档,「Build skills」。 "Skills build on the open agent skills standard." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  3. Codex 官方文档,「Build skills」。 "For repositories, Codex scans .agents/skills in every directory from your current working directory up to the repository root." / "$HOME/.agents/skills
    Any skills checked into the user's personal folder." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  4. Codex 官方文档,「Skills & Plugins」。 "ChatGPT supports @ mentions, while Codex supports $ mentions for skills." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  5. Codex 官方文档,「Agent approvals & security」。 "<writable_root>/.agents is protected as read-only when it exists as a directory." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  6. Codex 官方文档,「Slash commands」。 "You can also explicitly invoke skills by typing $ in the chat composer." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  7. Codex 官方文档,「Build skills」。 "Implicit invocation: ChatGPT or Codex can choose a skill when your task matches the skill description." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  8. Codex 官方文档,「Build skills」。 "Front-load the key use case and trigger words so a host can still match the skill if descriptions are shortened." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  9. Codex 官方文档,「Skills & Plugins」。 "In ChatGPT, start with @skill-creator; in Codex, use $skill-creator." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  10. Codex 官方文档,「Skills & Plugins」。 "Good first skills include a weekly update, a campaign brief, a meeting follow-up, or any task where the steps and format should stay consistent." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  11. Codex 官方文档,「Skills & Plugins」。 "A plugin is an installable bundle that can include skills and Model Context Protocol (MCP) servers." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  12. ChatGPT 和 Codex 共用一份插件目录。Codex 官方文档,「Skills & Plugins」。 "ChatGPT and Codex share one universal plugin directory." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  13. Codex 官方文档,「Plugins」。 "Review and trust plugin hooks before they run." learn.chatgpt.com (确认日期 2026-11-01) ↩︎