SuperAPI AI 工具集

skill-management

智能体与模型

查看项目

更新于 10-15 17:26

技能介绍

用途:帮助创建、更新和管理 Claude Code 技能(skills),适用于处理 SKILL.md 文件、斜杠命令或扩展 Claude 能力时参考。

技能位置与优先级:个人级 ~/.claude/skills/<name>/SKILL.md(所有项目);项目级 .claude/skills/<name>/SKILL.md(仅当前项目);插件级 <plugin>/skills/<name>/SKILL.md(启用处);企业级由托管设置控制(全组织)。优先级为 enterprise > personal > project,插件技能使用 plugin:skill 命名空间。

目录结构:my-skill/ 下 SKILL.md 为必需主指令,reference.md、examples/、scripts/ 可选。建议 SKILL.md 保持在 500 行以内,详细内容拆到单独文件按需加载。

Frontmatter 字段:name(显示名,默认目录名)、description(推荐,帮助 Claude 判断何时使用)、argument-hint、disable-model-invocation、user-invocable、allowed-tools、model、context、agent、hooks。所有字段可选,仅 description 推荐填写。

字符串替换:$ARGUMENTS 为全部参数,$ARGUMENTS[N] 或 $N 为指定参数(0 起始),${CLAUDE_SESSION_ID} 为当前会话 ID,反引号命令为动态注入(发送前执行)。若内容中无 $ARGUMENTS,参数会以 ARGUMENTS: <value> 追加。

调用控制:默认用户与 Claude 均可调用;disable-model-invocation: true 仅用户可经 /name 调用;user-invocable: false 仅 Claude 可调用。

子代理执行:加 context: fork 在隔离环境运行,技能内容成为子代理任务,agent 可指定 Explore、Plan、general-purpose 或 .claude/agents/ 中的自定义代理。动态上下文注入会在内容发送给 Claude 前运行 shell 命令。内容含 ultrathink 可启用扩展思考。

常见模式:参考型技能(约定/指南)、任务型技能(用户触发动作)、只读型技能(限制工具)。权限可在 /permissions 中限制:Skill 拒绝全部,Skill(name) 精确匹配,Skill(name *) 前缀匹配。

排障:技能未触发时检查 description 关键词,可用“What skills are available?”验证;触发过频时细化 description 或加 disable-model-invocation: true;技能缺失时注意预算为上下文窗口的 2%,可用 SLASH_COMMAND_TOOL_CHAR_BUDGET 覆盖。完整文档见 https://code.claude.com/docs/en/skills.md。