一项工作只要长期重复、材料在电脑里、结果又能检查,就值得尝试交给Codex先跑一个小样。
把一段很长的万能提示词改名叫Skill,并不会自动变成可靠流程。没有输入、边界和验收,重复的只是同一种不确定。
所以这篇文章只解决一件事:从一个已跑通的重复任务提炼首个可维护Codex Skill。最终交付必须能被另一位不了解过程的人复查,而不是只由工具自己宣布完成。
适合谁
适合每周或每天重复同一类工作,已经有稳定步骤,希望Codex下次直接按流程执行的人。
如果没有真实材料、说不清结果要用在哪里,或准备把输出不经检查直接提交,先不要扩大任务。补齐最小输入,再从一份样本开始。
Codex可以读取项目、修改文件和执行命令,因此先使用副本或版本控制,明确禁止触碰的目录与生产环境。高风险操作、唯一原件和最终判断必须留给人工。
开始前准备
- 至少两次真实任务记录
- 稳定步骤与常见异常
- 输入、输出和验收样例
- 建立一个测试副本或新目录,不直接操作唯一原件。
- 写下一句验收标准:Skill能在一份新样本上按相同步骤交付,缺材料时会暂停,结果可用明确清单验收
先确认这三项材料是当前版本,并写明各自用途。文件越多,越需要先编号和分批,不能用一次全量处理来测试规则是否正确。
完整步骤
第一步之前:先做一个最小样本
第一轮只验证流程,不追求覆盖全部范围。保留原始输入和第一次结果,后面每次调整才能知道究竟改善了什么。
第一步:选择边界清楚的任务
优先选频率高、判断规则稳定、结果能检查的任务,不从“帮我运营全部业务”开始。
继续下一步之前,抽查“Skill任务定义”中的边界项和异常项;发现前提不成立就先修正。
第二步:分离说明、脚本和样例
把执行规则写在入口说明,可重复机械步骤放脚本,合格输出放样例。
把“Skill目录草案”作为本轮留存证据。后续合并或扩大范围时,都应能用它复盘。
第三步:用新样本独立运行
不要只用创建时的原案例测试,换一份结构相近但内容不同的输入。
先停在这里检查一次。此时应已经形成“独立测试记录”,并且能回到原始材料说明它从哪里来。
第四步:记录触发与失败边界
说明何时使用、何时不用、缺什么材料应暂停,并根据失败迭代。
这一阶段的完成标志不是工具有回复,而是“可发布Skill版本”已经可供人工检查。
第五步:人工验收并沉淀流程
完成一次任务只是起点。保留材料版本、实际改动和验收记录,下次才有条件把它训练成稳定工作流。
实际示例
“每周从工作记录生成证据化周报”适合做Skill,因为输入、栏目和验收稳定;“帮我成为优秀产品经理”没有清晰输出,不适合作为第一个Skill。
可以先这样描述任务:
我正在处理“从一个已跑通的重复任务提炼首个可维护Codex Skill”。已有材料包括至少两次真实任务记录、稳定步骤与常见异常、输入、输出和验收样例。请先不要扩大任务范围,也不要补造缺失信息。先完成“选择边界清楚的任务”,输出可以人工检查的中间结果;我确认后,再继续“分离说明、脚本和样例”。最终请按照“Skill能在一份新样本上按相同步骤交付,缺材料时会暂停,结果可用明确清单验收”列出验收结果和仍需人工确认的内容。
判断示例是否成立时,不看字数和语气,重点看另一位同事能否沿着文件、页码、表格或命令输出复查。
常见问题与报错
Skill只有在原项目里能用
检查是否把绝对路径、个人账号、临时文件名或未说明依赖写死;改成参数、相对路径和明确前置条件。
任务跑了很久,却说不清改了什么
先要求列出计划和预计修改文件,每个阶段输出变更摘要、diff、命令和未解决项;没有检查点的长任务应暂停后重新拆分。
一次修改太多文件,出现问题无法定位
回到版本控制或副本,按一个目标一组文件重新执行;每批修改后立即运行对应检查,不把多个不相关需求放进同一次任务。
排查时先看实际读取文件、修改diff、命令和输出。一次只调整一个范围或规则,避免把多个故障叠在同一次执行里。
完成后的检查方法
- Skill能在一份新样本上按相同步骤交付,缺材料时会暂停,结果可用明确清单验收
- 关键结论能回到原始材料、文件、命令输出或当前控制台。
- 没有把缺失信息、推测内容或示例数字写成已经确认的事实。
- 重要文件保留原件、版本或可恢复副本,敏感信息没有进入公开内容。
- 结果已经由真正负责这项工作的人审阅,而不是只看页面是否生成。
验收通过的标准很朴素:结果能用、过程能查、出错能退、未知项没有被伪装成结论。
资料来源
- OpenAI Codex文档
用于核对Codex的产品定位和当前官方使用说明。
- OpenAI Codex Skills文档
用于核对Skills的当前组织和使用方式。
FAQ
可以一次把整个任务交给Codex完成吗?
不建议一次交付全部范围。先按本文步骤完成一个小样,用“Skill能在一份新样本上按相同步骤交付,缺材料时会暂停,结果可用明确清单验收”验收,再决定是否扩大范围。
遇到“Skill只有在原项目里能用”应该先检查什么?
检查是否把绝对路径、个人账号、临时文件名或未说明依赖写死;改成参数、相对路径和明确前置条件
完成后还需要人工检查吗?
需要。AI或执行工具负责推进流程,最终仍要由你根据原始材料、任务规则和“Skill能在一份新样本上按相同步骤交付,缺材料时会暂停,结果可用明确清单验收”完成验收。
