用途:本技能用于在 Claude Code 中创建和管理技能(Skill),并理解其自动激活机制,遵循 Anthropic 官方最佳实践,包括 500 行规则与渐进式披露模式。提及创建技能、修改触发器、调试激活问题、skill-rules.json、钩子机制等话题时会自动激活。
主要能力:采用双钩子架构。UserPromptSubmit 钩子(.claude/hooks/skill-activation-prompt.ts)在 Claude 看到用户提示前,基于关键词与意图模式注入格式化的技能提醒;Stop 钩子在响应结束后给出错误处理提醒(.claude/hooks/error-handling-reminder.ts),分析被编辑文件的高风险模式并提示,不阻塞流程。配置文件 .claude/skills/skill-rules.json 定义技能触发条件、强制级别(block、suggest、warn)、文件路径模式(glob)、内容检测模式(regex)以及跳过条件。技能分为两类:护栏型(guardrail,block,用于防止运行时错误、数据完整性等关键问题)与领域型(domain,suggest,提供领域指导)。
使用方式:技能文件位于 .claude/skills/{skill-name}/SKILL.md,需带 YAML frontmatter(name、description 含触发关键词),并在 skill-rules.json 添加条目后再测试触发。可用以下命令测试钩子:
echo '{"session_id":"test","prompt":"your test prompt"}' | npx tsx .claude/hooks/skill-activation-prompt.ts
cat <<'EOF' | npx tsx .claude/hooks/skill-verification-guard.ts {"session_id":"test","tool_name":"Edit","tool_input":{"file_path":"test.ts"}} EOF
跳过条件包括会话跟踪(避免同一会话重复提醒)、文件标记 // @skip-validation、以及环境变量 SKIP_SKILL_GUARDRAILS 等。
最佳实践:SKILL.md 保持在 500 行内,用参考文件做渐进式披露;参考文件超过 100 行加目录;名称用小写连字符、优先动名词形式;描述包含全部触发关键词(最多 1024 字符);先用 3 个以上真实场景测试再补充文档。
限制:仅在任务明确匹配上述范围时使用;输出不能替代针对具体环境的验证、测试或专家评审;输入、权限、安全边界或成功标准缺失时应停下并请求澄清。具体收费与平台支持信息暂未提供。