SuperAPI AI 工具集

skill-create

智能体与模型

查看项目

更新于 10-16 04:48

技能介绍

skill-create 是一个交互式技能创建工作流,用于在项目中生成 project-local 技能。

用途

用于根据项目上下文创建项目本地技能,将技能文件写入 .claude/skills/project/{name}/SKILL.md。该位置可被 Git 跟踪以便团队共享,优先于 bkit 核心技能(2 层架构),并被 Claude Code 的技能发现机制自动加载。

主要能力

  • 交互式收集技能信息:技能名称(kebab-case)、技能用途/描述、分类(workflow 或 capability)。
  • 支持多种调用方式:/skill-create(无参数,逐项询问)、/skill-create {name}(使用给定名称并分析项目上下文推断用途)、/skill-create from-btw {btw-id}(从 .bkit/btw-suggestions.json 读取 btw 建议作为描述种子与项目上下文)。
  • 分析项目上下文:读取 CLAUDE.md 获取项目约定;扫描项目结构识别技术栈(如 Java/Spring、Next.js、Python 等);在源码中查找相关模式;检查已有 project-local 技能是否重叠;确定合适的允许工具、触发关键词(韩文 + 英文)、需引用的相关文件/模式。
  • 生成 SKILL.md:包含前置元数据(name、classification、classification-reason、deprecation-risk: none、effort: low、description、argument-hint、user-invocable: true、allowed-tools: Read/Write/Edit/Glob/Grep/Bash)以及正文内容(用途与使用时机、workflow 技能的分步指令、capability 技能的模式参考、来自实际项目文件的代码示例、与其他技能的集成点)。
  • 可选生成评测文件:创建 evals/{name}/ 目录,含 eval.yaml(测试配置)、prompt.txt(测试提示)、expected.txt(预期行为描述);eval.yaml 包含技能路径与测试用例(如 basic trigger、edge case)。
  • 确认与报告:展示生成的文件路径、技能摘要(名称、分类、触发条件),并提示用 /{name} 测试或在 .claude/skills/project/{name}/SKILL.md 查看。

使用方式

三种调用方式:

  • /skill-create:无参数时询问技能名称、用途/描述、分类。
  • /skill-create {name}:使用提供的名称,分析项目上下文推断用途,并请用户确认或修改。
  • /skill-create from-btw {btw-id}:从 btw 建议读取,读取建议的 context.file 了解正在处理的代码、context.feature 了解 PDCA 功能上下文,以建议文本作为主要描述种子;创建后更新该 btw 建议的 promotedTo 字段为新技能名称。

命名约定

  • {project}-{domain},示例 hunikflow-model,用于领域特定能力。
  • {action}-{target},示例 validate-entity,用于面向动作的工作流。
  • {tool}-{purpose},示例 proxy-guide,用于工具/模式指南。

限制

关于收费、价格、平台支持范围等事实,资料中暂未提供。