跳到正文
教程31 篇

Codex CLI第 3 / 4 篇

把重复流程做成 Skill,而不是堆更多提示词

用一次页面验收流程,区分 Skill、项目指引和单次任务。

进阶约 10 分钟练习资料核实

学习目标

得到触发条件、输入、输出和完成标准清楚的 Skill 设计。

流程示意一个页面验收 Skill 的执行链
  1. 重复流程

    多次用相同步骤检查页面,才值得从对话里抽出来。

  2. 触发与输入

    明确何时使用,以及需要页面地址、关键流程和预期结果。

  3. Skill 执行

    按项目既有工具完成操作,不额外扩大任务权限。

  4. 可观察验收

    记录实际结果、失败证据和未覆盖项,不凭空给出通过率。

Skill 只组织流程;是否通过仍取决于工具执行和观察到的结果。

适用场景

你反复要求 AI“检查页面、验证关键流程、留下结果”,每次描述不同,输出也不稳定。

准备条件

  • 已经执行过至少一次目标流程,知道什么结果有用。
  • Codex 中可使用 Skill;若当前环境提供 skill-creator,可用它辅助创建。

操作步骤

  1. 先找真正重复的部分

    稳定的仓库规定放在 AGENTS.md;一次任务的具体地址和验收数据放在本次输入;跨任务复用的检查步骤才适合做成 Skill。

  2. 定义触发条件和交付物

    给 Skill 一个明确用途。说明什么时候用、需要哪些信息、如何判断完成;流程简单时不必附加脚本或新工具。

    Skill 设计提纲
    名称:page-check
    触发:需要验收一个可运行的网页改动。
    输入:页面地址、关键用户流程、预期结果。
    输出:执行动作、实际结果、失败证据、未覆盖项。
    完成:关键流程已验证,失败项能定位,未检查项不冒充通过。
  3. 借助创建工具整理草稿

    如果当前环境有 skill-creator,可在 Codex 中明确调用它。先核对候选的目录、范围与完成标准,再按项目既有方式接入。

    Codex 提示词示例
    使用 $skill-creator,将我的页面验收流程整理成可复用 Skill。
    先检查已有同类能力,明确触发条件、所需输入和报告格式。
    只封装重复流程,不扩大任务权限。
  4. 用一项真实任务验收 Skill

    用同一页面的成功与失败两种结果检查报告是否区分清楚。Skill 是流程指导;完成情况仍要用工具执行和观察结果来判断。

常见误区

把“处理所有开发工作”做成一个 Skill
缩小到一个可辨认、可重复的用户目标。
启用 Skill 就认为验证已经完成
要求记录实际地址、操作和结果;缺环境时说明未执行。

验收清单

  • 描述能区分应该触发和不应该触发的任务。
  • 输入缺少页面地址或预期时能明确指出缺口。
  • 报告区分已检查、失败和未检查,不凭空给出通过率。

资料与版本

本文为原创整理,示例需按项目调整;工具界面与功能以当前版本为准。