如何为 Claude Code 开发高效的 AI 技能（Skill） #

本文档提供一套完整的 Claude Code 技能开发指南，教你如何利用双钩子架构（Two-Hook Architecture）和 skill-rules.json 配置，创建能够根据上下文自动激活并强制执行最佳实践的 AI 技能。

为什么需要这个技能 #

在复杂的软件项目中，单纯依靠通用 Prompt 很难确保 AI 始终遵循特定的架构规范或安全准则。通过开发结构化的 Skill，可以将领域知识（Domain Knowledge）和护栏（Guardrails）模块化。

本技能引入了 Anthropic 的核心最佳实践：500 行规则（避免上下文过载）和渐进式披露（将详细文档分层），确保 AI 在获得必要指导的同时，保持高效的响应速度。

适用场景 #

• 规范强制执行：例如在执行 Prisma 查询前，强制 AI 校验数据库字段名（Guardrail Skill）。
• 领域知识注入：为 AI 提供特定于项目的 React/TypeScript 编码风格指南（Domain Skill）。
• 自动化激活：无需每次手动输入指令，AI 根据关键词或文件路径自动加载相关技能。
• 质量把控：在 AI 完成代码编写后，通过 Stop Hook 提醒其检查错误处理逻辑。

核心工作流 #

1. 构建双钩子架构 #

• UserPromptSubmit Hook：在 Claude 看到用户输入前触发，根据关键词和意图模式注入相关技能提示。
• Stop Hook：在 Claude 响应后触发，进行事后检查（如错误处理提醒），而非阻塞开发流程。

2. 定义技能类型与强制级别 #

• Guardrail（护栏类）：优先级最高，设置为 block 级别。如果未遵循，将直接拦截 Edit/Write 工具的执行，强制 AI 修正。
• Domain（领域类）：优先级中等，设置为 suggest 级别。作为建议性指南，在相关上下文中被激活。

3. 快速创建步骤 #

1. 编写 SKILL.md：在 .claude/skills/{name}/ 下创建，包含 frontmatter。注意：正文需控制在 500 行以内。
2. 配置 skill-rules.json：定义触发词（keywords）、意图正则（intentPatterns）及执行级别。
3. 测试触发器：使用 npx tsx 手动运行钩子脚本，验证触发逻辑。
4. 迭代优化：通过 // @skip-validation 标记或环境变量 SKIP_SKILL_GUARDRAILS 处理特例。

下载和安装 #

下载 skill-developer 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要 #

暂无推荐