💬
PayForChat
❓ 帮助中心
← 返回文章列表

Codex Skill 怎么创建?从零做一个文章审校技能,附完整 SKILL.md

PayForChat Editorial Team·2026/10/12·15 分钟阅读
Codex SkillSKILL.mdskill-creatorCodex教程文章审校

如果每次让 Codex 审稿,都要反复强调“核对官方出处、推测与事实分开、无依据勿下断言”,可以把这些规则保存为一个可复用的 Codex Skill。后续只需调用该技能并传入文章与参考资料即可。

本文将实现一个开箱即用的技能:article-fact-review(文章事实审校技能)。它专注于将正文断言与参考材料交叉比对,输出具体的问题定位、原因及最小修正建议。纯文字版 Skill 依托 Markdown 规则运行,不需要接入 API Key,也无需依赖外部数据库或后台服务。

配置流程分为:定义规范 → 放置文件 → 验证加载 → 显式调用测试 → 边界调优。

你可以通过对话式工具快速生成,也可以直接按模板手动创建。两种方式二选一即可,避免在不同路径存放同名技能引起冲突。

先用现有账号完成这个小练习制作纯文字 Skill 不要求单独购买 API 余额。需要更多模型或用量时,再核对 Plus、Pro 的实际权益和当前价格。

前提准备

运行环境建议为支持本地文件读写的 Codex 桌面端或 CLI。

需要准备:

  • 待审校的文章与对应的来源材料(可直接使用后文提供的测试用例文本)。
  • 本地技能存放目录(后文提供了标准默认路径)。

纯文字 Skill 本质上是结构化规则提示词,它本身不提供额外的模型额度,也不代表自动获得了私有网页或内网文档的爬取权限。如果不清楚概念边界,可参考 Plugins、Skills、Apps、MCP 的区别。

第 1 步:明确职责与边界

初版规则切忌贪大求全,不要尝试构建“全能写作导师”。先限定一个任务,便于逐项检查结果:

输入待审文章与对照资料,仅核验事实、数据、日期与适用范围;明确指出不符之处,未获授权时不重写全文。

第一版暂不建议引入自动联网检索。当审校结果出现偏差时,必须首先分清是“来源资料缺失”还是“规则解析不到位”。先将离线核对流程跑顺,后续再根据需要挂载外部检索工具。

第 2 步:确定技能文件存放路径

Codex 技能以专属文件夹组织,核心规范入口文件命名为 SKILL.md。依据官方文档,个人级技能推荐存放在用户主目录的 ~/.agents/skills 下;若随项目代码库维护,则存放在仓库根目录下的 .agents/skills。官方 Build skills

适用范围推荐保存目录
跨项目全局可用(个人级)~/.agents/skills/article-fact-review/
仅限当前仓库共享(项目级)<项目根目录>/.agents/skills/article-fact-review/

Windows 环境下的个人路径一般为 C:\Users\<你的用户名>\.agents\skills\;macOS 通常为 /Users/你的用户名/.agents/skills/。~ 表示用户目录。

注意:部分早期配置可能采用 .codex/skills。如果客户端此前已经成功识别过旧目录,可继续沿用,不必为了对齐本文而强制迁移已有文件。新创建的技能建议统一遵循官方最新的 .agents/skills 约定。

第 3 步(方式 A):通过 skill-creator 对话生成

在 Codex 中输入 $ 调出工具,选择内置的 skill-creator(也可以直接在指令里输入 $skill-creator)。创建方式

直接发送以下指令(保存路径可按需调整):

$skill-creator
请创建一个纯文字 Skill,名称 article-fact-review。
用途:根据我提供的文章和来源材料,审校事实、数字、日期及适用范围。

保存到本机用户目录的 .agents/skills/article-fact-review/SKILL.md。
创建前检查该位置是否已有同名文件;如果有,先说明差异,不覆盖。

工作方式:
- 先列出来源材料,再逐项检查正文中的事实断言。
- 区分“与材料矛盾”“材料不足以证明”“缺少日期或范围”。
- 找不到依据的说法标待核实,不自动补数字、来源、测试结果。
- 输出问题位置、原因、依据、最小修改建议。
- 我没有要求重写时,不重写整篇,不发布文章。
- 第一版只使用我提供的材料,不添加联网、登录、脚本或外部连接。

