skill-factory

原文：🇺🇸 英文

已翻译

包含 16 个脚本

当需要将工作流、操作指南或功能打包为Agent Skill，或者需要对现有Skill进行脚手架搭建、验证、代码检查或评估时使用。适用于构建、创建、生成、搭建脚手架、检查或评估Skill的需求：Skill是一个包含SKILL.md、脚本、测试、任务图、CI和评估用例的文件夹。即使请求中使用playbook、runbook或可复用工作流而非Skill一词，同样适用。

249次下载

来源srinitude/skills

添加于2026-07-26

NPX安装

npx skill4agent add srinitude/skills skill-factory

SKILL.md 内容（中文）

查看翻译对照 →

Skill Factory

Skill Factory 可将需求转化为可用的Agent Skill：一个包含SKILL.md、脚本、测试、任务图、CI和评估用例的目录，所有内容需通过检查后才算完成工作。它还可验证和评估已有的Skill。

该技能支持哪些命令？

将用户的请求解读为以下命令之一。

命令	功能
help	显示此表格及每个命令的单行摘要。
new <prompt>	构建一个满足prompt需求的Skill。以下是主要流程。
validate <path>	对指定路径下的Skill运行结构、文档和代码检查。
eval <path>	检查Skill的评估文件，然后运行评估用例。
doctor	运行scripts/doctor.py并报告就绪状态。

任何内置脚本后添加

--help

都会打印其参数、退出码及示例。若请求不匹配任何命令，或缺少必要信息且无法推断，则停止操作，准确报告缺失内容并等待，切勿猜测。

如何构建新Skill？

以下是完整流程。每一步完成后运行指定检查；若检查失败，修复问题后重新运行该检查，再进行下一步。

运行
```
python3 scripts/doctor.py
```
。仅当输出显示"ready": true时才可继续。否则报告失败检查项并停止。
完整阅读references/generation-contract.md。你编写的每个文件都必须符合其中规定。
根据references/registry.md检查注册表。若已安装的Skill已覆盖当前需求，则直接使用该Skill并告知用户，避免重复构建。
生成符合
```
^[a-z0-9][a-z0-9._-]*$
```
格式的名称，以及包含"Use when"的描述。若存在无法解决的信息缺失：提出一个问题。若信息缺失较小：说明假设并继续。
在新Skill旁创建名为<name>-build-log.md的进度日志。后续每完成一步就追加一行记录。
搭建脚手架：
```
python3 scripts/scaffold_skill.py --name <name> --description "<description>" --dest <skills directory>
```
。验证输出显示"created"。退出码2表示名称或描述违反规则，错误信息会说明具体原因。修复后重新运行。
按TDD顺序编写内容，根据需求替换脚手架生成的初始内容：先编写mise.toml任务，再编写CI契约测试，接着是脚本测试、脚本、文档，最后是评估用例。编写代码前阅读references/code-rules.md，编写markdown前阅读references/writing-rules.md，编写评估用例前阅读references/eval-authoring.md。
在新Skill目录内运行
```
mise run ci
```
。需确保退出码为0。若任务失败，会显示对应的文件及原因；修复后重新运行直至全部通过。
运行
```
python3 scripts/validate_skill.py <path>
```
并确认最后一行以PASS开头。
报告目录结构、每个文件的用途及检查输出。关于检查通过的声明需引用最新运行结果，而非记忆内容。

如何验证或评估现有Skill？

对于validate <path>命令，在指定路径下运行scripts/validate_skill.py、scripts/lint_writing.py和scripts/check_code_rules.py。报告所有包含FAIL的行，包括文件及原因，然后针对每个问题提出修复方案。对于eval <path>命令，先运行scripts/check_evals.py；当退出码为0时，根据references/eval-authoring.md运行评估用例，并对照引用的证据对每个断言进行评分。

各类资源何时加载？

references/generation-contract.md：生成新Skill的任何文件前需阅读。这是生成型Skill需遵循的递归契约。
references/writing-rules.md：编写或编辑任何markdown文件前需阅读。
references/code-rules.md：编写任何脚本或测试前需阅读。
references/eval-authoring.md：编写或评估评估用例时需阅读。
references/registry.md：任何构建操作前需阅读，以便复用现有Skill而非重新构建。
assets/：脚手架工具使用的模板。若需查看生成的SKILL.md包含内容，可阅读assets/skill-template.md。
scripts/：可执行命令。直接运行即可；仅当重新运行后检查信息仍不清晰时，才阅读其源代码。
scripts/tests/：修改任何脚本后，通过
```
mise run test
```
运行测试。
evals/：本技能自身的用例和触发查询，以及references/eval-authoring.md中描述的注册表评估工件集。评估Factory自身时需阅读。

哪些任务对应哪些作业？

每个作业对应一个命令。

mise run ci

会运行整个流水线，是CI使用的唯一入口点。具体包含：test-ci、test、validate、lint-writing、lint-code、evals、doctor和new。远程CI配置来自assets/ci/ci.yml；将该文件复制到托管仓库的.github/workflows/ci.yml即可。

注意事项

脚手架工具会拒绝不含"Use when"的描述以及包含大写字母的名称。这是契约要求，并非bug。
文档检查会禁用破折号，并禁止scripts/lint_writing.py中维护的词汇表内的词汇。重写被标记的句子；禁用词汇的近义词通常也会触发其他规则。
文档检查还强制执行单行布局：每个段落或列表项为单行，无硬换行且无长度限制。详情请查看references/writing-rules.md。
生成的Skill会自带检查脚本的副本，因此它们可通过
```
mise run ci
```
自行验证，且无需依赖本目录的路径。
任何Skill中的文件不得提及Agent产品或模型。测试套件会扫描生成的输出，若发现此类名称则会失败。
新Skill可能要到下一个会话才能进入执行器的索引。即使索引延迟，文件也会立即生成。

工作完成的标准是什么？

完成意味着在新Skill目录内的最新运行中满足以下所有条件：

mise run ci

退出码为0，validate_skill.py输出PASS，文档检查报告0个问题，评估用例至少包含4个带有两种触发标签的用例，且构建日志记录了每一步操作。