返回Skill 与创意场景实践 · Skill 与创意

不用反复写 Prompt:把一次好用的 Codex 对话保存成自己的 Skill

以“从 X 喜欢和公开平台筛选文章选题”为真实案例,拆解一段对话如何变成 Skill、SKILL.md 应该保留什么,以及怎样测试和继续修正。

场景实践 · Skill 与创意
本篇要完成的事

把一次选题对话保存成可重复使用的 Skill。

本文不只演示创建命令,还会打开 SKILL.md,检查触发条件、工作步骤、授权边界,并用第二个真实主题验证。

起点
一段已跑通的对话
需要操作
复制 3 次
得到结果
1 个已测试 Skill
01
先有可用流程

先完成一次真实任务

Skill 适合保存已经验证过的做法。先让 Codex 真正完成一次任务,在对话里纠正搜索范围、筛选标准和输出格式,直到结果可以直接使用。

第一轮“全网搜索,找出最值得写的一篇文章”

目标清楚,但搜索范围、私人来源、去重方式和交付格式还没有确定。

第二轮补上 X 喜欢和站内文章

明确私人来源只能在已登录浏览器里查看,同时先读现有内容,避免重复选题。

第三轮只做调研,先给候选和推荐

把“开始写、改站、提交、部署”拆成后续授权,调研结果终于可以直接验收。

真正值得保存的并不是第一句话,而是三轮对话后才出现的稳定判断:去哪里找、怎样排除、如何说明依据,以及做到哪一步必须停下。

本文案例

从 X 喜欢和公开平台中筛出最值得写的文章

  1. 01
    先做站内去重

    读取已经发布的文章,避免重复写同一个主题。

  2. 02
    再看私人来源

    通过已经登录的 Browser 查看 X 喜欢,不转交登录信息。

  3. 03
    补充公开搜索

    从多个公开平台寻找近期讨论和原始资料。

  4. 04
    给出编辑结论

    列出 3 个候选,并推荐最值得写的 1 个。

普通 Prompt

说明这一次要做什么

主题、日期、数量等本次输入可以每次变化。

Skill

保存每次都要遵守的做法

来源顺序、判断标准、输出结构和操作边界保持稳定。

02
判断复用价值

这件事适合做成 Skill 吗

不用把每段好对话都保存。下面四项大多符合时,再做成 Skill。

会重复

下周、下个月还会再做

步骤稳定

顺序和检查项已经明确

有判断标准

知道什么结果算合格

值得复用

能省掉下一次重新说明

简单判断:如果下次还得重新解释同一组步骤、边界和验收条件,就值得保存。

场景是否适合原因
每周从多个平台筛选 3 个选题适合

来源、筛选标准和输出结构会重复。

只需要改一次活动日期不适合

单次任务一句话就能说清,没有复用价值。

流程仍在频繁变化先等等

先多跑几次,等真正稳定后再保存。

内容依赖密码或 Cookie不能写入

Skill 可以记录访问方式,不能保存敏感凭证。

03
从当前对话生成

用 skill-creator 保存这次流程

留在已经完成任务的对话里发送下面这段话。Codex 能看到前面的纠正过程,可以从中提取真正生效的规则。

创建选题 Skill在原对话中发送
$skill-creator

请把当前这次“多平台调研并筛选文章选题”的对话保存成一个可复用的 Skill,名称为 weekly-topic-picker。

请保留这些规则:
- 先读取站内已有文章,排除重复选题;
- X 喜欢属于需要登录的私人来源,只能通过已经登录的 Browser 查看;
- 同时搜索多个公开平台,不能只看一个来源;
- 把有来源支持的事实和编辑判断分开写;
- 最后给出 3 个候选,并明确推荐其中 1 个;
- 默认只做调研,不修改文章、不提交代码、不部署;这些操作需要我另行确认。

请创建并验证这个 Skill,完成后告诉我它保存在哪里、包含哪些文件,以及我下一次该怎样调用。
1读取当前对话提取已经验证过的规则
2选择文件结构只创建实际需要的资源
3写入并校验检查名称、说明和文件格式