完成后给出实际文件路径,并解释如何调用。

生成完毕后,确认它实际写入的物理路径及文件内容。完成后可直接跳到第 5 步开始验证。

第 4 步,路线 B:手动保存完整 SKILL.md

在选定的技能目录下创建 article-fact-review 文件夹,然后新建 SKILL.md。Windows 如果用记事本,保存时选择所有文件类型、UTF-8,并确认文件没有变成 SKILL.md.txt。

想用 Windows PowerShell 创建文件夹,可以运行下面这段。它不会自动覆盖已有技能:

$skillExampleDir = Join-Path $env:USERPROFILE '.agents/skills/article-fact-review'
$skillExampleFile = Join-Path $skillExampleDir 'SKILL.md'
if (Test-Path -LiteralPath $skillExampleFile) {
    Write-Output "已有文件,请先检查:$skillExampleFile"
} else {
    New-Item -ItemType Directory -Path $skillExampleDir -Force | Out-Null
    New-Item -ItemType File -Path $skillExampleFile | Out-Null
    notepad.exe $skillExampleFile
}

macOS 可以在访达中前往 ~/.agents/skills,创建对应目录,再用纯文本编辑器保存。不要使用富文本格式;如果不熟悉隐藏目录,路线 A 更省事。

把下面内容完整复制进文件,不要把代码块外面的反引号也复制进去:

---
name: article-fact-review
description: 根据用户提供的来源材料审校文章事实、数字、日期与适用范围。用于文章事实核对和发布前审稿;普通闲聊、翻译或只改语气时不使用。
---

# 文章事实审校

输入是待审文章及对应资料。输出是能定位到原文的事实问题清单。
只使用本次提供的材料;缺少来源时标明待核实,不补造依据。

## 审校方法

1. 给来源材料编号 S1、S2 等,记录其中已有的日期和适用范围。
2. 检查文章中的日期、数字、功能、价格、套餐和效果承诺。
3. 将问题分成三类:与材料矛盾、材料不足以证明、缺少日期或范围。
4. 对每个问题给出:原文片段、问题类型、依据编号、原因、最小修改建议。
5. 没发现问题时说明已核对的范围,不承诺文章绝对无误。

## 边界

- 材料没有给出准确率、提速倍数、价格或开放日期时,不自行填写。
- 只有官方示例而无真实测试记录时,不改写成作者亲测。
- 将“部分账号、逐步开放、预览”保留为限制,不扩大成人人可用。
- 材料相互冲突时列出冲突,不替用户猜哪一份一定正确。
- 用户未要求重写时,只给审校结果;不改文件,不发布文章。
- 用户明确要求改稿时,保留原意并修正有依据的问题。

## 输出

先用一句话说明是否发现影响事实准确性的问题。
再给问题表:原文片段|类型|依据|原因|建议改法。
文末列出待补材料。没有待补材料时写“本次没有额外待补材料”。

文件顶部的 YAML Frontmatter(两条 --- 之间)必不可少:name 用来识别技能,description 是让模型判断何时应自动调度该技能的关键元信息。下方主体部分则是模型在审校时遵循的具体逻辑约束。

本示例专注于离线比对,因此未引入外部脚本或网络请求。先跑通核心规则后,再根据实际工程需求渐进式扩展。

第 5 步:检查技能加载状态

文件就绪后,在桌面端的 Skills 入口查看;CLI 或 IDE 可用 /skills 或 $ 查找技能,确认列表中出现 article-fact-review。调用与发现规则

若技能未显示,可按以下清单排查:

  1. 文件名严格为 SKILL.md(注意大小写,避免被编辑器误加上 .txt)。
  2. 该文件必须位于 article-fact-review 子文件夹中,而非直接堆在 skills/ 顶层。
  3. 头部 YAML 的 --- 是否闭合,缩进是否规范。
  4. 若使用项目级技能,确认终端或会话当前的工作目录处于该 Git 项目下。
  5. 重启客户端或新开会话,触发环境重新扫描。

测试时,可通过一次定位指令确认其实际读取的路径:

请查找 article-fact-review 技能,告诉我实际加载路径,
并概述它的适用范围和输入要求。现在先不要执行审校。

