一条命令装好第一个 Codex 技能：Agent Skills 实战入门

一条命令装好第一个 Codex 技能：Agent Skills 实战入门

【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills

上周一个 PR 里堆了 20 条 review 评论，逐条翻找处理很耗时间；再往前，你还得手写一遍浏览器自动化的指令给 Codex 执行。这类重复劳动其实可以存下来。Agent Skills 就是 Codex 的技能目录（一个 AI 代理技能库），每个技能都是一个标准化的文件夹：指令、脚本、资源都装在里面，Codex 发现它之后就能照做，写一次到处用。这篇 Agent Skills 教程会讲清楚：它长什么样、怎么装、装完能干什么。

一个 Codex 技能长什么样

打开skills/.curated/下任意一个技能，它就是一个结构固定的小文件夹：SKILL.md是核心，文件头部的 name 和 description 两个字段用来告诉 Codex"什么任务该用我"；agents/openai.yaml存放技能的基本信息；scripts/放现成脚本，比如 playwright 技能里的浏览器包装脚本；references/存按需加载的文档；assets/放图片等素材，LICENSE.txt声明许可。安装后技能会落在~/.codex/skills/目录下（用户级），所以你在任何项目里都能调用。判断一个技能靠不靠谱，看三处就够了：SKILL.md 的 description 是否写明了触发条件、脚本里有没有错误处理、许可是否齐全，翻一遍文件夹就能验证。

结构清楚之后，剩下的是怎么装进来。

一条命令装好 Codex 技能 📦

先把目录仓库拉到本地：

git clone https://gitcode.com/GitHub_Trending/skills4/skills

仓库里三个目录，处理方式各不相同：skills/.system/下的（skill-installer、imagegen、plugin-creator 等）会随最新版 Codex 自动装好，不用管；skills/.curated/是经过社区验证的，在 Codex 对话里按名字装即可；skills/.experimental/还在打磨，安装时要指明技能文件夹路径或直接给 URL：

$skill-installer gh-address-comments $skill-installer install the create-plan skill from the .experimental folder

有一个容易漏的细节：装完记得重启 Codex，新技能才会被加载。

装好之后，它和手写指令差在哪？两个代表技能可以直接说明。

装完技能实际能干什么

gh-address-comments处理 PR 评论：先确保 gh 已登录，然后跑fetch_comments.py拉出当前分支 PR 上的全部评论和 review 线程，逐条编号，并说明修复每条需要什么，你只管选编号，它动手改。playwright同理，不是一套测试框架，而是从终端驱动真实浏览器的一组命令：

"$PWCLI" open https://example.com "$PWCLI" snapshot "$PWCLI" click e3 "$PWCLI" screenshot

开页面、snapshot 拿到稳定的元素引用、点击输入、截图，四步走通。表单填写、多标签页、带 trace 的 UI 调试，都在它自己的 references/ 文档里写好了，照着执行就行。

精选目录覆盖不到的场景，可以自己写。

自定义 Codex 技能要注意什么

自建技能照第 1 节的结构组织：SKILL.md、agents/openai.yaml、scripts/、assets/和LICENSE.txt各就各位。重点只有一条：description 要写具体，明确说清"什么时候该用这个技能"，Codex 全靠它判断要不要调用。社区协作遵循 Contributor Covenant；发现安全漏洞，发邮件到 security@openai.com 即可。

那从哪下手？建议先在 curated 里挑一个技能跑通，比如装 gh-address-comments，拿一个真实 PR 处理几条评论，体会一下技能的触发和执行方式，再考虑自建。

【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills