skill-creator

模式：脚本优先 —— 创建新技能时，将 scripts/create.cjs 作为规范路径，然后使用本指南完成研究、审核和集成后续工作。

技能创建器

为多 Agent 生态系统创建、验证、安装和转换技能，不跳过路由、目录和注册表集成。

用途

使用此技能来：

1. 从头创建新技能。
2. 将 MCP 服务或外部代码库转换为技能。
3. 从 GitHub 安装技能。
4. 验证现有技能定义。
5. 分配或注册相关钩子、架构和配套产物。

参考文档

• 研究门槛详情 - 保留的研究门槛、安全扫描、证据质量和类型化产物搜索指南。
• 企业级套件详情 - 保留的脚手架默认设置、操作参考和目录／布局指南。
• 集成参考 - 保留的创建前／后工作流、目录／路由／索引更新，以及创建器生态系统交叉链接。
• 示例与评估 - 保留的参考技能说明、示例演练、系统影响检查清单和可选评估材料。

操作

操作	适用场景	主要命令
create	创建全新技能	node .claude/skills/skill-creator/scripts/create.cjs --name <skill-name> --description "<summary>"
convert	将 MCP 服务转换为技能	node .claude/skills/skill-creator/scripts/convert.cjs --source <package-or-url>
validate	检查现有技能定义	node .claude/tools/cli/validate-integration.cjs .claude/skills/<skill-name>/SKILL.md
install	从 GitHub 导入技能	按照企业级套件详情中的保留安装流程操作
convert-codebase	将外部工具或代码库转化为技能	按照企业级套件详情中的保留转换说明操作
consolidate	将多个范围较窄的技能整合为领域专家技能	使用企业级套件详情中的保留整合参考
convert-rules	将旧版规则迁移到技能	使用企业级套件详情中的保留规则转换参考
assign	将技能分配给一个或多个 Agent	使用下方的检查清单和集成参考中的详细矩阵
register-hooks / register-schemas	将现有资产接入技能	使用企业级套件详情中的保留操作说明
show-structure	查看预期的文件夹布局	使用下方的模板和目录指南

核心创建工作流

步骤 0：存在性检查与更新器委派

创建任何技能文件之前，先检查该技能是否已存在。

test -f .claude/skills/<skill-name>/SKILL.md && echo "EXISTS" || echo "NEW"

• 如果该技能已存在，停止创建并委派给 artifact-updater。
• 如果这是新技能，继续执行步骤 0.1。
• 不要通过直接写入绕过此步骤；unified-creator-guard.cjs 应会阻止不安全的创建路径。

步骤 0.1：智能重复项检测

继续之前，先运行重复项检测器：

const { checkDuplicate } = require('.claude/lib/creation/duplicate-detector.cjs');
const result = checkDuplicate({
  artifactType: 'skill',
  name: proposedName,
  description: proposedDescription,
  keywords: proposedKeywords || [],
});

严格按照之前的方式处理结果：

• EXACT_MATCH -> 停止并转交给 skill-updater
• REGISTRY_MATCH -> 在创建前调查注册表与文件之间的差异
• SIMILAR_FOUND -> 检查候选项，并决定是创建还是更新
• NO_MATCH -> 继续执行步骤 0.5

步骤 0.5：配套项检查

创建前运行配套项检查：

1. 加载 .claude/lib/creators/companion-check.cjs。
2. 调用 checkCompanions("skill", "{skill-name}")。
3. 记录必需和推荐的配套构件。
4. 在创建后备注中记录任何跳过的配套项。

如果该技能提供的行为指导应在显式调用之外持续生效，请确认是否还需要 .claude/rules/<skill-name>.md。

步骤 1：选择正确的操作

选择与请求匹配且范围最小的操作：

• create 用于全新技能
• convert 用于 MCP 服务转换
• install 用于导入 GitHub 技能
• convert-codebase 用于将外部工具或代码库提取为技能
• validate 用于构件已存在且只需验证的情况

步骤 2：定稿内容前通过研究关卡

定稿技能正文前，完成 研究关卡详情 中保留的研究工作流。该参考文档保留了原始的 VoltAgent、Exa、arXiv、typed-artifact-search、证据质量和外部内容安全材料。

步骤 3：运行规范创建脚本

对于全新技能，请从受管脚手架开始：

node .claude/skills/skill-creator/scripts/create.cjs --name <skill-name> --description "<summary>"

使用下方模板作为生成的 SKILL.md 必须满足的规范。详细格式说明、操作示例和布局指南保留在 企业版套件详情 中。

步骤 4：检查所请求的脚手架

企业版套件现在为可选。默认从最小脚手架开始，仅在请求明确指定 --enterprise 或确实需要相关能力时才添加企业版文件。至少要决定该技能是否需要：

• scripts/ 用于可执行辅助程序
• hooks/ 用于执行前后强制执行规则
• schemas/ 用于类型化接口
• templates/ 或 references/ 用于可复用的创作材料
• .claude/tools/<skill-name>/ 中的配套工具
• .claude/workflows/ 中的工作流

原始套件细分和验收清单保留在 企业版套件详情 中。

步骤 5：验证并集成

完成前：

1. 运行下方的创建后检查清单。
2. 运行 node .claude/tools/cli/validate-integration.cjs .claude/skills/<skill-name>/SKILL.md。
3. 如果构件是新增的或有实质性变更，请重新生成技能索引。
4. 针对已修改的部分，重新运行所需的定向验证器。
5. 如果新技能发现了另一个创建器的配套构件工作，请将其记录为后续事项，而不是在此流程中内联调用另一个创建器。

