必须使用Skill功能来自动化Git导出、会议纪要结构化等重复任务;需启用Skill Mode,通过CLI、手动克隆或$skill-installer安装,并验证触发关键词匹配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让 Codex 自动执行 Git 增量导出、会议纪要结构化、TikTok 达人匹配这类重复性高又容易出错的任务,而不是每次都要重新解释需求、反复校验步骤、手动粘贴脚本——这就必须用 Skill 功能,它不是插件,而是 Codex 的“员工手册”和“标准作业流程”。
确认 Codex 已启用 Skill 支持
打开 Codex 设置 → 选择「Agent」→ 查看「Skill Mode」是否为「Enabled」。若显示灰色不可点,说明当前模型服务未支持 Skill 加载机制——【必须使用 OpenAI Compatible API 接入且模型支持 function calling】,iThinkAPI 的 claude-fable-5 或 gpt-5.5 线路可直接启用。
重启 Codex 客户端,确保新配置生效。
安装 Skill 的三种方式
方法一:命令行一键安装(推荐给 CLI 用户)
在终端中执行:codex skill install https://github.com/obra/superpowers.git。这会自动克隆仓库、校验 SKILL.md 结构、写入本地 skills 目录。
方法二:手动克隆(兼容所有版本)
执行:mkdir -p ~/.agents/skills && git clone https://github.com/aronhy/tiktok-agent-skills.git ~/.agents/skills/tiktok-agent。
注意:Codex App 用户还需同步到 ~/.codex/skills/ 目录,否则界面无法识别。
方法三:显式调用安装器(适合新手)
在 Codex 对话框中输入:$skill-installer hatch-pet。系统将自动拉取依赖、生成配置、提示重启。这是唯一无需接触文件系统的安装路径。
验证 Skill 是否生效
第一步:重启 Codex,强制重载所有 Skill 元数据。
第二步:在对话框中输入:list skills 或 show skills,查看返回列表中是否包含你刚安装的 skill 名称(如 tiktok-agent 或 export-git-updates)。
第三步:触发测试任务,例如说:“帮我从提交 a1b2c3 开始导出增量文件”,观察 Codex 是否自动加载 export-git-updates 并开始执行 PowerShell 脚本——【若仍按普通对话响应,说明 SKILL.md 中的 description 触发关键词与你的提问不匹配】。
创建你自己的 Skill
① 在 ~/.agents/skills/my-report 创建目录。
② 新建 SKILL.md,顶部 YAML 区必须包含 name 和 description 字段,例如:
---<br>name: weekly-report-gen<br>description: Generate formatted weekly report from Notion page URL and Jira sprint ID.<br>---
③ 正文写明执行流程:先调用 Notion API 拉取周报草稿,再用正则提取 Jira issue 编号,最后用 scripts/report.py 渲染为 PDF。
④ 将 Python 脚本放入
scripts/report.py,确保有可执行权限。⑤ 执行
codex skill reload 或重启 Codex,即可通过自然语言触发该 Skill。


















