---

name: skill-developer description: 用于创建和管理Claude Code技能、钩子、代理和命令的元技能。在创建新技能、设置技能触发器、配置钩子、管理Claude Code基础设施时使用。

技能开发者指南

目的

创建和管理Claude Code技能、钩子、代理和命令的全面指南。这个元技能帮助您构建和配置Claude Code基础设施组件。

何时使用此技能

• 创建新技能
• 在skill-rules.json中配置技能触发器
• 设置钩子
• 创建代理
• 添加斜杠命令
• 理解技能激活模式
• 自定义技能行为

---

快速开始

创建新技能

1. 创建技能目录：

   mkdir -p .claude/skills/{技能名称}
   

2. 创建SKILL.md文件：

   • 添加包含name和description的前置元数据
   • 编写全面的指南
   • 使用渐进式披露（主文件 + resources/）

3. 更新skill-rules.json：

   • 添加带有触发器的技能条目
   • 配置fileTriggers和promptTriggers
   • 设置enforcement和priority

技能结构

.claude/skills/
  {技能名称}/
    SKILL.md              # 主技能文件
    resources/            # 可选：附加资源
      pattern-1.md
      pattern-2.md

---

技能配置

skill-rules.json结构

{
  "version": "1.0",
  "description": "技能激活触发器",
  "skills": {
    "{技能名称}": {
      "type": "domain" | "guardrail",
      "enforcement": "suggest" | "block" | "warn",
      "priority": "critical" | "high" | "medium" | "low",
      "description": "技能描述",
      "promptTriggers": {
        "keywords": ["关键词1", "关键词2"],
        "intentPatterns": ["正则表达式模式"]
      },
      "fileTriggers": {
        "pathPatterns": ["app/**/*.tsx"],
        "pathExclusions": ["**/*.test.tsx"],
        "contentPatterns": ["import.*from.*next"]
      }
    }
  }
}

执行类型

• suggest：显示技能建议但不阻止执行
• block：需要先使用技能才能继续（防护栏）
• warn：显示警告但允许继续

优先级级别

• critical：最高 - 匹配时始终触发
• high：重要 - 大多数匹配时触发
• medium：中等 - 明确匹配时触发
• low：可选 - 仅明确匹配时触发

---

文件触发器

路径模式

使用glob模式匹配文件路径：

{
  "pathPatterns": [
    "app/**/*.tsx", // app/中的所有.tsx文件
    "components/**/*.ts", // components/中的所有.ts文件
    "**/*.tsx" // 任何地方的所有.tsx文件
  ]
}

路径排除

排除触发器的文件：

{
  "pathExclusions": [
    "**/*.test.tsx", // 测试文件
    "**/node_modules/**", // 依赖项
    "**/.next/**" // 构建输出
  ]
}

内容模式

使用正则表达式匹配文件内容：

{
  "contentPatterns": [
    "from '@/components/ui/", // Shadcn导入
    "import.*from.*next", // Next.js导入
    "'use client'" // 客户端组件指令
  ]
}

---

提示触发器

关键词

简单关键词匹配：

{
  "keywords": ["组件", "页面", "路由", "前端"]
}

意图模式

用于灵活匹配的正则表达式模式：

{
  "intentPatterns": [
    "(创建|添加|制作|构建).*?组件", // 创建组件
    "(如何|最佳实践).*?react", // 如何问题
    "应用路由.*?(页面|路由)" // 应用路由器相关
  ]
}

---

技能类型

领域技能

• 目的：为特定领域提供指南
• 示例：前端开发指南、后端开发指南
• 执行：通常为"suggest"

防护栏技能

• 目的：强制执行最佳实践并防止错误
• 示例：代码质量检查、安全规则
• 执行：通常为"block"或"warn"

---

最佳实践

技能设计

1. 渐进式披露：主文件 + resources/用于详细指南
2. 清晰示例：包含工作代码示例
3. 快速参考：添加快速参考表
4. 何时使用：明确说明技能何时适用

触发器配置

1. 特定关键词：使用领域特定术语
2. 灵活模式：使用正则表达式进行意图匹配
3. 路径特异性：匹配实际项目结构
4. 避免过度触发：适当使用排除项

文件组织

1. 模块化结构：将大型技能拆分为resources/
2. 清晰命名：使用描述性技能名称
3. 文档：记录所有配置选项

---

常见模式

技术栈特定技能

{
  "前端开发指南": {
    "fileTriggers": {
      "pathPatterns": ["app/**/*.tsx", "components/**/*.tsx"],
      "contentPatterns": ["from '@/components/ui/", "import.*from.*next"]
    },
    "promptTriggers": {
      "keywords": ["组件", "shadcn", "next.js"],
      "intentPatterns": ["(创建|构建).*?组件"]
    }
  }
}

框架无关技能

{
  "错误跟踪": {
    "fileTriggers": {
      "pathPatterns": ["**/*Controller.ts", "**/*Service.ts"],
      "contentPatterns": ["Sentry\\.", "captureException"]
    },
    "promptTriggers": {
      "keywords": ["错误", "sentry", "异常"],
      "intentPatterns": ["(添加|实现).*?错误.*?处理"]
    }
  }
}

---

集成检查清单

添加新技能时：

• [ ] 创建技能目录和SKILL.md
• [ ] 编写全面的指南
• [ ] 添加到skill-rules.json
• [ ] 配置fileTriggers（pathPatterns、exclusions、contentPatterns）
• [ ] 配置promptTriggers（keywords、intentPatterns）
• [ ] 设置适当的执行和优先级
• [ ] 测试技能激活
• [ ] 记录自定义需求

---

故障排除

技能未触发

1. 检查pathPatterns是否匹配实际文件路径
2. 验证关键词拼写是否正确
3. 测试intentPatterns正则表达式模式
4. 检查是否有pathExclusions阻止触发器

过度触发

1. 添加更具体的pathPatterns
2. 使用pathExclusions过滤文件
3. 使intentPatterns更具体
4. 降低优先级级别

技能文件未找到

1. 验证技能目录是否存在：.claude/skills/{技能名称}/
2. 检查SKILL.md文件是否存在
3. 验证技能名称是否与skill-rules.json条目匹配

---

相关技能

• 前端开发指南：前端开发模式
• 后端开发指南：后端开发模式

---

技能状态：用于技能开发和管理的元技能