路由缺口检测

为技能搭建脚手架或更新技能后，请确认路由层仍能发现该技能。任何 no matching agent/skill 结果都应视为必须在交接前解决的路由缺口。

• 检查该技能是否需要新增或更新 Agent 分配。
• 如果可发现性元数据发生变化，请重新生成索引和注册表。
• 明确记录尚未解决的路由后续事项，不要假设另一个创建器会自行推断。

模板参考

在 SKILL.md 中使用以下基准结构：

---
name: skill-name
description: What the skill does
version: 1.0.0
model: sonnet
invoked_by: user | agent | both
user_invocable: true | false
tools: [Read, Write, Bash]
args: "<required> [optional]"
agents: [developer, qa]
category: "Validation & Quality"
tags: [testing, validation]
frontmatter:
  triggers:
    - <pattern or trigger phrase that should invoke this skill>
  token_budget: 10000  # estimated token cost for invoking this skill
  # output_schema_ref: (set if a skill-*-output.schema.json exists for this skill)
  # requires_skills: []  # list dependent skill names here
---

# Skill Name

## Purpose
What this skill accomplishes.

## Usage
How the skill is invoked and applied.

## Examples
Concrete invocation or workflow examples.

必须明确保留的 frontmatter 字段：name、description、version、agents、category、tags、tools、invoked_by 和 user_invocable。

v3.1.0 架构新增：frontmatter 块

frontmatter 对象是 v3.1.0 引入的可选、可机器解析的元数据块。Agent 无需解析完整文本即可检查其中的内容。create 操作默认会在所有新建的 SKILL.md 文件中生成该对象。

字段	类型	必填	用途
triggers	string[]	否	应触发调用此技能的模式
token_budget	integer	否	预计的令牌开销（最低为 1000）；供规划器进行预算管理
output_schema_ref	string	否	技能输出架构的路径（例如 skill-foo-output.schema.json）
requires_skills	string[]	否	此技能所依赖技能的名称（由技能索引解析）

所有 frontmatter 字段均为可选。没有 frontmatter 块的现有 SKILL.md 文件仍然有效——架构在根级别使用 additionalProperties: true，且 frontmatter 属性不在 required 中。不要在与此无关的更新中为现有技能添加 frontmatter；仅在有意刷新或验证技能时添加。

创建后检查清单

• 使用了正确的操作路径（create、convert、install、validate 或其他受支持的操作）。
• 已完成研究关卡，或已明确记录并保留相关证据。
• 技能文件位于 .claude/skills/<skill-name>/SKILL.md。
• 已填写必需的 frontmatter 字段，尤其是 agents、category 和 tags。
• 已确认至少分配了一个相关 Agent。
• 如有需要，已更新 CLAUDE.md、路由说明和技能目录。
• node .claude/tools/cli/validate-integration.cjs .claude/skills/<skill-name>/SKILL.md 运行通过。
• 可发现性元数据发生变化时，已运行 node .claude/tools/cli/generate-skill-index.cjs。
• 新建或重新注册技能时，已运行 npm run gen:all-registries。
• 创建流程有要求时，已完成 README 相关内容或目录更新。
• 已记录配套产物、记忆说明和后续事项。

生态对齐契约（强制）

此创建者技能必须确保所有新建或更新的技能与更广泛的创建者生态保持一致：

• agent-creator：负责所有权和执行路径
• tool-creator：负责可执行辅助工具
• hook-creator：负责强制执行和防护措施
• rule-creator 和 semgrep-rule-creator：负责策略覆盖
• template-creator：负责可复用的脚手架
• workflow-creator：负责编排
• command-creator：负责面向用户的快捷方式

创建者间交接确认（必需）

交接前，确认已完成相关生态更新：

1. 在需要时更新路由和发现元数据。
2. 已创建配套 Agent、钩子、工具、模板、规则或工作流，或明确记录豁免情况。
3. 技能产物通过 validate-integration.cjs 验证。
4. 元数据变更时，已重新生成技能索引和注册表。
5. 已将所有尚未解决的生态缺口记录为后续工作。

研究关卡（Exa + arXiv——两者均为必选）

对于新的技能模式、打包方式或 AI 相关方法：

1. 使用 Exa 调研当前生态中的模式和实现示例。
2. 如果主题涉及 AI Agent、评估、编排、记忆/RAG、安全或其他新兴方法，则搜索 arXiv。
3. 记录影响技能契约的决策、约束和非目标。
4. 优先采用满足请求的最小且经过验证的改动。

安全交付，防止回归

• 行为变更遵循 RED -> GREEN -> REFACTOR。
• 针对受影响的技能和创建器界面运行目标测试。
• 交付前运行必需的格式检查和验证命令。
• 将改动限定在失败的契约范围内，不要捆绑无关的清理工作。

备注

• 在创建器流程之外直接创建技能，可能导致技能不可见并破坏注册表状态。
• 如果新技能意味着需要创建新的 Agent 或其他配套产物，请将其记录为后续事项，留待下一次创建器工作流处理，而不是在流程中串联调用创建器。
• 请使用集成参考查看保留的详细步骤 6-13 指南。
• 请使用示例和评估查看保留的参考技能、创建示例演练和可选评估扩展。