第 6 步:用故意包含错误的用例验收

通过显式调用(在指令前加 $article-fact-review)试运行。下面的“青禾笔记”和资料卡均为虚构,用来检查审校结果:

$article-fact-review
请按技能规则审校下面的短稿,只给问题清单,不重写全文。

来源材料 S1(虚构资料卡):
青禾笔记于 2026 年 10 月 8 日发布表格导出预览。
仅部分 Pro 账号可用,逐步开放。
资料没有公布准确率、价格和正式开放日期。

待审文章:
青禾笔记 10 月 8 日上线了表格导出。
现在所有免费账号都能使用,官方准确率达到 99%。
我们亲测节省了 80% 的整理时间,下周就会对所有用户开放。

合格的输出应当明确识别出以下逻辑缺陷:

  • 缺失限定词:“上线表格导出”遗漏了材料中的“预览”状态。
  • 与事实矛盾:“所有免费账号可用”直接与“仅部分 Pro 账号”冲突。
  • 依据缺失:材料中并未出现“99% 准确率”。
  • 越界断言:材料中无实测数据,不应下结论“亲测节省 80%”。
  • 过度承诺:材料明确标注未公布正式开放时间,“下周对所有用户开放”属无依据推测。

重点验证模型是否遵守了输出表格要求,并且在未授权重写时没有擅自重构整篇文章。

第 7 步:正向验证与负向边界测试

为防止规则过宽导致误触发,还需进行两轮互补测试:

正向测试(无错误文章):

$article-fact-review
来源材料仍使用上面的 S1。
待审文章:青禾笔记于 2026 年 10 月 8 日发布表格导出预览,
目前仅向部分 Pro 账号逐步开放。

预期表现:明确确认未发现与 S1 冲突的事实,并如实说明仅核对了所给材料,不强行挑刺。

负向测试(不应触发审校的日常请求): 在不显式调用技能的新会话中输入:

把“请于周三前给我回复”改得礼貌一点,意思不要变。

预期表现:正常润色语气,不应机械套用审校表格或追问参考材料。如果出现误触发,说明 YAML 中的 description 描述过于泛化,应进一步收紧其触发边界。

常见调优对照

异常表现优先排查项处理对策
列表中未出现技能文件路径与扩展名确保文件为 .agents/skills/<skill-name>/SKILL.md
技能已加载但未生效触发方式与 Prompt 匹配首次测试建议显式使用 $article-fact-review
审校时擅自重写正文规则执行边界强化“未明确要求重写时,仅输出问题列表”
缺少材料时强行推断事实推论约束明确标红“证据不足时一律标明待核实”
简单润色或闲聊误触发description 描述范围在元数据中显式排除常规沟通与翻译场景
切换目录后找不到技能技能安装层级跨仓库使用需将技能放置于个人主目录(User Home)

调整规则时,针对暴露的具体问题微调即可。Skill 规则并非越冗长越好,精简准确的边界设定往往执行效果更稳定。

日常复用与进阶

日常使用中,一次性传入正文与参考来源即可高效运行:

$article-fact-review
审校下面这篇订阅说明,来源有 S1 产品页摘录、S2 帮助文档摘录。
请重点查价格单位、适用账号、是否仍在逐步开放。
先给问题清单;发现缺失来源的地方不要自行补事实。

需要团队分发或连接外部工具时,可以再考虑插件。写好 Skill 不会自动建立定时任务,也不会自动获得外部应用权限。参考官方指南了解更多进阶模式:Skills 与 Plugins 的分工。

更多关于 Prompt 与 Skill 的协作规范,可参阅 GPT-6 提示词与 Skills 设置指南 以及 GPTs 迁移到插件指南。

资源与用量说明

纯文字 Skill 本身仅为指令模板,不提升账号的模型额度,亦不产生额外的技术溢价。它带来的主要收益是免去每次手动粘贴长篇约束规范的繁琐,方便复用同一套审校标准。实际调用仍会消耗模型用量,文章、材料和输出长度等都会影响消耗。

PayForChat 为独立第三方订阅服务,与 OpenAI 无隶属关系。当前可订购套餐、价格和账号条件请查阅套餐页。本文示例不涉及任何私有账号认证信息或外部 API 凭证。

