SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场skills-creator

skills-creator

编程与开发

查看项目

更新于 10-15 09:53

技能介绍

用途

skills-creator 用于创建 Claude Code 插件组件，包括技能（skills）、代理（agents）、命令（commands）以及完整插件。它还负责在技能与代理架构之间做出选择。

主要能力

  • 根据用户意图进入不同工作流：new skill、new agent、new command、new plugin。
  • 在收集需求前，帮助判断应该创建技能还是代理：如果属于知识、约定、配方，则创建技能；如果需要独立上下文、工具限制或并行执行，则创建代理；如果同时包含知识与专门工作，则创建技能加一个或多个代理。
  • 提供描述词工程指导，包括高激活模板、指令式语气、负面约束、TRIGGER WHEN 与 DO NOT TRIGGER WHEN 的写法以及 token 预算注意事项。
  • 生成技能目录、SKILL.md、代理文件、命令文件以及捆绑资源目录。
  • 在 .claude-plugin/marketplace.json 中注册新组件，并提升插件版本与 metadata.version。
  • 进行验证：文件存在、frontmatter 可解析、命名规范、无 em dash 字符，并报告创建结果。

使用方式

该技能以流程化方式运作。首先加载 marketplace-ops:kernel-marketplace，并检测目标项目的源模型。对于 daodan/v1 中性内核，遵循该技能的操作流程；生成的导出与目录条目被视为输出，不作为源编写。以下流程仅适用于手工编写 agents/ 与 commands/ 的传统 Claude 市场，不适用于中性内核检出。

随后根据用户请求选择工作流。若不清楚，询问用户要创建技能、代理、命令还是完整插件。

在技能 vs 代理决策中，核心问题是：这是需要独立上下文、工具或隔离，还是任何代理都应能访问的知识？

在描述词工程部分，文档指出描述字段决定组件是否能激活。被动描述激活率约为 50-77%，带负面约束的指令式描述可达 97-100%。高激活模板为：领域专家。当用户执行某操作时始终调用此技能。不要直接执行某替代操作。TRIGGER WHEN: 具体触发条件，逗号分隔。DO NOT TRIGGER WHEN: 易混淆情形（改用同级组件）。最后一行仅在存在可命名的同级组件时编写。

描述规则包括：使用指令式语气、包含负面约束、列出具体触发短语、使用第三人称、最多 1024 字符、始终包含 TRIGGER WHEN、仅在命名同级组件时包含 DO NOT TRIGGER WHEN、避免在开头句与 TRIGGER WHEN 中重复术语。

DO NOT TRIGGER WHEN 规则：只有当该子句命名了应处理该情形的组件时，才值得消耗上下文。它是路由指令，不是免责声明。若不存在易混淆的同级组件，则完全省略该子句。

Token 预算意识：描述是组件中唯一每次会话都存在于上下文的部分；正文仅在调用后加载。每个技能或代理在空闲时约消耗 100 token（仅名称与描述）。所有描述合计默认共享 15000 字符预算。当总描述文本超过此限制时，组件可能被静默地从系统提示中移除。建议尽可能将单个描述保持在 300 字符以下，只列出触发词汇而非功能集，去除营销形容词、机制句子以及非触发条件的工具链版本号。

需求收集阶段：针对技能，询问功能与解决的问题、确切触发短语、不应触发的情形、应归属的插件、是否需要捆绑资源、自由度。针对代理，询问角色与任务、所需工具、所属插件、适合的颜色。针对命令，询问调用时的行为、期望参数、所属插件。针对完整插件，询问领域与目的、需要的组件、类别。每封消息不超过 3-4 个问题。

内容生成阶段：生成生产就绪的文件与真实内容，不使用占位符。技能创建需建立 plugins/<plugin>/skills/<skill-name>/ 目录并编写 SKILL.md，遵循 frontmatter 规则与描述模板；正文控制在 500 行以内，使用祈使语气；仅在需要时创建 references/、scripts/、assets/ 子目录。代理创建需编写 plugins/<plugin>/agents/<agent-name>.md，frontmatter 包含 name、description、model: inherit、color，可选 tools；正文使用简洁关键词列表风格，包含 # ROLE、# CAPABILITIES、# CONVENTIONS、# OUTPUT FORMAT 等部分；简单代理 60-200 行，复杂代理最多 800 行。命令创建需编写 plugins/<plugin>/commands/<command-name>.md，frontmatter 包含 description、argument-hint，正文为步骤化流程。

市场注册阶段：读取 .claude-plugin/marketplace.json，将路径加入对应数组；若为新插件，添加完整条目，包含 name、source、description、version 1.0.0、author、license、keywords、category、strict；提升插件版本与 metadata.version。

验证阶段：确认文件存在于注册路径、frontmatter 可解析、命名规范、无 em dash 字符，并报告创建的文件路径。

适用场景

适用于需要为 Claude Code 创建新技能、代理、命令或完整插件的场景，尤其是需要遵循项目约定、生成真实内容、正确注册到市场并确保描述可被有效激活的情况。

限制

该技能仅适用于手工编写 agents/ 与 commands/ 的传统 Claude 市场，不得应用于中性内核检出。描述字段有 1024 字符硬限制，全部描述默认共享 15000 字符预算，超出可能导致组件被静默移除。命名必须使用 kebab-case，不得使用 em dash。代理默认模型为 inherit，代理文件名与技能目录名必须匹配 frontmatter 的 name 字段。必须同时提升插件版本与 metadata.version，并在同一提交中暂存 marketplace.json 与组件文件。必须编写真实内容，不得使用占位文本。