学习目标
得到触发条件、输入、输出和完成标准清楚的 Skill 设计。
- 重复流程
多次用相同步骤检查页面,才值得从对话里抽出来。
- 触发与输入
明确何时使用,以及需要页面地址、关键流程和预期结果。
- Skill 执行
按项目既有工具完成操作,不额外扩大任务权限。
- 可观察验收
记录实际结果、失败证据和未覆盖项,不凭空给出通过率。
Skill 只组织流程;是否通过仍取决于工具执行和观察到的结果。
适用场景
你反复要求 AI“检查页面、验证关键流程、留下结果”,每次描述不同,输出也不稳定。
准备条件
- 已经执行过至少一次目标流程,知道什么结果有用。
- Codex 中可使用 Skill;若当前环境提供 skill-creator,可用它辅助创建。
操作步骤
先找真正重复的部分
稳定的仓库规定放在 AGENTS.md;一次任务的具体地址和验收数据放在本次输入;跨任务复用的检查步骤才适合做成 Skill。
定义触发条件和交付物
给 Skill 一个明确用途。说明什么时候用、需要哪些信息、如何判断完成;流程简单时不必附加脚本或新工具。
Skill 设计提纲名称:page-check 触发:需要验收一个可运行的网页改动。 输入:页面地址、关键用户流程、预期结果。 输出:执行动作、实际结果、失败证据、未覆盖项。 完成:关键流程已验证,失败项能定位,未检查项不冒充通过。借助创建工具整理草稿
如果当前环境有 skill-creator,可在 Codex 中明确调用它。先核对候选的目录、范围与完成标准,再按项目既有方式接入。
Codex 提示词示例使用 $skill-creator,将我的页面验收流程整理成可复用 Skill。 先检查已有同类能力,明确触发条件、所需输入和报告格式。 只封装重复流程,不扩大任务权限。用一项真实任务验收 Skill
用同一页面的成功与失败两种结果检查报告是否区分清楚。Skill 是流程指导;完成情况仍要用工具执行和观察结果来判断。
常见误区
- 把“处理所有开发工作”做成一个 Skill
- 缩小到一个可辨认、可重复的用户目标。
- 启用 Skill 就认为验证已经完成
- 要求记录实际地址、操作和结果;缺环境时说明未执行。
验收清单
- 描述能区分应该触发和不应该触发的任务。
- 输入缺少页面地址或预期时能明确指出缺口。
- 报告区分已检查、失败和未检查,不凭空给出通过率。
资料与版本
本文为原创整理,示例需按项目调整;工具界面与功能以当前版本为准。