常见问题

Q: 创建 Skill 必须会写代码吗?

A: 不必。本例只用一个 Markdown 文件,核心是结构化地列出审稿约束与输出规则。只有在需要复杂自动化计算或外部服务集成时,才需要引入脚本与连接器。

Q: Skill 和每次粘贴提示词有什么区别?

A: Skill 把规则保存为可发现、可重复调用的文件。个人级技能可以跨项目使用,项目级技能跟随对应项目;这不保证每次审校都没有错误。

Q: 为什么保存了文件,Codex 仍然找不到该技能?

A: 优先检查文件命名是否严格为 SKILL.md,所在目录名称是否一致,YAML 元数据是否完整。如果是项目级技能,需确认当前会话处于对应工作目录下。保存后可重启客户端或新建会话强制刷新。

Q: 可以直接在 ChatGPT 网页端上传 SKILL.md 来安装吗?

A: 直接上传文件仅作为单次会话的上下文输入,不会被系统注册为全局可调用的本地技能。网页端或跨团队的分发需走插件(Plugins)发布机制。

Q: Skill 会自动读取本地未授权的文件或发布文章吗?

A: 不会。技能只在当前会话的权限与上下文范围内工作。本例要求只审校提供的材料;Skill 文本本身不会授予或撤销工具权限,外部操作仍需相应工具与授权。

Q: 怎么确认它真的有用,而不只是格式正确?

A: 用错误稿、正确稿和不应触发的请求分别检查,确认它能指出真实问题、不编依据,也不会把无关任务套进审稿流程。

来源与更新记录

  • OpenAI:Build skills:文件结构、路径规范、调用与创建器。
  • OpenAI:Skills & Plugins:技能与插件的架构差异及分发机制。
  • OpenAI:Use ChatGPT:本地与云端环境差异说明。

2026-10-12:首次整理。提供 Skill 模板、排错清单和测试方法;虚构资料卡用于练习,未将预期结果写成模型实测。

需要开通 Codex?查看 Codex 充值专题页,了解支持套餐、支付方式和到账流程。查看 Codex 充值

推荐阅读

Codex 运行中改需求更快了:Steer、Queue 和停止任务该怎么选

OpenAI 10 月 8 日推出更快的 Codex steering。本文用改需求、追加任务和紧急停止三个场景,说明 Steer 与 Queue 的区别、桌面设置位置,以及为什么新消息不会撤销已完成操作。

国庆想用 AI 做个小项目,买一个月 Plus 够不够?附旅行预算工具提示词

趁着国庆假期,用 AI 搓一个能直接本地运行的旅行记账与预算工具。内附需求、调优、验收三组完整提示词与测试数据,并聊聊免费 Luna 与 Plus 的选型与额度规划。

Codex CLI 0.155 教程:语音对话、Worktree 隔离、插件市场和 Touch ID,Plus 用户怎么用上(2026)

OpenAI 9 月 17 日发布 Codex CLI 0.155.0。按官方更新记录整理 0.154 到 0.155 的新功能:/voice 语音对话、--worktree 隔离检出、边干活边答题、/plugins 插件市场、MCP 请求 Touch ID 验证,附升级命令、模型迁移提醒和 Plus/Pro 额度注意点。

看完教程,3 步完成充值

无需海外信用卡,支持微信 / 支付宝 / 信用卡支付,便捷开通

月卡 ¥189 起

立即充值

已为 10000+ 用户完成充值

充值教程与常见问题也整理在 GitHub 指南仓库,觉得有用请点个 Star

💬PayForChat

最简单的 GPT Plus / Pro 开通服务

快速链接

💎 购买套餐⚖️ Plus / Pro 套餐对比📖 Plus 代充指南📦 我的订单🚀 Pro 代充指南💎 Pro 200 说明💎 Pro 500 说明❓ 帮助中心📖 Codex 代充指南📚 教程文章⭐ GitHub 充值指南

联系客服

📧

客服邮箱

点击复制邮箱,发送邮件获取帮助

PayForChat 为独立第三方服务,与 OpenAI, Inc. 无任何关联。ChatGPT® 是 OpenAI, Inc. 的注册商标。

© 2026 PayForChat. All rights reserved.

关于我们隐私政策服务条款