SuperAPI AI 工具集

agent-skill-builder

智能体与模型

查看项目

更新于 10-15 20:27

技能介绍

用途:根据自然语言请求生成可直接使用的技能,并保留用户指定的运行时、作用范围与实现程度。支持三种模式:new <description> 创建或起草技能;review <path> 报告可操作发现并运行校验,除非被要求否则不重写;migrate <path> 将旧版 .claude/commands/*.md 文件转换为技能目录并保留行为。

主要能力:选择运行时(Claude Code 为默认,或可移植 Agent Skills);读取宿主仓库的 AGENTS.md、CLAUDE.md 等指令文件并检查已有技能,匹配本地约定、避免能力重复;识别输入、输出、所需资源与目标目录;将技能分类为 Reference(常驻领域规则)、Task(有明确结果与停止条件的工作流)、Tool-backed(受益于可重复脚本或窄范围工具授权)。设计上只保留会改变行为的字段与指令,命名使用小写字母、数字和连字符,可移植技能要求 frontmatter 名称与目录一致,描述以能力开头并包含用户自然表达。Claude Code 专属能力包括调用控制(disable-model-invocation、user-invocable)、参数提示、context: fork、allowed-tools 预批准、! 命令动态注入只读上下文。资源组织上,共享指令放 SKILL.md,条件细节放 references/,重复确定性机制放 scripts/,输出材料放 assets/。

使用方式:解析 $ARGUMENTS,默认 new。写入前检查 <destination>/<name>/SKILL.md 是否存在,未经明确批准不覆盖。校验时运行:python3 ${CLAUDE_SKILL_DIR}/scripts/validate_skill.py --profile claude-code <skill-directory> 或 --profile agentskills <skill-directory>;可移植技能在可用时另运行 skills-ref validate <skill-directory>,并报告实际执行的检查与 PASS/FAIL 结果。建议在全新会话中测试直接调用、应激活的自然语言请求、不应激活的近似请求,以及一个应导致校验失败的变更后恢复。

适用场景:创建 SKILL.md、审计已有技能、迁移旧版 Claude Code 命令,以及需要按本地约定生成技能目录的仓库。

限制:资料未提供收费、价格、平台支持范围与效果保证;部分能力仅适用于 Claude Code 运行时;动态注入不得把技能参数插入 shell 命令,预处理阶段不得执行变更;调用控制不能替代外部或难以撤销变更前的即时批准。