Codex 技能库实战指南:3 步给 AI 代理装上可复用的工作流
2026/9/5 18:36:36 网站建设 项目流程

Codex 技能库实战指南:3 步给 AI 代理装上可复用的工作流

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

本文是写给有开发基础、刚接触 Agent Skills 的工程师的 Codex 技能库实战指南。用官方 skills 目录仓库做例子,带你 3 步装好第一个技能,再写出自己的技能包。

评审意见堆一堆:怎么让 AI 每次都把活干稳?

PR 提上去,评审留了 20 条意见。你希望 Codex 替你处理,却要一步步交代:先找到 PR,再拉评论列表,编号,挑出要改的,才动手改。明天换个项目,又从头交代一遍。写成一段长提示词吧,同事也没法直接拿去用。

把这套流程写进一个文件夹,全团队随调随用。这个技能目录干的就是这件事。

技能目录里有什么:两个目录就够

仓库很小,结构直白。你作为使用者真正会碰到的只有两个目录:

skills/ ├── .system/ # 随 Codex 自动装好(skill-installer 等) ├── .curated/ # 38 个验证过的精选技能 │ ├── gh-address-comments/ │ ├── playwright/ │ └── sentry/ └── 每个技能内部:SKILL.md + agents/ + scripts/
  • skills/.system/:最新版 Codex 自带,不用装。下面要用的 skill-installer 就在里面。
  • skills/.curated/:38 个验证过的精选技能,比如 GitHub 评论处理、Playwright 浏览器自动化、Sentry 监控、多个部署类技能。清单更新很快,常能看到新名字。
  • 每个技能的核心是 SKILL.md,把操作步骤写成指令;scripts/目录放可执行脚本。

三步跑通第一个技能

第一步,拿到仓库,放到 Codex 容易找到的位置。.system目录不用管,最新版 Codex 开箱就有。

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

第二步,装一个技能。在 Codex 里敲一行命令,默认从 .curated 里按名字安装:

$skill-installer gh-address-comments

第三步,重启 Codex。新技能重启后才会加载。之后你就能按名字或场景直接调它。

真实跑一遍:PR 评论处理技能

挑 gh-address-comments,精选技能里最有代表性的一个。

你输入什么:在 Codex 里说一句话,"帮我处理这个 PR 的评论"。

它做了什么:技能先检查 gh CLI 的登录状态,没登录就让你先跑gh auth login。认证通过后,它执行 fetch_comments.py,把当前分支开放 PR 上的所有评审线程拉下来,逐条编号,再给每条附一句"修它要做什么"的摘要。像"这里改成循环吧"这类建议性评论,也会变成列表里的一行。

你得到什么:一份编号的评论清单。你挑"改 1、3、5",它就只改这三条,其余不动。全程不用你复述流程,步骤都写在 SKILL.md 里,代理照着一步步执行。

写自己的技能:自定义 Agent Skills 最小模板

写一个技能不用多少文件,四样东西就够:

my-skill/ ├── SKILL.md # 必须:技能说明书 ├── agents/ │ └── openai.yaml # 必须:展示信息 ├── scripts/ # 可选:配套脚本 └── LICENSE.txt # 必须:每个技能自带许可

agents/openai.yaml决定技能在 Codex 里的名字和触发句:

interface: display_name: "我的技能" short_description: 一句话说清干什么 icon_large: "./assets/icon.png" default_prompt: "用户调用时的默认触发句"

SKILL.md 按"带新人走流程"的口吻写,每步一行,前置条件和出错处理都写明白。能塞进scripts/的尽量塞进去,代理发挥的空间越小,结果越稳。模板和仓库里精选技能的结构完全一样。assets 目录可省,许可文件不能省。

避坑 & 社区规矩

  • 装完技能记得重启
  • 每个技能自带 LICENSE
  • 依赖 gh 的技能先登录
  • 漏洞报官方安全渠道
  • 本仓库已弃用,看 README
  • 改动走 PR 或 Issue
  • 遵守贡献者行为准则

动手吧

先把 gh-address-comments 装上,重启 Codex 跑一次,就知道它值不值。再照上面的最小模板写一个自己的技能,提交 PR。README 里声明仓库已弃用,新技能请跟官方插件指南走,但这里学到的结构照样通用。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询