如果每次让 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。调用与发现规则
若技能未显示,可按以下清单排查:
- 文件名严格为
SKILL.md(注意大小写,避免被编辑器误加上.txt)。 - 该文件必须位于
article-fact-review子文件夹中,而非直接堆在skills/顶层。 - 头部 YAML 的
---是否闭合,缩进是否规范。 - 若使用项目级技能,确认终端或会话当前的工作目录处于该 Git 项目下。
- 重启客户端或新开会话,触发环境重新扫描。
测试时,可通过一次定位指令确认其实际读取的路径:
请查找 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 模板、排错清单和测试方法;虚构资料卡用于练习,未将预期结果写成模型实测。