没有指定位置时,个人 Skill 通常保存在 ~/.codex/skills/weekly-topic-picker/。创建完成后,以 Codex 实际报告的路径为准。

04
确认创建结果

看懂 Codex 创建了什么

每个 Skill 都有一个 SKILL.md。名称和 description 帮助 Codex 判断何时加载它,正文只保留会改变执行结果的规则;较长资料和固定程序再拆到其他目录。

weekly-topic-picker/
SKILL.md何时使用、按什么顺序执行、怎样验收必需
agents/openai.yaml显示名称、简介和调用策略等界面信息可选
references/较长的标准、示例或资料说明可选
scripts/需要稳定重复执行的命令或程序可选
assets/模板、图片等输出资源可选
SKILL.md 示例本文案例可以从这份最小结构开始
---
name: weekly-topic-picker
description: 调研多个来源并为教程站筛选文章选题。适用于周度选题、内容去重和候选比较。
---

# Weekly Topic Picker

## 开始前
- 读取站内已有文章,先排除重复主题。
- 私人 X 喜欢只通过用户已经登录的 Browser 查看。

## 调研
1. 从私人来源提取主题线索,不保存账号信息和收藏原文。
2. 搜索多个公开平台,为候选补充可打开的原始来源。
3. 把来源事实与编辑判断分开。

## 交付
- 给出 3 个候选,并推荐其中 1 个。
- 推荐理由说明读者价值、时效性和站内差异。
- 默认停在调研结果。修改、提交和部署需要用户另行授权。
渐进加载

Codex 不会一开始读完所有文件

  1. 01
    先看到名称和 description

    用它判断这个 Skill 是否适合当前任务。

  2. 02
    匹配后读取 SKILL.md

    获得核心流程、边界和验收标准。

  3. 03
    需要时再读其他资源

    例如只有做评分时才打开 references/scoring.md。

  • 触发条件清楚 看到什么任务时应该使用它。
  • 操作边界清楚 调研、改文件和部署分别需要什么授权。
  • 完成条件清楚 最终要交付几项内容,怎样判断合格。
05
验证能否复用

换一个主题测试

创建成功不等于已经好用。换一个真实主题调用它,检查 Codex 是否仍会去重、核验来源、给出候选并遵守授权边界。

第一次复用换主题,保留同一套流程
请使用 $weekly-topic-picker,为“普通人怎样用 Codex 整理个人知识”找出本周最值得写的选题。

先完成调研和去重,只输出 3 个候选、各自依据,以及 1 个最终推荐。不要修改站点,也不要发布。
读取旧文章搜索多个来源3 选 1停在调研结果
第一次测试记录

结果看起来完整,仍有两项没有达到标准

检查项实际结果结论
先做站内去重

列出了相近旧文章和差异

通过
每个候选有原始来源

部分候选只有搜索摘要,没有原始链接

未通过
事实与判断分开

推荐理由混在来源摘要中

未通过
停在调研结果

没有修改站点或触发发布

通过

这个表比“感觉结果不错”更有用。它把 Skill 的质量变成可检查的行为,也直接指出下一轮应该修哪里。

06
继续用结果校准

把纠正写回 Skill

测试中发现遗漏时,直接指出具体差距,并要求 Codex 更新 Skill。这样保留下来的规则来自真实结果,而不是第一次就写出的猜测。

更新 Skill把本次纠正变成长期规则
刚才的测试还需要修正:
- 每个候选至少附 2 个可打开的原始来源;
- 明确标记哪些是来源事实,哪些是你的编辑判断;
- 推荐理由要同时说明读者价值、时效性和与站内内容的差异。

请把这些纠正更新到 $weekly-topic-picker,并再次验证。
这次应该写回什么

把失败改成更明确的完成条件

原规则- 搜索多个公开平台,为候选补充来源。
更新后+ 每个候选至少附 2 个可打开的原始来源。
新增+ 来源事实与编辑判断分栏输出。
完成标准

新主题也能稳定得到合格结果

连续测试后仍能遵守来源、筛选、输出和授权规则,这个 Skill 才算真正可复用。

本页导航选择要查看的章节