如何从零开发一个工业级的 SKILL

可能大家都听过 skill 这个东西,可能也用过。但是自己从未动手开发过一个 skill,本文主要是带你从一个空目录开始,做出一个可以被验证的 Skill 包。

我们要做的 Skill 叫 Skill Forge。它的用途不是处理某个具体业务任务,而是帮助我们创建、改进和检查其他 Skill。

你可以把它理解成一个“Skill 开发助手”:当你想做一个新的 Skill,比如“会议记录转项目周报 Skill”时,Skill Forge 会帮助你明确触发条件、工作流程、参考材料、检查规则和评估方式。


工业级 SKILL 是什么



为什么管 Skill Forge 叫工业级 skill 呢?我们来说下工业级的标准:


  • 触发准确:该用时再触发

  • 权限收敛:只给必要权限

  • 模型匹配:任务匹配模型

  • 渐进披露:材料按需读取

  • 可评测:能做验证测试

  • 可迭代:能持续改进


简单来说,就是把一个好用的提示词,进一步做成可触发、可执行、可检查、可持续修改的工作流包。


实践流程



在开始之前,我们先过下一个通用的 skill 的常见开发流程。如下图所示:

分析需求 → 写成可复用 prompt/workflow → 跑起来测试 → 看哪里不稳定 → 修改 → 再测试

简单来说,就是明确具体需求之后,写成可复用的 prompt 或者是 workflow,再通过支持 skill 功能的 Agent 运行,看这个 skill 是否满足需求。再进一步迭代,优化。

下面,开始今天的实践:


具体实践过程



环境准备


你需要有:


1.一台能运行 python3 的电脑;本文实践环境为:Python 3.14.5;

2.一个可以编辑文件的工具,比如 VS Code;

3.一个可以运行 Skill 的 Agent 环境,比如 Claude Code、Codex,或其他支持 SKILL.md 的 Agent;本文用的 Agent 为 Codex CLI;

4.一个准备放实验文件的目录。


项目初始化


定义路径变量


这部分主要是为了统一后面命令中会反复用到的路径,少写长路径,也减少复制命令时出错的概率。

打开终端,先执行:

export CASE_ROOT="./cases/skill-forge"
  • CASE_ROOT 是这次实践的根目录。后面我们创建的 Skill 包、测试结果、评分文件,都会放在这个目录下面。


你可以把它理解成一个“快捷地址”:一个指向这次实践的工作区。只要这个变量配置对了,后面的命令基本就能直接复制执行。

友情提醒:如果你关闭了终端,后面重新打开了终端,需要先重新执行一次 export CASE_ROOT="./cases/skill-forge" 。


实操参考图:



创建实验目录


现在,来创建下本次实践要用到目录:

mkdir -p "$CASE_ROOT"
cd "$CASE_ROOT"

现在你的目录大概是:

cases/
  skill-forge/

后面我们会在这个目录下面放文章记录、测试结果和真正的 Skill 包。

命令执行参考图:



文件目录参考图:(由于我是在本地的根目录下执行的命令,所以就在用户目录下见到“cases”文件)



创建 Skill 包目录


来创建下真正的 Skill 包目录,在你当前所在的 skill-forge 目录下执行下面命令:

mkdir -p skill-forge/{references,assets,scripts,agents}

创建完成后,目录应该长这样:

cases/
  skill-forge/              # 外层:这次实践的工作区
    article.md              # 可选:文章记录,目前没有这个文件
    eval/                   # 可选:测试结果,目前没有这个目录
    skill-forge/            # 内层:真正的 Skill 包
      references/
      assets/
      scripts/
      agents/

注意,里面这个最下面的这个 skill-forge/ 才是真正的 Skill 包;外层的cases/skill-forge/ 是这次实验的工作区,可以放文章、测试记录和其他临时材料。

实操参考图:

命令执行参考图:



文件目录参考图:



简单的需求分析


在正式写 SKILL.md 之前,我们要先把 Skill Forge 的需求拆一下。

这次要做的 Skill Forge,不是用来处理某个具体业务任务的。它接收的是一个 Skill 需求,比如“帮我做一个会议记录转项目周报的 Skill”;它要产出的,是一个新的、可复用的 Skill 包。

所以它至少要回答几个问题:


  • 用户提出什么请求时,应该触发 Skill Forge;

  • 用户只是做普通总结、写作或代码任务时,不应该触发它;

  • 触发之后,先判断任务类型,再决定是创建、更新、验证,还是保持安静;

  • 详细评分规则、测试样例和检查脚本,不全部塞进 SKILL.md,而是拆到 references、assets 和 scripts 里。


把这些想清楚之后,再去写 SKILL.md,就不会把它写成一大段混在一起的提示词。


编写 Skill 入口:SKILL.md


下面,我们来创建下 SKILL.md 文件。它是 Skill 的入口文件,主要放触发条件、边界和最短工作流;详细规则、样例、评分标准不一定都放这里。

在终端的当前目录(外层的 skill-forge)下继续执行下如下命令:

touch skill-forge/SKILL.md
现在,用 VS Code 打开上面的 SKILL.md 文件,先写入一个最小版本,并保存文件:
---
name: skill-forge
description: Use when the user asks to create, improve, validate, or evaluate an agent skill package. Do not use for general writing, generic summarization, ordinary coding tasks, or requests to perform the business task directly.
---

# Skill Forge

Use this skill to help create, improve, validate, or evaluate agent skills.

This skill does not perform the target business task directly. For example, if the user asks for a meeting-notes skill, create or improve the skill package instead of summarizing the meeting notes.

## Task types

Classify the request into one of four types:

- new: the user wants to create a new skill.
- update: the user wants to improve an existing skill.
- validate: the user wants to check whether a skill is usable.
- quiet: the request is a general writing, summarization, coding, or business-task request and should not trigger this skill.

## Minimal workflow

1. Identify the task type.
2. Check whether the request should trigger this skill.
3. If creating or improving a skill, define the skill contract first.
4. Keep SKILL.md short.
5. Put detailed scoring rules in references/rubric.md.
6. Put eval cases in assets/eval-cases.json.
7. Use scripts/skill_quality_gate.py for repeatable checks.

## Output requirements

When creating or improving a skill, produce:

- skill name
- description with positive and negative trigger rules
- minimal…
— 以上为试看内容(约 40%),开通会员后阅读全文 —