SuperAPI AI 工具集

skill-optimizer

智能体与模型

查看项目

更新于 10-16 02:02

技能介绍

用途

Skill Optimizer 用于指导创建和审查用于扩展 Claude 能力的技能(Skills),帮助其在特定领域知识、工作流或工具集成方面形成模块化、自包含的能力包。技能被类比为面向特定领域或任务的“入职指南”,可将 Claude 从通用代理转变为具备程序性知识的专用代理。技能遵循 Agent Skills 开放标准,并带有 Claude Code 在调用控制、子代理执行和动态上下文注入方面的扩展。

主要能力

  • 说明技能提供的内容:专用工作流(多步骤流程)、工具集成(文件格式或 API 使用说明)、领域专业知识(公司特定知识、schema、业务逻辑)、捆绑资源(用于复杂重复任务的脚本、参考与资产)。
  • 讲解技能结构:必需的 SKILL.md(含 YAML frontmatter 元数据与 Markdown 指令)与可选的捆绑资源目录 scripts/、references/、assets/。
  • 梳理 frontmatter 字段:name、description、argument-hint、disable-model-invocation、user-invocable、allowed-tools、model、context、agent、hooks,并说明元数据质量如何决定 Claude 何时使用该技能,建议使用第三人称描述。
  • 支持字符串替换:$ARGUMENTS、${CLAUDE_SESSION_ID},并说明当内容中不存在 $ARGUMENTS 时参数会以 ARGUMENTS: <value> 追加。
  • 动态上下文注入:使用感叹号加反引号的语法在技能内容到达 Claude 之前运行 shell 命令,用命令输出替换占位符,属于预处理而非由 Claude 执行。
  • 调用控制:通过 disable-model-invocation: true(仅用户可调用)与 user-invocable: false(仅 Claude 可调用的背景知识)控制可见性与触发方式。
  • 子代理集成:通过 context: fork 在隔离子代理中运行技能,agent 可选 Explore、Plan、general-purpose 或 .claude/agents/ 中的自定义代理;并提示仅含指导原则的技能不适合 fork。
  • 技能存放位置与优先级:Enterprise(最高)、Personal(高)、Project(中)、Plugin(命名空间隔离),同名时高优先级覆盖;支持 monorepo 的嵌套发现;.claude/commands/ 旧式命令仍兼容。
  • 捆绑资源:scripts/(可执行代码,仅输出进入上下文,token 高效且确定性强)、references/(按需加载的文档与参考)、assets/(用于输出而非加载进上下文的模板、图标、字体等)。
  • 渐进式披露设计原则:三级加载(元数据约 100 tokens 始终加载、指令在触发时加载约 5k tokens 以内、资源按需加载且几乎无上限),并提及描述字符预算(默认 15,000 字符)与 SLASH_COMMAND_TOOL_CHAR_BUDGET 环境变量。
  • 技能创建流程:理解具体用例(含结构化访谈与失败模式梳理)、规划可复用内容、使用 scripts/init_skill.py <skill-name> --path <output-directory> 初始化、编辑技能;并包含 9 类技能分类的识别与确认。

使用方式

该技能以指导文档形式提供,内容包含可直接参考的结构说明、字段表与示例。创建新技能时建议运行初始化脚本 scripts/init_skill.py <skill-name> --path <output-directory>,生成含正确 frontmatter 与 TODO 占位符的 SKILL.md 模板及示例资源目录,随后按需定制或删除。

适用场景

适合需要为特定领域或任务扩展 Claude 能力、沉淀组织内部知识、业务逻辑、数据库 schema、API 文档、公司政策,或将重复任务脚本化、模板化的团队与个人开发者。

限制

资料未提供该技能的收费、价格、平台支持范围、效果数据及具体安装命令等事实,暂未提供。技能的实际可用性取决于所在环境对 Agent Skills 标准与 Claude Code 扩展的支持情况。