skill-developer

# 技能开发指南 ## 目的 本指南旨在全面指导如何在 Claude Code 中创建和管理具备自动激活系统的技能，并遵循 Anthropic 的官方最佳实践，包括 500 行规则和渐进式披露模式。 ## 何时使用此技能 当您提及以下内容时会自动激活： - 创建或添加技能 - 修改技能触发器或规则 - 理解技能激活的工作原理 - 调试技能激活问题 - 处理 skill-rules.json - 钩子系统机制 - Claude Code 最佳实践 - 渐进式披露 - YAML 元数据 - 500 行规则 --- ## 系统概述 ### 双钩子架构 **1. UserPromptSubmit 钩子** (主动建议) - **文件**: `.claude/hooks/skill-activation-prompt.ts` - **触发**: 在 Claude 看到用户提示词之前 - **目的**: 根据关键词 + 意图模式建议相关技能 - **方法**: 将格式化的提醒作为上下文注入 (stdout → Claude 的输入) - **用例**: 基于主题的技能、隐式工作检测 **2. Stop 钩子 - 错误处理提醒** (温和提醒) - **文件**: `.claude/hooks/error-handling-reminder.ts` - **触发**: 在 Claude 完成响应之后 - **目的**: 温和提醒自我评估所编写代码中的错误处理 - **方法**: 分析已编辑文件中的风险模式，必要时显示提醒 - **用例**: 在不造成阻塞摩擦的情况下提高错误处理意识 **理念变更 (2025-10-27)：** 我们不再使用阻塞式的 PreToolUse 来处理 Sentry/错误处理。取而代之的是使用温和的响应后提醒，既不阻塞工作流，又能保持代码质量意识。 ### 配置文件 **位置**: `.claude/skills/skill-rules.json` 定义了： - 所有技能及其触发条件 - 强制级别 (阻塞、建议、警告) - 文件路径模式 (glob) - 内容检测模式 (regex) - 跳过条件 (会话跟踪、文件标记、环境变量) --- ## 技能类型 ### 1. 护栏技能 (Guardrail Skills) **目的：** 执行关键的最佳实践以防止错误 **特征：** - 类型: `"guardrail"` - 强制: `"block"` - 优先级: `"critical"` 或 `"high"` - 在使用技能前阻塞文件编辑 - 防止常见错误（列名、严重错误） - 会话感知（不在同一会话中重复提醒） **示例：** - `database-verification` - 在 Prisma 查询前验证表/列名 - `frontend-dev-guidelines` - 强制执行 React/TypeScript 模式 **何时使用：** - 会导致运行时错误的失误 -