用途：这是一份在 Claude Code 中创建和管理 skills 的综合指南，配合自动激活系统，遵循 Anthropic 官方最佳实践（500 行规则、渐进式披露）。
主要能力与触发：提及创建/添加技能、修改技能触发规则、理解技能激活原理、调试激活问题、使用 skill-rules.json、钩子机制、Claude Code 最佳实践、渐进式披露、YAML frontmatter、500 行规则时自动激活。
配置：核心配置文件为 .claude/skills/skill-rules.json，定义技能及触发条件、执行级别（block、suggest、warn）、文件路径模式（glob）、内容检测模式（regex）与跳过条件。
技能类型：guardrail 类用于强制关键实践，enforcement 为 block，优先级 critical/high，可阻止文件编辑直到使用该技能；domain 类为特定领域提供综合指导，enforcement 为 suggest。
创建步骤：1) 在 .claude/skills/{skill-name}/SKILL.md 创建技能文件并写 frontmatter（name、description，description 含触发关键词，最多 1024 字符）；2) 在 skill-rules.json 添加条目；3) 测试触发；4) 根据测试优化模式；5) 遵循最佳实践，SKILL.md 保持 500 行以内。
测试命令：UserPromptSubmit 测试用 echo '{"session_id":"test","prompt":"your test prompt"}' | npx tsx .claude/hooks/skill-activation-prompt.ts；PreToolUse 测试用 cat <<'EOF' | npx tsx .claude/hooks/skill-verification-guard.ts 配合包含 tool_name 与 tool_input.file_path 的 JSON。
跳过机制：会话跟踪避免同会话反复提示；文件标记 // @skip-validation 永久跳过；环境变量 SKIP_SKILL_GUARDRAILS 全局禁用，另有 SKIP_DB_VERIFICATION、SKIP_ERROR_REMINDER 等技能级开关。
钩子：UserPromptSubmit 在 Claude 看到提示前注入建议；Stop 钩子在响应后做错误处理提醒。
限制与说明：具体安装方式、收费与平台信息暂未提供。