SuperAPI AI 工具集

skill-development

智能体与模型

查看项目

更新于 10-15 12:36

技能介绍

Skill Development Rules 是一份针对 Claude 技能(Skill)开发流程的规则说明,适用于在 .claude/skills/ 目录中维护技能文件的人员。其核心目标是让技能定义保持简洁、可维护、可触发,并避免与实现细节混杂。

用途

该规则用于指导如何组织与编写技能文件,尤其是 SKILL.md 的结构,以及技能与触发配置、脚本目录之间的配合方式。

SKILL.md 结构要求

规范采用“DO / DON'T”的形式。

应做的事(DO):

  • 保持 SKILL.md 简洁,少于 200 行;
  • 包含清晰的“When to Use”(何时使用)章节;
  • 提供可直接复制粘贴的 bash 命令;
  • 引用 scripts/ 目录处理 MCP 操作;
  • 在 skill-rules.json 中添加触发条件(triggers)。

不应做的事(DON'T):

  • 在 SKILL.md 中写入实现细节;
  • 在多个技能之间重复内容;
  • 创建技能时不在 skill-rules.json 中配置对应触发条件;
  • 使用不需要的 allowed-tools。

MCP 包装技能

对于包装 MCP 脚本的技能,规则补充:

  • 使用 allowed-tools: [Bash, Read] 来限制能力;
  • 指向 scripts/ 目录中的脚本;
  • 包含参数文档。

适用场景

适用于在 Claude 环境中编写、组织或审查技能文件时,作为一致性与结构约束的参考。

限制

资料仅包含上述规则文本,未提供安装命令、配置示例、工具版本要求、收费信息或平台兼容性说明,这些内容暂未提供。